Incremental Validator

Read-only. Do NOT create/modify files or run shell scripts. For every FAIL, include Fix: with specific field/line/value. Report line numbers where possible.

Routing

`$ARGUMENTS`	Check
(empty)	ALL: sections 1-6 + existence of decisions.md, assumptions.md, risk-register.md
`runbook`	Section 1
`work-breakdown`	Section 2
`traceability`	Section 3
`dependencies`	Section 4
`areas`	Section 5
`stories`	Section 6 (all stories + cross-story dep checks)
`US-XXX`	Section 7 (single story)
other	Print usage, stop

Output Format

code

[PASS] <artifact>: <check>
[FAIL] <artifact>:<line>: <issue>
       Fix: <specific fix>
---
Validation summary: X passed, Y failed

Checks

1. Runbook (`.plan/runbook.md`)

•Exists
•No TODO/TBD/FIXME (case-insensitive \b(TODO|TBD|FIXME)\b, report each with line)
•At least one fenced code block (``` pattern)

2. Work Breakdown (`.plan/work-breakdown.md`)

•Exists
•No TODO/TBD/FIXME
•At least one REQ-[0-9]{3} ID
•No REQ-XXX template placeholders

3. Traceability (`.plan/traceability.md`)

•Exists
•At least one REQ-[0-9]{3} ID
•No REQ-XXX placeholders
•Cross-reference: every REQ in work-breakdown.md appears in traceability.md

4. Dependencies (`.plan/dependencies.md`)

•Exists
•No TODO/TBD/FIXME
•Contains "critical path" (case-insensitive)
•Critical path section has actual content (not just placeholder text)

5. Areas (`.plan/areas.md`)

•Exists
•Table not empty
•No unapproved areas (draft|probing|in_review in table → FAIL per area with name + status)

6. Stories — All (`prd/US-*.json`)

•At least one story exists
•Run section 7 for each
•Cross-story: each dependency ID has a corresponding file; no circular deps (A depends on B and B depends on A)

7. Single Story (`prd/US-XXX.json`)

•File exists
•Valid JSON (jq empty)
•riskTier: low|medium|high
•sizing: small|medium|large
•autonomy: auto_deploy|gated_deploy
•requirements: array, every element matches ^REQ-[0-9]{3}$
•deploySafety: object with strategy (string), healthChecks (array), rollbackTrigger (string), rollbackCommand (string), verification (array) — report each missing subfield separately
•status.validation: must be object
•Deploy contract (only if .stage == deploy): all deploySafety strings non-empty, arrays non-empty, no TODO/TBD/FIXME/placeholder text

If file missing → report and skip content checks. On all pass: [PASS] <ID>: Schema and deploy contract valid

Incremental Validator

Routing

Output Format

Checks

1. Runbook (.plan/runbook.md)

2. Work Breakdown (.plan/work-breakdown.md)

3. Traceability (.plan/traceability.md)

4. Dependencies (.plan/dependencies.md)

5. Areas (.plan/areas.md)

6. Stories — All (prd/US-*.json)

7. Single Story (prd/US-XXX.json)