wicked-garden 12.27.0

package/skills/product/strategy/refs/templates-roi-value.md

@@ -0,0 +1,207 @@
+---
+phase_relevance: ["clarify", "design", "review"]
+archetype_relevance: ["*"]
+---
+# Strategic Analysis Templates: ROI & Value Proposition
+
+ROI analysis and value proposition templates for business strategy.
+
+## ROI Analysis Template
+
+```markdown
+## ROI Analysis: {Project Name}
+
+### Decision: APPROVE | CONDITIONAL | REJECT
+**Confidence**: HIGH | MEDIUM | LOW
+**Analysis Date**: {date}
+
+### Executive Summary
+{2-3 sentences: what, why, recommendation}
+
+### Financial Analysis
+
+**Investment**:
+- Development Cost: ${amount} ({hours} hours × ${rate})
+- Infrastructure Setup: ${amount}
+- Ongoing Annual Cost: ${amount}
+- **Total 3-Year Investment**: ${total}
+
+**Benefits** (Annual):
+- Revenue Impact: ${amount}
+  - {specific revenue source}
+- Cost Savings: ${amount}
+  - {specific cost reduction}
+- Risk Mitigation Value: ${amount}
+  - {quantified risk reduction}
+- **Total Annual Benefit**: ${amount}
+
+**Returns**:
+- **ROI**: {percentage}%
+- **Payback Period**: {X} years {Y} months
+- **3-Year NPV** (@10%): ${amount}
+- **Break-even**: {Yes/No}
+
+### Strategic Alignment
+
+**Business Objectives**:
+- {How this supports strategic goal 1}
+- {How this supports strategic goal 2}
+
+**Strategic Fit**: {HIGH | MEDIUM | LOW}
+
+**Prioritization**:
+- Ranking vs other investments: {position}
+- Resource availability: {assessment}
+- Market timing: {assessment}
+
+### Assumptions & Confidence
+
+**Key Assumptions**:
+- {assumption 1} - {confidence level}
+- {assumption 2} - {confidence level}
+
+**Data Sources**:
+- {source for cost estimates}
+- {source for benefit projections}
+
+**Confidence Factors**:
+- {What increases confidence}
+- {What decreases confidence}
+
+### Risks & Mitigation
+
+| Risk | Probability | Impact | Mitigation Strategy | Owner |
+|------|-------------|--------|---------------------|-------|
+| {risk} | H/M/L | H/M/L | {strategy} | {who} |
+
+### Recommendation
+
+**Primary Recommendation**: {APPROVE | CONDITIONAL | REJECT}
+
+**Rationale**:
+{Why this recommendation}
+
+**Conditions** (if CONDITIONAL):
+1. {condition to be met}
+2. {condition to be met}
+
+**Action Items**:
+1. {action} - {owner} - {deadline}
+2. {action} - {owner} - {deadline}
+
+**Next Steps**:
+- {immediate next step}
+- {follow-up action}
+
+### Appendix
+
+**Calculation Details**:
+{Detailed ROI calculations}
+
+**Alternative Scenarios**:
+- Best case: ROI {%}, Payback {months}
+- Base case: ROI {%}, Payback {months}
+- Worst case: ROI {%}, Payback {months}
+```
+
+## Value Proposition Template
+
+```markdown
+## Value Proposition: {Product/Feature}
+
+### Value Score: {X}/25
+**Strength**: STRONG | SOLID | WEAK | NOT VIABLE
+
+### Value Statement
+
+**For** {target customer segment}
+**Who** {statement of need or opportunity}
+**Our** {product/service name}
+**Is a** {product category}
+**That** {key benefit/value}
+**Unlike** {primary alternative or competitor}
+**We** {primary differentiation}
+
+### Customer Profile
+
+**Target Customer**: {description}
+- {demographic/firmographic details}
+- {behavioral characteristics}
+- {key attributes}
+
+**Jobs-to-be-Done**:
+
+*Functional Jobs* (tasks):
+- {task they're trying to complete}
+- {task they're trying to complete}
+
+*Emotional Jobs* (feelings):
+- {how they want to feel}
+- {frustration to avoid}
+
+*Social Jobs* (perception):
+- {how they want to be perceived}
+- {status they seek}
+
+### Pain & Gain Analysis
+
+**Current Pains**:
+| Pain Point | Severity | Frequency | Our Solution | Impact |
+|------------|----------|-----------|--------------|--------|
+| {pain} | H/M/L | H/M/L | {how we solve} | H/M/L |
+
+**Desired Gains**:
+| Desired Outcome | Importance | How We Deliver | Impact |
+|-----------------|------------|----------------|--------|
+| {gain} | H/M/L | {our approach} | H/M/L |
+
+### Differentiation Analysis
+
+**Primary Differentiation Axis**: {Performance | Experience | Price | Niche | Innovation}
+
+**Unique Advantages**:
+1. {advantage} - {why it matters to customers}
+2. {advantage} - {why it matters to customers}
+3. {advantage} - {why it matters to customers}
+
+**Competitive Comparison**:
+| Factor | Us | Alternative A | Alternative B |
+|--------|-----|---------------|---------------|
+| {factor} | {our position} | {their position} | {their position} |
+
+**Defensibility**:
+- {What makes this sustainable}
+- {Barriers to copying}
+- {What strengthens over time}
+
+### Value Score Breakdown
+
+| Dimension | Score | Assessment |
+|-----------|-------|------------|
+| Clarity | {1-5} | {Is the value obvious?} |
+| Relevance | {1-5} | {Does customer care?} |
+| Differentiation | {1-5} | {Is it unique/better?} |
+| Credibility | {1-5} | {Is it believable?} |
+| Defensibility | {1-5} | {Can we sustain it?} |
+| **TOTAL** | **{/25}** | |
+
+### Positioning Recommendations
+
+**Target Segments** (prioritized):
+1. {segment name} - {why good fit} - {approach}
+2. {segment name} - {why good fit} - {approach}
+
+**Key Messages**:
+- Primary: {main message}
+- Supporting: {supporting message}
+- Proof: {proof point needed}
+
+**Channel Strategy**:
+- {where to reach customers}
+- {marketing approach}
+
+**Pricing Guidance**:
+- {pricing model recommendation}
+- {price point rationale}
+- {value-based pricing justification}
+```

