whiteport-design-studio 0.1.0

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-example-empowerment-frame.md

@@ -0,0 +1,88 @@
+# Example: Badass Users Framework Applied to Hairdresser Newsletter
+
+**VTC Context:** Hairdresser newsletter signup
+
+**Empowerment Frame:**
+
+```yaml
+empowerment_frame:
+  transformation:
+    current_state:
+      description: "Harriet feels behind when clients ask about trends she hasn't heard of"
+      feelings: ["frustrated", "embarrassed", "uncertain"]
+      capabilities: "Can't confidently discuss latest trends with clients"
+
+    badass_state:
+      description: "Harriet is always ahead—clients see her as their beauty authority"
+      feelings: ["confident", "proud", "expert"]
+      capabilities: "Spots trends before competitors, impresses clients, leads conversations"
+
+    visibility: "2,000 stylists already there + 'Try it on next client Monday' = immediate, real path"
+
+  aha_moment:
+    insight: "Oh! I don't need to follow 100 accounts or read for hours—60 seconds on Monday morning is enough!"
+    why_powerful: "Removes the overwhelm barrier. Being ahead doesn't require massive effort—just smart curation."
+
+  capability_framing:
+    - feature: "AI analyzes 10,000 beauty sources weekly"
+      reframed: "You'll spot trends before your competitors even hear about them"
+
+    - feature: "Weekly email with 5 top trends"
+      reframed: "You'll always have something new and exciting to talk about with clients"
+
+    - feature: "60-second explainers for each trend"
+      reframed: "You'll understand trends fast enough to use them the same day"
+
+    - feature: "2,000 stylist subscribers"
+      reframed: "You'll join successful stylists who are already ahead"
+
+  cognitive_load:
+    potential_issues:
+      - issue: "Fear of email overload / another thing to manage"
+        solution: "Emphasize: 'Weekly, not daily' + '60 seconds' + 'Monday morning ritual'"
+
+      - issue: "Uncertainty about what trends are or how to use them"
+        solution: "'Client conversation starters included' = no guesswork"
+
+    simplifications:
+      - "Cut: Technical details about AI or sources (doesn't help capability)"
+      - "Cut: Company history (irrelevant to their transformation)"
+      - "Simplify: One clear CTA, not multiple options"
+
+  skill_focus:
+    primary_skill: "Staying ahead of beauty trends effortlessly"
+    supporting_skills:
+      - "Impressing clients with current knowledge"
+      - "Leading beauty conversations in their town"
+      - "Building authority and reputation"
+    tools_secondary: "Newsletter is the vehicle, but skill is what matters"
+```
+
+---
+
+## Key Transformations
+
+**Current → Badass:**
+- From: "Behind and embarrassed" → To: "Ahead and confident"
+- From: "Can't discuss trends" → To: "Leads trend conversations"
+- Path made real: 2,000 already there + immediate application
+
+**The Aha Moment:**
+"60 seconds is enough" - removes the massive barrier of thinking staying ahead requires hours of work
+
+**Feature → Capability Reframing:**
+- "AI analyzes sources" → "You'll spot trends first" (about THEM, not us)
+- "Weekly email" → "Always something new to discuss" (capability, not delivery)
+- "60-second explainers" → "Understand fast enough to use same day" (skill outcome)
+
+**Cognitive Load Reduction:**
+- Addressed fear of "another thing to manage" → "Weekly + 60 seconds + ritual"
+- Removed uncertainty → "Conversation starters included"
+- Cut all non-essential: company history, technical details, multiple CTAs
+
+**Skill Focus:**
+Primary skill is "staying ahead effortlessly" - not "using a newsletter"
+
+---
+
+_Example demonstrating Badass Users framework application for hairdresser newsletter_

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-example-golden-circle.md

