ai-plan

# Plan ## Quick start ``` /ai-plan # plan from approved spec /ai-plan --pipeline=hotfix # override classification /ai-plan --skip-design # skip design routing ``` ## Workflow Takes an approved spec and produces a phased execution plan — bite-sized tasks, agent assignments, gate criteria. The plan is the contract `/ai-build` executes. **HARD GATE**: operator must approve before `/ai-build` runs (§10.6 SDD). 1. **Approval gate (HARD STOP, no escape hatch)** — BEFORE reading the spec for decomposition, resolve the active spec's CANONICAL lifecycle state. Read `<spec_id>` from `.ai-engineering/specs/spec.md` frontmatter `spec:` (fallback `slug:`), then run `python .ai-engineering/scripts/spec_lifecycle.py status <spec_id>` to read the sidecar `state`. - **Sidecar resolves to a known state ≠ `approved`** → HARD STOP. Write NO `plan.md`. Emit exactly: ``` Error: spec-<id> is in '<state>' state. Complete /ai-brainstorm approval before running /ai-plan. ``` - **No sidecar exists** → fall back to `spec.md` frontmatter `status:`; block (same HARD STOP) unless `status: approved`. - **Neither sidecar NOR frontmatter `status:` resolves** → this is indeterminate plumbing only (D-161-03): emit a LOUD warning and proceed (fail-open). - Vocab: sidecar `approved` ⇔ frontmatter `status: approved`. There is NO `--force` / escape hatch — the ONLY bypass is approving the spec via `/ai-brainstorm`. 2. **Read spec*...