DESIGN.md: the file after AGENTS.md
AGENTS.md tells a coding agent how to work in your repo. DESIGN.md tells it why the code is shaped that way, so it stops undoing your decisions.
Filtering by topic #documentation · clear
AGENTS.md tells a coding agent how to work in your repo. DESIGN.md tells it why the code is shaped that way, so it stops undoing your decisions.
One root AGENTS.md in a monorepo goes stale and burns context on directories the agent never opens. Here is the nested layout that fixes it.
Agent-written docs drift into stale claims and contradictory rules. Cambium answers with a governance kernel and append-only receipts. Who needs it.
Your AGENTS.md is wrong three weeks later and the agent trusts it. Use dox to regenerate the file from the repo, then review the diff like code.
Convert a PDF, EPUB or folder of internal docs into an agent skill your coding agent loads on demand: install, token budget, headless runs, licensing.