DESIGN.md vs AGENTS.md
A clean mental model for splitting agent instructions by domain.
AGENTS.md handles execution
It tells the coding agent how to behave in the repo and what guardrails to follow.
DESIGN.md handles output taste
It tells the same agent how the product should look and feel.
Why it matters
Separating these files keeps each document shorter, clearer, and easier to maintain.
Have a public DESIGN.md?
Create an account and submit the source URL so it can be reviewed and indexed in the directory.
Submit DESIGN.md →