spec-to-code-compliance

Checks code against specification documents and reports requirement-level divergences with verdicts.

1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/stefaniuk/loadout --skill spec-to-code-compliance-stefaniuk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-to-code-compliance
Source: https://github.com/stefaniuk/loadout/tree/main/.github/skills/spec-to-code-compliance
Command: npx skills add https://github.com/stefaniuk/loadout --skill spec-to-code-compliance-stefaniuk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code and the documents that specify it drift apart, and finding where requires reading every requirement against every enforcement path — work that exceeds a single context window and produces unreliable verdicts when rushed. This Skill fans the check out so each requirement gets its own evidence-backed verdict. ## Core Features & Use Cases - Per-requirement verdicts: Each requirement is classified as implemented, partial, contradicted, stronger-than-spec, absent, or undecidable, with cited code lines and recorded searches. - Independent refutation: Divergences are sent to agents that did not produce them, so findings survive adversarial re-reading of both code and document before being reported. - Reverse-direction coverage: The report also surfaces behavior the code has that no document mentions, which a document-driven pass cannot find by construction. - Use Case: Point it at a Solidity codebase and its whitepaper to learn which stated guarantees hold, which fail on untested paths, and which constraints exist only in the code. ## Quick Start Run the spec-compliance workflow on your code directory against your specification document, for example by asking to check ./contracts against SPEC.md.

Frequently Asked Questions about spec-to-code-compliance

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

FAQPage Schema
How do I check code against a specification document?▼

Run the spec-compliance workflow with a path to the code and the specification file. It splits the document into checkable requirements, assigns each its own agent, and writes a report with one verdict per requirement.

What verdicts does a spec-to-code compliance check produce?▼

Each requirement receives one of six verdicts: implemented, partial, contradicted, stronger-than-spec, absent, or undecidable. The report also lists behavior the code has that no document mentions.

Can I check code against an RFC or standard instead of a project document?▼

Yes. The domain notes cover RFCs, FIPS, and IEEE standards, including scoping large documents by section and weighing MUST versus SHOULD requirements differently when assigning findings.

When should I not use a spec-to-code compliance check?▼

Do not use it when no documentation of intended behavior exists, since there is nothing to check against. It also does not find general bugs that both the code and the document are silent about.

Why run each requirement in its own agent instead of one pass?▼

Judging one requirement means reading its enforcement, callees, and callers, which exceeds a single context window across many requirements. Per-requirement agents also enable independent refutation of each divergence before it is reported.