Overview
Simple Flow uses a single agent (/specsmd-agent) that guides you through all three phases: Requirements, Design, and Tasks.
Invoking the Agent
- Claude Code
- Cursor
- GitHub Copilot
Agent Capabilities
The Simple Flow agent handles:Spec Creation
Generate requirements, design, and task documents from a feature idea
Phase Navigation
Move through Requirements → Design → Tasks with explicit approval gates
Task Execution
Execute implementation tasks one at a time with review
Context Loading
Resume work on existing specs by reading saved documents
Commands
Workflow
1. Create a Spec
- Derives a feature name (
user-dashboard) - Generates
requirements.md - Waits for approval
2. Approve or Revise
To approve: Say “yes”, “approved”, or “looks good” To revise: Provide specific feedback like “Add a requirement for export functionality”3. Progress Through Phases
After approving requirements:- Agent generates
design.md - Wait for approval
- Agent generates
tasks.md - Wait for approval
4. Execute Tasks
Agent Session Lifecycle
1
Context Loading
Agent reads existing spec files from
specs/{feature-name}/2
Phase Detection
Agent determines current phase based on which files exist and their status
3
Generation or Execution
Agent generates the next document or executes the next task
4
Approval Gate
Agent waits for explicit approval before proceeding
Best Practices
Be specific with feature ideas
Be specific with feature ideas
Good: “User auth with email/password and session management”Too vague: “Login feature”The more specific you are, the better the generated specs.
Review each phase carefully
Review each phase carefully
Don’t rush through approvals. The design phase influences task generation, and tasks influence implementation quality.
One task at a time (default)
One task at a time (default)
The agent pauses after each task for review. If you’re confident, say “continue until done” or “go yolo”.
Use checkpoints
Use checkpoints
Checkpoint tasks run the test suite. Don’t skip them—they catch issues early.