What problem does it solve?
This Skill addresses the lack of traceability in legacy codebases by retroactively applying spec tags to methods, ensuring that existing code is correctly mapped to requirements without requiring logic changes or refactors.
Core Features & Use Cases
- Ghost Change Creation: Automatically generates a synthetic change artifact to serve as a stable reference point for spec tags.
- Automated Annotation: Safely applies @spec tags to file and method docblocks across large codebases while respecting existing formatting.
- Use Case: When a project adopts a new specification-driven development process, use this Skill to map thousands of legacy methods to their corresponding requirements in a single, clean, annotation-only PR.
Quick Start
Use the opsx-annotate skill to apply spec tags to the procest application based on the latest coverage report.