DESIGN.md vs CLAUDE.md
Keep engineering behavior and visual behavior separate so agents can follow both well.
CLAUDE.md scope
CLAUDE.md or AGENTS.md explains repo rules, commands, architecture, and coding constraints.
DESIGN.md scope
DESIGN.md explains visual taste, layout logic, UI rules, and product presentation.
Best pairing
Use both in the same repo so implementation and design decisions stay aligned.
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 →