whiteport-design-studio 0.1.0

package/src/workflows/4-ux-design/scenario-init/steps-c/05-mutual-success.md

@@ -0,0 +1,69 @@
+# Question 4: What's the End Goal (Mutual Success)?
+
+**Define winning for both business and user**
+
+---
+
+## The Question
+
+```
+Agent: "What does success look like for both sides?
+
+        For the business: [what outcome?]
+        For the user: [what state/feeling/outcome?]"
+```
+
+---
+
+## Why This Matters
+
+Success must be mutual:
+
+- Business gets value
+- User gets value
+- Both are happy
+
+**If only one side wins, the relationship fails.**
+
+---
+
+## Example: Dog Week
+
+```
+Designer: "Business: Active subscription
+           User: Family harmony restored, dog gets walked consistently,
+                 no more nagging needed"
+```
+
+**Why both matter:**
+
+- Business needs subscription (revenue)
+- User needs harmony (problem solved)
+- Subscription only works if harmony is real
+- Harmony only happens if product delivers
+
+**Mutual success = sustainable business.**
+
+---
+
+## What Agent Captures
+
+```
+MUTUAL SUCCESS:
+
+Business Goal: Active subscription (recurring revenue)
+User Goal: Family harmony + consistent dog care + no nagging
+
+Success Metric: User stays subscribed because harmony is real
+Failure Point: User cancels if product doesn't reduce conflict
+```
+
+---
+
+## Next Question
+
+[What's the shortest path to get there?](05-shortest-path.md)
+
+---
+
+[← Back to Guide](00-SCENARIO-INIT-GUIDE.md)

package/src/workflows/4-ux-design/scenario-init/steps-c/06-shortest-path.md

@@ -0,0 +1,92 @@
+# Question 5: What's the Shortest Path?
+
+**Map the minimum journey from starting point to mutual success**
+
+---
+
+## The Question
+
+```
+Agent: "Let's map the shortest possible journey from
+        [starting point] to [mutual success]:
+
+        What's the absolute minimum path?"
+```
+
+---
+
+## Why This Matters
+
+Shortest path means:
+
+- No unnecessary steps
+- No feature bloat
+- Clear focus
+- Faster to mutual success
+
+**Every extra step is a chance to lose the user.**
+
+---
+
+## Example: Dog Week
+
+```
+Agent: "From 'frustrated parent on Google' to 'active subscription + harmony':
+        What's the minimum path?"
+
+Designer: "Google → Landing page → See how it works →
+           Sign up → Set up family → Start using calendar →
+           First walk completed → Everyone happy"
+```
+
+**Why this path:**
+
+- Landing: Understand solution (addresses frustration)
+- How it works: See it's simple (addresses complexity fear)
+- Sign up: Commit to trying (low friction)
+- Family setup: Get everyone involved (necessary for accountability)
+- Calendar: Plan first week (immediate action)
+- First walk: Proof it works (mutual success moment)
+
+---
+
+## What Agent Captures
+
+```
+SCENARIO: Parent Onboarding to First Success
+
+START: Google search (frustrated, tired of nagging)
+END: First walk completed (harmony, system working)
+
+CRITICAL PATH:
+1. Landing page → Understand solution
+2. Sign up → Commit to trying
+3. Family setup → Get everyone involved
+4. Calendar → Plan first week
+5. First walk → Proof it works
+
+BUSINESS GOAL: Active subscription
+USER GOAL: Family harmony without nagging
+
+Each step serves the journey. Nothing extra.
+```
+
+---
+
+## Next Step
+
+With all 5 questions answered, you have:
+
+- ✅ Core feature (what to design)
+- ✅ Entry point (where to start)
+- ✅ Mental state (how they feel)
+- ✅ Mutual success (where to end)
+- ✅ Shortest path (how to get there)
+
+**→ Proceed to [Step 6: Create VTC](06-create-vtc.md)**
+
+Before sketching, crystallize this scenario's strategy into a Value Trigger Chain.
+
+---
+
+[← Back to Guide](00-SCENARIO-INIT-GUIDE.md)

package/src/workflows/4-ux-design/scenario-init/steps-c/07-create-vtc.md

@@ -0,0 +1,132 @@
+# 6. Create Value Trigger Chain for Scenario
+
+**Purpose:** Crystallize scenario strategy before sketching
+
+---
+
+## Why Now?
+
+You've defined:
+- ✅ Feature that delivers value
+- ✅ Entry point
+- ✅ Mental state
+- ✅ Mutual success
+- ✅ Shortest path
+
+**Perfect time to create a VTC** - you have everything needed.
+
+This VTC will guide every page, every interaction, every word in this scenario.
+
+---
+
+## Agent Instructions
+
+> "Before we start sketching, let's create a Value Trigger Chain for this scenario.
+> 
+> This captures the strategic essence:
+> - Business Goal (from mutual success - business side)
+> - Solution (this scenario/feature)
+> - User (primary target group)
+> - Driving Forces (from mental state and Trigger Map)
+> - Customer Awareness (where they start → where they end up)
+> 
+> This takes 10-15 minutes since we have the Trigger Map. It'll guide every design decision.
+> 
+> Shall we create the scenario VTC?"
+
+---
+
+## Route to VTC Workshop
+
+**If user agrees:**
+
+Load and execute the VTC Workshop Router:
+`../../shared/vtc-workshop/vtc-workshop-router.md`
+
+**Since Trigger Map exists:** Router will likely send you to **Selection Workshop** (10-15 mins).
+
+---
+
+## Leverage Context
+
+**Important:** You have rich context from scenario init! Use it:
+
+- **Business Goal:** From mutual success (business side)
+- **Solution:** The feature/scenario just defined
+- **User:** Primary target group from Trigger Map
+- **Entry Point/Mental State:** For Customer Awareness starting point
+- **Mutual Success:** For Customer Awareness ending point
+- **Driving Forces:** From Trigger Map for this user
+
+**Scenario init IS strategic discovery** - use it!
+
+---
+
+## Save VTC
+
+VTC should be saved to:
+`{output_folder}/D-UX-Design/[scenario-name]/vtc.yaml`
+
+Example: `docs/D-UX-Design/1.1-parent-onboarding/vtc.yaml`
+
+---
+
+## Confirm and Set Expectation
+
+> "Excellent! This scenario now has its own VTC.
+> 
+> As we sketch each page, we'll use this VTC to ensure:
+> - Every interaction addresses these driving forces
+> - Every message moves them through awareness
+> - Every design choice serves mutual success
+> 
+> The VTC is your strategic compass. When in doubt, check the VTC.
+> 
+> Ready to start sketching?"
+
+---
+
+## If User Declines VTC
+
+**If user says:** "Let's skip the VTC and sketch"
+
+**Response:**
+> "I strongly recommend creating the VTC first. Here's why:
+> 
+> Without it, design becomes opinion-based:
+> - 'I like this button here'
+> - 'This color feels right'
+> - 'Users probably want this'
+> 
+> With VTC, design becomes strategic:
+> - 'This button triggers their wish to [driving force]'
+> - 'This message addresses their fear of [driving force]'
+> - 'This moves them from [awareness start] to [awareness end]'
+> 
+> It takes 15 minutes and saves hours of redesign.
+> 
+> Still want to skip?"
+
+**If still declines:**
+> "Okay, but I recommend creating VTC before presenting to stakeholders. You can add it anytime using:
+> `../../shared/vtc-workshop/vtc-workshop-router.md`"
+
+Then proceed to sketching without VTC (not ideal).
+
+---
+
+## Next Step
+
+After VTC is created:
+
+**Start sketching the scenario journey!**
+
+Each sketch should:
+- Serve the VTC driving forces
+- Move user through awareness progression
+- Support shortest path to mutual success
+
+---
+
+*Strategic clarity achieved - now sketch with purpose!*
+

package/src/workflows/4-ux-design/scenario-init/steps-c/examples/booking-example.md

@@ -0,0 +1,64 @@
+# Example: Service Booking (Appointment Goal)
+
+**Trust-building booking flow**
+
+---
+
+## The 5 Questions
+
+### 1. Core Feature
+
+```
+"Consultation booking with social proof - testimonials + credentials"
+```
+
+### 2. Entry Point
+
+```
+"Friend recommendation (shared link)"
+```
+
+### 3. Mental State
+
+```
+"Curious but cautious, need to trust before committing time/money"
+```
+
+### 4. Mutual Success
+
+```
+Business: Consultation booked (lead captured)
+User: Confident in decision, looking forward to meeting
+```
+
+### 5. Shortest Path
+
+```
+Friend link → About page → Testimonials →
+Book consultation → Confirmation
+```
+
+---
+
+## Scenario Captured
+
+```
+SCENARIO: Trust-Building Booking
+
+START: Friend recommendation (curious but cautious)
+END: Consultation booked (confident, excited)
+
+CRITICAL PATH:
+1. About page → Understand who you are
+2. Testimonials → See social proof
+3. Credentials → Verify expertise
+4. Book consultation → Commit with confidence
+5. Confirmation → Excitement reinforced
+
+BUSINESS GOAL: Consultation booked
+USER GOAL: Confident decision, trust established
+```
+
+---
+
+[← Back to Guide](../00-SCENARIO-INIT-GUIDE.md)

package/src/workflows/4-ux-design/scenario-init/steps-c/examples/ecommerce-example.md

@@ -0,0 +1,64 @@
+# Example: E-commerce (Sales Goal)
+
+**Transparent purchase journey**
+
+---
+
+## The 5 Questions
+
+### 1. Core Feature
+
+```
+"Transparent pricing breakdown - shows all costs upfront"
+```
+
+### 2. Entry Point
+
+```
+"Google search 'affordable [product]'"
+```
+
+### 3. Mental State
+
+```
+"Anxious about hidden costs, need transparency before committing"
+```
+
+### 4. Mutual Success
+
+```
+Business: Purchase completed
+User: Confident in value, no surprise costs
+```
+
+### 5. Shortest Path
+
+```
+Google → Product page → Transparent pricing →
+Add to cart → Checkout → Confirmation
+```
+
+---
+
+## Scenario Captured
+
+```
+SCENARIO: Transparent Purchase Journey
+
+START: Google search (anxious about hidden costs)
+END: Purchase completed (confident in value)
+
+CRITICAL PATH:
+1. Product page → See product + upfront pricing
+2. Pricing breakdown → Understand all costs
+3. Add to cart → Commit to purchase
+4. Checkout → Complete transaction
+5. Confirmation → Confidence reinforced
+
+BUSINESS GOAL: Product sale
+USER GOAL: Confident purchase, no surprises
+```
+
+---
+
+[← Back to Guide](../00-SCENARIO-INIT-GUIDE.md)

package/src/workflows/4-ux-design/scenario-init/steps-c/examples/saas-example.md

@@ -0,0 +1,64 @@
+# Example: SaaS (Subscription Goal)
+
+**Frictionless onboarding**
+
+---
+
+## The 5 Questions
+
+### 1. Core Feature
+
+```
+"Quick setup wizard - gets users to first success fast"
+```
+
+### 2. Entry Point
+
+```
+"ChatGPT recommendation"
+```
+
+### 3. Mental State
+
+```
+"Overwhelmed by current tools, need simple solution that just works"
+```
+
+### 4. Mutual Success
+
+```
+Business: Active monthly subscription
+User: Problem solved, no complexity added
+```
+
+### 5. Shortest Path
+
+```
+ChatGPT → Landing → See demo → Sign up →
+Quick setup → First success
+```
+
+---
+
+## Scenario Captured
+
+```
+SCENARIO: Frictionless Onboarding
+
+START: ChatGPT recommendation (overwhelmed, need simplicity)
+END: First success (problem solved, staying subscribed)
+
+CRITICAL PATH:
+1. Landing → Understand it's simple
+2. Demo → See it in action
+3. Sign up → Low friction entry
+4. Quick setup → Minimal configuration
+5. First success → Immediate value
+
+BUSINESS GOAL: Monthly subscription
+USER GOAL: Problem solved without complexity
+```
+
+---
+
+[← Back to Guide](../00-SCENARIO-INIT-GUIDE.md)