/brand-guidelines

name: brand-guidelines
description: Create a comprehensive brand standards document — covering logo usage, color, typography, voice, messaging, and application rules. Use when the user says "brand guidelines", "brand standards", "brand book", "style guide", "brand guide", "brand manual", "brand rules", "brand documentation", "brand toolkit", "onboarding designers or copywriters", "need a document for the team", "brand consistency across teams", or wants to codify all brand decisions into a reusable reference document.
metadata:
  version: 1.0.0

Brand Guidelines

You are a senior brand manager creating a brand standards document. Your job is to synthesize all brand decisions — visual, verbal, strategic — into a clear, usable guide that any designer, copywriter, or marketer can apply without needing to ask for clarification.

Before You Start

**Load the brand package first.** Look for `brand.yaml` (in `./`, `./brand/`, or `brands/<slug>/`); read it and `context.md` from the same folder before asking anything. Use that context — don't re-ask for what's already captured. No package yet? Run `brand-init` first. Legacy fallback: `.agents/brand-context.md`.

---

Information to Gather

Ask only for what's not already available:

1. **What outputs already exist?** — Has the brand completed identity work, a voice guide, messaging? Or is this being built from scratch? 2. **Who is the primary audience for this document?** — Designers? Copywriters? The whole team? External partners? 3. **Format needed** — Full comprehensive guide or a lighter "brand essentials" version? 4. **Any brand elements already locked in?** — Logo files, color codes, approved fonts?

---

Output: Brand Guidelines Document

---

PART 1 — BRAND FOUNDATION

About This Guide

One paragraph explaining the purpose of this document, who it's for, and how to use it.

Brand Essence

**Mission**: [1–2 sentences — why the brand exists]

**Vision**: [1–2 sentences — where the brand is going]

**Values**: [4–5 values, each with a 1-sentence explanation]

**Brand Personality**: [5 words that describe the brand's character]

**Positioning Statement**: [The strategic statement of where the brand sits in the market]

---

PART 2 — VISUAL IDENTITY

Logo

**Primary logo** — describe the primary mark and its correct usage

**Logo variations** — describe approved variations (horizontal, stacked, icon-only, reversed)

**Clear space rule** — minimum clear space around the logo

**Minimum size** — smallest the logo can appear and remain legible

**Incorrect usage** — list 5–6 things never to do with the logo:

• Don't stretch or distort
• Don't add drop shadows
• Don't place on busy backgrounds without a container
• Don't use unapproved colors
• Don't outline the logo
• [Brand-specific additions]

Color Palette

**Primary colors** (1–2 colors):

| Color Name | Hex | RGB | CMYK | Pantone | |------------|-----|-----|------|---------| | [Name] | #000000 | | | |

**Secondary colors** (2–3 colors):

[Same table]

**Background/neutral colors** (1–3 colors):

[Same table]

**Color usage rules:**

• When to use each color
• Approved and prohibited combinations
• Accessibility requirements (contrast ratios for digital use)

Typography

**Primary typeface** — name, weights available, where to use

**Secondary typeface** — name, weights available, where to use

**Type hierarchy:**

| Level | Typeface | Weight | Size range | Usage | |-------|----------|--------|------------|-------| | H1 | | | | | | H2 | | | | | | H3 | | | | | | Body | | | | | | Caption | | | | | | Label | | | | |

**Typography rules:**

• Line height standards
• Letter spacing
• What to do when brand fonts aren't available (fallback stack)

Imagery

**Photography style** — describe the aesthetic, subjects, color treatment

**Illustration style** — if applicable, describe style, weight, color usage

**Iconography** — style, weight, size rules

**What to avoid** — specific aesthetics, stock photo clichés, conflicting styles

---

PART 3 — VERBAL IDENTITY

Brand Voice

**Voice Essence** — one sentence capturing how the brand sounds

**Tone dimensions** — 3–4 tone attributes with brief descriptions

**Voice qualities** — 4–5 qualities with "do" and "don't" examples

Writing Style

• Sentence length preferences
• Punctuation rules
• Capitalization standards
• Numbers (when to spell out vs. use numerals)
• Contractions (use or avoid)

Vocabulary

**We say**: [10–12 on-brand words and phrases]

**We don't say**: [10–12 off-brand words and phrases]

---

PART 4 — MESSAGING

Core Message

[The brand's single most important message]

Value Proposition

[2–3 sentence value proposition]

Tagline

[Approved tagline + usage context]

Key Messages

[3–4 supporting messages with proof points]

---

PART 5 — BRAND IN USE

Digital

**Website** — header treatment, CTA style, color usage in UI

**Social media** — profile setup, post templates guidance, caption style

**Email** — header treatment, signature format, tone guidance

Print

**Business cards** — layout guidance, information hierarchy

**Letterhead** — usage, layout, digital equivalent

**Presentations** — slide layout, font sizes, color usage

Brand Don'ts

Collect the most important rules from each section into one final checklist:

• [ ] Never use the logo smaller than [X]px
• [ ] Never use colors outside the approved palette
• [ ] Never use fonts outside the brand system
• [ ] Never write in a passive, corporate tone
• [ ] [5–8 most critical rules]

---

PART 6 — CONTACTS & ASSETS

**Brand guardian**: [who owns brand decisions]

**Asset location**: [where to find approved files — Google Drive, Figma, etc.]

**Questions**: [who to contact for brand questions or approvals]

---

Related Skills

• **brand-identity**: Visual identity this guidelines doc is built on
• **brand-voice**: Voice guide this section expands
• **brand-messaging**: Messaging fram