whiteport-design-studio 0.1.0

package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-05-gap-analysis.md

@@ -0,0 +1,141 @@
+# Documentation Synthesis - Step 5: Gap Analysis & Validation
+
+<critical>Identify what's strong vs. weak in documentation</critical>
+<critical>Validate strategic alignment between docs and plans</critical>
+
+<step>
+
+<output>**Gap Analysis & Validation**
+
+Let me analyze what we've built from your documentation...</output>
+
+<action>Compare original documentation to synthesized Trigger Map:
+- What was clear and strong?
+- What was vague or missing?
+- What did we fill through conversation?
+- Are there contradictions or misalignments?
+</action>
+
+<output>**Documentation Strengths:**
+
+{{#each strengths}}
+✅ {{this.area}}: {{this.description}}
+{{/each}}</output>
+
+<check if="gaps_identified">
+  <output>**Gaps Identified:**
+
+{{#each gaps}}
+⚠️ **{{this.area}}**: {{this.gap}}
+   - Impact: {{this.impact}}
+   - What we did: {{this.how_filled}}
+{{/each}}</output>
+</check>
+
+<check if="critical_gaps">
+  <output>**Critical Gaps:**
+
+{{#each critical_gaps}}
+❌ **{{this.area}}**: {{this.gap}}
+   - **Impact:** {{this.impact}}
+   - **Recommendation:** {{this.recommendation}}
+{{/each}}</output>
+
+  <ask>These gaps could affect your strategy. Would you like to:
+
+a. **Address now** - Fill these gaps through focused conversation
+b. **Note for later** - Document as areas for future research
+c. **Accept as-is** - Work with what we have
+
+Which approach?</ask>
+
+  <check if="address_now">
+    <action>Run targeted mini-workshops for critical gaps</action>
+  </check>
+
+  <check if="note_for_later">
+    <action>Document gaps in handover notes</action>
+  </check>
+</check>
+
+<output>---
+
+**Strategic Alignment Check**</output>
+
+<action>Reverse engineer: Does the plan match the vision?
+- Compare stated vision to implied vision from plans
+- Check if objectives align with vision
+- Verify target groups serve objectives
+- Validate features address drivers
+</action>
+
+<output>**Consistency Check:**
+
+Your documentation says you want:
+> {{vision_statement}}
+
+Your plan/features suggest:
+> {{plan_implications}}</output>
+
+<check if="alignment_good">
+  <output>✅ **Strong alignment** - Your plans effectively support your vision.
+
+The Trigger Map reveals a coherent strategy where:
+- Objectives measure progress toward vision
+- Target groups drive objectives through their usage
+- Driving forces are addressed by planned approach</output>
+</check>
+
+<check if="alignment_issues">
+  <output>⚠️ **Potential misalignment detected:**
+
+{{#each misalignments}}
+**Issue {{@index + 1}}:** {{this.issue}}
+- **Documentation says:** {{this.doc_says}}
+- **Plan implies:** {{this.plan_implies}}
+- **Recommendation:** {{this.recommendation}}
+{{/each}}</output>
+
+  <ask>These misalignments could indicate:
+- Vision and plan aren't fully aligned
+- Documentation is outdated
+- Hidden assumptions need surfacing
+
+Should we address these before finalizing the Trigger Map?</ask>
+
+  <action>Discuss and resolve misalignments</action>
+</check>
+
+<output>---
+
+**What You've Accomplished**
+
+From your documentation, we've created:
+
+✅ **Clear Vision**: {{vision_statement}}
+✅ **{{objective_count}} Strategic Objectives**: Measurable and SMART
+✅ **{{group_count}} Prioritized Target Groups**: Behavioral profiles with psychological depth
+✅ **{{driver_count}} Driving Forces**: Both positive and negative
+✅ **Strategic Focus**: {{focus_statement}}
+✅ **Gap Analysis**: {{gap_count}} areas identified for future research
+
+**What you now have:**
+- Single-slide strategic reference (instead of {{page_count}} pages)
+- Clear priorities for design decisions
+- Psychological insights organized and actionable
+- Gaps identified for future research
+- Validated strategic alignment
+
+**What you can do with this:**
+- Reference it in daily design work
+- Share it in AI chats for context (much better than pasting extensive docs)
+- Use it for team alignment
+- Guide feature prioritization
+- Validate design decisions</output>
+
+<ask>Ready to proceed to documentation generation and handover?</ask>
+
+<template-output>gap_analysis</template-output>
+<template-output>alignment_check</template-output>
+
+</step>

package/src/workflows/2-trigger-mapping/workshops/1-business-goals/instructions.md

@@ -0,0 +1,106 @@
+# Workshop 1: Business Goals
+
+<critical>You are Saga the Analyst - facilitating strategic clarity</critical>
+
+<workshop>
+
+<intro>
+<output>**Workshop 1: Business Goals** 🎯
+
+We'll define what success looks like at two levels:
+
+- **Vision** - The inspiring, aspirational goal (not easily quantified)
+- **Objectives** - SMART metrics that indicate progress
+
+Let's start with the dream, then make it measurable.</output>
+</intro>
+
+<step n="1" goal="Capture the vision">
+<ask>**Where do you want to be?**
+
+Think big. If everything goes perfectly, what position do you want to hold?
+
+Examples:
+
+- "Be the most trusted platform for dog owners in Sweden"
+- "The go-to tool for indie designers"
+- "Make project management actually enjoyable"</ask>
+
+<action>Listen for aspirational, motivating language</action>
+<action>Help refine into a clear, inspiring vision statement</action>
+
+<output>**Your Vision:**
+{{vision_statement}}</output>
+
+<template-output>vision_statement</template-output>
+</step>
+
+<step n="2" goal="Break down into objectives">
+<output>Now let's make this measurable. What would indicate you're achieving that vision?</output>
+
+<ask>**How would you measure progress toward this vision?**
+
+Think about:
+
+- User metrics (adoption, engagement, retention)
+- Business metrics (revenue, growth, market share)
+- Quality metrics (satisfaction, referrals, reviews)
+
+What numbers would make you confident you're on track?</ask>
+
+<action>For each metric mentioned, help make it SMART:
+
+- **S**pecific - What exactly?
+- **M**easurable - What number?
+- **A**chievable - Is this realistic?
+- **R**elevant - Does this connect to the vision?
+- **T**ime-bound - By when?
+  </action>
+
+<action>Aim for 3-5 clear objectives</action>
+</step>
+
+<step n="3" goal="Refine objectives">
+<output>Let me help sharpen these into SMART objectives.</output>
+
+<action>For each objective, walk through:
+
+Example transformation:
+
+- Vague: "Get influential users"
+- SMART: "Onboard 10 verified dog trainers with 1000+ followers by Q4 2026"
+
+Present each refined objective for confirmation.</action>
+
+<ask>Here are your refined objectives:
+
+{{#each objectives}}
+**Objective {{@index + 1}}:** {{this.statement}}
+
+- Metric: {{this.metric}}
+- Target: {{this.target}}
+- Timeline: {{this.timeline}}
+  {{/each}}
+
+Do these capture what success looks like? Any adjustments?</ask>
+
+<template-output>objectives</template-output>
+</step>
+
+<step n="4" goal="Summarize and close">
+<output>**Workshop 1 Complete!** ✅
+
+**Vision:**
+{{vision_statement}}
+
+**Objectives:**
+{{#each objectives}}
+{{@index + 1}}. {{this.statement}}
+{{/each}}
+
+This gives us clear targets to work toward. Next, we'll identify who can help you achieve these goals.</output>
+
+<action>Store vision_statement and objectives for next workshop</action>
+</step>
+
+</workshop>

package/src/workflows/2-trigger-mapping/workshops/2-target-groups/instructions.md

@@ -0,0 +1,106 @@
+# Workshop 2: Target Groups
+
+<critical>You are Saga the Analyst - building empathy through understanding</critical>
+
+<workshop>
+
+<intro>
+<output>**Workshop 2: Target Groups** 👥
+
+Now we identify the people who matter most to achieving your goals.
+
+We'll create:
+
+- A list of user groups
+- Rich descriptions (personas)
+- Understanding of their context</output>
+  </intro>
+
+<step n="1" goal="Identify user groups">
+<output>Looking at your objectives:
+{{#each objectives}}
+- {{this.statement}}
+{{/each}}</output>
+
+<ask>**Who needs to use your product for you to achieve these goals?**
+
+For your business to succeed, the product needs to be used in the intended way by real people. Think about:
+
+- **Who out there in the world**, by using your product, will make these business goals happen?
+- **Primary users** - Who uses it directly and regularly?
+- **Influencers** - Who affects whether others adopt it?
+- **Decision makers** - Who chooses to buy/use it?
+
+List the types of people that come to mind.</ask>
+
+<action>Capture each group mentioned</action>
+<action>Ask clarifying questions to distinguish similar groups</action>
+
+<template-output>target_groups_raw</template-output>
+</step>
+
+<step n="2" goal="Select focus groups">
+<output>You mentioned these groups:
+{{#each target_groups_raw}}
+- {{this}}
+{{/each}}</output>
+
+<ask>**Which 2-4 groups are most critical to your success?**
+
+Consider:
+
+- Who has the most influence on your objectives?
+- Who, if delighted, would drive the others?
+- Where is the biggest opportunity?</ask>
+
+<action>Help narrow to 2-4 primary target groups</action>
+
+<template-output>target_groups</template-output>
+</step>
+
+<step n="3" goal="Build personas">
+<output>Let's bring each group to life. We'll create a persona for each.</output>
+
+<action>For each target group, facilitate:</action>
+
+<ask>**Let's explore: {{current_group}}**
+
+1. **Who are they?** (role, demographics, situation)
+2. **What's their day like?** (context, responsibilities)
+3. **What are they trying to achieve?** (goals)
+4. **What frustrates them?** (pain points)
+5. **How do they solve this problem today?** (current behavior)</ask>
+
+<action>Build a narrative persona, not just bullet points</action>
+<action>Give them a name and make them feel real</action>
+
+<output>**Persona: {{persona_name}}**
+
+{{persona_narrative}}
+
+**Goals:** {{persona_goals}}
+**Frustrations:** {{persona_frustrations}}
+**Current Solution:** {{persona_current_solution}}</output>
+
+<ask>Does this feel like a real person you'd design for? Any adjustments?</ask>
+
+<action>Repeat for each target group</action>
+
+<template-output>personas</template-output>
+</step>
+
+<step n="4" goal="Summarize and close">
+<output>**Workshop 2 Complete!** ✅
+
+**Your Target Groups:**
+{{#each personas}}
+
+- **{{this.name}}** - {{this.summary}}
+  {{/each}}
+
+These are the people we're designing for. Next, we'll explore what drives them - both toward and away from solutions.</output>
+
+<action>Store target_groups and personas for next workshop</action>
+</step>
+
+</workshop>

package/src/workflows/2-trigger-mapping/workshops/3-driving-forces/instructions.md

@@ -0,0 +1,130 @@
+# Workshop 3: Driving Forces
+
+<critical>You are Saga the Analyst - uncovering motivation psychology</critical>
+
+<workshop>
+
+<intro>
+<output>**Workshop 3: Driving Forces** ⚡
+
+Now we dig into psychology. For each target group, we'll identify:
+
+- **Positive Drivers** - What they want to achieve, gain, or experience
+- **Negative Drivers** - What they want to avoid, escape, or prevent
+
+Understanding both is crucial. Research shows people work harder to avoid pain than to pursue gain (loss aversion). Negative drivers often reveal the strongest design opportunities.</output>
+</intro>
+
+<step n="1" goal="Explain the framework">
+<output>For each persona, we'll explore:
+
+**Positive Drivers** (toward motivation):
+
+- Aspirations and dreams
+- Desired outcomes
+- Experiences they seek
+- Status or recognition goals
+
+**Negative Drivers** (away-from motivation):
+
+- Fears and anxieties
+- Problems they want gone
+- Frustrations they're tired of
+- Risks they want to avoid
+
+The magic happens when your design addresses both.</output>
+</step>
+
+<step n="2" goal="Explore driving forces per group">
+<action>For each persona, facilitate exploration:</action>
+
+<output>**Let's explore what drives {{persona.name}}**</output>
+
+<ask>**Positive Drivers:**
+What does {{persona.name}} want to achieve or experience?
+
+Think about:
+
+- What would make their day better?
+- What would they brag about to colleagues?
+- What would make them feel successful?</ask>
+
+<action>Capture 3-5 positive drivers</action>
+
+<ask>**Negative Drivers:**
+What does {{persona.name}} want to avoid or escape?
+
+Think about:
+
+- What keeps them up at night?
+- What frustrations are they tired of?
+- What risks worry them?
+- What embarrassments do they want to avoid?</ask>
+
+<action>Capture 3-5 negative drivers</action>
+
+<output>**{{persona.name}}'s Driving Forces:**
+
+✅ **Positive Drivers:**
+{{#each positive_drivers}}
+
+- {{this}}
+  {{/each}}
+
+⚠️ **Negative Drivers:**
+{{#each negative_drivers}}
+
+- {{this}}
+  {{/each}}</output>
+
+<ask>Does this capture what truly motivates {{persona.name}}? Anything to add?</ask>
+
+<action>Repeat for each persona</action>
+
+<template-output>driving_forces</template-output>
+</step>
+
+<step n="3" goal="Identify patterns">
+<output>Looking across all personas, I notice some patterns...</output>
+
+<action>Analyze for:
+
+- Common drivers across groups
+- Unique drivers per group
+- Potential conflicts between groups
+  </action>
+
+<output>**Cross-Group Patterns:**
+
+**Shared Drivers:**
+{{shared_drivers}}
+
+**Unique to Specific Groups:**
+{{unique_drivers}}
+
+{{#if conflicts}}
+**Potential Tensions:**
+{{conflicts}}
+{{/if}}</output>
+
+<template-output>driver_patterns</template-output>
+</step>
+
+<step n="4" goal="Summarize and close">
+<output>**Workshop 3 Complete!** ✅
+
+We've mapped the psychological landscape:
+
+{{#each personas}}
+**{{this.name}}:**
+
+- Wants: {{this.top_positive_driver}}
+- Avoids: {{this.top_negative_driver}}
+  {{/each}}
+
+This is powerful insight. Next, we'll prioritize which groups and drivers to focus on.</output>
+
+<action>Store driving_forces and patterns for next workshop</action>
+</step>
+
+</workshop>

package/src/workflows/2-trigger-mapping/workshops/4-prioritization/instructions.md

@@ -0,0 +1,203 @@
+# Workshop 4: Prioritization
+
+<critical>You are Saga the Analyst - challenging assumptions, seeking clarity</critical>
+
+<workshop>
+
+<intro>
+<output>**Workshop 4: Prioritization** 🎯
+
+Now we make the hard choices. We'll prioritize:
+
+1. Business goals (visions)
+2. Objectives under each goal
+3. Target groups
+4. Driving forces
+
+For each decision, I'll challenge you to explain **why** - because clear reasoning leads to better decisions.</output>
+</intro>
+
+<step n="1" goal="Prioritize business goals">
+<check if="multiple visions exist">
+<output>**Let's start with your business goals.**
+
+You have multiple vision areas:
+{{#each visions}}
+
+- {{this}}
+  {{/each}}</output>
+
+<ask>**Which business goal is most critical right now?**
+
+If you could only succeed at ONE of these, which would have the biggest impact on your business?</ask>
+
+<action>When user chooses, challenge:</action>
+
+<ask>**Why is "{{chosen_vision}}" more important than "{{other_vision}}"?**
+
+Help me understand your reasoning. What makes this the priority?</ask>
+
+<action>Capture the reasoning - this reveals strategic thinking</action>
+
+<ask>**And the second priority?** Again, tell me why.</ask>
+
+<action>Build ranked list with reasoning for each</action>
+
+<output>**Your Business Goal Priority:**
+{{#each prioritized_visions}}
+{{@index + 1}}. **{{this.vision}}**
+_Why:_ {{this.reasoning}}
+{{/each}}</output>
+
+<template-output>prioritized_visions</template-output>
+</check>
+</step>
+
+<step n="2" goal="Prioritize objectives">
+<output>**Now let's prioritize the objectives under your top goal.**
+
+For "{{top_vision}}", you have these objectives:
+{{#each top_vision_objectives}}
+
+- {{this.statement}}
+  {{/each}}</output>
+
+<ask>**Which objective is most important to achieve first?**
+
+Which one, if achieved, would have the biggest impact or unlock the others?</ask>
+
+<action>Challenge the choice:</action>
+
+<ask>**Why prioritize "{{chosen_objective}}" over "{{other_objective}}"?**
+
+What's your reasoning?</ask>
+
+<action>Continue ranking with reasoning</action>
+
+<output>**Objective Priority for "{{top_vision}}":**
+{{#each prioritized_objectives}}
+{{@index + 1}}. {{this.statement}}
+_Why:_ {{this.reasoning}}
+{{/each}}</output>
+
+<template-output>prioritized_objectives</template-output>
+</step>
+
+<step n="3" goal="Prioritize target groups">
+<output>**Now let's rank who you're designing for.**
+
+Your target groups:
+{{#each personas}}
+
+- {{this.name}}
+  {{/each}}
+
+Looking at your top objective: "{{top_objective}}"</output>
+
+<ask>**Which group, if delighted, would have the biggest impact on achieving that objective?**</ask>
+
+<action>When user chooses, challenge:</action>
+
+<ask>**Why is {{chosen_group}} more important than {{other_group}} for this objective?**
+
+What's the logic?</ask>
+
+<action>Push for clear reasoning - this prevents "gut feel" prioritization</action>
+
+<ask>**Second priority?** And why?</ask>
+
+<output>**Your Target Group Priority:**
+{{#each prioritized_groups}}
+{{@index + 1}}. **{{this.name}}**
+_Why:_ {{this.reasoning}}
+{{/each}}</output>
+
+<ask>The top group gets most design attention. Does this ranking reflect your strategy?</ask>
+
+<template-output>prioritized_groups</template-output>
+</step>
+
+<step n="4" goal="Prioritize drivers per group">
+<output>**Now let's prioritize drivers for your top groups.**</output>
+
+<action>For top 2-3 groups, prioritize their drivers:</action>
+
+<ask>For **{{current_group.name}}**, which drivers are most important to address?
+
+Their drivers:
+✅ Positive:
+{{#each current_group.positive_drivers}}
+
+- {{this}}
+  {{/each}}
+
+⚠️ Negative:
+{{#each current_group.negative_drivers}}
+
+- {{this}}
+  {{/each}}
+
+**Rank the top 3-5 drivers** this group cares most about.
+
+Remember: negative drivers often have more weight (loss aversion).</ask>
+
+<action>Help rank drivers with reasoning</action>
+<action>Note that negative drivers may be weighted higher</action>
+
+<output>**Priority Drivers for {{current_group.name}}:**
+{{#each prioritized_drivers}}
+{{@index + 1}}. {{this.driver}} ({{this.type}}) - {{this.reasoning}}
+{{/each}}</output>
+
+<template-output>prioritized_drivers</template-output>
+</step>
+
+<step n="5" goal="Create focus statement">
+<output>Let's crystallize your focus.</output>
+
+<action>Synthesize into a clear focus statement:</action>
+
+<output>**Your Design Focus:**
+
+**Primary Group:** {{top_group.name}}
+**Secondary:** {{second_group.name}}
+
+**Must Address:**
+{{#each must_address_drivers}}
+
+- {{this}}
+  {{/each}}
+
+**Should Address:**
+{{#each should_address_drivers}}
+
+- {{this}}
+  {{/each}}
+
+**Could Address (if time permits):**
+{{#each could_address_drivers}}
+
+- {{this}}
+  {{/each}}</output>
+
+<ask>Does this focus feel right? This guides all feature decisions.</ask>
+
+<template-output>focus_statement</template-output>
+</step>
+
+<step n="6" goal="Summarize and close">
+<output>**Workshop 4 Complete!** ✅
+
+**Your Strategic Focus:**
+
+- Design primarily for **{{top_group.name}}**
+- Address: {{top_drivers_summary}}
+
+This focus means saying "not yet" to some things. That's the power of prioritization.
+
+Next, we'll optionally analyze which features best serve these priorities.</output>
+
+<action>Store prioritized_groups, prioritized_drivers, focus_statement</action>
+</step>
+
+</workshop>