spec-sync

What problem does it solve?

This Skill prevents "spec drift" where code and documentation diverge, leading to confusion, bugs, and outdated knowledge. It ensures that your specifications accurately reflect the current codebase, maintaining consistency and traceability across your project.

Core Features & Use Cases

• Drift Detection: Automatically identifies discrepancies between code changes and specification updates, highlighting new functions not in spec or unimplemented requirements.
• Coverage Analysis: Maps acceptance criteria and edge cases to code and tests, providing clear metrics on what's covered and what's missing.
• Actionable Sync Reports: Generates detailed reports with recommendations to update either the spec or the code to achieve perfect alignment.
• Use Case: After a major refactor, a team uses this Skill to check if their SPEC.md still accurately describes the system. The Skill identifies several new helper functions not documented and an old requirement that was removed from the code but still exists in the spec, guiding the team to update their documentation.

Quick Start

Trigger the skill to synchronize a specification with the codebase

Trigger: sync spec for SPEC-AUTH-001.md