brand-voice-generator

# Brand Voice Generator

Transform brand inputs into comprehensive, archetype-aware voice profiles.

## Workflow Overview

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

## Step 1: Gather Brand Inputs

Request one or more input types:

**Content Examples** (8+ recommended)
- Marketing copy, website text, emails, social posts
- Headlines, taglines, product descriptions

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

**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
> - **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 |

**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.**

Present a confirmation summary:

```
## Voice Generation Plan

**Brand Name:** [Name]

**Detected Archetype:** [Primary Archetype]
[1-2 sentence explanation of why this archetype fits]

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

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

**Output You'll Receive:**
- Voice description (3 primary attributes + personality)
- Core values (3-4 with manifestation descriptions)
- Replication guidelines (5-7 actionable instructions)
- Representative excerpts (4-6 original examples)
- [Archetype-specific sections if applicable]

**Does this approach look right? Reply "yes" to proceed, or let me know if you'd like to adjust the archetype or focus areas.**
```

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

## Step 4: Analyze with Archetype Framework

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

- **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`

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

## Step 5: Generate Voice Profile

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

Standard sections (all archetypes):
- Name
- Description (3 attributes + personality + communication style)
- Core Values (3-4 with manifestations)
- Replication Guidelines (5-7 actionable instructions)
- Representative Excerpts (4-6 examples)

Archetype-specific sections (add when relevant):
- **Challenger**: Enemy/contrast positioning, proof point patterns
- **Founder**: Narrative arc structure, vulnerability patterns
- **Luxury**: Exclusivity signals, sensory language guide
- **DTC**: Conversion copy patterns, urgency calibration
- **Community**: Collective voice guide, member story integration
- **Healthcare**: Compliance-safe patterns, trust signaling guide

## Step 6: Validate with User

After presenting the profile, ask:
> Does this voice profile accurately capture your brand? I can:
> - Adjust specific attributes (e.g., "make it more playful")
> - Shift archetype blend (e.g., "add more challenger elements")
> - Regenerate excerpts for different content types
> - Expand any section with more detail

## Reference Files

- `references/frameworks/` — Archetype-specific analysis frameworks
- `references/output-template.md` — Standard output format
- `references/example-outputs.md` — Complete profile examples
- `references/voice-analysis-core.md` — Universal analysis dimensions