DESIGN.md, CLAUDE.md and AGENTS.md are plain-text, repo-resident files that give AI coding agents persistent context. CLAUDE.md and AGENTS.md cover code and conventions; DESIGN.md covers the visual identity. Complementary layers an agent reads on every interaction.
What each file covers
CLAUDE.md / AGENTS.md -> code & project context
(stack, conventions, commands)
SKILL.md -> on-demand capabilities






