brand-voice-generator

# Brand Voice Generator v3

Transform brand inputs into actionable voice profiles — from a quick-reference identity card to a comprehensive content creation playbook.

## Two Output Tiers

| | Brand Voice Card | Brand Voice Playbook |
|---|---|---|
| **What it is** | 1-2 page identity profile | 20-40 page content creation handbook |
| **Who it's for** | Teams needing a quick voice reference; input for other skills | Content creators, AI agents, and marketing teams producing on-brand content across channels |
| **What it enables** | "Here's who the brand is" | "Here's exactly how to write as the brand across every channel" |
| **Time to generate** | Single response | Multi-step (research → draft → refine) |
| **Input requirements** | Brand description OR 3-5 examples OR 1 URL | Card inputs PLUS web research OR 15+ examples across 3+ channels |

The Card is always generated first. The Playbook builds on it.

---

## Workflow Overview

**Steps 1-6: Brand Voice Card** (always executed)

1. **Gather inputs** — Collect brand examples, URLs, or descriptions
2. **Classify archetype** — Identify brand type + engagement style
3. **Confirm approach** — Present plan, ask Card or Playbook, get approval
4. **Analyze with framework** — Apply archetype-specific analysis
5. **Generate Card** — Output structured voice profile
6. **Validate Card** — Confirm accuracy with user

**Steps 7-9: Brand Voice Playbook** (only if selected)

7. **Deep research** — Gather 20+ real examples across channels
8. **Generate Playbook** — Produce 10-11 sections as a document
9. **Validate Playbook** — Present for section-level refinement

---

## Step 1: Gather Brand Inputs

Request one or more input types:

**Content Examples** (8+ recommended for Card, 15+ for Playbook)
- Marketing copy, website text, emails, social posts
- Headlines, taglines, product descriptions
- Customer stories, case studies

**Website URLs**
- Use web_fetch to retrieve content from provided URLs
- Focus on homepage, about page, product pages, blog, customer stories

**Brand Descriptions**
- Written personality, values, target audience
- Existing guidelines or positioning statements

**Prompt template:**
> To generate your brand voice profile, please provide at least one of:
> - **Content examples**: 8+ pieces of on-brand content (15+ for a full Playbook)
> - **Website links**: URLs representing your brand voice
> - **Brand descriptions**: Personality, values, or target audience details

## Step 2: Classify Brand Archetype

Analyze inputs to identify the primary archetype. Look for signals:

| Archetype | Key Signals |
|-----------|-------------|
| **B2B Tech** | Feature-benefit language, ROI focus, enterprise terms, integration mentions |
| **Challenger/Disruptor** | "Unlike others...", enemy framing, urgency, contrarian claims, temporal authority |
| **Luxury/Premium** | Scarcity language, heritage references, sensory descriptors, understated confidence |
| **DTC/E-commerce** | Lifestyle framing, social proof, urgency/scarcity, benefit-first headlines |
| **Founder/Personal** | First-person narrative, vulnerability, teaching through story, strong POV |
| **Community-First** | Collective "we", member stories, movement language, belonging emphasis |
| **Healthcare/Regulated** | Trust signaling, compliance awareness, credentialed authority, empathy + precision |
| **Professional Services** | Credentialed expertise, relationship language, thought leadership, client-centric framing |
| **Mission-Driven / Social Impact** | Purpose-over-product, impact metrics, activism language, moral authority |
| **Financial Services / FinTech** | Trust + innovation tension, regulatory awareness, security signals, simplification of complexity |
| **Education / Knowledge** | Authority + encouragement, progress language, scaffolded complexity, coach register |
| **Marketplace / Platform** | Two-sided messaging, neutrality, trust arbitration, platform-as-enabler positioning |

Also classify the **Engagement Style**:
- **Directive**: "Do this..." — commands, instructions, clear imperatives
- **Invitational**: "Consider..." — suggestions, possibilities, soft guidance
- **Collaborative**: "Let's..." — partnership, shared journey, co-creation
- **Informational**: "Here's what..." — facts, data, neutral presentation

**If signals are ambiguous**, ask the user:
> Based on your inputs, I see elements of [Archetype A] and [Archetype B]. Which best describes your brand?
> - **[Archetype A]**: [brief description]
> - **[Archetype B]**: [brief description]
> - **Hybrid**: Combine both frameworks

## Step 3: Confirm Approach (REQUIRED)

**ALWAYS present the analysis plan and wait for user confirmation before proceeding.**

