What goes in DESIGN.md
The agent reads the file, not the taste in your head. This is what the file actually contains.
YAML comes first
Front matter keys stay in English: colors, typography, rounded, spacing. Colors use semantic roles such as primary, background, and onBackground. Do not invent a second hex palette in components.
Eight sections
The order is Overview, Colors, Typography, Layout, Elevation & Depth, Shapes, Components, and Do's and Don'ts. Titles stay in English so the file matches Google's DESIGN.md spec. This site checks that order before export.
Chinese can live in the sentences
When you export in Chinese, the overview, component notes, and Do / Don't list are in Chinese. YAML keys and the eight section titles stay in English. Style-page previews follow the same rule.
Tradeoffs should be specific
Do not write “keep it beautiful.” Write something an agent can obey, such as one accent, 44px targets, and no default row of three equal feature cards.