Skip to content

/plan-generate

Role: Generator Pipeline position: mid

Generates a complete Master Plan Suite from the authored _spec/spec.md.

Canonical invocation

/plan-generate

With arguments:

/plan-generate [path/to/plan-suite/] [phase-id] [--dry-run]

Inputs

_spec/spec.md + _inputs/handoff-manifest.yml from /plan-spec

Outputs

PREAMBLE.md, MASTER-PLAN.md, PROGRESS.md, PLAN-NOTES.md, phases/*/.md

Downstream

/plan-review or /plan-execute (downstream)

Workflow phases

The command follows the standard /plan-* pipeline workflow:

  1. Load context — Read plan suite, rules, and Resumption Contract.
  2. Verify prerequisites — Confirm dependency phases complete.
  3. Execute tasks — Perform the command mission.
  4. Verify outputs — Confirm all declared outputs exist and pass quality gates.
  5. Update PROGRESS.md — Record verified outputs in the Phase Output Registry.
  6. Emit REPORT.md — Pre-emission gate attestation recorded.

Failure modes

Symptom Cause Recovery
Prerequisite incomplete Dependent phase not finished Complete upstream phase first
Quality gate FAIL Output does not meet standards Fix the output and re-run
Missing input file Plan suite file absent Run /plan-generate to create it

Examples

# Dry-run to preview what would happen
/plan-generate --dry-run

# Execute against a named plan suite
/plan-generate path/to/plan-suite/

Cross-references