@c0x12c/ai-toolkit 1.15.0

package/frameworks/00-framework-comparison-guide.md

@@ -0,0 +1,317 @@
+# Startup Validation Frameworks: Complete Comparison & Usage Guide
+
+## Overview
+This guide provides a comprehensive comparison of all major startup validation frameworks, helping you choose the right approach for your specific situation. Each framework has its strengths, and many work best when combined strategically.
+
+## Quick Decision Matrix
+
+### By Stage of Your Startup Journey
+
+| Stage | Primary Frameworks | Why |
+|-------|-------------------|-----|
+| **Idea Stage** | Mom Test, JTBD, Customer Development | Need to validate problems exist |
+| **Concept Validation** | Lean Canvas, Javelin Board, Value Proposition Canvas | Structure your thinking and assumptions |
+| **Solution Design** | Design Sprint, Foundation Sprint, Pretotyping | Rapidly prototype and test solutions |
+| **Building Phase** | MVP Approaches, Build-Measure-Learn | Create minimum viable solutions |
+| **Scaling Phase** | Business Model Canvas, Customer Development (later stages) | Optimize and expand |
+
+### By Time Available
+
+| Timeframe | Recommended Frameworks | Output |
+|-----------|----------------------|---------|
+| **1 Day** | Lean Canvas, Value Proposition Canvas | Structured hypotheses |
+| **1 Week** | Design Sprint, Javelin Board experiments | Tested prototype or validated learning |
+| **2-4 Weeks** | Foundation Sprint, MVP launch | Aligned team and early product |
+| **Ongoing** | Build-Measure-Learn, Customer Development | Continuous validation |
+
+### By Primary Goal
+
+| Goal | Best Frameworks | Key Benefit |
+|------|----------------|-------------|
+| **Understand Customers** | Mom Test, JTBD, Customer Development | Deep customer insights |
+| **Test Business Model** | Lean Canvas, Business Model Canvas | Holistic view of business |
+| **Validate Demand** | Landing Page MVP, Javelin Board | Quick market validation |
+| **Design Solution** | Design Sprint, Value Proposition Canvas | User-centered design |
+| **Build Quickly** | MVP Approaches, Pretotyping | Fast time to market |
+| **Align Team** | Foundation Sprint, Design Sprint | Shared understanding |
+
+## Framework Deep Comparison
+
+### 1. Problem Validation Frameworks
+
+#### The Mom Test
+- **Best For**: Getting honest customer feedback
+- **Time**: Ongoing, 30-min conversations
+- **Output**: Validated problems and behaviors
+- **Strength**: Avoids false positives
+- **Weakness**: Requires practice to master
+- **Combines With**: All other frameworks
+
+#### Jobs to be Done (JTBD)
+- **Best For**: Understanding customer motivations
+- **Time**: 2-4 weeks research
+- **Output**: Job statements and outcome metrics
+- **Strength**: Deep behavioral insights
+- **Weakness**: Can be abstract
+- **Combines With**: Value Proposition Canvas, Design Sprint
+
+#### Customer Development
+- **Best For**: Systematic market validation
+- **Time**: 3-6 months full cycle
+- **Output**: Validated business model
+- **Strength**: Comprehensive approach
+- **Weakness**: Time intensive
+- **Combines With**: Lean Canvas, Build-Measure-Learn
+
+### 2. Business Model Frameworks
+
+#### Lean Canvas
+- **Best For**: Early-stage startups
+- **Time**: 20 minutes to 2 hours
+- **Output**: 1-page business model
+- **Strength**: Forces clarity and focus
+- **Weakness**: Oversimplification risk
+- **Combines With**: Customer Development, Javelin Board
+
+#### Business Model Canvas
+- **Best For**: Established businesses or complex models
+- **Time**: 2-4 hours workshop
+- **Output**: Comprehensive business model
+- **Strength**: Holistic view
+- **Weakness**: Can be overwhelming for startups
+- **Combines With**: Value Proposition Canvas, SWOT
+
+#### Value Proposition Canvas
+- **Best For**: Product-market fit refinement
+- **Time**: 2-3 hours workshop
+- **Output**: Detailed value prop mapping
+- **Strength**: Customer-centric design
+- **Weakness**: Requires good customer data
+- **Combines With**: Business Model Canvas, Design Sprint
+
+### 3. Rapid Design Frameworks
+
+#### Design Sprint
+- **Best For**: Specific feature/product challenges
+- **Time**: 5 days
+- **Output**: Tested prototype
+- **Strength**: Fast, structured process
+- **Weakness**: Requires full team commitment
+- **Combines With**: Foundation Sprint, JTBD
+
+#### Foundation Sprint
+- **Best For**: New initiatives needing alignment
+- **Time**: 2-5 days
+- **Output**: Shared vision and roadmap
+- **Strength**: Team alignment
+- **Weakness**: Less hands-on building
+- **Combines With**: Design Sprint follow-up
+
+### 4. Testing Frameworks
+
+#### Javelin Board
+- **Best For**: Systematic assumption testing
+- **Time**: 1-2 weeks per experiment
+- **Output**: Validated/invalidated assumptions
+- **Strength**: Visual progress tracking
+- **Weakness**: Can slow down action
+- **Combines With**: Lean Canvas validation
+
+#### Build-Measure-Learn
+- **Best For**: Continuous iteration
+- **Time**: 1-4 week cycles
+- **Output**: Validated learning
+- **Strength**: Fast feedback loops
+- **Weakness**: Requires discipline
+- **Combines With**: All frameworks
+
+#### MVP Approaches
+- **Best For**: First product launch
+- **Time**: 1 day to 3 months
+- **Output**: Market-ready minimum product
+- **Strength**: Fast validation
+- **Weakness**: Quality vs speed balance
+- **Combines With**: Build-Measure-Learn
+
+## Combining Frameworks: Recommended Sequences
+
+### Sequence 1: Complete Validation Journey
+1. **JTBD Research** → Understand customer needs
+2. **Mom Test Interviews** → Validate problems exist
+3. **Lean Canvas** → Structure business model
+4. **Javelin Board** → Test riskiest assumptions
+5. **Design Sprint** → Create solution prototype
+6. **MVP Launch** → Validate with real users
+7. **Build-Measure-Learn** → Iterate to product-market fit
+
+### Sequence 2: Fast Track (30 Days)
+1. **Mom Test** (Week 1) → Problem validation
+2. **Lean Canvas** (Day 7) → Business model hypothesis
+3. **Landing Page MVP** (Week 2) → Demand validation
+4. **Concierge MVP** (Week 3-4) → Solution validation
+5. **Build-Measure-Learn** → Continuous improvement
+
+### Sequence 3: Enterprise/Complex Products
+1. **Foundation Sprint** → Align stakeholders
+2. **JTBD Research** → Deep customer understanding
+3. **Business Model Canvas** → Comprehensive planning
+4. **Design Sprint** → Prototype key features
+5. **Customer Development** → Systematic validation
+
+### Sequence 4: Technical Products
+1. **Customer Development** → Validate market need
+2. **Value Proposition Canvas** → Define clear value
+3. **API MVP** → Technical validation
+4. **Javelin Board** → Track experiments
+5. **Build-Measure-Learn** → Scale gradually
+
+## Common Pitfalls and How to Avoid Them
+
+### Pitfall 1: Framework Overload
+**Problem**: Trying to use every framework
+**Solution**: Pick 2-3 that match your current stage
+
+### Pitfall 2: Analysis Paralysis
+**Problem**: Endless planning without action
+**Solution**: Set time limits, bias toward testing
+
+### Pitfall 3: Skipping Problem Validation
+**Problem**: Building solutions to non-existent problems
+**Solution**: Always start with Mom Test or JTBD
+
+### Pitfall 4: Confirmation Bias
+**Problem**: Only seeing positive signals
+**Solution**: Use structured frameworks like Javelin Board
+
+### Pitfall 5: Premature Scaling
+**Problem**: Growing before product-market fit
+**Solution**: Use Build-Measure-Learn metrics
+
+## Metrics and Success Indicators
+
+### Problem Validation Metrics
+- Number of problem confirmations
+- Problem severity scores
+- Current solution satisfaction
+- Willingness to pay indicators
+
+### Solution Validation Metrics
+- Conversion rates (interest → trial → purchase)
+- Activation rates
+- Retention/churn
+- Net Promoter Score
+- Customer Acquisition Cost vs Lifetime Value
+
+### Framework Success Metrics
+- Time to first customer
+- Pivots required
+- Capital efficiency
+- Team alignment scores
+- Learning velocity
+
+## Resource Requirements
+
+### Minimal Resources (Solo Founder)
+- Start with: Mom Test, Lean Canvas, Landing Page MVP
+- Tools needed: Google Docs, simple website builder
+- Time: 10-20 hours/week
+- Budget: <$100/month
+
+### Small Team (2-5 people)
+- Add: Design Sprint, Javelin Board, Build-Measure-Learn
+- Tools: Miro, analytics tools, prototyping software
+- Time: 2-3 days for workshops + ongoing
+- Budget: $500-1000/month
+
+### Funded Startup (5+ people)
+- Full suite: All frameworks as needed
+- Tools: Professional stack
+- Time: Dedicated roles
+- Budget: $2000+/month
+
+## Quick Start Recommendations
+
+### If You're Starting Today
+1. **Hour 1**: Create Lean Canvas
+2. **Day 1**: List riskiest assumptions
+3. **Week 1**: Conduct 5 Mom Test interviews
+4. **Week 2**: Launch Landing Page MVP
+5. **Week 3**: Analyze and iterate
+
+### For B2B Startups
+- Focus on: Customer Development, JTBD
+- MVP type: Concierge or Wizard of Oz
+- Key metric: Paid pilots
+
+### For B2C Startups
+- Focus on: Mom Test, Design Sprint
+- MVP type: Landing Page or Single Feature
+- Key metric: Weekly active users
+
+### For Technical Founders
+- Start with: Mom Test (fight the urge to build)
+- Then: Lean Canvas, API MVP
+- Remember: Problem validation > Technical excellence
+
+### For Non-Technical Founders
+- Start with: Customer Development, Piecemeal MVP
+- Partner or outsource technical validation
+- Focus on: Business model validation
+
+## Action Plan Template
+
+### Week 1: Problem Discovery
+- [ ] 10 Mom Test interviews
+- [ ] JTBD research (if complex)
+- [ ] Document top 3 problems
+
+### Week 2: Solution Ideation
+- [ ] Lean Canvas workshop
+- [ ] Javelin Board setup
+- [ ] First experiment design
+
+### Week 3: Initial Testing
+- [ ] Launch simplest MVP
+- [ ] Set up analytics
+- [ ] Daily customer feedback
+
+### Week 4: Learn and Iterate
+- [ ] Analyze all data
+- [ ] Pivot or persevere decision
+- [ ] Plan next cycle
+
+## Conclusion
+
+The best validation approach combines multiple frameworks strategically. Start with problem validation (Mom Test, JTBD), structure your thinking (Lean Canvas), test systematically (Javelin Board, MVPs), and iterate quickly (Build-Measure-Learn).
+
+Remember:
+- **Validation > Features**
+- **Learning > Being Right**
+- **Customer Truth > Your Opinion**
+- **Fast Iterations > Perfect Plans**
+
+The goal isn't to use every framework—it's to find product-market fit as efficiently as possible. Choose frameworks that address your biggest risks and unknowns, then execute with discipline and customer focus.
+
+## Additional Resources
+
+### Essential Books
+1. "The Mom Test" - Rob Fitzpatrick
+2. "The Lean Startup" - Eric Ries
+3. "Sprint" - Jake Knapp
+4. "Running Lean" - Ash Maurya
+5. "Competing Against Luck" - Clayton Christensen
+
+### Online Resources
+- Steve Blank's blog and courses
+- Strategyzer tools and resources
+- GV Design Sprint resources
+- Lean Startup community
+
+### Tools and Templates
+- Miro/Mural (visual collaboration)
+- Notion (documentation)
+- Typeform (surveys)
+- Mixpanel (analytics)
+- Figma (prototyping)
+
+Start with one framework today. Your future customers are waiting.

