Brand Agency

Brand Agency

Guide users through comprehensive brand identity development, from discovery questionnaire to final brand guidelines with visual assets.

The Job

1. Guide user through branding questionnaire (35 questions across 7 sections)
2. Let user choose conversation flow style (one-by-one, grouped, or custom)
3. Research fonts and color palettes online based on user's brand direction
4. Generate color swatches with rationale for each color
5. Recommend Google Fonts with usage rules
6. Output brand guidelines and executive summary
7. Evaluate output and iterate until requirements are met

Output Files

The skill generates three types of output in the ./branding/ directory:

• brand-guidelines.md — Comprehensive brand guidelines with strict rules for logo usage, colors, typography, and visual identity
• brand-summary.txt — Executive summary highlighting key brand decisions for stakeholders
• swatches/ — Visual color swatch images generated using the painter tool

Workflow Overview

Phase 1: Conversation Flow Selection

Start every branding session by asking the user to choose their preferred flow:

How would you like to proceed through the branding questionnaire?

1. **One-by-one** — I'll ask each question individually (best for thorough exploration)
2. **Grouped** — I'll present questions section by section (balanced approach)
3. **Custom** — You choose which sections/questions are relevant (fastest)

Flow Logic by Selection:

Option 1: One-by-One Flow

• Ask each of the 35 questions individually
• Wait for user response before proceeding to next question
• Allow user to say "skip" to move past any question
• Provide brief context for why each question matters
• After each response, acknowledge and move to next question

Option 2: Grouped Flow

• Present all questions within a section at once
• List the section name and all questions in that section
• User can answer all at once or respond to specific numbers
• After completing a section, summarize responses and move to next section
• Section order: Identity → Audience → Messaging → Visual → Marketing → Operational → Additional

Option 3: Custom Flow

• First, show the 7 section titles with question counts:

  Which sections are relevant to your project?
  
  1. Brand Identity and Story (6 questions)
  2. Target Audience and Market Position (5 questions)
  3. Brand Messaging and Communication (4 questions)
  4. Visual Identity and Design Preferences (5 questions)
  5. Marketing and Promotional Strategy (4 questions)
  6. Operational and Strategic Insights (5 questions)
  7. Additional Insights & Bonus Questions (6 questions)
  
  Enter section numbers (e.g., "1, 2, 4") or "all":
  

• After user selects sections, ask: "Within these sections, one-by-one or grouped?"
• Proceed with only the selected sections using chosen sub-flow

Handle interruptions gracefully:

• If user says "let's move on" or "skip this section" — proceed to next phase
• If user provides partial answers — work with what you have
• If user wants to revisit — allow jumping back to any section

Phase 2: Brand Discovery Questionnaire

Guide user through 35 branding questions organized into 7 sections. Use the flow style selected in Phase 1.

Section 1: Brand Identity and Story (Questions 1-6)

Follow-up prompts: If answers are vague, ask "Can you give me a specific example?" or "What would that look like in practice?"

Section 2: Target Audience and Market Position (Questions 7-11)

Follow-up prompts: If user struggles with Q7, suggest demographics (age, income, location) and psychographics (values, interests, lifestyle).

Section 3: Brand Messaging and Communication (Questions 12-15)

Follow-up prompts: For tone (Q13), offer examples: "formal vs casual, playful vs serious, authoritative vs friendly."

Section 4: Visual Identity and Design Preferences (Questions 16-20)

Follow-up prompts: For Q19, offer style spectrum: "minimalist vs ornate, modern vs classic, bold vs subtle, geometric vs organic."

Section 5: Marketing and Promotional Strategy (Questions 21-24)

Follow-up prompts: If Q24 is weak, ask "What do customers tell you they love about working with you?"

Section 6: Operational and Strategic Insights (Questions 25-29)

Follow-up prompts: For Q25-26, distinguish between revenue goals, market position, and brand perception goals.

Section 7: Additional Insights & Bonus Questions (Questions 30-35)

Follow-up prompts: Q33 is valuable for visual research — ask for specific examples and what elements they admire.

Skipping and Adaptive Selection

When to skip questions:

