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.
#agents-md
Filtering by topic #agents-md · clear
AGENTS.md and HUMAN.md, explained
AGENTS.md is the README your coding agent reads. What belongs in one, what never does, how CLAUDE.md fits, and a starter template to copy.