Imagine you could hand a new designer a single page of notes — "we use this shade of blue, this font, buttons are always rounded, lots of white space" — and they'd get it right on the first try, every time. That's roughly what DESIGN.md does, except the "designer" is an AI agent.
It started at Google. They introduced a format — just a plain text file — that describes how a UI should look. Not code, not a Figma file. Plain words and values that an AI can read and act on.
A group of developers then took that idea and built a library of these files, reverse-engineered from real websites: Apple, Spotify, Cursor, and dozens more. You pick the one that matches the vibe you want, drop it into your project, and tell your AI coding tool "build me something that looks like this." The result is surprisingly close to the real thing.
For a business owner, the interesting part isn't the technical side. It's what it signals: design consistency — something that used to require a specialist, a style guide, and hours of back-and-forth — is starting to become something you can describe in a text file and hand to a machine.
If you work with freelancers or a small dev team, this is worth knowing about. It means less "this doesn't look right" and more first drafts that are already in the right neighbourhood.
UI — "User interface." Everything a person sees and clicks on a website or app.
AI agent — A piece of software that can carry out tasks on its own, like writing code or building a webpage, based on instructions you give it.
Design system — A set of rules about how your brand should look: which colors, fonts, and spacing to use. Big companies have whole teams for this. A DESIGN.md file is a lightweight version of the same idea.
Markdown — A simple way of writing text that uses symbols (like # for headings) to add basic formatting. It's readable by humans and machines alike.
Think about how you currently communicate your visual style to people who build things for you. Is it a mood board? An email? A vague "make it look clean"? The gap between what you imagine and what gets built is often just a description problem.