verify-subtask

Imported from yuchdev/AwesomeTemplates (templates/cpp/.claude/skills/verify-subtask/SKILL.md). Install upstream with npx skills add yuchdev/AwesomeTemplates --skill verify-subtask. Copyright stays with the author.

Verify Subtask (spec-compliance check)

Check that the implementation of a subtask matches its specification document.

Steps

1. Resolve the spec path from $ARGUMENTS.

   • If the argument ends with .md, use it as-is relative to repo root.
   • Otherwise, expand to docs/roadmap/$ARGUMENTS.md.
   • If the file does not exist, error: "Spec not found: . Pass the path relative to docs/roadmap/ without the .md extension, e.g. 0001-working-implementation/01.0-hello-world-endpoint/01-config-model."

2. Gather the diff scope. Run git diff --name-only HEAD to get changed files. If the working tree is clean (no staged or unstaged changes), try git diff --name-only HEAD~1 to capture the most recent commit.

3. Spawn subtask-verifier with:

   • The resolved spec path
   • The diff (changed file list + git diff HEAD or git diff HEAD~1 output) Ask it to produce a full compliance matrix and verdict.

4. Return the agent's compliance report verbatim.

   • PASS → confirm to the caller that review/testing can proceed.
   • PARTIAL → list deviations; recommend fixing before merge but do not block.
   • FAIL → list blocking gaps; instruct caller to return to cpp-expert with the list.

Output

The verbatim compliance matrix from subtask-verifier, plus one line:

→ Next step: [proceed to /test-gap | fix gaps then re-run /verify-subtask | proceed with caution]

Completion checklist

• Spec file found and readable
• Diff scope captured (changed files list non-empty or commit diff used)
• subtask-verifier returned a verdict (not null / timed out)
• On FAIL: blocking gaps listed and next step is "return to cpp-expert"
• On PARTIAL: deviations listed and next step is "fix before merge"
• On PASS: confirmation that /test-gap and /pr-review can proceed