The Branddock Brand Profile
A brand is more than a logo and a colour. It is who you are, who you are for, how you sound and where your line is. The Brand Profile captures that in one readable file: brand.md. People read it, AI tools read it, and it stays yours.
Why a file. Every AI tool that writes or designs for you needs context. Without it you get average copy in an average tone. With brand.md every tool starts from the same foundation, from the same source. Branddock keeps that source; the file is how your brand leaves the building.
What stays in Branddock. The file is the summary. In Branddock you build the brand and keep it current, work with it in campaigns, copy and images, check what you make against your brand, decide what goes live and see what it delivers. What is confidential, such as your competitors and your research, stays in your workspace.
Two files. brand.md describes who the brand is. design.md describes how it looks on a surface, in the form of Google's DESIGN.md. Anything that survives a full redesign belongs in brand.md; anything that may change in a redesign without changing the brand belongs in design.md. design.md points to brand.md.
Origin. The layers and headings follow the BRAND.md specification v0.3.0 (MIT) by its maintainer. The Brand Profile extends that form without changing it: a tool that only knows BRAND.md reads our file as is. Two of our additions were proposed there and remain open.
What it adds. Provenance and a date per section; per audience what they believe and what they are skeptical of, and who the brand is not for; under Guardrails the tone in a few words, what the brand cannot be and one litmus test; colours with a name and a meaning; typefaces with fallbacks and licensing source; logos; products and services; tone per channel; and a set of writing rules that keep AI copy human.
Honesty. What is not known is not invented. It says "Not yet defined", and the first line says how many sections are filled in and where to complete them. validation says whether a section is filled, from which source, and whether a person confirmed it. It does not say it is right; you decide that.
How to use it. Give an AI tool the public URL: it is built live from your workspace, so there is nothing to maintain. Or put BRAND.md and DESIGN.md in the root of your repository, next to AGENTS.md or CLAUDE.md; that is a snapshot, which you download again after a change.
Our own file. branddock.app/brand.md · branddock.app/design.md
What changed. A downloaded file does not change. A published file changes the next time it is fetched: only the personas you set to public, new lines under Audience and Guardrails, colours with a name and a meaning, typefaces with fallbacks and licensing source, a new Logo & Marks section, Mission & Vision under Overview, and "N of 7" instead of "N of 5" in the first line. design.md no longer describes who the brand is; it points to brand.md.
Specification.
| Layer | Section | Defined in | Always present | Content |
|---|---|---|---|---|
| Strategy | Overview | BRAND.md 0.3.0 | yes | one or more paragraphs |
| Strategy | Audience | BRAND.md 0.3.0 | yes | a prose line naming the personas, then one `####` entry per persona with its tagline and lines when they exist |
| Strategy | Positioning | BRAND.md 0.3.0 | yes | one or more paragraphs |
| Strategy | Personality | BRAND.md 0.3.0 | yes | one or more paragraphs |
| Strategy | References & Anti-References | BRAND.md 0.3.0 | yes | one or more paragraphs |
| Strategy | Promise | BRAND.md 0.3.0 | yes | one or more paragraphs |
| Strategy | Guardrails | BRAND.md 0.3.0 | yes | `#### Do` and/or `#### Don't` with bullet lines |
| Strategy | Brand Profile | no | one `###` per further brand-foundation element (heading = its name; ` (brand asset)` after a name that equals a Strategy heading) | |
| Voice | Identity | BRAND.md 0.3.0 | yes | one or more paragraphs |
| Voice | Tagline & Slogans | BRAND.md 0.3.0 | yes | `- Primary: "…"` plus up to four slogans |
| Voice | Message Pillars | BRAND.md 0.3.0 | yes | one bullet per pillar: `**pillar** — statements` |
| Voice | Phrases | BRAND.md 0.3.0 | yes | one quoted bullet per phrase |
| Voice | Vocabulary | BRAND.md 0.3.0 | no | `- Preferred:` and/or `- Avoid:` lines |
| Voice | Tonal Rules | BRAND.md 0.3.0 | yes | bullet rules and/or a `We Say | We Never Say` table; filled with at least one rule or one table row |
| Voice | Brand Profile | yes | the Branddock writing rules; the headings of the human-voice rules are currently Dutch, also in an English file, while `### Writing rules` and `#### Avoid these terms` follow the language of the file | |
| Visual | Logo & Marks | BRAND.md 0.3.0 | yes | one bullet per logo: the variant, the URL in angle brackets, then in parentheses the type, the size and "hosted copy" when known, then the description when there is one; in the public profile the URL only for a logo on Branddock's own storage. Then the logo guidelines and `Don't:` lines |
| Visual | Core Colors | BRAND.md 0.3.0 | yes | one to five bullets, mandatory colours first: the name in bold, the hex as code, then the meaning (at most 160 characters) or "not yet described", then (mandatory) or (optional); without brand colour rows, one bullet per colour role with a hex value |
| Visual | Typefaces | BRAND.md 0.3.0 | yes | one bullet per family: `**<family>** — used for <roles>. Fallback: <stack or not yet defined>. Licensing: <source>.`; without font rows, the families of the type scale with "Licensing: not verified" |
| Visual | Photography & Illustration | BRAND.md 0.3.0 | no | a style paragraph, the subjects and composition, and/or guideline bullets |
| Visual | Art Direction | BRAND.md 0.3.0 | yes | design keywords and/or a direction statement |
| Products & Services | Brand Profile | no | one `###` per product, with a description and benefit and use-case lines when they exist | |
| Channel Tones | Brand Profile | no | one bullet per channel: `channel: tone` | |
| Market Context | Brand Profile | never in the public profile | one `###` per competitor |
version 1.0 · text under CC BY 4.0 · validator brandmd-validate (MIT)
The Brand Profile is maintained by Branddock, a product of Better Brands (sole proprietorship, Chamber of Commerce no. 75832208).