Plan Verify
Overview
Runs the plan’s required tests/gates and validates acceptance criteria, producing a pass/fail verification report.
Workflow (Verify)
Locate the plan
-
Prefer docs/codex-plans/<plan>.md (local, not in repo).
-
If unclear, ask for the plan path.
Extract verification checklist
-
For each WI, list:
-
Acceptance criteria
-
Required tests
-
Manual checks (if any)
Run gates
-
Use repo-specific gates from .claude/commands/feature-workflow.md or plan “Testing Procedures”.
-
If tests are not runnable, note the blocker explicitly.
Verify acceptance
-
For each WI, mark each acceptance criterion as Pass/Fail/Blocked.
-
Include evidence (test output, file refs, manual steps).
Report results
- Summarize pass/fail with concrete next actions.
Output Format (required)
-
Verification Summary
-
Total WIs verified
-
Pass/Fail/Blocked counts
-
Gate Results
-
Command → status
-
Failures with key error lines
-
Acceptance Matrix
-
WI‑### → criterion → Pass/Fail/Blocked
-
Manual Checks
-
Steps executed + outcome
Verification Rules
-
Always run tests unless the user explicitly forbids it.
-
If tests are skipped or fail, mark WI as Blocked.
-
Do not claim “verified” without test evidence.
-
Manual checks must include evidence (step list + observed result).