DESIGN.md · brand DNA for AI agents

Generate DESIGN.md
from 440 quality-graded references.

One DESIGN.md spec, 440 company references with explicit quality grades, and local workflows for Claude Code, Cursor, Codex, and OpenCode. Use confirmed patterns without filling unknown brand facts. Free, MIT, and no AI calls during install.

$npx oh-my-design-cli@latest
# DESIGN.md
## Brand: Toss
primary: #3182f6
radius: 8px
weight.heading: 700
## Voice
솔직하고 다정하게,
금융용어 없이.
## Forbidden
- Get Started
- Click here
- Submit
auto · brand cycle
CLI

Install the workflow. Your agent does the design work.

The guided installer detects your coding tools, writes only the capabilities each channel supports, and stores the reference catalog locally. Doctor checks the result before you start.

~/project
$ npx oh-my-design-cli@latest
✓ Installed supported capabilities for selected channels
✓ Synced 440 quality-graded DESIGN.md references
✓ Preserved files outside OmD-managed paths
→ Restart your agent, then run: npx oh-my-design-cli@latest doctor
First prompt: “Set up the design system for a calm B2B fintech dashboard.”
Project or global scopeNo separate API key or MCP serverMIT licensed
Live proof

Same prompt. Five brands. One file decides.

Prompt
build me a hero card for the landing
↓ DESIGN.md context loaded: Stripe
Stripe
Built for scale
Move money for businesses around the world. From day one.
Toss
송금, 더 쉽게
복잡한 절차 없이 3초 안에 보내세요.
Linear
Issue tracking, finally fast
Built for high-velocity software teams.
Notion
Your wiki, docs & projects. Together.
One workspace. Every team.
Vercel
Ship. Then iterate.
The frontend cloud for builders.
DESIGN.md → Stripe: voice: clear, technical, confidence-led
The wall

440 references. Quality-graded.

Each tile opens an evidence-backed company reference in Builder. Unknown fields stay absent instead of being replaced with guesses.

104
11st
17live
29cm
3o3
42dot
591
8percent
91app
abema
ably
accupass
acer
adobe
airbnb
airbridge
airtable
alipay
amazingtalker
appier
apple
asana
asleep
asos
au
autopedia
aws-cloudscape
baemin
bahamut
banksalad

Logos belong to their respective companies. Reproduced for educational reference only.

Same prompt · Different brain

What an agent ships without vs with DESIGN.md

Same prompt to the same model. The only difference: one read yourDESIGN.mdfirst.

Without DESIGN.mdPrimary CTA

Generic Tailwind defaults · stock voice · zero brand recognition.

With · TossPrimary CTA
voice ·솔직하고 다정하게
§01 Toss Voice §10 — 솔직하고 다정하게, 금융용어 없이. Forbidden: 'Get Started'.
Without DESIGN.mdEmpty state
No data available.

Generic Tailwind defaults · stock voice · zero brand recognition.

With · AnthropicEmpty state
Nothing here yet — and that's a good place to begin.
Tell Claude what you want this page to feel like.
voice ·warm, literary, human-first
§02 Anthropic Voice §10 — warm, human, literary. Empty isn't empty — it's a doorway.
Without DESIGN.mdError toast
Error 500: Internal Server Error

Generic Tailwind defaults · stock voice · zero brand recognition.

With · LinearError toast
Sync paused — we'll retry in 4 seconds.⌘.
voice ·precise, unhurried
§03 Linear Voice §10 — precise, no panic, builder-to-builder. Mono numerals, no exclamation marks.
Without DESIGN.mdAuth form

Generic Tailwind defaults · stock voice · zero brand recognition.

With · VercelAuth form
Continue with Vercel
voice ·ship, then iterate
§04 Vercel Voice §10 — minimal, primitive-first. Text size shrinks. Buttons are pills.

Tokens get you halfway. Voice takes you home.

When the evidence exists, a reference can preserve more than tokens — Voice · Narrative · Principles · Personas · States · Motion. Unknown fields stay absent.

Move your cursor
Open source · MIT · zero AI calls

Help shape oh-my-design.

No signup, no API key, no cost — but every brand we add, every bug we squash, comes from someone like you reaching out.

$npx oh-my-design-cli@latest
or run the 5-minute demo