The one-liner about not touching the users table from the API layer is the shape of doc that has done the most for us, and the version we underrated is the sentence that says why a rule exists at all. The agent-facing rules in our repo require any setting to carry a comment saying why it's needed, what it sets and what behaviour it changes, and in practice that was written for the next session more than for people, since a bare value gives it no way to tell whether the value is load-bearing. What I don't have a good answer to is who prunes those docs once they drift, because the agent reading them will follow a stale one just as faithfully.