package/skills/product/synthesize/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: synthesize
+description: |
+  Generate actionable recommendations from customer voice insights. This skill
+  should be used when the user needs to translate analyzed feedback into product
+  priorities, feature recommendations, or strategic guidance.
+
+  Use when: "recommendations from feedback", "translate feedback to priorities",
+  "feature priorities from customer data", "synthesize feedback into action"
+phase_relevance: ["clarify", "design", "review"]
+archetype_relevance: ["*"]
+---
+
+# Synthesize Skill
+
+Transform customer voice analysis into actionable product recommendations.
+
+## When to Use
+
+- After analyzing customer feedback
+- Product planning or roadmap prioritization
+- Feature decision support
+- User asks "what should we build based on customer feedback"
+
+## Usage
+
+```bash
+# Synthesize all recent insights
+/wicked-garden:product:synthesize
+
+# Prioritize by impact level
+/wicked-garden:product:synthesize --priority high
+
+# Feature-specific synthesis
+/wicked-garden:product:synthesize --feature "mobile-app"
+
+# Brief format (for quick decisions)
+/wicked-garden:product:synthesize --format brief
+```
+
+## Synthesis Framework
+
+### 1. Insight Extraction
+Identify: Pain Points, Opportunities, Risks, Strengths
+
+### 2. Recommendation Generation
+Score = (Customer_Value × Urgency) / Effort
+See [refs/prioritization.md](refs/prioritization.md) for detailed scoring.
+
+### 3. Customer Journey Mapping
+Map feedback across: Awareness → Evaluation → Onboarding → Adoption → Retention → Advocacy
+See [refs/journey-mapping.md](refs/journey-mapping.md) for stage analysis.
+
+### 4. Priority Levels
+- **P0**: Churn risk, blocker, security
+- **P1**: Major friction, competitive gap
+- **P2**: Enhancement, efficiency
+- **P3**: Nice-to-have, edge case
+
+## Output Format
+
+```markdown
+## Customer Voice Synthesis: {Context}
+
+### Executive Summary
+{2-3 sentences on what customers need most}
+
+### Top Recommendations
+1. **{Recommendation}** - {Priority}
+   - Impact: {HIGH/MEDIUM/LOW}
+   - Evidence: {N} mentions, {sentiment}, {trend}
+   - Action: {specific what to do}
+   - Effort: {LOW/MEDIUM/HIGH}
+
+{Top 3-5 recommendations}
+
+### Customer Journey Insights
+- **Onboarding**: {key pain point or win}
+- **Adoption**: {key pain point or win}
+- **Retention**: {key pain point or win}
+
+### Strategic Considerations
+- **Strengths**: {what to maintain}
+- **Risks**: {what threatens retention}
+- **Opportunities**: {what could differentiate}
+
+### Quick Wins
+{1-3 low-effort, high-impact improvements}
+
+### Long-term Bets
+{1-2 strategic investments based on customer needs}
+```
+
+## Synthesis Process
+
+1. Load theme and sentiment analysis from the product voice analysis directory (resolved via `resolve_path.py wicked-garden:product`)
+2. Sort themes by priority score, filter by threshold
+3. Generate recommendations: theme → action, score by impact/effort
+4. Map to customer journey stages, identify friction points
+5. Format output: executive summary first, top 3-5 recommendations
+
+## Integration
+
+**wicked-crew**: Auto-inject synthesis into `product:requirements:started` events
+**wicked-brain:memory**: Store high-priority insights as decision memories
+**Native tasks**: Link recommendations to roadmap tasks via TaskCreate with `metadata.event_type="task"`
+
+## Rules
+
+- Maximum 5 recommendations (context efficiency)
+- Always include effort estimates
+- Provide confidence levels (HIGH/MEDIUM/LOW)
+- Cite supporting evidence (N mentions, sentiment)
+- Distinguish quick wins from strategic bets
+- Keep output under 1000 words
+- Be honest about unknowns and limitations

