Your Agent Configs Are Internal Docs. Manage Them That Way.
· 10 min read
A few months into working with AI agents on a documentation project, I'd noticed some inconsistency in agent behaviors and decided to do some digging. Turns out the AGENTS.md file in our repo — the one telling agents how to behave, where things were, and what to escalate — had grown to over 800 lines, and a few people (or likely their agents) had added rules independently, some subtly contradicting each other.
The agents weren't broken. They were following instructions that didn't serve them well.