```
## Voice Generation Plan

**Brand Name:** [Name]

**Detected Archetype:** [Primary Archetype] (+ [Secondary] if hybrid)
[1-2 sentence explanation of why this archetype fits]

**Engagement Style:** [Directive / Invitational / Collaborative / Informational]
[1 sentence justification]

**Analysis Framework:** I'll analyze your brand using the [Archetype] framework, focusing on:
- [Key dimension 1]
- [Key dimension 2]
- [Key dimension 3]

**Inputs I'll Analyze:**
- [List of content examples / URLs / descriptions provided]

**Output Tier:**
Would you like:
- **Brand Voice Card** — Quick 1-2 page identity profile (good for reference and as input to other tools)
- **Brand Voice Playbook** — Comprehensive 20-40 page content creation handbook (includes headline patterns, CTA catalog, audience adaptations, few-shot examples, and more)

[If Playbook: I'll need to research your brand's content across channels. I can do this via web research if you provide URLs, or you can supply 15+ content examples across 3+ content types.]

**Reply with your preferred output tier to proceed.**
```

**Wait for explicit confirmation before proceeding to Step 4.**

## Step 4: Analyze with Archetype Framework

Load the appropriate framework from `references/frameworks/`:

| Archetype | Framework File |
|-----------|---------------|
| B2B Tech | `references/frameworks/b2b-tech.md` |
| Challenger/Disruptor | `references/frameworks/challenger.md` |
| Luxury/Premium | `references/frameworks/luxury.md` |
| DTC/E-commerce | `references/frameworks/dtc-ecommerce.md` |
| Founder/Personal | `references/frameworks/founder-personal.md` |
| Community-First | `references/frameworks/community.md` |
| Healthcare/Regulated | `references/frameworks/healthcare.md` |
| Professional Services | `references/frameworks/professional-services.md` |
| Mission-Driven / Social Impact | `references/frameworks/mission-driven.md` |
| Financial Services / FinTech | `references/frameworks/financial-services.md` |
| Education / Knowledge | `references/frameworks/education.md` |
| Marketplace / Platform | `references/frameworks/marketplace.md` |

For **hybrid archetypes**, load both frameworks and blend dimensions.

Apply the framework's analysis dimensions to all inputs, extracting:
- Voice attributes specific to the archetype
- Values signaled through language patterns
- Distinctive phrases and terminology
- Tone indicators and emotional register
- Buyer journey voice shifts
- Engagement style patterns

## Step 5: Generate Card

Use the output template from `references/output-template.md`.

**Standard sections (all archetypes):**
- Name + Archetype classification with rationale
- Engagement Style label with justification
- Description (3 attributes + personality + communication style)
- Core Values (3-4 with manifestations)
- Replication Guidelines (5-7 actionable instructions)
- Representative Excerpts (4-6 examples)
- Buyer Journey Voice Notes (awareness / consideration / decision)
- Archetype-specific additions

## Step 6: Validate Card

After presenting the Card, ask:
> Does this voice profile accurately capture your brand? I can:
> - Adjust specific attributes
> - Shift archetype blend
> - Regenerate excerpts for different content types
> - Expand any section
>
> [If Playbook was selected]: Once you approve the Card, I'll proceed to deep research and Playbook generation.

**If Card-only was selected, stop here.**

---

## Step 7: Deep Research (Playbook Only)

**Goal:** Gather 20+ real examples across 3+ content types to extract patterns.

**If user provided URLs:**
Use web_fetch to research:
- Homepage (headline patterns, hero copy, value propositions)
- Product/feature pages (benefit framing, technical depth)
- Blog posts (2-3 posts — narrative structure, opening hooks, CTA patterns)
- Customer stories/case studies (proof integration, storytelling structure)
- Social media (tone variation, audience engagement)
- About/company page (values, mission language)

**If user provided 15+ examples:**
Organize by content type and analyze pattern clusters.

**If insufficient material:**
Ask:
> To build a comprehensive Playbook, I need to see the brand across multiple channels. Could you provide:
> - **Website URL** — I'll research homepage, blog, customer stories, and product pages
> - **Additional content** — Emails, social posts, ads, or other content types
> - **Both** — URL for research + content you want to ensure I capture

**Extract and catalog:**
- 4-6 headline/hook examples with pattern labels
- 3-5 CTA examples across intensity levels
- Vocabulary preferences (recurring words, avoided words)
- Sentence length and rhythm patterns
- 3-5 proof/evidence integration examples
- Tone variation across channels
- Audience-specific language differences

