Documentation

Workflows Overview

Workflows are step-by-step AI playbooks for specific real-world tasks. They guide you through complex AI interactions with practice scenarios, prompt templates, and expected outcomes — helping you build AI fluency for your role.

What is a Workflow?

A workflow is a WORKFLOW.md file that defines:

  • YAML frontmatter — metadata like title, difficulty, role, safety level, time saved, and step definitions
  • Markdown body — detailed overview and any additional context for the workflow

Unlike skills (which teach AI how to do things) and personas (which define AI personality), workflows provide structured practice — guided sequences that help you learn AI techniques through hands-on experience.

Workflow Structure

Each workflow contains multiple steps, where each step includes:

  • Instruction — what you need to do in this step
  • AI Prompt Template — pre-filled prompt you can customize
  • Expected Output — what a good AI response looks like
  • Tips — guidance for getting better results

Difficulty Levels

Workflows are categorized by difficulty, which determines fluency points earned:

  • Beginner — Single-step tasks, 10 fluency points
  • Intermediate — Multi-step workflows, 25 fluency points
  • Advanced — Complex multi-step challenges, 50 fluency points

Safety Levels

Workflows have safety classifications to help you choose appropriately:

  • safe-anywhere — Uses synthetic/practice data only, safe for any environment
  • requires-own-ai — Should be run with your own AI provider (e.g., personal API key)
  • uses-real-context — Designed for real data, requires Live Mode (unlocks at 250 fluency points)

Role-Based Workflows

Workflows are tagged with role categories to help you find relevant practice for your job:

  • software-developer — Code review, debugging, documentation
  • product-manager — PRDs, user stories, roadmaps
  • designer — Design critiques, accessibility audits
  • data-analytics — Data analysis, visualizations, reports
  • marketer — Copy writing, campaign planning, A/B testing
  • sales — Outreach, objection handling, proposals
  • customer-success — Support responses, documentation
  • hr-recruiting — Job descriptions, interview questions
  • finance — Financial analysis, forecasting
  • operations — Process documentation, SOPs
  • content-writing — Blog posts, social content
  • executive — Strategy documents, board presentations

Practice Mode vs Live Mode

Workflows can be completed in two modes:

  • Practice Mode — Uses synthetic data generated for the scenario. Perfect for learning without risk.
  • Live Mode — Paste your real context and work with actual data. Unlocks at 250 fluency points.

The Workflows Marketplace

Browse and discover workflows at /marketplace?tab=workflows. You can:

  • Search by title, description, or tags
  • Filter by role category
  • Filter by difficulty level
  • Sort by newest, most completed, or highest rated
  • Preview workflow steps before starting

Creating Workflows

Workflows can be created by users with Creator access (Creator Pro plan or 1000+ fluency points). User-created workflows go through an AI quality gate:

  • Score ≥80 auto-approves for the marketplace
  • Lower scores receive specific improvement guidance
  • No admin moderation queue — instant feedback loop

Next Steps