Spec-Driven Development Validator

About

The sdd-validate skill is a comprehensive toolkit designed for developers using Spec-Driven Development (SDD) workflows. It provides deep inspection of JSON specification files, identifying structural errors, orphaned nodes, and complex dependency issues like circular loops or bottlenecks. Beyond mere detection, the skill can automatically repair over a dozen common spec issues, offering an iterative workflow that moves from initial drafting to a production-ready, valid specification. It is an essential utility for maintaining the quality and consistency of project specs before they are used for code generation or task implementation.

Key Features

• Advanced dependency analysis to detect circular references, orphaned tasks, and project bottlenecks.
• 0 GitHub stars
• Automated repair of 13+ common JSON spec structural issues including task rollups and metadata blocks.
• Flexible path resolution that automatically searches for specs in pending, active, or archived directories.
• Comprehensive statistical reporting on spec depth, coverage, complexity, and progress.
• Intelligent exit code system optimized for CI/CD integration and iterative manual refinement.

Use Cases

• Validating a newly created project specification to ensure it meets SDD structural requirements.
• Analyzing task dependencies to identify blocking issues before starting the implementation phase.
• Auto-fixing hierarchy mismatches and task count errors in large, complex specification files.