spec-cleanup
Installation
SKILL.md
Spec Cleanup
Spec directories accumulate history: a feature gets specced, then re-specced with a better approach, and the old spec lingers. Those leftovers cost mindshare — every overview scan, every "which spec is current?" question pays for them. This skill finds superseded specs and resolves them in one of two ways:
- Fully replaced — a newer spec covers everything the old one did. The old spec should be removed.
- Extended — a newer spec builds on a still-valid base, adding features. Both hold unique information, so a human must decide: consolidate into one spec, or remove one.
The skill is deliberately conservative. It deletes nothing without explicit approval, and when classification is ambiguous it errs toward "extended" because that routes the call to the user instead of the trash.
Prerequisites
- A
specs/directory in the project root with at least two spec subdirectories.