The most useful thing we deliver is a text file
The brand guideline was always written for a reader who never showed up.
Every studio delivers one. Forty pages, sometimes ninety. Clear space diagrams. A palette with hex values. A page explaining what the logo means.
The client opens it once, on the day it arrives.
Then the work starts. A contractor builds the Shopify theme. Someone’s nephew cuts the reel. A freelancer runs the ads in month four. The office manager makes the flyer for the trade show. Two years in, a new marketing hire inherits a folder and starts guessing.
None of them read the PDF. Not because they don’t care. Because a PDF isn’t a working tool. It’s a document you’d have to leave your work to consult, so you don’t.
The guideline’s job was never to be read. Its job was to make the brand hold when we’re not in the room. Measured against that, the PDF has been failing quietly for thirty years. We just didn’t have a better container.
Now we do.
What ships
Every project we deliver includes a file called design.md. Plain text. Markdown. Usually under two thousand words.
It carries the tokens. Color values, type scale, spacing. The typography rules, with the reasoning attached. The voice: how the brand writes, sentence rhythm, the words it uses and the ones it never does. And the wrong examples set next to the right ones, which turns out to matter more than anything else in the file.
You paste it into Claude, or ChatGPT, or Cursor, or whatever your developer has open. Then you ask for a landing page, an email, a caption, a product description.
What comes back is already yours. Not close. Yours.
The negatives do the work
A guideline written for a person can get away with “confident, modern, human.” A person fills the gap with judgment.
A model fills it with the average of everything it has ever seen. Which is precisely the generic the brand was built to escape.
So the file is written in constraints. No exclamation marks. Never open an email with hope this finds you well. Headlines declare; they don’t ask. Right example, wrong example, side by side.
What a brand refuses to do is the sharpest description of it available.
The obvious objection
Handing a client a file that lets them make on-brand work without us looks like giving away the business.
It isn’t. What kills a brand was never a client making their own Instagram post. It’s the drift across the eighteen months between engagements. The off-palette flyer. The vendor who eyeballed the logo. The intern who found an old file in a shared drive. Each one is small. Together they undo the work.
A file that stops the drift protects what we made. And a brand that holds is a brand worth investing in again.
Every project. No charge, no upsell, no module. It’s part of the delivery, the way the logo files are.
The brand guideline finally has a reader.
Common questions
What is a design.md file?
A plain-text Markdown file, usually under two thousand words, that carries a brand’s working rules: color values, type scale, spacing, typography rules with the reasoning attached, the voice — sentence rhythm, the words the brand uses and the ones it never does — and wrong examples set next to right ones.
How is design.md different from a brand guideline PDF?
A PDF is a document you have to leave your work to consult, so nobody does. design.md is a working tool: you paste it into Claude, ChatGPT, Cursor, or whatever your developer has open, then ask for a landing page, an email, a caption, or a product description — and what comes back is already on-brand.
Why does the file focus on what the brand refuses to do?
A person reading “confident, modern, human” fills the gap with judgment. A model fills it with the average of everything it has ever seen — precisely the generic the brand was built to escape. Constraints and wrong-versus-right examples are what keep generated work specific.
Is design.md an extra module or an upsell?
No. It ships with every x-brands project at no charge, part of the delivery the way the logo files are. A file that stops brand drift between engagements protects the work — and a brand that holds is a brand worth investing in again.