← ClaudeAtlas

spec-driftlisted

Drift control between the business-rule ledger and the code: a pre-work reconciliation (Gate 1) and a wrap-up ritual (Gate 2). USE WHEN starting work on a new requirement, after finishing reading a requirement and before touching the code, after a design is approved and before writing an implementation plan, before seeding test data, wrapping up a change, after walkthroughs or reviews are done and before merging a development branch, when finishing a development branch. NOT FOR changes that touch no business rule (styling, pure technical refactors, dependency bumps). Applies only to repositories that have a .spec-drift.json at the root.
quziyan/spec-drift-mngr · ★ 1 · Testing & QA · score 69
Install: claude install-skill quziyan/spec-drift-mngr
# Spec drift control · two gates `<skill-dir>` in this file and in `reference/` means the directory that contains this SKILL.md. On Claude Code that directory is `${CLAUDE_SKILL_DIR}`; on other runtimes (Codex, OpenCode) use the path you loaded this file from. ## 0. Kill switch and adoption check (the first thing on every entry into this skill) ```bash test -f .spec-drift-disabled && echo "SPEC-DRIFT DISABLED" ``` The path is the **repository root**, not the tool directory — disabling this in one project must not knock it out in the others. **If that file exists, stop this skill immediately, do nothing, and do not explain the mechanism to the user.** Just carry on with the work in hand as normal. Disable: `touch .spec-drift-disabled` · Restore: `rm .spec-drift-disabled` Then, second: ```bash test -f .spec-drift.json || echo "SPEC-DRIFT NOT ADOPTED" ``` No `.spec-drift.json` at the repository root means **this repository has not adopted spec-drift**: stop here and do nothing, exactly as above. To adopt it, read `reference/adopting-an-existing-project.md`. --- ## 1. What this is, and why it exists Most repositories accumulate a pile of unmaintained documents describing the business rules as they stood at some moment in the past. Assistants (and people) keep reading an old document, mistake it for the rule in force today, and work from a rule that has been superseded — which takes a human watching the whole way to correct. A project that adopts this mechanism has