Design Spec Auditor

Design Spec Auditor compares your code against design documentation to identify architectural, interface, and behavioral misalignments. It generates a compliance report categorizing discrepancies by severity with remediation guidance, helping you catch drift early during development and code reviews.

The Skill identifies architectural deviations, interface mismatches, and behavioral gaps between design docs and actual code. Issues are classified as Critical, Major, or Minor with actionable recommendations, enabling you to prioritize fixes and prevent technical debt.

Run audits after implementing new features, during code reviews, and before refactoring. This prevents architectural drift by catching implementation deviations early, ensuring your code stays aligned with documented patterns, error handling requirements, and performance specs.

Yes. The Skill compares any codebase against its design documentation regardless of age. It works during refactoring efforts to surface where legacy implementations deviate from intended architecture, helping you plan modernization and technical debt remediation.

You receive a compliance report listing discrepancies by severity category, detailed categorization of each issue type, and specific remediation guidance. This enables prioritized fixes and helps teams align implementation with architectural intent.

The Skill reads design documentation and parses corresponding code to generate reports. It handles systematic compliance checking across planned and implemented designs, making it applicable to various documentation and codebase structures.