sdd-validate

What problem does it solve?

This Skill ensures the structural integrity and consistency of your Spec-Driven Development (SDD) JSON specification files, preventing errors and inconsistencies that could derail implementation. It automates the detection and fixing of common issues, saving manual debugging time and ensuring reliable specs.

Core Features & Use Cases

• Comprehensive Validation: Checks hierarchy, task counts, metadata, and dependency graph validity.
• Auto-Fix Capabilities: Automatically corrects 13 common issue types with preview and backup options, ensuring spec health.
• Detailed Reporting: Generates comprehensive Markdown or JSON reports with categorized issues, statistics, and dependency analysis.
• Use Case: After creating or modifying a complex JSON spec, run this skill to automatically fix incorrect task counts, resolve hierarchy mismatches, and detect circular dependencies, ensuring your spec is robust and ready for implementation.

Quick Start

Validate a spec file and get a summary

sdd validate specs/active/my-spec.json

Preview auto-fixable issues without applying changes

sdd fix specs/active/my-spec.json --preview

Apply auto-fixes to the spec file (creates a backup by default)

sdd fix specs/active/my-spec.json

Generate a detailed validation report in Markdown

sdd report specs/active/my-spec.json --format markdown --output -