speckit-superb-verify
Mandatory completion gate. Loads the obra/superpowers verification skill at runtime and extends it with spec-kit's spec-coverage checklist. No task may be marked done without fresh evidence.
SKILL.md.claude/skills/speckit-superb-verify/SKILL.md
GitHubVerification Before Completion — After Implementation
Skill origin: obra/superpowers
verification-before-completionInvocation: Mandatory post-hook forspeckit.implement. Cannot be skipped.
Step 1 — Load the Authoritative Verification Skill
Any user context provided:
$ARGUMENTS
Locate and internalize the superpowers verification skill using this priority chain:
- Local plugin: Read
skills/verification-before-completion/SKILL.mdfrom the workspace root (present when superpowers is installed as a plugin). - Remote fetch: If the local file does not exist, fetch from
https://raw.githubusercontent.com/obra/superpowers/main/skills/verification-before-completion/SKILL.md - Embedded fallback: If both fail, apply this minimal contract:
NO COMPLETION CLAIM WITHOUT FRESH VERIFICATION EVIDENCE.
- IDENTIFY which command proves the claim.
- RUN the full command (fresh, not cached).
- READ the output in full — check exit code, count failures.
- VERIFY the output confirms the claim. If not, state actual status.
- ONLY THEN make the completion claim.
You must internalize the full SKILL.md content before proceeding. Its rules are non-negotiable for every completion claim.
Step 2 — Execute the Verification Skill
Apply the loaded skill against the current implementation state:
- Run the project's full test suite (not a subset) and paste the output.
- Run any applicable build / lint / type-check commands and paste the output.
- Follow the skill's evidence requirements exactly — "should pass" or "I'm confident" are never acceptable substitutes for fresh output.
Step 3 — Spec-Kit Extension: Spec-Coverage Checklist
After the verification skill's checks pass, perform this additional spec-kit gate:
- Re-read
spec.mdin full. - For each requirement or user story, verify the implementation satisfies the acceptance criteria and map it to a passing test:
## Spec Verification Checklist
- [x] R01: [requirement] — verified by [test file]::[test name]
- [x] R02: [requirement] — verified by [test file]::[test name]
- [ ] R03: [requirement] — NOT VERIFIED ([reason])
- If any
spec.mdrequirement is unchecked:
⚠ INCOMPLETE: [N] spec requirements are not verified.
Cannot declare implementation complete.
Unmet requirements: [list them]
Do not proceed past this point if any requirement is uncovered.
Step 4 — Completion Report
When all checks pass, output:
## Implementation Complete — Verification Evidence
**Test suite:** [N] tests, [N] passing, 0 failing
**Spec coverage:** [N/N] requirements verified (see checklist above)
**Build:** [PASS / N/A]
**Lint:** [PASS / N/A]
All spec requirements are met. Implementation is verified complete.
Suggested next steps:
- Run `speckit.superb.critique` for code review against spec
- Or proceed to PR creation
If anything is unverified:
## Implementation Status — INCOMPLETE
**Test suite:** [status]
**Spec coverage:** [N/M] requirements verified, [M-N] unverified
**Unverified requirements:** [list]
Implementation cannot be declared complete until all items above are resolved.