design.md

Why we included this project

Anyone who has watched a coding agent pick a slightly different blue on every request knows the pain this solves. DESIGN.md is a plain-text spec that fixes a visual identity in two layers: YAML front matter holds machine-readable design tokens with exact color, type, spacing, and component values, while the markdown prose underneath explains why those values exist and how to use them. An agent that reads the file stops improvising and produces the same headlines, buttons, and backgrounds every time. The bundled CLI earns its keep too: it lints a DESIGN.md for broken token references and WCAG contrast problems, and it diffs two versions of a design system so token or prose regressions get caught before they ship. For teams that want a versionable, reviewable way to hand a design system to an agent, this is a concrete starting point.