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