@@ -0,0 +1,96 @@
+# Example: Golden Circle Applied to Hairdresser Newsletter
+
+**VTC Context:** Hairdresser newsletter signup
+
+**Structural Order:**
+
+```yaml
+structural_order:
+  section_why:
+    purpose: "Emotional connection—problem recognition and aspiration"
+    content_elements:
+      - order: 1
+        element: "Headline: 'Are Your Clients Asking About Trends You Haven't Heard Of?'"
+        rationale: "Opens with emotional pain point—immediate recognition"
+
+      - order: 2
+        element: "Subhead: 'Stop feeling behind. Become your town's go-to beauty authority.'"
+        rationale: "Validation (you're not alone) + aspiration (badass state)"
+
+      - order: 3
+        element: "Visual: Split image—uncertain hairdresser → confident trendsetter"
+        rationale: "Shows transformation visually, reinforces emotional journey"
+
+  section_how:
+    purpose: "Solution approach—how stylists stay ahead"
+    content_elements:
+      - order: 1
+        element: "Heading: 'Here's How Stylists Stay Ahead:'"
+        rationale: "Introduces solution category (trend newsletters) to Problem Aware users"
+
+      - order: 2
+        element: "Weekly trend alerts delivered Monday morning"
+        rationale: "Explains the method—simple, regular, manageable"
+
+      - order: 3
+        element: "60-second explainers—understand it fast"
+        rationale: "Key differentiator—reduces cognitive load fear"
+
+      - order: 4
+        element: "Client conversation starters included"
+        rationale: "Shows transformation path—immediate application"
+
+  section_what:
+    purpose: "Product naming, proof, and action"
+    content_elements:
+      - order: 1
+        element: "Heading: 'Join TrendWeek—Free for Stylists'"
+        rationale: "NOW we can name the product (moved to Product Aware)"
+
+      - order: 2
+        element: "2,000 stylists already ahead"
+        rationale: "Social proof builds credibility before ask"
+
+      - order: 3
+        element: "Button: 'Start Staying Ahead'"
+        rationale: "Capability-framed CTA (not 'sign up')"
+
+      - order: 4
+        element: "Subtext: 'Free. No credit card. Cancel anytime.'"
+        rationale: "Risk removal last—addresses final barrier"
+
+  flow_validation:
+    feels_natural: "Yes—emotion → method → specifics flows smoothly"
+    persuasive_arc: "WHY connects emotionally, HOW builds confidence, WHAT enables action without jumping too fast"
+```
+
+---
+
+## Analysis
+
+**WHY Section:**
+- Opens with emotional pain (problem recognition)
+- Validates feeling (not alone)
+- Shifts to aspiration (can become authority)
+- **Flow:** Problem → Validation → Aspiration
+
+**HOW Section:**
+- Introduces solution approach
+- Explains method (weekly delivery)
+- Shows differentiator (60-second format)
+- Demonstrates transformation path (conversation starters)
+- **Flow:** Introduction → Method → Differentiator → Application
+
+**WHAT Section:**
+- Names the product (now user is Product Aware)
+- Provides social proof (credibility)
+- Capability-framed CTA (action)
+- Removes risk (final barrier)
+- **Flow:** Naming → Proof → Action → Risk Removal
+
+**Persuasive Arc:**
+Emotion (WHY) → Method (HOW) → Specifics (WHAT) creates smooth journey from pain recognition to empowered action.
+
+---
+
+_Example demonstrating Golden Circle sequencing for hairdresser newsletter content_

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-golden-circle-guide.md