package/skills/product/synthesize/refs/journey-mapping.md

@@ -0,0 +1,212 @@
+---
+phase_relevance: ["clarify", "design", "review"]
+archetype_relevance: ["*"]
+---
+# Customer Journey Mapping
+
+Map feedback to customer lifecycle stages for holistic insights.
+
+## Journey Stages
+
+```
+Awareness → Evaluation → Onboarding → Adoption → Retention → Advocacy
+```
+
+## Stage Definitions
+
+### 1. Awareness
+**What**: Customer first hears about product
+**Feedback Sources**:
+- Marketing site feedback
+- Social media mentions
+- Comparison posts ("X vs Y")
+
+**Key Metrics**:
+- First impression sentiment
+- Clarity of value proposition
+- Competitive positioning
+
+**Pain Points to Watch**:
+- "Didn't understand what this does"
+- "Confused about pricing"
+- "Not clear how this differs from [competitor]"
+
+---
+
+### 2. Evaluation
+**What**: Customer trying to decide if product fits needs
+**Feedback Sources**:
+- Trial feedback
+- Demo requests
+- Sales conversations
+
+**Key Metrics**:
+- Trial conversion sentiment
+- Feature gap mentions
+- Comparison to alternatives
+
+**Pain Points to Watch**:
+- "Missing feature X that competitor has"
+- "Trial period too short to evaluate"
+- "Couldn't test with my data"
+
+---
+
+### 3. Onboarding
+**What**: Customer setting up and learning product
+**Feedback Sources**:
+- Setup support tickets
+- Getting started documentation feedback
+- Early usage confusion
+
+**Key Metrics**:
+- Time to first value
+- Setup difficulty mentions
+- Documentation clarity
+
+**Pain Points to Watch**:
+- "Setup is too complex"
+- "Couldn't figure out how to [basic task]"
+- "Documentation missing key steps"
+- "Integration didn't work as expected"
+
+---
+
+### 4. Adoption
+**What**: Customer expanding usage, becoming proficient
+**Feedback Sources**:
+- Feature requests
+- Usage pattern feedback
+- Training requests
+
+**Key Metrics**:
+- Feature discovery rate
+- Power user emergence
+- Team expansion requests
+
+**Pain Points to Watch**:
+- "Didn't know this feature existed"
+- "Can't do [advanced task]"
+- "Need more training resources"
+
+---
+
+### 5. Retention
+**What**: Customer continues using, renews subscription
+**Feedback Sources**:
+- Renewal conversations
+- Churn interviews
+- Ongoing support tickets
+
+**Key Metrics**:
+- Renewal sentiment
+- Churn reasons
+- Competitive switching
+
+**Pain Points to Watch**:
+- "Thinking about switching to [competitor]"
+- "Not seeing enough value for price"
+- "Support quality declined"
+- "Missing features I need"
+
+---
+
+### 6. Advocacy
+**What**: Customer recommends product to others
+**Feedback Sources**:
+- Reviews and testimonials
+- Referrals
+- Case studies
+- Social sharing
+
+**Key Metrics**:
+- NPS score
+- Referral rate
+- Public praise
+
+**Signals to Amplify**:
+- "I recommended this to my team"
+- "Wrote a blog post about how we use this"
+- "Can't imagine working without this"
+
+## Journey Analysis Output
+
+```markdown
+## Customer Journey Insights
+
+### Awareness → Evaluation
+- **Strength**: Clear value proposition (78% positive sentiment)
+- **Pain Point**: Pricing confusion (12 mentions)
+- **Opportunity**: Clearer comparison to competitors
+
+### Evaluation → Onboarding
+- **Strength**: Easy trial signup (92% positive)
+- **Pain Point**: Trial period too short (18 mentions)
+- **Drop-off Risk**: Integration setup complexity
+
+### Onboarding → Adoption
+- **Strength**: Good documentation (65% positive)
+- **Pain Point**: Advanced features hidden (23 mentions)
+- **Opportunity**: Better feature discovery
+
+### Adoption → Retention
+- **Strength**: Core features solid (70% satisfaction)
+- **Pain Point**: Missing bulk operations (45 mentions)
+- **Risk**: Competitive pressure on mobile experience
+
+### Retention → Advocacy
+- **Strength**: Strong promoters (NPS 42)
+- **Opportunity**: Make sharing easier, case study program
+```
+
+## Drop-off Analysis
+
+Identify where customers struggle or leave:
+
+```python
+def analyze_dropoff(stage: str, feedback: list) -> dict:
+    """
+    Analyze customer friction at specific journey stage.
+
+    Returns:
+        {
+            "stage": "onboarding",
+            "dropoff_signals": 15,  # mentions of difficulty/confusion
+            "top_blockers": ["setup complexity", "unclear docs"],
+            "sentiment": "negative (42%)",
+            "recommendation": "Simplify setup wizard, add video walkthrough"
+        }
+    """
+```
+
+## Cross-Stage Patterns
+
+Look for issues that span multiple stages:
+
+- **Onboarding → Adoption**: Feature discovery problems
+- **Adoption → Retention**: Scalability concerns
+- **Evaluation → Retention**: Unmet expectations
+
+## Mapping Feedback to Stages
+
+Use keywords and context:
+
+```python
+# Stage classification keywords
+STAGE_KEYWORDS = {
+    "awareness": ["heard about", "saw ad", "comparison"],
+    "evaluation": ["trial", "demo", "considering"],
+    "onboarding": ["setup", "getting started", "first time"],
+    "adoption": ["how do I", "advanced", "power user"],
+    "retention": ["renewal", "pricing", "value"],
+    "advocacy": ["recommend", "love", "testimonial"]
+}
+```
+
+## Strategic Insights
+
+Journey analysis reveals:
+1. **Biggest drop-off stage**: Where to focus improvement
+2. **Smoothest transitions**: What's working well
+3. **Segment differences**: Enterprise vs SMB journey variations
+4. **Lifecycle value**: When customers see most value