whiteport-design-studio 0.1.0

package/src/workflows/shared/content-creation-workshop/steps-c/step-06-generate-content.md

@@ -0,0 +1,247 @@
+# Step 6: Generate & Review Content
+
+**Create content options and select the final version**
+
+---
+
+## Purpose
+
+This is where the strategic work from Steps 1-5 becomes actual content. The agent generates 2-3 variations based on all the strategic context, and you select or combine them into the final version.
+
+---
+
+## Duration
+
+⏱️ **5-10 minutes**
+
+---
+
+## The Single Task
+
+**Generate strategically grounded content variations → User selects/combines → Finalize**
+
+---
+
+## Context from Previous Steps
+
+**Step 1 - VTC Context:**
+- Business goal, solution, user, driving forces, customer awareness
+
+**Step 2 - Awareness Strategy:**
+- Language guidelines, information priorities, emotional journey
+
+**Step 3 - Action Filter:**
+- Required action, essential information, barriers to address
+
+**Step 4 - Empowerment Frame:**
+- Transformation (current → badass), "aha moment," capability framing
+
+**Step 5 - Structural Order:**
+- WHY-HOW-WHAT sequence, content mapped to sections
+
+---
+
+## Agent Instructions
+
+### Generation Process
+
+**Reference:** See [substeps/06-generation-instructions.md](substeps/06-generation-instructions.md) for detailed instructions on:
+1. Synthesizing all context
+2. Generating 2-3 variations (wish-focused, fear-focused, balanced)
+3. Presentation format
+4. Explaining strategic choices
+
+**Key Point:** Generate variations that differ in which driving forces they emphasize, then let user select or combine.
+
+---
+
+## Questions for the User
+
+### 1. Initial Reaction
+
+**"Which variation resonates most with you?"**
+
+- Variation A (wish-focused)?
+- Variation B (fear-focused)?
+- Variation C (balanced/awareness-shifted)?
+- Combination of elements?
+
+### 2. Alignment Check
+
+**"Does this feel aligned with the strategic context?"**
+
+- Does it serve the VTC's business goal?
+- Does it speak to the user's driving forces?
+- Does it meet them at their awareness level?
+- Does it enable the required action?
+- Does it frame around capability?
+- Does it follow WHY → HOW → WHAT?
+
+### 3. Refinement
+
+**"What would you adjust or combine?"**
+
+- Headline from A, but body from B?
+- Stronger emphasis on X?
+- Softer tone on Y?
+- Add/remove specific element?
+
+### 4. Missing Anything?
+
+**"Is anything missing that we identified in previous steps?"**
+
+Check against:
+- Essential information (Step 3)
+- Barriers to address (Step 3)
+- "Aha moment" (Step 4)
+- Cognitive load reductions (Step 4)
+
+### 5. Awareness Journey Validation
+
+**"Does this move the user from START → END awareness?"**
+
+- At START, can they understand the opening?
+- By END, have they reached the target awareness level?
+- Is the journey smooth or jarring?
+
+---
+
+## Agent Actions
+
+1. **Generate 2-3 variations** with clear rationale (see generation instructions)
+2. **Present them** using the structured format
+3. **Explain strategic choices** for each
+4. **Guide refinement** based on user feedback
+5. **Finalize content** incorporating adjustments
+6. **Document** final version with strategic traceability
+
+---
+
+## Validation
+
+Before considering this workshop complete:
+
+- [ ] Multiple variations generated (2-3 options)
+- [ ] Each variation has clear rationale
+- [ ] Strategic choices are explained and visible
+- [ ] User has reviewed and selected/combined approach
+- [ ] Final content aligns with all strategic context (Steps 1-5)
+- [ ] Required action is enabled
+- [ ] Awareness journey is smooth (START → END)
+- [ ] User feels confident about the content
+
+---
+
+## Output Format
+
+**Final Content Document:**
+
+```yaml
+content_generation:
+  variations_presented:
+    - name: "[Variation A name]"
+      approach: "[Wish-focused/Fear-focused/Balanced]"
+      rationale: "[Why this approach]"
+      content: |
+        [Full content for Variation A]
+
+    - name: "[Variation B name]"
+      approach: "[Approach type]"
+      rationale: "[Why this approach]"
+      content: |
+        [Full content for Variation B]
+
+    - name: "[Variation C name]"
+      approach: "[Approach type]"
+      rationale: "[Why this approach]"
+      content: |
+        [Full content for Variation C]
+
+  selection:
+    chosen: "[Which variation or combination]"
+    reasoning: "[Why user selected this]"
+    adjustments: "[Any refinements made]"
+
+  final_content:
+    section_why: |
+      [Final WHY content]
+
+    section_how: |
+      [Final HOW content]
+
+    section_what: |
+      [Final WHAT content]
+
+  strategic_traceability:
+    vtc_reference: "[Link or reference to VTC]"
+    serves_business_goal: "[How content drives goal]"
+    addresses_driving_forces: "[Which forces and how]"
+    awareness_journey: "[START → END validated]"
+    action_enabled: "[What user can now do]"
+    empowerment_achieved: "[How user feels capable]"
+
+  implementation_notes:
+    - "[Any technical or design notes for implementation]"
+    - "[Language tags if multi-language]"
+    - "[Asset needs: images, videos, etc.]"
+```
+
+---
+
+## Complete Workshop Output
+
+**Save everything together:**
+
+Use the template: `content-output.template.md`
+
+This creates a complete record:
+1. VTC Context (Step 1)
+2. Awareness Strategy (Step 2)
+3. Action Filter (Step 3)
+4. Empowerment Frame (Step 4)
+5. Structural Order (Step 5)
+6. Content Generation (Step 6)
+
+**Result:** Strategically grounded content with full traceability.
+
+---
+
+## Example
+
+**See:** [substeps/06-example-hairdresser-newsletter.md](substeps/06-example-hairdresser-newsletter.md)
+
+This shows a complete example of:
+- Three variations (wish-focused, fear-focused, balanced)
+- User selection and combination
+- Final content with strategic traceability
+
+---
+
+## Workshop Complete! 🎉
+
+**You now have:**
+- Strategically grounded content
+- Full traceability to business goals and user psychology
+- Content that serves a clear action
+- Empowering, capability-focused framing
+- Persuasive WHY → HOW → WHAT structure
+
+**Next Steps:**
+- Implement content in design/development
+- Test with real users
+- Iterate based on performance
+- Apply this workshop to next content section
+
+---
+
+## Notes
+
+- Variations are not drafts—they're strategic alternatives
+- User may prefer different elements from different variations—that's expected
+- If no variation feels right, loop back to check strategic context (Steps 1-5)
+- The strategic traceability document is crucial—don't skip it
+- This is content creation as strategic craft, not guesswork
+
+---
+
+**⚠️ ALPHA:** Was this final step satisfying? Did variations help or confuse? How was the refinement process? Feedback critical for improvement.

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/00-purpose-examples.md

