DESIGN.md vs AGENTS.md vs CLAUDE.md
Use each file for a different job. DESIGN.md is for visual system rules; agent instruction files are for process, tooling, and workflow constraints.
| File | Main job | Best used when | Risk if misused |
|---|---|---|---|
| DESIGN.md | Visual system and UI implementation rules. | Before building or restyling product surfaces. | Too vague, or copied from a brand without rights. |
| AGENTS.md | Project-level working rules for coding agents. | When a repository needs operating instructions. | Mixing process rules with visual design rules. |
| CLAUDE.md | Claude-specific workflow and memory rules. | When Claude Code needs persistent project guidance. | Locking all context to one tool. |
| Cursor rules | Cursor-specific editing and style preferences. | When Cursor should consistently follow local patterns. | Hiding design requirements inside tool-specific rules. |