spec-check

Compares DESIGN/*.md specifications with implementation code to surface Missing, Diverged, Extra, and Constraint issues.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/nok0321/claude-pipeline --skill spec-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-check
Source: https://github.com/nok0321/claude-pipeline/tree/main/skills/spec-check
Command: npx skills add https://github.com/nok0321/claude-pipeline --skill spec-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill compares DESIGN/*.md specifications with actual implementation to surface Missing, Diverged, Extra, and Constraint issues across a codebase.

Core Features & Use Cases

  • Automates cross-checks between design docs and code to surface gaps and inconsistencies.
  • Generates a structured report to guide PR reviews and design updates.
  • Use Case: When vetting a new feature, run the check to ensure implemented interfaces align with DESIGN docs before merging.

Quick Start

Run the spec-check tool for a target component to generate a findings report comparing DESIGN docs to the implementation.

Frequently Asked Questions about spec-check

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

FAQPage Schema
How do I check if my code matches design specifications?

To check if code matches design specifications, compare DESIGN/*.md files with implementation directories to surface Missing, Diverged, Extra, and Constraint issues. This generates a structured report highlighting gaps to guide fixes during PR reviews.

What is design-implementation alignment checking?

Design-implementation alignment checking is the process of comparing DESIGN docs against actual implementation code to surface cross-document inconsistencies. It identifies Missing, Diverged, Extra, and Constraint issues to ensure implemented interfaces align with design specifications.

How do I automate spec compliance checks for PR reviews?

Automate spec compliance checks for PR reviews by running a diff analysis between DESIGN/*.md specifications and implementation directories. This produces a structured findings report that highlights gaps and guides fixes before merging new features.

Can I use diff analysis to find missing features in my implementation?

Yes, you can use diff analysis to find missing features by comparing DESIGN docs with implementation code. The analysis specifically surfaces Missing issues where specified features or interfaces are not implemented, guiding necessary code additions.

What is the best way to surface cross-document inconsistencies between design docs and code?

The best way to surface cross-document inconsistencies between design docs and code is to apply automated spec-implementation alignment checks to DESIGN/*.md files and corresponding implementation directories, which produces a structured report of gaps and divergences.

Does spec compliance checking work without external dependencies?

Yes, spec compliance checking works without external dependencies. The analysis operates directly on DESIGN/*.md specifications and implementation directories to generate findings reports, requiring no additional components or libraries to function.