/plan-design¶
Role: Architect Pipeline position: pre-generate
Produces a comprehensive architectural-design artifact at _inputs/design.md.
Canonical invocation¶
/plan-design
With arguments:
/plan-design [path/to/plan-suite/] [phase-id] [--dry-run]
Inputs¶
Project context + _spec/spec.md (optional)
Outputs¶
_inputs/design.md — consumed by /architecture-review
Downstream¶
/plan-generate or /architecture-review (downstream)
Workflow phases¶
The command follows the standard /plan-* pipeline workflow:
- Load context — Read plan suite, rules, and Resumption Contract.
- Verify prerequisites — Confirm dependency phases complete.
- Execute tasks — Perform the command mission.
- Verify outputs — Confirm all declared outputs exist and pass quality gates.
- Update PROGRESS.md — Record verified outputs in the Phase Output Registry.
- 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-design --dry-run
# Execute against a named plan suite
/plan-design path/to/plan-suite/