Menu

1 / 2

Stop trusting your AGENTS.md: the drift-check that makes it a contract

DEV Community: react·Veaceslav·14 days ago
#b5Sm44kR
#devtoreact#devto#dev#rule#agents
Reading 0:00
15s threshold

Back in September I published Stop bloating your AGENTS.md: reference your conventions instead of pasting them — and advice I still stand behind: keep AGENTS.md a thin index, move the details into per-topic docs, reference them from one place. The argument was about context hygiene — your conventions stay detailed, your context stays clean. What that argument never claimed to do was enforcement.

It was a solid argument. It was also half an argument, and the second half bit me within two weeks of real agent work.

Because here's the uncomfortable truth I glossed over: a lean AGENTS.md is still just prose. ESLint enforces boundaries because CI turns red. AGENTS.md enforces itself because... nothing does. The agent reads it, nods, and the next time a task touches an edge case the doc doesn't cover, the doc becomes fiction. It doesn't drift loudly.…

Continue reading — create a free account

Join HashtagPLUS to read full articles, follow hashtags, vote, and join the conversation.