Review implementation fidelity against specifications by comparing actual code to spec requirements. Identifies deviations, assesses impact, and generates compliance reports for tasks, phases, or entire specs.
The `sdd-fidelity-review` skill is designed to verify the alignment of software implementations with specified requirements in the context of Spec-Driven Development (SDD). By comparing actual code with the outlined specifications, this skill identifies deviations, assesses their impact, and generates detailed compliance reports to ensure that the development process adheres to predefined standards. This helps teams to maintain high-quality code and avoid issues arising from misaligned implementations, ensuring a smooth development lifecycle and reducing the risk of rework or specification discrepancies.
This skill provides several key features, including phase and task reviews, which allow users to focus on specific parts of the development process. Phase reviews target specific phases within a specification, offering reports on a per-task basis. Task reviews are useful for validating critical tasks or complex implementations, providing detailed compliance checks. The skill also emphasizes the importance of accurate specification reading and warns against using inappropriate methods for spec file access. This focus ensures that context is maintained while reviewing specifications. It is intended for development teams and quality assurance personnel focused on verifying code compliance with specifications before progressing to the next phases of development or deployment.
You can use the skill to compare your implementation against the SDD specifications by running phase or task reviews. The skill generates compliance reports that help identify deviations and assess their impact.
No, this skill is not designed for creating specifications. You should use the `sdd-plan` skill for that purpose.
Always use the `sdd-fidelity-review` CLI tool for reading specifications. Avoid using tools like `Read()`, `jq`, or Bash commands to access spec files directly.
While the skill is versatile, it is particularly useful for reviewing critical or complex tasks like authentication, data handling, or API contract compliance.
Yes, the skill may require up to 5 minutes for some operations, so be patient. It's also important not to use background execution for long-running tasks to avoid spam output and degraded performance.
Quick Setup:
.claude/skills/Repository
tylerburleigh/claude-sdd-toolkit