Keep docs current in every commit

Give one area its own doc with the facts the code cannot tell the agent, name it in AGENTS.md, and add one rule so the same commit updates the doc when the code changes it.