We’ve spent the last year teaching AI coding agents how to build our software. But what about teaching them how to make it look good?Enter DESIGN.md, a brilliant new concept introduced by Google Stitch that is quietly changing how we build UIs.
The Problem with AI Design
Until now, getting an AI to generate consistent UI meant messy Figma exports, rigid JSON schemas, or endless prompt engineering. It was clunky, and it rarely captured the true “feel” of a brand.DESIGN.md fixes this by going back to basics: it’s just a markdown file.Because markdown is the native language of LLMs, there’s nothing to parse, no special tooling to configure, and no complex schemas to maintain. You just drop a DESIGN.md into your project root, and any AI design agent instantly understands your visual language.
The New Dynamic Duo
If you’re familiar with AGENTS.md, you already know the drill. The new paradigm for AI-native repos looks like this:
AGENTS.mdtells coding agents how to build the project.DESIGN.mdtells design agents how the project should look and feel.
The Heavyweights Are Already Onboard
This isn’t just a fringe experiment; first-party adoption is exploding. A new tracker for official DESIGN.md files reveals that some of the biggest names in dev tools have already shipped them:
- Vercel (Geist design system: black-and-white precision)
- Atlassian (Structured enterprise clarity)
- Nuxt (Tailwind v4, dark mode by default)
- Clerk (Signature purple, written for humans and AI)
- Resend, Mintlify, and VoltAgent are also leading the charge with their own token-driven and terminal-native systems.
The Takeaway
The DESIGN.md standard is brand new, but it’s growing fast. It proves that when it comes to AI, simplicity wins. No proprietary formats, no black boxes—just clean, readable markdown.If your team ships a design system, it’s time to write it down for the machines.Want to see what these look like in the wild? Check out the official tracker or dive into the awesome-design-md collection for ready-to-use examples.
