How does the skill handle ambiguous requirement language?

It flags 'red flag' words like 'fast', 'should', or 'appropriately' and provides specific suggestions to make those requirements concrete and verifiable.

Can this skill enforce project-specific architectural standards?

Yes, if a 'constitution.md' file exists in your project, the skill will automatically validate the specification against your team's specific principles and patterns.

What kind of report does the review process generate?

It produces a structured Markdown report with a sound/needs work status, numerical scores for each dimension, and a prioritized list of critical, important, and optional fixes.

What is the main benefit of using the review-spec skill?

It prevents 'spec drift' and costly rework by ensuring requirements are clear, measurable, and technically feasible before any implementation begins.

What criteria does the skill use to evaluate a specification?

The skill evaluates specifications across four primary dimensions: Completeness (required sections), Clarity (language quality), Implementability (technical feasibility), and Testability (measurable outcomes).

SDD Specification Reviewer

Name: SDD Specification Reviewer
Author: rhuss

byrhuss

•

セキュリティとテスト

Validates technical specifications for completeness, clarity, and implementability to ensure a smooth development process.

概要

The SDD Specification Reviewer is a specialized tool for Claude Code designed to enforce high standards in Specification-Driven Development. It systematically audits feature specifications against critical quality dimensions including structural completeness, linguistic clarity, and practical implementability. By identifying ambiguous language and missing edge cases before implementation begins, it helps developers minimize rework, catch dependencies early, and maintain perfect alignment between requirements and code.

主な機能

Automated structural validation for mandatory specification sections
Comprehensive assessment of technical implementability and scope
Detailed review report generation with prioritized recommendations
Detection of ambiguous 'red flag' terminology and subjective requirements
1 GitHub stars
Testability verification for success and acceptance criteria

ユースケース

Auditing new feature specifications before generating an implementation plan
Ensuring architectural consistency by checking specs against a project constitution
Identifying gaps in error handling and edge case definitions in existing docs

概要

主な機能

Automated structural validation for mandatory specification sections
Comprehensive assessment of technical implementability and scope
Detailed review report generation with prioritized recommendations
Detection of ambiguous 'red flag' terminology and subjective requirements
1 GitHub stars
Testability verification for success and acceptance criteria

ユースケース

Auditing new feature specifications before generating an implementation plan
Ensuring architectural consistency by checking specs against a project constitution
Identifying gaps in error handling and edge case definitions in existing docs