/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/prose.md] [--mode NEW|OVERHAUL] [--seriousness LEVEL] [--context CONTEXT] [--mission MISSION] [--domain DOMAIN] [--dry-run]

Inputs

The authored _spec/spec.md + _inputs/handoff-manifest.yml from /plan-spec (or operator-supplied prose).

Outputs

PREAMBLE.md, MASTER-PLAN.md, PROGRESS.md, PLAN-NOTES.md, and per-phase phases/**/PHASE.md files, plus the augmented _inputs/handoff-manifest.yml.

Downstream

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

Workflow phases

The command generates a complete Master Plan Suite from the authored spec:

1. Ingest requirements — Read _spec/spec.md and the upstream Handoff Manifest; refuse with Blocked: run /plan-spec first when the spec is absent.
2. Discover — Run seriousness-scaled discovery with the Five Cognitive Filters; resolve every authoritative-data gap through the structured-inquiry channel.
3. Decompose — Break the work into an acyclic phase graph with an explicit dependency order.
4. Emit the suite — Author PREAMBLE.md, MASTER-PLAN.md, PROGRESS.md, PLAN-NOTES.md, and every phases/NN-topic/PHASE.md.
5. Run the pre-emission gate — Run the fifteen-bar sweep against every emitted artifact; failure blocks user-approval until resolved.

Failure modes

Examples

# Dry-run to preview the generated phase graph
/plan-generate --dry-run

# Generate a suite from authored prose
/plan-generate path/to/prose.md --mode NEW

Cross-references

• Pipeline overview
• Command reference