• User says "skip", "not applicable", or "I don't know" — move on without pressure
• For startups: Skip Q31 (current logo) if they don't have one yet
• For rebrand projects: Prioritize Q31, Q30, Q32 to understand what's changing
• For time-constrained users: Sections 1-4 are essential; Sections 5-7 are supplementary

Minimum viable questionnaire (10 essential questions): If user requests the fastest path, use: Q1, Q4, Q6, Q7, Q9, Q13, Q16, Q17, Q19, Q24

Recording responses:

• Keep a running summary of responses for each section
• After completing all questions, present a consolidated summary for user confirmation
• Allow user to revise any answer before proceeding to research phase

Phase 3: Research

Based on questionnaire responses, research fonts, colors, and competitors using web tools.

3.1 Google Fonts Research

When to research: After capturing brand personality (Q4), visual style (Q19), and typography preferences (Q18).

Search workflow:

1. Use web_search with brand descriptors:

   web_search: "Google Fonts [personality trait] [visual style]"
   Example: "Google Fonts modern minimalist sans-serif"
   

2. Read Google Fonts directly for pairing suggestions:

   read_web_page: "https://fonts.google.com" 
   objective: "Find [style] fonts suitable for [brand personality]"
   

3. For each font candidate, verify:

   • Available weights (need at least regular, medium, bold)
   • Language support if brand operates internationally
   • Free for commercial use (all Google Fonts are)

Capture for each font:

3.2 Color Palette Research

When to research: After capturing emotional triggers (Q6), color preferences (Q17), and industry context (Q1).

Search workflow:

1. Research industry color conventions:

   web_search: "[industry] brand color palette examples"
   Example: "fintech brand color palette examples"
   

2. Research color psychology for brand emotions:

   web_search: "color psychology [emotion] branding"
   Example: "color psychology trust professional branding"
   

3. Find palette inspiration:

   read_web_page: "https://coolors.co/palettes/trending"
   objective: "Find [mood] color palettes for [industry]"
   

4. Cross-reference with competitor colors (avoid similarity):

   • Note competitor primary colors from Phase 3.3
   • Ensure differentiation while staying industry-appropriate

Capture for each color:

3.3 Competitor Analysis

When to research: After user provides competitor examples (Q10) and competitive stance (Q11).

Search workflow:

1. For each competitor URL provided:

   read_web_page: "[competitor URL]"
   objective: "Identify visual identity: primary colors, typography style, logo characteristics, overall aesthetic"
   

2. If competitor URLs not provided, search for them:

   web_search: "[industry] [location] companies similar to [user's business]"
   

3. Analyze competitor patterns:

   • Common color choices in the industry
   • Typography trends (serif vs sans-serif dominance)
   • Visual density (minimalist vs information-rich)
   • Imagery style (photography vs illustration)

Capture competitor summary:

