/plan-review¶
Role: Auditor Pipeline position: mid
Forensic audit of an existing plan suite — prose fidelity, consistency, quality.
Canonical invocation¶
/plan-review
With arguments:
/plan-review [path/to/plan-suite/] [phase-id] [--dry-run]
Inputs¶
Generated plan suite + _inputs/handoff-manifest.yml
Outputs¶
Review scorecards in PLAN-NOTES.md + updated _inputs/handoff-manifest.yml
Downstream¶
/plan-execute (downstream consumer)
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-review --dry-run
# Execute against a named plan suite
/plan-review path/to/plan-suite/