@@ -0,0 +1,131 @@
+# Content Purpose Examples
+
+**Three examples demonstrating how to define clear, testable content purpose**
+
+---
+
+## Example 1: Landing Page Hero
+
+```yaml
+content_purpose:
+  content_type: "Landing page hero section"
+
+  purpose_statement: "Hook Problem Aware hairdressers by validating their frustration and promising transformation"
+
+  audience:
+    who: "Harriet (hairdresser, ambitious, small-town)"
+    state: "Problem Aware - feels behind when clients ask about trends"
+    context: "Landing on site from Google search or Instagram ad"
+
+  success_criteria:
+    - "User immediately recognizes themselves in the problem"
+    - "User feels validated, not alone"
+    - "User wants to continue reading (doesn't bounce)"
+
+  model_priorities:
+    primary: ["Customer Awareness ⭐⭐⭐", "Golden Circle ⭐⭐⭐"]
+    secondary: ["Badass Users ⭐⭐", "VTC ⭐⭐"]
+    tertiary: ["Action Mapping ⭐"]
+
+  review_question: "Does a Problem Aware hairdresser feel seen and want to learn more?"
+```
+
+**Analysis:**
+- **Specific audience state:** Problem Aware (not just "hairdressers")
+- **Measurable outcome:** "Recognizes themselves" and "doesn't bounce"
+- **Model priority:** Customer Awareness and Golden Circle emphasized for landing page hook
+- **Testable:** Can observe if users recognize themselves and continue reading
+
+---
+
+## Example 2: Error Message
+
+```yaml
+content_purpose:
+  content_type: "Form validation error message"
+
+  purpose_statement: "Help user fix invalid email while maintaining confidence and reducing frustration"
+
+  audience:
+    who: "New user attempting signup"
+    state: "Frustrated - made a typo, wants to fix it quickly"
+    context: "Just clicked submit and saw error"
+
+  success_criteria:
+    - "User understands what's wrong"
+    - "User knows exactly how to fix it"
+    - "User doesn't feel stupid or blamed"
+    - "User successfully resubmits"
+
+  model_priorities:
+    primary: ["Badass Users ⭐⭐⭐", "Action Mapping ⭐⭐⭐"]
+    secondary: ["Customer Awareness ⭐"]
+    tertiary: ["Golden Circle ⭐", "VTC ⭐"]
+
+  review_question: "Can user fix error quickly without feeling frustrated?"
+```
+
+**Analysis:**
+- **Emotional state:** Frustrated (critical for error messages)
+- **Dual focus:** Fix problem AND maintain confidence
+- **Model priority:** Badass Users and Action Mapping for functional content
+- **Testable:** Can measure successful resubmission and user sentiment
+
+---
+
+## Example 3: Product Comparison Feature
+
+```yaml
+content_purpose:
+  content_type: "Shelf life comparison row in feature table"
+
+  purpose_statement: "Convince value-conscious users that 3x longer shelf life saves them money and hassle"
+
+  audience:
+    who: "Product Aware users comparing us to competitors"
+    state: "Evaluating features, looking for differentiators"
+    context: "In active comparison mode, possibly has competitor tab open"
+
+  success_criteria:
+    - "User understands the 3x advantage"
+    - "User connects longer shelf life to personal benefit (saves money/waste)"
+    - "User sees this as competitive advantage worth paying for"
+
+  model_priorities:
+    primary: ["VTC ⭐⭐⭐", "Badass Users ⭐⭐"]
+    secondary: ["Action Mapping ⭐⭐", "Customer Awareness ⭐"]
+    tertiary: ["Golden Circle ⭐"]
+
+  review_question: "Does user see 3x shelf life as a compelling reason to choose us?"
+```
+
+**Analysis:**
+- **Comparison context:** User actively evaluating competitors
+- **Value connection:** Not just "3x longer" but "saves money/hassle"
+- **Model priority:** VTC emphasized for understanding driving forces
+- **Testable:** Can assess if users understand and value the advantage
+
+---
+
+## Quick Reference: Purpose Templates
+
+**Persuasion:**
+- "Convince [audience] that [claim] by [strategy]"
+- "Activate [driving force] through [benefit/proof]"
+- "Move [start awareness] to [end awareness] by [approach]"
+
+**Education:**
+- "Enable [user] to [action] with [confidence level]"
+- "Help [user] understand [concept] in [timeframe]"
+
+**Functional:**
+- "Guide [user] to [action] with zero [friction]"
+- "Maintain [emotion] while [outcome]"
+
+**Brand:**
+- "Connect [audience] to our [value]"
+- "Inspire [emotion] through [story]"
+
+---
+
+_Examples demonstrating content purpose definition across different content types_

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/03-action-filter-example.md

