Examples
Plan walkthrough
End-to-end walkthrough of the /plan pipeline for a real task.
This example walks through the full /plan pipeline for a simple task:
adding a new CLI subcommand to Apothem.
Step 1: Write prose requirements
Create prose.md:
Add a `apothem status` subcommand that prints the current apothem
version, installed harnesses, and the result of `apothem verify`.
The output should be machine-parseable (JSON with --json flag) and
human-readable by default.Step 2: Refine to spec
/plan-spec prose.md --suite-name apothem-status-commandThis runs the six-phase Forge, asking clarifying questions and producing
plans/apothem-status-command/_spec/spec.md.
Step 3: Generate the plan
/plan-generateProduces PREAMBLE.md, MASTER-PLAN.md, PROGRESS.md, PLAN-NOTES.md, and
per-phase PHASE.md files under plans/apothem-status-command/phases/.
Step 4: Review the plan
/plan-reviewForensic audit with prose-fidelity, consistency, and quality scores. Fix any FAIL findings before proceeding.
Step 5: Execute phases
/plan-execute # executes the first phase, then pauses
/plan-execute # executes the next phase, then pauses
...Step 6: Check progress
/plan-statusReports current phase, verified outputs, and next action.