prevent-drift
Installation
SKILL.md
Single source of truth
Every fact has exactly one owner. Everywhere else names the owner instead of restating it.
Duplication is not a style problem. Two copies of a fact are two facts as soon as one is edited, and nothing reports the split - the reader trusts whichever copy they happened to open.
Who owns what
| Owner | Holds | Why it wins |
|---|---|---|
| What executes - config files, scripts, hooks, manifests, CI | The values | True by construction: it is what actually runs |
| The skill or procedure doc | How to do the thing | It is what an agent follows at the moment of acting |
| The prose doc, page or ADR | Why the decision was made | Reasons have no other home |
| Always-loaded instructions (CLAUDE.md) | Only what must be known before acting | Everything else costs context on every turn |
A doc that restates a config value is a copy. A doc that names the config file is a reference.