design.md

DESIGN.md is a format specification developed to describe visual identities to coding AI agents. It combines machine-readable design tokens in YAML front matter with human-readable design rationale in Markdown prose, giving agents a persistent, structured understanding of a design system. It includes a robust CLI tool for structural validation (linting), WCAG contrast ratio checking, and version diffing. Additionally, it seamlessly exports design tokens into Tailwind v3/v4 configurations or the W3C Design Tokens (DTCG) format.

• Machine and human readable format
• Optimized context for coding AI agents
• Built-in linting & WCAG contrast checks
• Design system version diffing
• Interoperable Tailwind & DTCG exports