@@ -0,0 +1,160 @@
+# Golden Circle Framework Guide
+
+**Simon Sinek's WHY → HOW → WHAT model for persuasive content sequencing**
+
+---
+
+## The Golden Circle Model
+
+```
+    WHY (Core)
+     ↓
+    HOW (Process)
+     ↓
+    WHAT (Proof)
+```
+
+---
+
+## The Three Levels
+
+### WHY - The Purpose, Cause, Belief
+
+**Purpose:** Connect emotionally, establish motivation
+
+**Questions:**
+- Why does this matter?
+- Why should the user care?
+- What's the emotional truth?
+
+**Good WHY Examples:**
+- "Are your clients asking about trends you haven't heard of?" (emotional truth)
+- "You deserve to feel ahead, not behind" (aspiration)
+- "Every stylist feels this—you're not alone" (validation)
+
+**Bad WHY Examples:**
+- "Our company was founded in 2018" (not emotional)
+- "TrendWeek is a beauty newsletter" (WHAT, not WHY)
+- "Sign up now" (jumping to action without motivation)
+
+**Connects to:**
+- User's driving forces (from VTC)
+- Current emotional state (from Empowerment Frame)
+- The problem or aspiration that matters
+
+---
+
+### HOW - The Process, Approach, Differentiator
+
+**Purpose:** Bridge emotion to specifics, show the method
+
+**Questions:**
+- How does this work?
+- How do you do it differently?
+- What's the method?
+
+**Example HOW Content:**
+- "Here's how stylists stay ahead: Weekly trend alerts delivered Monday morning"
+- "60-second explainers—understand trends fast enough to use them same day"
+- "Client conversation starters included—no guesswork"
+
+**Connects to:**
+- Essential information (Action Filter)
+- Capability framing (Empowerment Frame)
+- The transformation path
+
+---
+
+### WHAT - The Tangible, Proof, Specifics
+
+**Purpose:** Provide concrete details and enable action
+
+**Questions:**
+- What exactly do you do/offer?
+- What are the features?
+- What's the concrete evidence?
+
+**Example WHAT Content:**
+- "Join TrendWeek—Free for Stylists"
+- "2,000 stylists already ahead"
+- "Start Staying Ahead" (CTA button)
+- "Free. Cancel anytime."
+
+**Includes:**
+- Specific features or offers
+- Tangible evidence
+- Social proof
+- The ask/action
+
+---
+
+## Key Insights
+
+**Start with WHY:**
+- People don't buy WHAT you do, they buy WHY you do it
+- Emotion drives decisions, logic justifies them
+- WHY creates connection before presenting solution
+
+**Bridge with HOW:**
+- HOW explains the approach that delivers on the WHY
+- Shows your unique method or differentiator
+- Builds confidence in the transformation
+
+**Prove with WHAT:**
+- WHAT provides concrete specifics after buy-in
+- Only effective after WHY and HOW establish context
+- Enables action with confidence
+
+---
+
+## Common Mistakes
+
+**Mistake #1: Starting with WHAT**
+- ❌ "TrendWeek is a weekly newsletter for hairdressers..."
+- ✅ "Are your clients asking about trends you haven't heard of?"
+
+**Mistake #2: Missing WHY**
+- Content feels cold and transactional
+- No emotional connection
+- Features without context
+
+**Mistake #3: WHAT before WHY**
+- Content feels salesy and pushy
+- User isn't ready to hear specifics
+- Premature call to action
+
+---
+
+## Sequencing Within Sections
+
+The Golden Circle is fractal—apply it at page level AND within each section:
+
+**WHY Section Micro-sequence:**
+1. Problem recognition (emotional hook)
+2. Validation (you're not alone)
+3. Aspiration (you can feel different)
+
+**HOW Section Micro-sequence:**
+1. Introduce solution approach
+2. Explain key differentiator
+3. Show transformation path
+
+**WHAT Section Micro-sequence:**
+1. Name the product/offer
+2. Social proof
+3. Clear CTA
+4. Risk removal
+
+---
+
+## Application Notes
+
+- The "aha moment" from Step 4 often lives in the HOW section (the insight that bridges emotion to action)
+- If WHAT comes before WHY, content feels salesy and pushy
+- If WHY is missing, content feels cold and transactional
+- This structure works for pages, sections, paragraphs, even sentences
+- The Golden Circle creates natural persuasive flow: emotion → method → specifics
+
+---
+
+_Golden Circle framework guide for Step 5 - Structural Order_

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-example-hairdresser-newsletter.md

@@ -0,0 +1,136 @@
+# Example: Hairdresser Newsletter Signup
+
+**VTC Context:** Hairdresser newsletter signup
+
+**Content Generations:**
+
+---
+
+## Variation A: Wish-Focused (Become the Authority)
+
+**Rationale:**
+Emphasizes the positive driving force: "Wish to be local beauty authority." This variation speaks to aspiration and confidence. Works best for users who are motivated by status and recognition.
+
+**Content:**
+
+**WHY Section:**
+- Headline: **"Become Your Town's Go-To Beauty Authority"**
+- Subhead: "The trends your clients are asking about? You'll spot them first."
+- Visual: Confident hairdresser surrounded by admiring clients
+
+**HOW Section:**
+- Heading: "Here's How Stylists Stay Ahead:"
+- Every Monday morning: Top 5 trends in your inbox
+- 60-second explainers—understand and apply the same day
+- Client conversation starters included—lead the discussion
+
+**WHAT Section:**
+- Heading: "Join 2,000 Stylists Who Are Already Ahead"
+- Button: **"Start Leading Trends"**
+- Subtext: "Free. No credit card. Cancel anytime."
+
+**Why This Might Resonate:**
+For hairdressers who are confident but want to level up. Aspirational tone matches their ambition.
+
+---
+
+## Variation B: Fear-Focused (Stop Falling Behind)
+
+**Rationale:**
+Addresses the negative driving force: "Fear of missing industry trends." This variation acknowledges the pain point directly. Works best for users feeling frustrated or embarrassed.
+
+**Content:**
+
+**WHY Section:**
+- Headline: **"Are Your Clients Asking About Trends You Haven't Heard Of?"**
+- Subhead: "Stop feeling behind. Never miss a trend again."
+- Visual: Split image—uncertain hairdresser → confident trendsetter
+
+**HOW Section:**
+- Heading: "Here's How to Never Miss a Trend:"
+- Weekly alerts delivered Monday morning—stay current effortlessly
+- 60-second reads—no time wasted
+- Client conversation starters—no more guesswork
+
+**WHAT Section:**
+- Heading: "Join TrendWeek—Free for Stylists"
+- "2,000 stylists already staying ahead"
+- Button: **"Stop Missing Out"**
+- Subtext: "Free. No credit card. Cancel anytime."
+
+**Why This Might Resonate:**
+For hairdressers actively experiencing the pain. Direct problem recognition creates immediate connection.
+
+---
+
+## Variation C: Balanced (Recognition + Aspiration)
+
+**Rationale:**
+Combines both driving forces naturally—opens with problem recognition (fear), bridges to aspiration (wish). Works for most users by meeting them where they are and showing where they can go.
+
+**Content:**
+
+**WHY Section:**
+- Headline: **"Your Clients Are Asking. You Should Be Leading."**
+- Subhead: "Stop playing catch-up. Become the trendsetter your town needs."
+- Visual: Transformation sequence—uncertain → confident → authority
+
+**HOW Section:**
+- Heading: "Here's How Stylists Go From Behind to Ahead:"
+- Monday mornings: Top 5 trends delivered to your inbox
+- 60 seconds per trend—fast enough to use the same day
+- Conversation starters included—turn knowledge into client impact
+
+**WHAT Section:**
+- Heading: "Join TrendWeek—Free for Stylists"
+- "2,000 stylists made the shift. Your turn."
+- Button: **"Start Staying Ahead"**
+- Subtext: "Free. No credit card. Cancel anytime."
+
+**Why This Might Resonate:**
+Balanced approach works broadly. Acknowledges pain without dwelling, focuses on transformation.
+
+---
+
+## Refinement Process
+
+**User selects:** "I like Variation B's headline and opening, but prefer Variation C's HOW section and Variation A's CTA framing."
+
+**Agent refines and combines:**
+
+---
+
+## FINAL CONTENT
+
+**WHY Section:**
+- Headline: **"Are Your Clients Asking About Trends You Haven't Heard Of?"**
+- Subhead: "Stop feeling behind. Become your town's go-to beauty authority."
+- Visual: Split image—uncertain hairdresser → confident trendsetter
+
+**HOW Section:**
+- Heading: "Here's How Stylists Go From Behind to Ahead:"
+- Monday mornings: Top 5 trends delivered
+- 60 seconds per trend—fast enough to use the same day
+- Conversation starters included—lead the discussion
+
+**WHAT Section:**
+- Heading: "Join TrendWeek—Free for Stylists"
+- "2,000 stylists already ahead"
+- Button: **"Start Leading Trends"**
+- Subtext: "Free. No credit card. Cancel anytime."
+
+---
+
+**Strategic Traceability:**
+
+- **Business Goal:** Increase newsletter signups
+- **Driving Forces Addressed:**
+  - Fear: Missing industry trends (opening headline)
+  - Wish: Be local beauty authority (subhead, CTA)
+- **Awareness Journey:** Problem Aware → Solution Aware (recognizes problem, sees how to solve it)
+- **Action Enabled:** Sign up for free newsletter
+- **Empowerment Achieved:** "You'll be able to lead trends" (not just follow)
+
+---
+
+_Example demonstrating how variations combine strategic context into final content_

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-generation-instructions.md

@@ -0,0 +1,95 @@
+# Content Generation Instructions
+
+**How to generate strategically grounded content variations**
+
+---
+
+## 1. Synthesize All Context
+
+Before generating, review and confirm you understand:
+- [ ] WHO the user is and what drives them (VTC)
+- [ ] WHERE they are in awareness (START → END)
+- [ ] WHAT action this content must enable (Action Filter)
+- [ ] HOW to make them feel capable (Empowerment Frame)
+- [ ] WHAT order creates persuasive flow (Golden Circle)
+
+---
+
+## 2. Generate Multiple Variations
+
+Create **2-3 content variations** that differ in:
+
+**Variation A: Wish-Focused**
+- Emphasizes positive driving forces
+- Aspirational tone
+- "Become the authority," "Stay ahead," "Impress your clients"
+
+**Variation B: Fear-Focused**
+- Addresses negative driving forces
+- Problem-recognition tone
+- "Stop feeling behind," "Never miss a trend," "No more embarrassment"
+
+**Variation C: Balanced OR Awareness-Shifted** (choose one):
+- **Balanced:** Combines wish + fear naturally
+- **Awareness-Shifted:** Uses different starting awareness level (if user was uncertain)
+
+**For each variation, include:**
+- Complete content (headlines, body, CTA)
+- Rationale explaining the approach
+- Why this might resonate
+
+---
+
+## 3. Presentation Format
+
+Use this format:
+
+```markdown
+---
+
+## Variation A: [Name - e.g., "Wish-Focused"]
+
+### Rationale
+[Why this approach, what driving force it emphasizes, when this works best]
+
+### Content
+
+**WHY Section:**
+[Content for WHY]
+
+**HOW Section:**
+[Content for HOW]
+
+**WHAT Section:**
+[Content for WHAT]
+
+### Why This Might Resonate
+[Specific user insight or context that makes this effective]
+
+---
+
+## Variation B: [Name]
+[Same structure]
+
+---
+
+## Variation C: [Name]
+[Same structure]
+
+---
+```
+
+---
+
+## 4. Explain Strategic Choices
+
+For each variation, show how you applied the strategic context:
+- "This opens with [X] because the user is Problem Aware—they need problem validation first"
+- "This uses 'you'll be able to' framing because of Badass Users principle"
+- "This puts social proof before CTA because Action Filter identified trust as a barrier"
+
+**Make the strategy visible.**
+
+---
+
+_Reference for generating content variations in Step 6_

package/src/workflows/shared/content-creation-workshop/steps-c/workflow.md

@@ -0,0 +1,41 @@
+# Content Creation Workshop - Sequential Workflow
+
+**⚠️ ALPHA - First real-world usage pending. Please provide feedback after use.**
+
+---
+
+## Instructions for Agents
+
+**Execute these steps ONE AT A TIME, in sequence.**
+
+**Do not look ahead. Do not skip. Do not summarize.**
+
+Each step builds on the previous. Complete validation before proceeding.
+
+---
+
+## Step Sequence
+
+**Start here:** [Step 1: Load VTC Context](step-01-load-vtc-context.md)
+
+After completing Step 1, proceed to Step 2.
+After completing Step 2, proceed to Step 3.
+Continue sequentially through all 6 steps.
+
+---
+
+## Workshop Steps
+
+1. **Load VTC Context** → Establish strategic foundation
+2. **Apply Customer Awareness Strategy** → Determine language & information priorities
+3. **Define Required Action** → Filter for relevance
+4. **Frame User Empowerment** → Set tone and transformation narrative
+5. **Determine Structural Order** → Sequence content for persuasion
+6. **Generate & Review Content** → Create options and select
+
+---
+
+**Total Duration:** 15-25 minutes
+
+**Begin:** [Step 1: Load VTC Context](step-01-load-vtc-context.md)
+