About plan-verify
plan-verify is a development skill for checking a project plan’s tests and acceptance criteria. It runs required gates and produces a report with evidence and follow-up actions.
Key features
- 01Extracts tests and acceptance criteria
- 02Runs repository-specific test gates
- 03Records pass, fail, or blocked status
- 04Reports evidence and next actions
Use cases
- 01Checking completion of planned work items
- 02Finding blockers when tests cannot run
- 03Reviewing acceptance criteria before sign-off
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ xiaolai/ vmark --skill plan-verifyAfter installing, type/plan-verifyin Claude Code to confirm it loaded.
Details
From the project READMEPlan 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
dev-docs/plans/<plan>.md. - If unclear, ask for the plan path.
- Prefer
-
Extract verification checklist
- For each WI, list:
- Acceptance criteria
- Required tests
- Manual checks (if any)
- For each WI, list:
-
Run gates
- Use repo-specific gates from
.claude/commands/feature-workflow.mdor plan “Testing Procedures”. - If tests are not runnable, note the blocker explicitly.
- Use repo-specific gates from
-
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).
Comments
Markdown supported