sync-spec
Installation
SKILL.md
Sync a Spec
Realign one feature's spec triad (docs/specs/<date>-<feature>/{requirements,design,tasks}.md) with what is actually true — in the code, the tests, and the tasks. Specs that are not resynced after change become fiction, and fiction is worse than no spec.
Work one feature at a time. Identify the spec directory first (from the user, the current branch, or docs/specs/INDEX.md).
Iron rules
- Never renumber requirement IDs. IDs are immutable once approved; everything downstream cites them.
- Never delete a requirement. Retire it:
~~**CODE-N.M**~~ <reason>— struck-through IDs stop counting as defined, but the history stays legible. - New requirements get the next free number under their story; new tasks match the existing task format exactly.
Steps
a. Baseline. Run the trace check (REQUIRED SUB-SKILL: use trace) and capture the finding set — this is the "before" picture.
b. Requirements ↔ tasks. Compare requirements.md against tasks.md: