Coding agents are great at writing components and terrible at remembering your brand — colors, spacing, and tone drift every session. DESIGN.md, an open format from Google Labs, tries to fix that by giving agents one persistent, structured description of a design system.
## What it is
A DESIGN.md file is a plain-text source of truth: optional YAML frontmatter holding machine-readable design tokens, and a markdown body with human-readable rationale and guidance. The idea is that both humans and agents read and refine the same document, so stylistic choices survive across sessions and across different AI tools instead of being re-explained every time.
## The tooling
Alongside the spec, Google Labs open-sourced an agent-first CLI and linter. It validates DESIGN.md files and compiles the documented tokens, with deterministic JSON output and silent execution modes built for agents rather than humans. That’s the useful part: a design system stops being a Figma file an agent can’t read and becomes a formal, checkable contract between design and the code an agent generates.

Leave a comment