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.

Installs
37
GitHub Stars
1
First Seen
Nov 3, 2026