@@ -0,0 +1,97 @@
+# Action Filter Example: Hairdresser Newsletter
+
+**VTC Context:** Hairdresser newsletter signup
+
+**Action Filter:**
+
+```yaml
+action_filter:
+  required_action:
+    description: "Click the 'Start Staying Ahead' button to begin email signup"
+    success_criteria: "User clicks with confidence, clear on what they'll get"
+
+  business_impact:
+    connection: "Email capture drives 500 newsletter signups goal"
+    logic: "Click button → Enter email → Confirm subscription → New subscriber"
+
+  user_motivation:
+    positive_driver: "Satisfies wish to 'be local beauty authority' by getting trend info"
+    negative_driver: "Addresses fear of 'missing industry trends' with regular updates"
+
+  essential_information:
+    - "WHAT they'll get: Weekly trend alerts (enables confident click)"
+    - "HOW OFTEN: Every Monday (sets expectation, reduces uncertainty)"
+    - "TIME INVESTMENT: 60 seconds per trend (shows it's manageable)"
+    - "SOCIAL PROOF: 2,000 stylists (reduces risk, builds trust)"
+    - "COMMITMENT LEVEL: Free, cancel anytime (removes fear barrier)"
+
+  cut_list:
+    - "Company founding story (doesn't enable signup action)"
+    - "Technical newsletter platform details (irrelevant to action)"
+    - "Full team bios (nice but doesn't reduce barriers)"
+
+  action_barriers:
+    - barrier: "Fear of email overload"
+      solution: "Weekly (not daily), 60-second reads, unsubscribe anytime"
+    - barrier: "Uncertainty about value"
+      solution: "Specific: 'Top 5 trends' + testimonial about client reactions"
+    - barrier: "Distrust of free offers"
+      solution: "2,000 stylists already using it (social proof)"
+```
+
+---
+
+## Analysis
+
+**Required Action:**
+"Click signup button with confidence" - specific, observable behavior
+
+**Business Connection:**
+Click → Email capture → Subscription → 500 signups goal
+
+**User Motivation:**
+- Wish: "Be beauty authority" → Gets trend info
+- Fear: "Miss trends" → Regular updates
+
+**Essential Information (5 elements):**
+All focused on enabling confident click by addressing barriers:
+1. What: Weekly trend alerts (clarifies offering)
+2. When: Every Monday (sets expectation)
+3. Time: 60 seconds (shows manageable)
+4. Proof: 2,000 stylists (builds trust)
+5. Commitment: Free, cancel anytime (removes risk)
+
+**Cut List (3 elements):**
+All "nice to know" but don't enable the action:
+- Company story (impressive but irrelevant)
+- Technical details (doesn't reduce barriers)
+- Team bios (interesting but unnecessary)
+
+**Barriers Addressed (3):**
+Each barrier gets specific content solution:
+- Email overload → "Weekly, 60 seconds, unsubscribe"
+- Uncertainty → "Top 5 trends + testimonial"
+- Distrust → "2,000 using it" (social proof)
+
+---
+
+## Key Insights
+
+**Information is filtered through action:**
+- Only 5 essential elements kept
+- 3 "nice to know" elements cut
+- Everything serves the signup action
+
+**Barriers drive content:**
+- Each barrier identified gets targeted content
+- Not generic "benefits" but specific barrier removal
+- Content is strategic, not decorative
+
+**Business + User alignment:**
+- Action serves business goal (email capture → signups)
+- Action serves user motivation (authority wish, trends fear)
+- Win-win: both parties get what they need
+
+---
+
+_Example demonstrating Action Mapping for hairdresser newsletter signup_

package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-badass-users-principles.md

@@ -0,0 +1,159 @@
+# Badass Users Principles
+
+**Kathy Sierra's framework for user-centered content**
+
+---
+
+## Core Philosophy
+
+> "Users don't care about your product. They care about being awesome at what your product helps them do."
+
+**The Insight:** Don't make a better product. Make a better USER.
+
+---
+
+## The Five Key Principles
+
+### 1. Make Them Better, Not Your Product Better
+
+**Focus on THEIR capability, not your features**
+
+**Bad (product-focused):**
+- "Our AI analyzes 10,000 beauty sources"
+- "We send weekly emails with 5 trends"
+- "Our platform has been trusted since 2018"
+
+**Good (capability-focused):**
+- "You'll spot trends before your competitors"
+- "You'll always have something new to talk about with clients"
+- "You'll feel confident when clients ask about the latest looks"
+
+**Frame:** "You'll be able to..." not "Our product has..."
+
+---
+
+### 2. Show The Transformation
+
+**From: Current state → To: Badass state**
+
+**Make the path visible:**
+- Where they are (current state: struggling, uncertain)
+- Where they're going (badass state: capable, confident)
+- That the path is real and achievable
+
+**Examples:**
+- Specific numbers: "60 seconds per trend" (concrete, not vague)
+- Social proof: "2,000 stylists already there" (others did it)
+- Quick win: "Try it on your next client" (immediate application)
+
+---
+
+### 3. Create "Aha Moments"
+
+**Insights that shift perspective and build confidence**
+
+**Not just understanding—perspective shift:**
+
+**Examples:**
+- "Oh! I don't need to follow 100 accounts—I just need THIS digest!"
+- "Oh! This is about my CLIENT'S reactions, not just knowing trends!"
+- "Oh! 60 seconds is all I need—I thought it would take hours!"
+
+**Characteristics:**
+- Specific insight (not vague "understanding")
+- Removes a barrier or misconception
+- Unlocks confidence to act
+- Memorable and quotable
+
+---
+
+### 4. Reduce Cognitive Load
+
+**Don't make them think unnecessarily**
+
+**Strategies:**
+- Too many choices? → Reduce options or guide selection
+- Too much jargon? → Use plain language
+- Too many steps? → Break down or simplify
+- Unclear what to do? → Make next step obvious
+
+**Cognitive load reduction often means cutting 30-40% of planned content**
+
+**Remove:**
+- Unnecessary decisions
+- Complex explanations
+- Industry jargon
+- Multiple CTAs
+- Non-essential features
+
+---
+
+### 5. Focus on Skills, Not Tools
+
+**What skill or capability are we helping them develop?**
+
+**Not (tool-focused):**
+- "Using our platform"
+- "Receiving emails"
+- "Accessing our database"
+
+**But (skill-focused):**
+- "Staying current effortlessly"
+- "Impressing your clients"
+- "Becoming the local authority"
+
+**The tool is the vehicle, the skill is what matters**
+
+---
+
+## Application Framework
+
+**For each piece of content, ask:**
+
+1. **Does this make THEM feel capable?** (not us look good)
+2. **Does it show transformation?** (current → badass with visible path)
+3. **Does it create an "aha moment"?** (perspective shift that unlocks confidence)
+4. **Does it reduce cognitive load?** (or add unnecessary complexity)
+5. **Does it focus on skills gained?** (not just tools used)
+
+---
+
+## Common Mistakes
+
+**Mistake #1: Feature Focus**
+- Talking about product capabilities instead of user capabilities
+- "We have..." instead of "You'll be able to..."
+
+**Mistake #2: Vague Transformation**
+- Aspirational marketing fluff without concrete path
+- No specifics on how transformation happens
+
+**Mistake #3: No Aha Moment**
+- Just explaining features
+- Missing the key insight that shifts perspective
+
+**Mistake #4: Cognitive Overload**
+- Trying to say everything
+- Multiple options without guidance
+- Complex language
+
+**Mistake #5: Tool Obsession**
+- Focusing on using the product
+- Missing the skill they're actually developing
+
+---
+
+## Key Quotes
+
+**On Product vs. User:**
+> "Nobody cares about your product. They care about being badass at what your product helps them do."
+
+**On Transformation:**
+> "Make the user awesome, not your product awesome."
+
+**On Skills:**
+> "People want to be great photographers, not great at using Photoshop."
+
+---
+
+_Badass Users principles reference for Step 4 - Empowerment Frame_