What is 'spec drift' and why does it matter?

Spec drift happens when the code and the documentation diverge. This skill catches instances where the spec was updated but the code wasn't (or vice-versa), ensuring your project remains maintainable.

Does this work with my existing testing framework?

Yes, it is framework-agnostic and can be configured to run npm test, pytest, go test, or any other command-line testing utility.

Can I skip the verification gate if I'm in a hurry?

The skill is designed to enforce discipline. While you can manually override, its primary purpose is to prevent the common pitfall of claiming a task is 'done' when it is only partially implemented.

How does this differ from standard test running?

While standard verification only checks if tests pass, this skill explicitly compares your code against your feature specifications to ensure every requirement was actually implemented as designed.

Spec-Aware Verification Gate

Name: Spec-Aware Verification Gate
Author: rhuss

byrhuss

•

Security & Testing

Enforces rigorous quality standards by validating implementation against both test suites and functional specifications before project completion.

The Verification Before Completion skill is a critical component of Specification-Driven Development (SDD) that transforms Claude into a disciplined quality gatekeeper. It goes beyond simple test execution by explicitly mapping code output back to original project specifications, identifying 'spec drift,' and ensuring every functional requirement and success criterion has been met. By blocking completion on failures and generating structured verification reports, it prevents incomplete features or untested edge cases from reaching production.

Key Features

01Detection of 'spec drift' between current code and design documents

02Detailed Go/No-Go reporting with prioritized blocking issues

03Automated execution and analysis of multi-language test suites

04Strict quality gates that prevent task completion until 100% compliance is met

051 GitHub stars

06Line-by-line requirement validation against markdown specifications

Use Cases

01Auditing code changes for compliance before committing to high-stakes repositories

02Maintaining synchronization between project documentation and actual implementation

03Ensuring AI-generated features perfectly match complex business logic requirements

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rhuss/cc-superpowers-sdd verification-before-completion

For use in Claude.ai and ChatGPT

Download Skill