package/frameworks/01-lean-canvas.md

@@ -0,0 +1,196 @@
+# Lean Canvas Framework
+
+## Overview
+The Lean Canvas is a 1-page business model adaptation of Alex Osterwalder's Business Model Canvas, created by Ash Maurya specifically for startups. It replaces four boxes of the Business Model Canvas with boxes that are more relevant for startups: Problem, Solution, Key Metrics, and Unfair Advantage.
+
+## When to Use
+- Early-stage startups needing to validate their business model
+- When you need to quickly iterate on business ideas
+- Before building an MVP to ensure problem-solution fit
+- When pivoting or exploring new business directions
+
+## The 9 Building Blocks
+
+### 1. Problem (Top 3)
+- List your top 1-3 problems
+- Include existing alternatives (how people solve this today)
+- Be specific and avoid generalizations
+- Focus on problems worth solving
+
+**Questions to ask:**
+- What are the top problems your customers face?
+- How are they currently solving these problems?
+- What's the cost of not solving these problems?
+
+### 2. Customer Segments
+- Define your target customers
+- Identify early adopters
+- Be specific (avoid "everyone")
+- Consider demographics, psychographics, behaviors
+
+**Questions to ask:**
+- Who has this problem most acutely?
+- Who would pay to solve this problem?
+- What are their characteristics?
+
+### 3. Unique Value Proposition
+- Single, clear, compelling message
+- What makes you different and worth paying attention to
+- Focus on outcomes and benefits, not features
+- Should pass the "so what?" test
+
+**Format:** [End Result] for [Target Customer] without [Current Pain]
+
+### 4. Solution
+- Top 3 features that solve the problems
+- Keep it simple and focused
+- Don't over-engineer at this stage
+- Should directly address the problems identified
+
+### 5. Channels
+- Path to customers
+- Consider both inbound and outbound channels
+- Focus on scalable channels
+- Test channels early and often
+
+**Examples:** SEO, Content Marketing, Social Media, Direct Sales, Partners
+
+### 6. Revenue Streams
+- Revenue model (subscription, one-time, freemium, etc.)
+- Pricing strategy
+- Lifetime value
+- Gross margin targets
+
+**Questions to ask:**
+- What will customers actually pay for?
+- How much are they willing to pay?
+- How do they prefer to pay?
+
+### 7. Cost Structure
+- Customer acquisition costs
+- Distribution costs
+- People costs
+- Hosting/operational costs
+- Keep it simple initially
+
+### 8. Key Metrics
+- Key activities you measure
+- Should indicate progress toward product/market fit
+- Focus on actionable metrics, not vanity metrics
+- Examples: Customer acquisition cost, Lifetime value, Churn rate, Monthly recurring revenue
+
+### 9. Unfair Advantage
+- Cannot be easily copied or bought
+- Often doesn't exist on day one
+- Examples: Insider information, Expert endorsements, Network effects, Community
+
+## How to Use the Lean Canvas
+
+### Step 1: Start with Problem and Customer Segments
+Always start here. If you don't have a problem worth solving for a specific customer segment, nothing else matters.
+
+### Step 2: Define Your Unique Value Proposition
+Based on the problem and customer, craft a compelling value proposition.
+
+### Step 3: Outline Your Solution
+Keep it minimal - just enough to test your hypothesis.
+
+### Step 4: Identify Channels
+How will you reach your customers?
+
+### Step 5: Revenue Streams and Cost Structure
+Build a basic financial model.
+
+### Step 6: Define Key Metrics
+What will you measure to know if you're succeeding?
+
+### Step 7: Identify Unfair Advantage
+What will make you defensible over time?
+
+## Best Practices
+
+1. **Time-box it**: Spend no more than 20 minutes on your first draft
+2. **Be concise**: Use short, clear phrases
+3. **Test assumptions**: Each box contains hypotheses to validate
+4. **Iterate frequently**: Update as you learn
+5. **Share and get feedback**: Don't work in isolation
+6. **Prioritize risks**: Focus on the riskiest assumptions first
+
+## Common Mistakes
+
+1. **Too many customer segments**: Start with one
+2. **Feature-focused solutions**: Focus on benefits and outcomes
+3. **Vague problems**: Be specific and measurable
+4. **Complex value propositions**: If you can't explain it simply, it's too complex
+5. **Ignoring unfair advantage**: Think about long-term defensibility
+
+## Validation Process
+
+1. **Customer interviews**: Validate problems exist
+2. **Solution interviews**: Test if your solution resonates
+3. **MVP testing**: Build minimum viable product
+4. **Metrics tracking**: Measure key indicators
+5. **Iterate or pivot**: Based on learnings
+
+## Tools and Resources
+
+- **Canvanizer**: Online Lean Canvas tool
+- **Leanstack**: Ash Maurya's platform
+- **Strategyzer**: Business model tools
+- **Books**: "Running Lean" by Ash Maurya
+
+## Example Questions for Each Block
+
+### Problem
+- What are the top 3 problems?
+- How do customers rank these problems?
+- How are they solving them today?
+
+### Customer Segments
+- Who are your early adopters?
+- What are their demographics?
+- Where do they hang out?
+
+### Unique Value Proposition
+- What's your high-level pitch?
+- Why is this different?
+- Why should customers care?
+
+### Solution
+- What's the minimum feature set?
+- How does each feature solve a problem?
+- What can you defer to later?
+
+### Channels
+- How will customers find you?
+- What channels do your customers use?
+- Which channels are most cost-effective?
+
+### Revenue Streams
+- What's your revenue model?
+- What's the pricing strategy?
+- What's the path to $100K MRR?
+
+### Cost Structure
+- What are your biggest costs?
+- What's your burn rate?
+- How long is your runway?
+
+### Key Metrics
+- What are your North Star metrics?
+- What indicates product/market fit?
+- What are your growth metrics?
+
+### Unfair Advantage
+- What do you have that others don't?
+- What would be hard to replicate?
+- What gets stronger over time?
+
+## When to Move Beyond Lean Canvas
+
+- When you've validated problem-solution fit
+- When you need more detailed planning
+- When you're scaling beyond early adopters
+- When you need to communicate to investors
+
+The Lean Canvas is a living document - revisit and update it regularly as you learn and grow.