## Step 8: Generate Playbook

Generate the Playbook as a `.docx` document using the docx skill. Read `references/playbook-output-template.md` for the master document structure.

The Playbook contains 10-11 sections organized in three groups. Read the section template for each before generating:

**Group A — Content Patterns**

| Section | Template File | What It Produces |
|---------|--------------|-----------------|
| P1: Vocabulary Rules | `references/playbook-sections/vocabulary-rules.md` | Preferred words, banned words, brand terminology, verb patterns |
| P2: Sentence Cadence | `references/playbook-sections/sentence-cadence.md` | Rhythm patterns, structural formulas, punctuation habits |
| P3: Headline & Hook Patterns | `references/playbook-sections/headline-patterns.md` | 4-6 named patterns with formulas and real examples |
| P4: CTA Language Catalog | `references/playbook-sections/cta-catalog.md` | Tiered CTA system with never/always rules |
| P5: Proof & Evidence Integration | `references/playbook-sections/proof-integration.md` | 3-4 patterns for weaving metrics, quotes, social proof |

**Group B — Channel & Audience Calibration**

| Section | Template File | What It Produces |
|---------|--------------|-----------------|
| P6: Emotional Register Spectrum | `references/playbook-sections/emotional-register.md` | 1-10 numerical scale mapped to channels with shift rules |
| P7: Audience-Specific Adaptations | `references/playbook-sections/audience-adaptations.md` | 3-5 personas with vocabulary, emphasis, proof points |
| P8: Buyer Journey Voice Map | `references/playbook-sections/buyer-journey.md` | Voice shifts across awareness → consideration → decision |

**Group C — Generation Reference**

| Section | Template File | What It Produces |
|---------|--------------|-----------------|
| P9: Few-Shot Example Pairs | `references/playbook-sections/few-shot-examples.md` | 4-6 complete brief→output demonstrations |
| P10: Narrative Arc Patterns | `references/playbook-sections/narrative-arcs.md` | 2-4 complete story structures |
| P11: Visual-to-Copy Relationship | `references/playbook-sections/visual-copy.md` | Visual-copy pairing principles (conditional — only if brand has visual content) |

**For each section:**
1. Read the section template file
2. Apply the archetype's Playbook Dimensions (found in each framework file)
3. Ground patterns in real examples from Step 7
4. Generate section content
5. Check against quality criteria in the template

**Use the archetype framework's "Playbook Dimensions" section** for archetype-specific guidance on each playbook section.

## Step 9: Validate Playbook

Present the completed Playbook document and offer:
> Your Brand Voice Playbook is ready. You can:
> - Request changes to any specific section
> - Add more examples to the Few-Shot section
> - Adjust audience personas
> - Add or remove channels from the Emotional Register
> - Request a Visual-to-Copy section if not included
> - Export in a different format

---

## Reference Files

### Core
- `references/output-template.md` — Card output format
- `references/playbook-output-template.md` — Playbook document structure
- `references/voice-analysis-core.md` — Universal analysis dimensions
- `references/voice-analysis-framework.md` — Detailed analytical criteria
- `references/example-outputs.md` — Complete Card examples
- `references/playbook-example.md` — Condensed Playbook example

### Archetype Frameworks (each includes Playbook Dimensions)
- `references/frameworks/b2b-tech.md`
- `references/frameworks/challenger.md`
- `references/frameworks/luxury.md`
- `references/frameworks/dtc-ecommerce.md`
- `references/frameworks/founder-personal.md`
- `references/frameworks/community.md`
- `references/frameworks/healthcare.md`
- `references/frameworks/professional-services.md`
- `references/frameworks/mission-driven.md`
- `references/frameworks/financial-services.md`
- `references/frameworks/education.md`
- `references/frameworks/marketplace.md`

### Playbook Section Templates
- `references/playbook-sections/vocabulary-rules.md`
- `references/playbook-sections/sentence-cadence.md`
- `references/playbook-sections/headline-patterns.md`
- `references/playbook-sections/cta-catalog.md`
- `references/playbook-sections/proof-integration.md`
- `references/playbook-sections/emotional-register.md`
- `references/playbook-sections/audience-adaptations.md`
- `references/playbook-sections/buyer-journey.md`
- `references/playbook-sections/few-shot-examples.md`
- `references/playbook-sections/narrative-arcs.md`
- `references/playbook-sections/visual-copy.md`