Skip to content
Cadence

/c-plan

Source of truth: skills/c-plan/SKILL.md. For the why behind this stage, read the Plan deep dive.

Purpose

Section titled “Purpose”

Translates an approved design into an AI-readable plan folder (exact file paths, exact code, exact commands, and no narrative) so the work can be executed step by step.

When to use it

Section titled “When to use it”

Use /c-plan once a design is approved and you want a precise, executable blueprint before building. It is the third stage, between design and execute. Don’t use it to write code or to run anything: it only writes the plan.

Invocation forms

Section titled “Invocation forms”
  • /c-plan: reads the approved design with the matching slug and writes the plan folder.

One design always becomes exactly one plan; large work is split into phase docs inside that single plan, not into sibling plans. After reading the design, it confirms the phase decomposition with you.

Inputs & preconditions

Section titled “Inputs & preconditions”

A design whose 00-overview.md has status: approved. It refuses if the design is still draft or in-review (finish and approve it first), or if a plan folder with the same slug already exists at a non-draft status (it won’t overwrite).

What it produces

Section titled “What it produces”

A plan folder at <paths.plans>/{yyyy-mm-dd-slug}/: a 00-overview.md (goal, architecture, design link, plan index, file map), one or more execution-ordered phase docs (01-…, 02-…) with fully-specified tasks, a 96-validation.md, shell 97/98 docs pointing back to the design, and a 99-out-of-scope.md. It also writes linked_design: onto the new plan and linked_plan: (singular) onto the design.

Gates & guarantees

Section titled “Gates & guarantees”
  • Every file path, line range, symbol, and import the plan cites is ground-truthed against the real code before it lands.
  • Every task carries Reads:, Touches:, and Depends: fields and ends with a commit step; banned placeholder phrases (TBD, TODO, “handle edge cases”, “similar to Task N”) are blocked in self-review.
  • It never writes code, never runs anything, and never auto-executes; /c-execute is invoked separately.
Section titled “Related commands”
  • Previous: /c-design produced the design this plan is built from.
  • Next: /c-execute drives this plan to implemented code.
  • Deep dive: The Plan stage for why a separate code-exact plan exists and the linkage mechanism.