spec-driven-sweep

Reviews a domain's spec-to-code binding through five ordered verification passes.

1|Updated Jan 14, 2024
One-click install
npx skills add https://github.com/Eyhenij/rt-tools --skill spec-driven-sweep-eyhenij
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-sweep
Source: https://github.com/Eyhenij/rt-tools/tree/main/.claude/skills/spec-driven-sweep
Command: npx skills add https://github.com/Eyhenij/rt-tools --skill spec-driven-sweep-eyhenij

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project documentation drifts from the code it describes: dead file references, symbols that exist only in comments, and promises in specs that the code never fulfills. This Skill provides a structured, five-pass review procedure that audits an entire domain's binding between specification statements and the code they point to. ## Core Features & Use Cases - Five ordered passes: three machine-executed checks (dead addresses, comment-only anchors, symbols not declared in the named file) followed by two manual reading passes (promise-versus-code verification, and lookup of numbers, refusal codes, and glossary keys). - Hit triage discipline: treats each pass's output as a reading queue rather than a defect list, recording both the raw hit count and the confirmed divergence count. - Layer-aware expectations: recognizes that false-positive rates differ between procedural layers and component/service layers, so only the pass order carries over between domains. - Use Case: After a large refactor moves code out of a documented domain, run the sweep to find every spec statement whose referenced file or symbol no longer exists, then read the flagged lines to confirm real divergences. ## Quick Start Run the spec-driven sweep over the authentication domain to audit every spec statement against the code it references.

Frequently Asked Questions about spec-driven-sweep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify that project documentation matches the actual code?

Run a five-pass sweep over the domain: first three passes mechanically detect dead file references, comment-only anchors, and symbols not declared in the named file; the last two passes manually read the flagged lines to confirm whether the code fulfills each documented promise.

What is a spec-driven sweep in documentation review?

It is a full audit of one domain's binding between specification statements and code. Every statement is checked against the code it points to, in a fixed pass order, with both raw hits and confirmed divergences recorded as results.

Why does a green binding check not guarantee correct documentation?

A binding check only confirms that every statement has a matching line somewhere, including comments. It says nothing about whether that line actually implements the documented behavior, which is why manual reading passes are required.

When should I not use the spec-driven sweep pattern?

Do not use it to create a new domain spec; that belongs to the spec-driven-domain pattern. The sweep is only for reviewing an existing domain's binding as a whole, not for checks done incidentally during other work.

Why do false-positive rates differ between review passes?

Hit legitimacy depends on the layer: procedural rules usually have one public implementation point, so hits are often real divergences, while component or service rules legitimately live in private fields or methods, producing mostly false hits.