## Competitor: [Name]
- **Primary color:** [hex + description]
- **Typography:** [serif/sans-serif, specific fonts if identifiable]
- **Visual style:** [minimalist/bold/elegant/playful]
- **Differentiation opportunity:** [what user's brand can do differently]

Research Summary Template

After completing research, present findings to user:

## Research Summary

### Font Recommendations
Based on your brand personality ([traits]) and visual style ([style]):
1. **Heading font:** [Name] - [why it fits]
2. **Body font:** [Name] - [why it fits]
3. **Accent font:** [Name] - [why it fits]

### Color Direction
Based on [industry] conventions and your desired emotions ([emotions]):
- Primary: [color] - [rationale]
- Secondary: [color] - [rationale]
- Accent: [color] - [rationale]
- Neutrals: [colors]

### Competitor Landscape
[2-3 sentence summary of what competitors are doing visually]
- Differentiation opportunity: [specific recommendation]

Does this direction align with your vision? Any adjustments before we proceed?

User confirmation required before proceeding to Phase 4.

Phase 4: Color Palette Generation

Generate a complete color palette based on research findings and user preferences.

4.1 Swatch Count Selection

Ask user before generating:

How many colors would you like in your brand palette?

Recommended options:
- **5 colors** — Minimal palette (primary, secondary, accent, 2 neutrals)
- **7 colors** — Standard palette (adds light/dark variants)
- **10 colors** — Extended palette (full system with semantic colors)

Enter a number or choose a recommendation:

Palette structure by count:

4.2 Color Research Workflow

Build on Phase 3.2 research — reference the color direction already approved by user.

1. For each color role, search for specific inspiration:

   web_search: "[color role] color [industry] [brand personality]"
   Example: "primary color fintech trustworthy modern"
   

2. Validate color accessibility:

   web_search: "[hex code] contrast ratio accessibility"
   

3. Check color harmony:

   read_web_page: "https://coolors.co/contrast-checker"
   objective: "Verify [primary] and [secondary] have sufficient contrast"
   

4. Research complementary/analogous options:

   web_search: "colors that pair well with [primary hex]"
   

4.3 Color Definition Template

For each color, capture:

4.4 Palette Output Format

Present the complete palette to user for approval:

## Your Brand Color Palette

### Primary Colors
| Color | Hex | Role | Usage |
|-------|-----|------|-------|
| 🔵 Trust Blue | #2563EB | Primary | Headlines, CTAs, buttons |
| 🟢 Growth Green | #10B981 | Secondary | Success states, highlights |

### Accent Colors
| Color | Hex | Role | Usage |
|-------|-----|------|-------|
| 🟡 Energy Gold | #F59E0B | Accent | Callouts, badges, icons |

### Neutral Colors
| Color | Hex | Role | Usage |
|-------|-----|------|-------|
| ⚪ Cloud White | #F9FAFB | Light neutral | Backgrounds, cards |
| ⚫ Charcoal | #1F2937 | Dark neutral | Body text, footers |

### Color Rationale Summary
[2-3 sentences explaining how the palette supports brand personality and differentiates from competitors]

Does this palette align with your brand vision? Any colors to adjust?

4.5 Iteration Handling

If user requests changes:

• "Too bold" → Research more muted/desaturated variants
• "Too safe" → Research more vibrant/saturated options
• "Doesn't feel [emotion]" → Re-research color psychology for that emotion
• "Too similar to [competitor]" → Find alternative hues that maintain brand personality

User approval required before proceeding to Phase 5.

4.6 Visual Swatch Generation

After user approves the palette, generate visual color swatches using the painter tool.

Swatch generation workflow:

1. Create the output directory structure:

   ./branding/swatches/
   

2. For each color in the approved palette, use the painter tool:

   painter: {
     "prompt": "Solid color swatch, single color fill #[HEX], 400x400 pixels, 
               no gradients, no textures, pure flat color, square format"
   }
   

3. Save swatches with consistent naming convention.

Swatch naming convention:

Naming rules:

• Lowercase only
• Hyphens instead of spaces
• Role prefix for easy sorting
• Brand name suffix from Color Definition (4.3)

Complete swatch set example:

./branding/swatches/
├── primary-trust-blue.png
├── secondary-growth-green.png
├── accent-energy-gold.png
├── neutral-light-cloud-white.png
└── neutral-dark-charcoal.png

Swatch generation prompts by palette size:

Validation checklist:

• All approved colors have corresponding swatch files
• Filenames follow naming convention (lowercase, hyphens, role prefix)
• All files are in ./branding/swatches/ directory
• Swatch colors match hex codes exactly
• No duplicate filenames

Inform user upon completion:

Visual color swatches generated in ./branding/swatches/

Files created:
- primary-[name].png (#XXXXXX)
- secondary-[name].png (#XXXXXX)
- accent-[name].png (#XXXXXX)
- neutral-light-[name].png (#XXXXXX)
- neutral-dark-[name].png (#XXXXXX)

Proceeding to typography selection...

Phase 5: Font Guidelines Generation

Generate a complete typography system with 4 Google Font recommendations based on research findings and brand personality.

5.1 Font Category Selection

Present the 4 font categories to user:

Your brand needs fonts for 4 purposes. I'll recommend Google Fonts for each:

1. **Heading font** — Used for page titles, section headers, hero text
2. **Body font** — Used for paragraphs, descriptions, general content
3. **Accent font** — Used for callouts, quotes, special emphasis
4. **Display font** — Used for logos, large decorative text, marketing materials

Would you like me to proceed with recommendations based on your brand personality ([traits from Q4])?

Font category requirements:

5.2 Google Fonts Research Workflow

Build on Phase 3.1 research — reference the font direction already explored.

1. For each font category, search with brand context:

   web_search: "Google Fonts best [category] font [brand personality]"
   Example: "Google Fonts best heading font modern minimalist"
   

2. Browse Google Fonts directly for specific styles:

   read_web_page: "https://fonts.google.com/?category=Sans+Serif"
   objective: "Find [style] fonts suitable for [category] with [personality traits]"
   

3. Research font pairings that work together:

   web_search: "[heading font name] font pairing suggestions"
   Example: "Playfair Display font pairing suggestions"
   

4. Verify font availability and weights:

   read_web_page: "https://fonts.google.com/specimen/[FontName]"
   objective: "Check available weights, styles, and language support"
   

Validation checklist for each font:

• Available on Google Fonts (free commercial use)
• Has required weights (regular, medium, bold minimum)
• Supports brand's target languages
• Pairs well with other selected fonts
• Matches brand personality traits

5.3 Font Definition Template

For each font, capture:

5.4 Usage Rules Template

Define usage rules for each font category:

## Heading Font: [Name]

**When to use:**
- Page titles and H1 headings
- Section headers (H2, H3)
- Hero text and taglines
- Navigation labels

**Sizing guidelines:**
- H1: 48-64px (desktop), 32-40px (mobile)
- H2: 32-40px (desktop), 24-28px (mobile)
- H3: 24-28px (desktop), 20-24px (mobile)

**Weight usage:**
- Bold (700): Primary headings
- Medium (500): Subheadings
- Regular (400): Navigation, labels

**Do:**
- Use for short, impactful text
- Maintain consistent hierarchy
- Allow adequate line height (1.2-1.3)

**Don't:**
- Use for body paragraphs
- Mix with display font in same context
- Use light weights for headings

Repeat for each font category with appropriate rules.

5.5 Typography Output Format

Present the complete typography system to user for approval:

## Your Brand Typography System

### Font Stack Overview
| Category | Font | Style | Primary Use |
|----------|------|-------|-------------|
| Heading | Playfair Display | Serif | Titles, headers |
| Body | Inter | Sans-serif | Paragraphs, content |
| Accent | Lora | Serif italic | Quotes, callouts |
| Display | Bebas Neue | Display | Logo, marketing |

### Font Pairing Rationale
[2-3 sentences explaining why these fonts work together and support the brand personality]

### Heading Font: [Name]
- **Style:** [Serif/Sans-serif]
- **Weights:** [List weights to use]
- **Personality:** [How it reflects brand]
- **Usage:** [Primary use cases]

### Body Font: [Name]
- **Style:** [Serif/Sans-serif]
- **Weights:** [List weights to use]
- **Personality:** [How it reflects brand]
- **Usage:** [Primary use cases]

### Accent Font: [Name]
- **Style:** [Serif/Sans-serif/Script]
- **Weights:** [List weights to use]
- **Personality:** [How it reflects brand]
- **Usage:** [Primary use cases]

### Display Font: [Name]
- **Style:** [Display/Decorative]
- **Weights:** [List weights to use]
- **Personality:** [How it reflects brand]
- **Usage:** [Primary use cases]

### Implementation
Google Fonts import link:
\`\`\`html
<link href="https://fonts.googleapis.com/css2?family=[Font1]&family=[Font2]&display=swap" rel="stylesheet">
\`\`\`

CSS variables:
\`\`\`css
:root {
  --font-heading: '[Heading Font]', serif;
  --font-body: '[Body Font]', sans-serif;
  --font-accent: '[Accent Font]', serif;
  --font-display: '[Display Font]', sans-serif;
}
\`\`\`

Does this typography system align with your brand vision? Any fonts to adjust?

5.6 Iteration Handling

If user requests changes:

• "Too formal" → Research more casual, friendly font alternatives
• "Too playful" → Research more professional, structured fonts
• "Hard to read" → Prioritize readability metrics, increase x-height preference
• "Doesn't match [competitor]" → Research what fonts competitor uses, find differentiated alternatives
• "Need more variety" → Research additional weights or complementary fonts

Common font swaps by feedback:

User approval required before proceeding to Phase 6.

Phase 6: Brand Guidelines Assembly

Compile all brand elements from Phases 4-5 into comprehensive guidelines with clear usage rules for every context.

6.1 Logo Usage Guidelines

Build on questionnaire responses — reference Q16 (logo inspiration), Q20 (existing assets), Q31 (current logo).

Present logo usage framework to user:

Before I create your brand guidelines, let's define logo usage rules.

Do you have an existing logo, or will one be designed separately?
- **Existing logo** — I'll create placement and usage rules for it
- **Logo pending** — I'll create placeholder guidelines for future logo

Logo usage template:

## Logo Usage Guidelines

### Primary Logo
[Description or placeholder for primary logo]

### Logo Variations
| Variation | Use Case | Background |
|-----------|----------|------------|
| Full color | Primary use, marketing | Light backgrounds |
| Reversed | Dark backgrounds | Dark backgrounds |
| Monochrome | Single-color printing | Any |
| Icon only | Favicons, app icons, small spaces | Any |

### Clear Space Requirements
- Minimum clear space: Equal to the height of the logo mark (or "X" unit)
- No text, graphics, or other elements within the clear space zone
- Clear space applies to all edges of the logo

### Minimum Size Requirements
| Format | Minimum Width |
|--------|---------------|
| Print | 1 inch (25mm) |
| Digital | 120px |
| Favicon | 32px (icon only) |

### Logo Placement

**Preferred positions:**
- Top-left for headers/navigation
- Center for hero sections and marketing
- Bottom-center for footers

**Placement rules by context:**
| Context | Position | Size | Variation |
|---------|----------|------|-----------|
| Website header | Top-left | 40-60px height | Full color |
| Email signature | Bottom-left | 80-120px width | Full color |
| Social media profile | Center | Platform specs | Full color or icon |
| Business cards | Top-left or center | 0.75-1 inch | Full color |
| Presentations | Title slide center, footer | Per template | Full color |

### Logo Don'ts
- ❌ Do not stretch, distort, or rotate the logo
- ❌ Do not change logo colors outside approved palette
- ❌ Do not add effects (shadows, gradients, outlines)
- ❌ Do not place on busy backgrounds without sufficient contrast
- ❌ Do not recreate or redraw the logo
- ❌ Do not use outdated versions of the logo

6.2 Color Usage Contexts

Build on Phase 4 color palette — reference the colors already approved by user.

Define color roles and contexts:

## Color Usage Contexts

### Color Hierarchy
| Role | Color | Usage Percentage |
|------|-------|------------------|
| Primary | [Primary color] | 60% of brand visuals |
| Secondary | [Secondary color] | 30% of brand visuals |
| Accent | [Accent color] | 10% for emphasis |

### Context-Specific Usage

#### Digital Applications
| Element | Color | Hex | Notes |
|---------|-------|-----|-------|
| Primary buttons | Primary | #XXXXXX | Call-to-action buttons |
| Secondary buttons | Secondary | #XXXXXX | Less prominent actions |
| Links | Primary or Accent | #XXXXXX | Ensure contrast |
| Backgrounds | Light neutral | #XXXXXX | Main content areas |
| Headers/Footers | Dark neutral | #XXXXXX | Navigation, footer |
| Hover states | Primary (darkened 10%) | #XXXXXX | Interactive feedback |
| Error states | Red variant | #DC2626 | Form validation |
| Success states | Green variant | #16A34A | Confirmations |

#### Print Applications
| Material | Primary Color Use | Secondary Color Use | Notes |
|----------|------------------|---------------------|-------|
| Business cards | Logo, name | Contact details | White background |
| Letterhead | Header, logo | Accent lines | Conservative use |
| Brochures | Headlines, CTAs | Body accents | Balance with white space |
| Packaging | Dominant brand color | Supporting elements | Consider shelf impact |

#### Social Media
| Platform | Profile | Cover/Banner | Posts |
|----------|---------|--------------|-------|
| LinkedIn | Logo on brand color | Brand gradient or primary | Professional, muted |
| Instagram | Logo icon | Brand imagery | Vibrant, on-brand |
| Twitter/X | Logo icon | Brand pattern or color | Consistent with posts |
| Facebook | Logo icon | Brand imagery | Balanced color use |

### Color Pairing Rules

**Allowed combinations:**
- Primary + Light neutral (high contrast content)
- Secondary + Dark neutral (subtle headers)
- Accent + Primary (emphasis within primary content)
- Light neutral + Dark neutral (clean, minimal layouts)

**Avoid combinations:**
- Primary + Secondary directly adjacent (unless tested for harmony)
- Accent + Accent (never use multiple accents together)
- Any combination that fails WCAG 2.1 AA contrast requirements

### Accessibility Requirements
| Combination | Minimum Contrast | Use Case |
|-------------|------------------|----------|
| Body text on background | 4.5:1 | All body copy |
| Large text on background | 3:1 | Headlines 18px+ |
| UI components | 3:1 | Buttons, inputs |
| Non-text elements | 3:1 | Icons, borders |

6.3 Font Pairing Rules

Build on Phase 5 typography system — reference the 4 fonts already approved.

Define pairing hierarchies:

## Font Pairing Rules

### The Font Stack
| Role | Font | Fallback Stack |
|------|------|----------------|
| Heading | [Heading font] | Georgia, serif |
| Body | [Body font] | Arial, sans-serif |
| Accent | [Accent font] | Georgia, serif |
| Display | [Display font] | Impact, sans-serif |

### Pairing Combinations

**Approved pairings (use these):**
| Heading | Body | Context |
|---------|------|---------|
| [Heading font] | [Body font] | Standard content pages |
| [Display font] | [Body font] | Marketing materials, landing pages |
| [Heading font] | [Accent font] | Editorial, blog posts |

**Avoid these pairings:**
- Display + Accent (too decorative, reduces readability)
- Two fonts from the same category in adjacent elements
- More than 2 fonts on a single page/screen

### Hierarchy Rules

**Content hierarchy pattern:**

H1 (Hero) → Display font, 48-64px, Bold H1 (Page) → Heading font, 36-48px, Bold
H2 (Section) → Heading font, 28-32px, Bold H3 (Subsect) → Heading font, 22-26px, Semi-bold Body → Body font, 16-18px, Regular Caption → Body font, 12-14px, Regular Accent text → Accent font, 16-20px, Italic

**Line height by context:**
| Element | Line Height | Letter Spacing |
|---------|-------------|----------------|
| Headlines | 1.1-1.2 | -0.02em to 0 |
| Body text | 1.5-1.7 | 0 |
| Captions | 1.4-1.5 | 0.02em |
| Buttons | 1.2 | 0.05em |

### Context-Specific Typography

#### Website
| Element | Font | Size | Weight |
|---------|------|------|--------|
| Navigation | Body | 14-16px | Medium (500) |
| Hero headline | Display | 48-72px | Bold (700) |
| Section titles | Heading | 32-40px | Bold (700) |
| Body copy | Body | 16-18px | Regular (400) |
| Buttons | Body | 14-16px | Semi-bold (600) |
| Footer links | Body | 14px | Regular (400) |

#### Print Materials
| Element | Font | Size | Weight |
|---------|------|------|--------|
| Document titles | Heading | 24-32pt | Bold |
| Section heads | Heading | 18-24pt | Bold |
| Body copy | Body | 10-12pt | Regular |
| Captions | Body | 8-10pt | Regular |
| Pull quotes | Accent | 14-18pt | Italic |

#### Presentations
| Element | Font | Size | Weight |
|---------|------|------|--------|
| Slide titles | Heading | 36-44pt | Bold |
| Bullet points | Body | 24-28pt | Regular |
| Annotations | Body | 18-20pt | Regular |

6.4 Visual Identity Rules

Define overall visual language beyond colors and fonts:

## Visual Identity Rules

### Photography Style

**Based on brand personality ([traits from Q4]):**

| Attribute | Guideline |
|-----------|-----------|
| Mood | [Derived from Q6 emotional triggers] |
| Lighting | Natural/studio, bright/moody |
| Color treatment | True color, warm filter, desaturated |
| Subjects | People, products, abstract, lifestyle |
| Composition | Centered, rule-of-thirds, asymmetric |

**Photography dos:**
- ✓ Use images that reflect brand personality
- ✓ Maintain consistent color grading across all imagery
- ✓ Feature diverse, authentic subjects when using people
- ✓ Ensure adequate resolution (min 72dpi web, 300dpi print)

**Photography don'ts:**
- ✗ Generic stock photos with forced smiles
- ✗ Inconsistent filters or color treatments
- ✗ Busy, cluttered compositions
- ✗ Low-quality or pixelated images

### Iconography

| Attribute | Guideline |
|-----------|-----------|
| Style | Line/solid, rounded/sharp, thick/thin |
| Stroke weight | Consistent (e.g., 2px for all icons) |
| Corner radius | Match brand style (e.g., 4px rounded) |
| Color | Primary, secondary, or neutral only |
| Size | Multiples of 8px (16, 24, 32, 48px) |

### Spacing and Layout

**Spacing scale (8px base unit):**
| Token | Value | Use |
|-------|-------|-----|
| xs | 4px | Inline elements, tight groups |
| sm | 8px | Related elements, list items |
| md | 16px | Standard component spacing |
| lg | 24px | Section padding, card margins |
| xl | 32px | Major section breaks |
| 2xl | 48px | Page sections |
| 3xl | 64px | Hero spacing, major divisions |

**Layout principles:**
- Use consistent grid system (12-column recommended)
- Maintain generous white space (don't crowd elements)
- Align elements to grid for visual harmony
- Group related content with consistent spacing

### Graphic Elements

**Patterns and textures:**
- [Define if brand uses patterns — derived from Q19, Q34]
- Usage: backgrounds, section dividers, accent areas
- Never compete with content for attention

**Shapes and containers:**
| Element | Style | Border Radius | Border |
|---------|-------|---------------|--------|
| Cards | Subtle shadow | 8-12px | None or 1px neutral |
| Buttons | Solid fill | 4-8px | None |
| Input fields | Outlined | 4px | 1px neutral |
| Tags/badges | Solid or outlined | 4px or full | Optional 1px |

### Brand Collateral Templates

**Required templates for consistency:**
| Template | Key Elements |
|----------|--------------|
| Email signature | Logo, name, title, contact, social icons |
| Presentation | Title slide, content slide, section divider |
| Social post | Brand colors, logo placement, text overlay |
| Document | Letterhead, header, footer with logo |

6.5 Brand Guidelines Confirmation

Present compiled guidelines summary to user:

## Brand Guidelines Summary

I've compiled your brand guidelines covering:

✓ **Logo Usage** — Variations, clear space, minimum sizes, placement rules
✓ **Color Contexts** — Digital, print, social media, accessibility requirements
✓ **Font Pairing** — Approved combinations, hierarchy, sizing by context
✓ **Visual Identity** — Photography, iconography, spacing, graphic elements

Before I generate the final files, please confirm:
1. Do the logo usage rules match your needs?
2. Are the color usage contexts complete for your applications?
3. Do the font pairing rules align with your vision?
4. Any visual identity elements to add or modify?

Once approved, I'll generate:
- `./branding/brand-guidelines.md` — Complete brand guidelines
- `./branding/brand-summary.txt` — Executive summary
- `./branding/swatches/` — Visual color swatches

6.6 Iteration Handling

If user requests changes:

• "Need more contexts" → Add specific use cases (signage, merchandise, video)
• "Too restrictive" → Relax rules, provide more flexibility language
• "Not restrictive enough" → Add more specific don'ts and requirements
• "Missing [element]" → Add subsection for requested element

User approval required before proceeding to file generation (Tasks 8-10).

6.7 Markdown File Generation

After user approval in 6.5, generate ./branding/brand-guidelines.md using this template:

# [Brand Name] Brand Guidelines

*Version 1.0 | Generated [Date]*

---

## Table of Contents

1. [Brand Overview](#brand-overview)
2. [Logo Usage](#logo-usage)
3. [Color Palette](#color-palette)
4. [Typography](#typography)
5. [Visual Identity](#visual-identity)
6. [Application Guidelines](#application-guidelines)
7. [Quick Reference](#quick-reference)

---

## Brand Overview

### Brand Essence
[3-5 sentences summarizing brand personality, derived from Q4, Q5, Q6]

### Mission & Values
[From Q3 mission statement and core values]

### Brand Personality
| Trait | Description |
|-------|-------------|
| [Trait 1 from Q4] | How this manifests in brand expression |
| [Trait 2 from Q4] | How this manifests in brand expression |
| [Trait 3 from Q4] | How this manifests in brand expression |

### Target Audience
[Summary from Q7-Q9: ideal customer, where brand fits, problems solved]

---

## Logo Usage

### Primary Logo
[Insert logo or placeholder description]

### Logo Variations
| Variation | Use Case | File Name |
|-----------|----------|-----------|
| Full color | Primary use, light backgrounds | logo-full-color.svg |
| Reversed | Dark backgrounds | logo-reversed.svg |
| Monochrome | Single-color printing | logo-mono.svg |
| Icon only | Favicons, app icons, small spaces | logo-icon.svg |

### Clear Space
Minimum clear space equals the height of the logo mark on all sides.

![Clear space diagram placeholder]

### Minimum Sizes
| Format | Minimum Width |
|--------|---------------|
| Print | 1 inch (25mm) |
| Digital | 120px |
| Favicon | 32px (icon only) |

### Logo Placement by Context
| Context | Position | Size | Variation |
|---------|----------|------|-----------|
| Website header | Top-left | 40-60px height | Full color |
| Email signature | Bottom-left | 80-120px width | Full color |
| Social media profile | Center | Platform specs | Full color or icon |
| Business cards | Top-left or center | 0.75-1 inch | Full color |
| Presentations | Title slide center, footer | Per template | Full color |

### Logo Don'ts
- ❌ Do not stretch, distort, or rotate the logo
- ❌ Do not change logo colors outside approved palette
- ❌ Do not add effects (shadows, gradients, outlines)
- ❌ Do not place on busy backgrounds without sufficient contrast
- ❌ Do not recreate or redraw the logo
- ❌ Do not use outdated versions of the logo

---

## Color Palette

### Primary Colors
| Color | Hex | RGB | Role |
|-------|-----|-----|------|
| [Name] | #XXXXXX | rgb(X, X, X) | Primary brand color |
| [Name] | #XXXXXX | rgb(X, X, X) | Secondary brand color |

### Accent Colors
| Color | Hex | RGB | Role |
|-------|-----|-----|------|
| [Name] | #XXXXXX | rgb(X, X, X) | Call-to-action, emphasis |

### Neutral Colors
| Color | Hex | RGB | Role |
|-------|-----|-----|------|
| [Name] | #XXXXXX | rgb(X, X, X) | Backgrounds |
| [Name] | #XXXXXX | rgb(X, X, X) | Text |
| [Name] | #XXXXXX | rgb(X, X, X) | Borders |

### Color Hierarchy
| Role | Color | Usage Percentage |
|------|-------|------------------|
| Primary | [Primary color] | 60% of brand visuals |
| Secondary | [Secondary color] | 30% of brand visuals |
| Accent | [Accent color] | 10% for emphasis |

### Digital Color Usage
| Element | Color | Hex | Notes |
|---------|-------|-----|-------|
| Primary buttons | Primary | #XXXXXX | Call-to-action |
| Secondary buttons | Secondary | #XXXXXX | Less prominent actions |
| Links | Primary or Accent | #XXXXXX | Ensure contrast |
| Backgrounds | Light neutral | #XXXXXX | Main content areas |
| Headers/Footers | Dark neutral | #XXXXXX | Navigation, footer |
| Hover states | Primary (darkened 10%) | #XXXXXX | Interactive feedback |
| Error states | Red | #DC2626 | Form validation |
| Success states | Green | #16A34A | Confirmations |

### Print Color Usage
| Material | Primary | S

…(truncated)