brand.md is a single markdown file that turns Claude, Cursor, ChatGPT, Figma and any image generator into an on-brand collaborator. Drop it in. Done.
BrandPatrol generates a brand.md from your real digital presence: colors sampled from real pixels, typography read off your site, tone of voice extracted from your actual copy, rules synthesized from how you already show up.
The file has YAML frontmatter for tools and readable markdown for humans and LLMs. Tools that understand Google's open design.md spec (Stitch, Figma plugins) consume it directly. AI assistants treat it as ground truth.
---
name: Northwind Coffee
tagline: Roasted slow. Poured warm.
colors:
- role: primary
hex: "#1F2937"
name: Onyx
- role: secondary
hex: "#D97706"
name: Saffron
typography:
primary: Recoleta
secondary: Inter
voice:
traits: [warm, knowledgeable, hands-on]
do: [Lead with the origin story, ...]
dont: [Use corporate jargon, ...]
mood:
image: ./mood.jpg
audio: ./voice.mp3
design_doc: ./design.md
---
# Northwind Coffee
> Roasted slow. Poured warm.
## Voice & Tone
Warm, knowledgeable, never preachy. We talk like a barista
sharing a secret with a regular...
Real hex codes sampled from your screenshots. Real font families read off your pages.
Traits, do/don't lists, and key phrases — distilled from your actual copy, not invented.
Tagline, value propositions, elevator pitch and headline templates ready to remix.
An AI-generated abstract mood image and a synthesised voice reading your tagline.
Pick your tool. Drop the file in. Get on-brand output without prompt-stuffing every time.
brand.md and design.md.Always write copy and design output in the voice of {brandName}, using the guidance in brand.md. Reference the Voice & Tone Do/Don't list before you produce anything. When you generate visual specs, follow design.md exactly — never invent colors or fonts../brand/) and add this to CLAUDE.md:## Brand
All user-facing copy and visual decisions must follow ./brand/brand.md
and ./brand/design.md. Read those before writing any marketing copy,
UI text, or design specs..cursor/rules/ in Cursor). Add a project rule:When generating UI components or copy, use the design tokens from design.md and the voice/messaging guidance from brand.md. Never use hex codes or font families that aren't defined there.brand.md into Instructions, and upload design.md + brand-profile.json as Knowledge.design.md directly. The frontmatter follows the open spec — tools that understand design.md will materialize tokens as variables, styles, or design components.mood.jpg as a style image and pull color cues from design.md. Template:[scene description], in the visual style of {brandName} — color palette: [hex codes from design.md], mood: [imagery_style + personality], composition: [from visual identity]. Reference: mood.jpg.Once brand.md is loaded, these prompts get you most of what you need.
Write 8 headlines for [campaign/page] in our brand voice. Use the Key phrases section as templates and respect Voice & Tone Do/Don't.
Draft a [hero / about / pricing] page. Pull positioning from Overview, value propositions from Messaging, and stay inside our voice traits.
Build a [card / hero / nav] component using design.md tokens only. Follow the visual identity description for spacing and feel.
Review this draft against brand.md. Flag any voice violations (Don't list), token violations (off-palette colors, wrong fonts), or rule breaks.
Generate brand.md from your website in minutes. Re-use it in Claude, Cursor, ChatGPT, Figma, and your image pipeline — same brand, everywhere.