A format specification for describing a visual identity to coding agents. DESIGN.md gives agents a persistent, structured understanding of a design system.
Market Signal
Why It Has Market Pull
Google Labs' DESIGN.md is an open spec that gives coding agents a persistent, structured understanding of a design system, pairing machine-readable tokens with human-readable rationale. In roughly two months it has grown to ~17k stars and is positioning itself as the visual-design counterpart to AGENTS.md and CLAUDE.md, with an official Google push tempered by alpha maturity.
- ~17k stars and ~1.6k forks; open-sourced ~2 months ago
- v0.3.0 released June 2026; still labeled alpha; Apache-2.0
- Backed by Google Labs (Stitch team), with an official launch blog on blog.google
- Ships an agent-first CLI/linter doing WCAG contrast checks, broken-token detection, export to Tailwind/W3C DTCG/CSS
- Agent-agnostic: read by Claude Code, Cursor, Gemini CLI, v0, Stitch
feedbacks
What People Are Saying
"Very useful. Stealing it."HN comment
"But how is DESIGN.md to play nicely with eg Figma Design Tokens, or tailwind.config.js?"HN comment
"trying to codify design rigidly and prescriptively in docs is going to slow you down"HN comment
"DESIGN.md very useful for quickly getting something up and running"HN comment
"It's emerging as a shared contract for agent-driven UI - same shape as CLAUDE.md/AGENTS.md but for visual decisions."GitHub issue
"The skill's current 'avoid AI slop' ethos might be better served by loose creativity than by a structured contract."GitHub issue



















