@comfanion/workflow 4.38.4-dev.0 → 4.39.0-dev.0

package/src/opencode/skills/methodologies/empathize.md

@@ -0,0 +1,253 @@
+# Empathize Methods
+
+Methods for understanding users, their needs, emotions, and behaviors.
+
+## User Interviews
+
+**Purpose:** Deep conversations to uncover needs, frustrations, and motivations
+
+**When to use:**
+- Starting new project
+- Validating assumptions
+- Understanding user context
+- Discovering pain points
+
+**How to conduct:**
+
+1. **Prepare:**
+   - Define research goals
+   - Identify user segments
+   - Prepare open-ended questions
+   - Schedule 30-60 min sessions
+
+2. **Interview Structure:**
+   ```
+   Opening (5 min):
+   - Build rapport
+   - Explain purpose
+   - Get consent
+   
+   Main Questions (40 min):
+   - "Tell me about the last time you..."
+   - "Walk me through your process for..."
+   - "What frustrates you most about..."
+   - "What would make this easier?"
+   - "Why is that important to you?"
+   
+   Closing (5 min):
+   - "Is there anything else I should know?"
+   - Thank participant
+   ```
+
+3. **Question Types:**
+   - **Context:** "Tell me about your role..."
+   - **Behavior:** "Walk me through how you..."
+   - **Emotion:** "How did that make you feel?"
+   - **Motivation:** "Why is that important?"
+   - **Pain Points:** "What frustrates you about..."
+   - **Ideal State:** "In a perfect world, what would..."
+
+4. **Best Practices:**
+   - Ask "Why?" to dig deeper
+   - Listen more than talk (80/20 rule)
+   - Avoid leading questions
+   - Record with permission
+   - Take notes on emotions
+   - Look for patterns across interviews
+
+**Output:** Interview notes, quotes, observations
+
+---
+
+## Empathy Mapping
+
+**Purpose:** Visualize what users say, think, do, and feel
+
+**When to use:**
+- After user interviews
+- To synthesize research
+- To build shared understanding
+- Before defining problems
+
+**Structure:**
+
+```
+┌─────────────────────────────────────┐
+│         USER: [Name/Persona]        │
+├─────────────────┬───────────────────┤
+│      SAYS       │      THINKS       │
+│                 │                   │
+│ Direct quotes   │ Unspoken thoughts │
+│ from interviews │ and beliefs       │
+│                 │                   │
+├─────────────────┼───────────────────┤
+│      DOES       │      FEELS        │
+│                 │                   │
+│ Observable      │ Emotional state   │
+│ behaviors       │ (use emojis)      │
+│                 │                   │
+└─────────────────┴───────────────────┘
+```
+
+**How to create:**
+
+1. **Identify User:** Choose specific user or persona
+2. **Fill Quadrants:**
+   - **Says:** Direct quotes from interviews
+   - **Thinks:** Inferred thoughts, beliefs, concerns
+   - **Does:** Observable actions, behaviors
+   - **Feels:** Emotions (frustrated 😤, anxious 😰, happy 😊)
+
+3. **Look for Contradictions:**
+   - Says vs Thinks (what they don't say)
+   - Does vs Feels (actions vs emotions)
+
+4. **Extract Insights:**
+   - What patterns emerge?
+   - What contradictions exist?
+   - What needs are unmet?
+
+**Example:**
+
+```markdown
+## Empathy Map: Busy Merchant
+
+| Says | Thinks |
+|------|--------|
+| "I don't have time for this" | "This is too complicated" |
+| "Just let me finish" | "Why do they need all this info?" |
+| "Can't I skip this?" | "I hope I don't mess this up" |
+
+| Does | Feels |
+|------|-------|
+| Skips optional fields | Frustrated 😤 |
+| Rushes through forms | Anxious 😰 |
+| Abandons at payment | Overwhelmed 😵 |
+
+**Insight:** Merchants value speed over completeness. They feel anxious about making mistakes and frustrated by unnecessary complexity.
+```
+
+**Output:** Visual map, insights, user needs
+
+---
+
+## Journey Mapping
+
+**Purpose:** Map user's experience across all touchpoints over time
+
+**When to use:**
+- Understanding full user experience
+- Identifying pain points
+- Finding opportunities
+- Aligning team on user flow
+
+**Structure:**
+
+```
+Stage → Awareness → Consideration → Action → Use → Support
+        ↓           ↓               ↓        ↓      ↓
+Actions [what user does at each stage]
+        ↓           ↓               ↓        ↓      ↓
+Emotions 😊 😐 😤 😰 [how user feels]
+        ↓           ↓               ↓        ↓      ↓
+Pain Points [problems, frustrations]
+        ↓           ↓               ↓        ↓      ↓
+Opportunities [how to improve]
+```
+
+**How to create:**
+
+1. **Define Stages:**
+   - **Awareness:** User discovers need
+   - **Consideration:** User researches options
+   - **Action:** User makes decision
+   - **Use:** User uses product
+   - **Support:** User needs help
+
+2. **For Each Stage, Document:**
+   - **Actions:** What user does
+   - **Touchpoints:** Where interaction happens
+   - **Emotions:** How user feels (use emojis)
+   - **Pain Points:** Problems, frustrations
+   - **Opportunities:** How to improve
+
+3. **Identify Patterns:**
+   - Where do emotions drop? (pain points)
+   - Where are gaps in experience?
+   - What causes frustration?
+   - What delights users?
+
+**Example:**
+
+```markdown
+## Journey Map: Merchant Onboarding
+
+### Stage 1: Awareness
+**Actions:** Hears about platform from friend
+**Emotions:** Curious 🤔, Hopeful 😊
+**Pain Points:** None yet
+**Opportunities:** Clear value proposition
+
+### Stage 2: Consideration
+**Actions:** Visits website, reads features, compares pricing
+**Emotions:** Interested 😊, Uncertain 😐
+**Pain Points:** Too many options, unclear pricing
+**Opportunities:** Simplify pricing, add comparison table
+
+### Stage 3: Action (Sign Up)
+**Actions:** Fills registration form, verifies email
+**Emotions:** Anxious 😰, Frustrated 😤
+**Pain Points:** Form too long, asks for unnecessary data
+**Opportunities:** ⭐ Reduce form fields, add progress indicator
+
+### Stage 4: Use (First Product)
+**Actions:** Creates first product listing
+**Emotions:** Confused 😕, Overwhelmed 😵
+**Pain Points:** Unclear what's required, no guidance
+**Opportunities:** ⭐ Add onboarding wizard, inline help
+
+### Stage 5: Support
+**Actions:** Searches help docs, contacts support
+**Emotions:** Frustrated 😤, Relieved 😌 (after help)
+**Pain Points:** Hard to find answers
+**Opportunities:** Better search, contextual help
+```
+
+**Output:** Journey map, prioritized pain points, opportunities
+
+---
+
+## When to Use Each Method
+
+| Method | Best For | Time | Output |
+|--------|----------|------|--------|
+| **User Interviews** | Deep understanding, discovery | 30-60 min/user | Quotes, observations |
+| **Empathy Mapping** | Synthesizing research, building empathy | 30-60 min | Visual map, insights |
+| **Journey Mapping** | Understanding full experience, finding gaps | 1-2 hours | Journey map, opportunities |
+
+**Typical Workflow:**
+```
+User Interviews → Empathy Map → Journey Map → Requirements
+```
+
+---
+
+## Tips
+
+**User Interviews:**
+- Interview 5-8 users per segment (patterns emerge)
+- Record with permission
+- Ask "Why?" at least 3 times
+- Look for emotions, not just facts
+
+**Empathy Mapping:**
+- Do it as a team (shared understanding)
+- Use real quotes from interviews
+- Focus on one user at a time
+- Look for contradictions (Says vs Thinks)
+
+**Journey Mapping:**
+- Start with current state (as-is)
+- Then create future state (to-be)
+- Use emojis for emotions (visual impact)
+- Prioritize opportunities (⭐ = high impact)

package/src/opencode/skills/methodologies/ideate.md

@@ -0,0 +1,458 @@
+# Ideate Methods
+
+Methods for generating creative solutions.
+
+## Brainstorming
+
+**Purpose:** Generate large quantity of diverse ideas without judgment
+
+**When to use:**
+- After defining problem (HMW)
+- Need many options
+- Team ideation
+- Breaking mental blocks
+
+**Rules:**
+
+1. **Defer judgment** - No criticism during generation
+2. **Go for quantity** - Aim for 50+ ideas
+3. **Encourage wild ideas** - Crazy ideas spark breakthroughs
+4. **Build on others** - "Yes, and..." not "Yes, but..."
+5. **Stay focused** - Keep HMW question visible
+6. **Be visual** - Sketch, don't just write
+
+**How to run:**
+
+1. **Setup (5 min):**
+   - Write HMW question on board
+   - Review rules
+   - Set timer (15-30 min)
+
+2. **Generate (15-30 min):**
+   - Everyone writes ideas on sticky notes
+   - One idea per note
+   - Call out ideas to spark others
+   - Build on what you hear
+
+3. **Share (10 min):**
+   - Post all ideas on wall
+   - Quick read-through
+   - No discussion yet
+
+4. **Cluster (10 min):**
+   - Group similar ideas
+   - Name themes
+   - Identify patterns
+
+**Tips:**
+- Warm up first (practice round)
+- Set quantity goal (50 ideas)
+- Use timer (creates urgency)
+- Stand up (more energy)
+- Play music (sets mood)
+
+**Example:**
+
+HMW: "How might we guide merchants through product creation?"
+
+Ideas:
+- Wizard with steps
+- Inline help text
+- Video tutorials
+- Live chat support
+- Pre-filled templates
+- Show examples
+- Progressive disclosure (show fields as needed)
+- Voice input
+- AI assistant
+- Copy from competitor
+- Mobile app with camera
+- Gamification (points for completion)
+- ... (50+ more)
+
+---
+
+## SCAMPER
+
+**Purpose:** Apply seven creative lenses to existing solutions to generate variations
+
+**When to use:**
+- Improving existing solution
+- Need structured creativity
+- Stuck in obvious ideas
+- Solo ideation
+
+**Seven Lenses:**
+
+### S - Substitute
+**What can we replace?**
+- Materials, components, people, processes
+- "What if we used X instead of Y?"
+
+Examples:
+- Replace text form → voice input
+- Replace manual entry → import from spreadsheet
+- Replace tooltips → video tutorials
+
+### C - Combine
+**What can we merge?**
+- Features, steps, tools, ideas
+- "What if we combined X and Y?"
+
+Examples:
+- Combine product creation + inventory setup
+- Combine form + preview
+- Combine help docs + form fields
+
+### A - Adapt
+**What can we borrow from elsewhere?**
+- Other industries, nature, history
+- "What does X do that we could adapt?"
+
+Examples:
+- Adapt TurboTax interview style
+- Adapt Instagram's photo filters
+- Adapt video game tutorials
+
+### M - Modify/Magnify/Minify
+**What can we change, enlarge, or reduce?**
+- Size, shape, frequency, intensity
+- "What if we made X bigger/smaller/different?"
+
+Examples:
+- Magnify: Show huge preview
+- Minify: Reduce to 3 required fields
+- Modify: Change form to conversation
+
+### P - Put to other uses
+**What else could this be used for?**
+- New contexts, users, purposes
+- "What if X was used for Y?"
+
+Examples:
+- Product form → inventory import tool
+- Preview → marketing material generator
+- Templates → learning resource
+
+### E - Eliminate
+**What can we remove?**
+- Features, steps, complexity
+- "What if we removed X?"
+
+Examples:
+- Eliminate optional fields
+- Eliminate separate steps
+- Eliminate technical terms
+
+### R - Reverse/Rearrange
+**What if we flipped or reordered?**
+- Sequence, roles, perspective
+- "What if we did X backwards?"
+
+Examples:
+- Reverse: Start with preview, work backwards
+- Rearrange: Put images first, details later
+- Reverse: Let AI generate, user edits
+
+**How to use:**
+
+1. **Start with existing solution:**
+   - Current product form
+
+2. **Apply each lens:**
+   - Go through S-C-A-M-P-E-R
+   - Generate 3-5 ideas per lens
+   - Don't judge, just generate
+
+3. **Review ideas:**
+   - Which are interesting?
+   - Which could work?
+   - Which to prototype?
+
+**Example Session:**
+
+Current: "15-field product creation form"
+
+**Substitute:**
+- Voice input instead of typing
+- AI generates description from photo
+- Import from competitor
+
+**Combine:**
+- Form + preview side-by-side
+- Creation + inventory in one flow
+- Help + form fields inline
+
+**Adapt:**
+- TurboTax interview style
+- Instagram's simple photo upload
+- Notion's slash commands
+
+**Modify:**
+- Reduce to 3 required fields
+- Expand preview to full page
+- Change to conversational UI
+
+**Put to other uses:**
+- Form becomes product catalog
+- Preview becomes marketing page
+- Template becomes tutorial
+
+**Eliminate:**
+- Remove all optional fields
+- Remove separate steps
+- Remove save button (auto-save)
+
+**Reverse:**
+- Start with preview, fill backwards
+- AI generates, user edits
+- Show examples first, form second
+
+---
+
+## Crazy 8s
+
+**Purpose:** Force rapid idea generation through time constraint
+
+**When to use:**
+- Need to break past obvious ideas
+- Individual ideation
+- Quick exploration
+- Before detailed brainstorming
+
+**How to do it:**
+
+1. **Prepare:**
+   - Fold paper into 8 sections
+   - Set timer for 8 minutes
+   - Have HMW question ready
+
+2. **Sketch:**
+   - 1 minute per section
+   - Sketch solution idea
+   - Don't overthink
+   - Quantity over quality
+
+3. **Review:**
+   - Which ideas are interesting?
+   - Which to explore further?
+   - Share with team
+
+**Tips:**
+- First 3 ideas will be obvious (that's OK)
+- Ideas 4-6 get more interesting
+- Ideas 7-8 are often breakthrough
+- Don't worry about drawing skills
+- Use stick figures and boxes
+
+**Example:**
+
+HMW: "How might we guide merchants through product creation?"
+
+8 sketches (1 min each):
+1. Step-by-step wizard
+2. Inline help tooltips
+3. Video tutorial overlay
+4. AI chatbot assistant
+5. Voice-guided creation
+6. Copy from example
+7. AR camera scan product
+8. Collaborative creation (invite expert)
+
+---
+
+## Provotype Sketching
+
+**Purpose:** Create deliberately extreme or provocative prototypes to spark breakthrough thinking
+
+**When to use:**
+- Stuck in incremental ideas
+- Need to challenge assumptions
+- Want to push boundaries
+- Before converging on solution
+
+**How to create:**
+
+1. **Make it extreme:**
+   - What's the most radical version?
+   - What if we had unlimited resources?
+   - What if we ignored all constraints?
+
+2. **Make it provocative:**
+   - What would shock users?
+   - What would competitors never do?
+   - What breaks all rules?
+
+3. **Extract insights:**
+   - What's interesting about this?
+   - What could actually work?
+   - What assumptions does it challenge?
+
+**Examples:**
+
+Problem: "Product creation form is too complex"
+
+**Provotypes:**
+
+1. **Zero-Field Form:**
+   - No form at all
+   - Just upload photo
+   - AI generates everything
+   - *Insight:* Could we reduce to 1-2 fields?
+
+2. **100-Field Form:**
+   - Every possible detail
+   - Takes 2 hours to complete
+   - Professional-grade
+   - *Insight:* Different users need different depth
+
+3. **Voice-Only:**
+   - No typing allowed
+   - Speak to create product
+   - AI interprets
+   - *Insight:* Could voice be an option?
+
+4. **Collaborative:**
+   - Can't create alone
+   - Must invite expert
+   - Expert fills technical fields
+   - *Insight:* Could we offer expert help?
+
+5. **Gamified:**
+   - Product creation is a game
+   - Earn points for fields
+   - Unlock features
+   - *Insight:* Could we make it fun?
+
+**From Provotype to Real Solution:**
+
+Provotype: "Zero-field form - just upload photo"
+
+Real Solution: "Smart form that pre-fills from photo, user confirms/edits"
+
+---
+
+## Analogous Inspiration
+
+**Purpose:** Find inspiration from completely different domains
+
+**When to use:**
+- Stuck in industry thinking
+- Need fresh perspective
+- Looking for innovation
+- Breaking assumptions
+
+**How to use:**
+
+1. **Identify the challenge:**
+   - What's the core problem?
+   - Abstract it from your domain
+
+2. **Find analogies:**
+   - How does nature solve this?
+   - How do other industries handle it?
+   - What's a similar problem elsewhere?
+
+3. **Extract principles:**
+   - What's the underlying principle?
+   - How does it work?
+   - What can we borrow?
+
+4. **Adapt to your context:**
+   - How could this work here?
+   - What would we need to change?
+   - What's the adapted solution?
+
+**Examples:**
+
+**Problem:** "Merchants abandon complex product form"
+
+**Analogies:**
+
+1. **Nature: How do ants navigate?**
+   - Ants leave pheromone trails
+   - Others follow successful paths
+   - *Principle:* Show the path others took
+   - *Adaptation:* Show "most merchants fill these 5 fields first"
+
+2. **Video Games: How do games teach?**
+   - Tutorial levels
+   - Gradual complexity
+   - Immediate feedback
+   - *Principle:* Progressive disclosure
+   - *Adaptation:* Start with 3 fields, unlock more
+
+3. **Restaurants: How do menus work?**
+   - Specials highlighted
+   - Descriptions for complex items
+   - Pictures for popular items
+   - *Principle:* Guide choices with visuals
+   - *Adaptation:* Show examples of good products
+
+4. **GPS Navigation: How does it guide?**
+   - Shows current position
+   - Shows destination
+   - Shows next step
+   - Recalculates if you deviate
+   - *Principle:* Show progress and next step
+   - *Adaptation:* Progress bar + "Next: add photo"
+
+**Domains to explore:**
+- Nature (biomimicry)
+- Other industries
+- History
+- Games
+- Sports
+- Art
+- Science
+
+---
+
+## When to Use Each Method
+
+| Method | Best For | Time | Output |
+|--------|----------|------|--------|
+| **Brainstorming** | Team ideation, quantity | 30-60 min | 50+ ideas |
+| **SCAMPER** | Structured creativity, solo | 30-45 min | 21+ variations |
+| **Crazy 8s** | Quick exploration, individual | 8 min | 8 sketches |
+| **Provotypes** | Breaking assumptions | 30 min | Extreme concepts |
+| **Analogous Inspiration** | Fresh perspective | 30-60 min | Cross-domain ideas |
+
+**Typical Workflow:**
+```
+Crazy 8s (warm up) → Brainstorming (quantity) → SCAMPER (variations) → Provotypes (extreme) → Converge
+```
+
+---
+
+## Tips
+
+**Brainstorming:**
+- Set quantity goal (50+ ideas)
+- Use timer (creates urgency)
+- Build on others ("Yes, and...")
+- No judgment during generation
+
+**SCAMPER:**
+- Go through all 7 lenses
+- Generate 3-5 ideas per lens
+- Don't skip "obvious" ones
+- Combine ideas from different lenses
+
+**Crazy 8s:**
+- First 3 will be obvious (that's OK)
+- Don't overthink
+- Stick figures are fine
+- Ideas 7-8 are often best
+
+**Provotypes:**
+- Make it extreme (not realistic)
+- Extract insights (what's interesting?)
+- Don't implement provotype directly
+- Use to challenge assumptions
+
+**Analogous Inspiration:**
+- Look far from your domain
+- Abstract the principle
+- Adapt, don't copy directly
+- Nature is great source