How to give DESIGN.md to an agent
A contract only works if the agent reads it. Below is the smallest hook that works in each tool today.
Where it lives
Put DESIGN.md at the repo root and name it in your rules: read this file before writing UI, and treat tokens as normative.
How each tool references it
The filenames differ. The requirement does not: the file is at the root, and the rules say read it first.
- Cursor — Root DESIGN.md, referenced from .cursorrules or .cursor/rules/design.mdc.
- Claude Code — Root DESIGN.md plus .claude/skills/design/SKILL.md, named in CLAUDE.md.
- Codex — Tell AGENTS.md that all UI must obey DESIGN.md.
- Stitch — Import DESIGN.md (YAML front matter plus the eight official sections).
What this site lints
Before export we lint contrast, token references, and section order, aligned with Google's @google/design.md.
What else you can take
From the editor you can also download tokens.json (DTCG), Tailwind v3/v4, SwiftUI Color/Font extensions, or a ZIP.