@rubytech/create-maxy-code 0.1.169 → 0.1.171

package/payload/platform/plugins/venture-studio/skills/zero-to-prototype/references/problem-validation.md

@@ -1,253 +0,0 @@
-# Problem Validation
-
-## Purpose
-Rigorously confirm that the problem you're solving is real, painful, and worth solving before investing in solutions—the most critical validation step that most founders skip.
-
-## When to Use
-- Before building any product or MVP
-- When pivoting to a new problem space
-- When customer acquisition is harder than expected
-- When churn is high despite a good product
-- Questioning whether you're solving the right problem
-
-## Process
-
-### 1. Understand the Validation Sequence
-
-**The sequence matters:**
-1. Problem Validation ← You are here
-2. Solution Validation
-3. Product-Market Fit
-4. Scale
-
-**Most founders skip to solution.** They assume the problem exists because they've experienced it or someone mentioned it. This creates products no one needs.
-
-### 2. The Problem Validation Criteria
-
-A validated problem meets ALL FIVE criteria:
-
-**1. It's Real (Exists)**
-- Customers describe the problem unprompted
-- It occurs regularly, not occasionally
-- Multiple people experience it
-
-**2. It's Painful (Matters)**
-- Customers actively try to solve it
-- It has measurable cost (time, money, stress)
-- It affects important outcomes
-
-**3. It's Urgent (Now)**
-- Customers are motivated to solve it soon
-- There's a trigger or timing component
-- It's not a "someday" problem
-
-**4. It's Frequent (Recurring)**
-- Happens often enough to justify a solution
-- Worth the effort to adopt a new tool
-- Creates ongoing value (not one-time)
-
-**5. Budget Exists (Funded)**
-- Customers have or can get money to solve it
-- They're already spending on alternatives
-- It's worth more than the cost to solve
-
-### 3. Problem Validation Questions
-
-**Testing Realness:**
-- "Tell me about the last time you dealt with [problem area]"
-- "Walk me through what happened"
-- "How did that make you feel?"
-
-Listen for: Specific stories, emotional language, detailed recall
-
-**Testing Pain:**
-- "What did that cost you?" (time, money, opportunity)
-- "What happened as a result?"
-- "How important was solving this?"
-
-Listen for: Quantified impact, consequences described, priority language
-
-**Testing Urgency:**
-- "What are you doing about this now?"
-- "When do you need this solved?"
-- "What would happen if you don't solve it?"
-
-Listen for: Active searching, timeline pressure, negative consequences
-
-**Testing Frequency:**
-- "How often does this come up?"
-- "Is this a regular occurrence?"
-- "When did this last happen?"
-
-Listen for: Weekly/daily occurrence, predictable triggers, ongoing pattern
-
-**Testing Budget:**
-- "What are you spending on this problem today?"
-- "What budget do you have for tools in this area?"
-- "Who decides spending for things like this?"
-
-Listen for: Current spend, budget ownership, willingness to pay
-
-### 4. Evidence Levels
-
-Rate your confidence based on evidence:
-
-| Level | Evidence | Confidence |
-|-------|----------|------------|
-| 5 | Customer paid to solve it | Very High |
-| 4 | Customer actively searching for solution | High |
-| 3 | Customer tried to solve it themselves | Medium |
-| 2 | Customer complained about it | Low |
-| 1 | Customer agreed it's a problem when asked | Very Low |
-
-**Level 5 evidence:** "I hired someone to handle this" / "I bought a tool"
-**Level 4 evidence:** "I've been Googling solutions"
-**Level 3 evidence:** "I built a spreadsheet for this"
-**Level 2 evidence:** "Yeah, that's really annoying"
-**Level 1 evidence:** "Sure, I guess that's a problem"
-
-### 5. Problem Validation Scorecard
-
-For each interview, score the five criteria:
-
-| Criterion | Score (1-5) | Evidence |
-|-----------|-------------|----------|
-| Real | 4 | Described specific incident |
-| Painful | 5 | Costs them 5 hours/week |
-| Urgent | 3 | "Need to fix this quarter" |
-| Frequent | 4 | Happens 2-3x per week |
-| Budget | 3 | $200/mo spent on workarounds |
-
-**Total: 19/25 - Strong problem validation**
-
-### 6. Aggregate Across Interviews
-
-After 10+ interviews, look for patterns:
-
-| Criterion | Avg Score | Consistent? |
-|-----------|-----------|-------------|
-| Real | 4.2 | Yes (all mention) |
-| Painful | 3.8 | Mixed (varies by role) |
-| Urgent | 2.5 | No (not time-sensitive) |
-| Frequent | 4.0 | Yes (weekly+) |
-| Budget | 3.2 | Mixed (startups vs. enterprise) |
-
-**Interpretation:**
-- Problem is real and frequent ✓
-- Pain varies by segment (narrow the target)
-- Urgency is weak (need trigger or timing)
-- Budget exists but inconsistent (pricing sensitivity)
-
-### 7. Red Flags
-
-**Problem may not be valid if:**
-
-- Only you experience it (n=1 problem)
-- People only agree when prompted
-- No one has tried to solve it
-- It's theoretical ("I might someday...")
-- No budget exists anywhere
-- Frequency is rare (annual event)
-- Cost is low (doesn't justify solution)
-
-**False validation signals:**
-
-- "That sounds like a great idea!" (enthusiasm ≠ validation)
-- "I would definitely use that" (hypothetical ≠ real)
-- "You should build that" (advice ≠ commitment)
-
-### 8. When to Move On
-
-**Problem validated when:**
-- 8/10+ interviews score 18/25+ on scorecard
-- Customers have tried to solve it themselves
-- Budget exists or can be found
-- You can find more customers like this easily
-
-**Problem NOT validated when:**
-- Scores inconsistent across interviews
-- No one has tried to solve it
-- Budget doesn't exist
-- Problem is "nice to have" not "must solve"
-
-**If not validated:** Find a different problem or different customer segment.
-
-### 9. Synthesis
-
-After problem validation interviews:
-- Is this problem real, painful, urgent, frequent, and funded?
-- Who experiences this problem most intensely?
-- What triggers the problem? (Marketing insight)
-- What are they currently doing about it?
-- Should we proceed to solution validation?
-
-## Example
-
-**Hypothesis**: "Small business owners struggle to track cash flow"
-
-### Interview 1: Maria, bakery owner
-
-| Criterion | Score | Evidence |
-|-----------|-------|----------|
-| Real | 5 | "I check my bank every morning" |
-| Painful | 4 | "Almost missed payroll twice" |
-| Urgent | 5 | "I need this fixed now" |
-| Frequent | 5 | "Daily stress" |
-| Budget | 3 | "I have QuickBooks but it doesn't help" |
-| **Total** | **22/25** | Strong validation |
-
-### Interview 2: James, freelance consultant
-
-| Criterion | Score | Evidence |
-|-----------|-------|----------|
-| Real | 3 | "Sometimes I lose track" |
-| Painful | 2 | "Not really a big deal" |
-| Urgent | 1 | "Maybe eventually" |
-| Frequent | 2 | "When quarterly taxes are due" |
-| Budget | 2 | "I just use a spreadsheet" |
-| **Total** | **10/25** | Weak validation |
-
-### Interview 3: Linda, restaurant owner
-
-| Criterion | Score | Evidence |
-|-----------|-------|----------|
-| Real | 5 | "Biggest source of stress" |
-| Painful | 5 | "Had to take emergency loan" |
-| Urgent | 5 | "Dealing with this right now" |
-| Frequent | 5 | "Think about it every day" |
-| Budget | 4 | "Pay my accountant $500/mo" |
-| **Total** | **24/25** | Strong validation |
-
-### Aggregate Analysis (10 interviews)
-
-| Segment | Avg Score | Pattern |
-|---------|-----------|---------|
-| Retail/Food owners | 22.3 | Strong problem |
-| Service providers | 14.2 | Weak problem |
-| Professional services | 12.1 | Weak problem |
-
-### Findings
-
-**Problem validated for:** Retail and food business owners
-**Problem NOT validated for:** Freelancers and professional services
-
-**Key insight:** The problem is real for businesses with:
-- High transaction volume (daily)
-- Variable revenue (seasonal, weather-dependent)
-- Tight margins (cash-sensitive)
-- Multiple expenses (rent, payroll, inventory)
-
-**Not a problem for:** Businesses with:
-- Predictable revenue (retainers, subscriptions)
-- Low expense volume
-- Comfortable margins
-
-### Decision
-
-**Proceed with solution validation** for retail/food segment
-**Do NOT pursue** freelancer/consultant segment
-
-**Refined problem statement:**
-"Retail and food business owners struggle to predict cash flow and avoid shortfalls due to variable daily revenue and multiple recurring expenses."
-
-**Insight:** The problem validation revealed that "small business owners" was too broad. The problem intensity varied 2x between segments. By narrowing to retail/food, the team avoided building for a segment that doesn't feel the pain urgently enough to buy.

package/payload/platform/plugins/venture-studio/skills/zero-to-prototype/references/product-market-fit.md

@@ -1,256 +0,0 @@
-# Product-Market Fit Signals
-
-## Purpose
-Identify and measure whether you've achieved product-market fit—the point where your product satisfies strong market demand and growth becomes organic.
-
-## When to Use
-- Deciding whether to scale or continue iterating
-- Assessing startup health and investment readiness
-- Determining if you should pivot or persevere
-- Communicating progress to stakeholders
-- Planning the transition from search to execution
-
-## Process
-
-### 1. Understand Product-Market Fit
-
-**Marc Andreessen's definition:**
-"Product-market fit means being in a good market with a product that can satisfy that market."
-
-**How it feels:**
-- Before PMF: Pushing a boulder uphill
-- After PMF: The market pulls the product out of you
-
-**The key question:**
-If you ask "Do we have product-market fit?", you probably don't. When you have it, you know.
-
-### 2. Qualitative PMF Signals
-
-**Strong positive signals:**
-
-- **Customers actively recommend you** - Unprompted referrals
-- **Organic usage grows** - Usage increases without marketing
-- **Customers find you** - Inbound exceeds outbound
-- **They'd be "very disappointed" without you** - Emotional attachment
-- **You're turning away customers** - Demand exceeds capacity
-- **Sales cycles shorten** - Less convincing required
-- **Low-touch conversion** - Customers self-serve to purchase
-
-**Weak or absent signals:**
-
-- Only paid/incentivized users
-- High churn even with engaged users
-- Customers need constant convincing
-- Features feel like "nice to have"
-- Growth plateaus when marketing stops
-- Heavy discounting required to close
-
-### 3. Quantitative PMF Signals
-
-**The Sean Ellis Test (Most common)**
-
-Survey users: "How would you feel if you could no longer use [product]?"
-- Very disappointed
-- Somewhat disappointed
-- Not disappointed
-
-**PMF threshold:** 40%+ "Very disappointed"
-
-**Retention Curves**
-
-Track cohort retention over time:
-- **Before PMF:** Retention declines to near zero
-- **At PMF:** Retention curve flattens (stable base of retained users)
-- **After PMF:** Retention improves with product maturity
-
-**Example retention curves:**
-```
-Before PMF:  100% → 50% → 25% → 10% → 3% → 1%
-At PMF:      100% → 60% → 45% → 40% → 38% → 38%
-Strong PMF:  100% → 70% → 55% → 50% → 50% → 52%
-```
-
-**Net Revenue Retention (NRR)**
-
-For subscription businesses:
-NRR = (Starting MRR + Expansion - Contraction - Churn) / Starting MRR
-
-- **<100%:** Revenue shrinking (no PMF)
-- **100-110%:** Stable (approaching PMF)
-- **>110%:** Growing from existing customers (strong PMF)
-- **>120%:** Excellent (customers expanding significantly)
-
-**Engagement Ratios**
-
-DAU/MAU ratio (daily active / monthly active):
-- **<10%:** Low engagement (no PMF)
-- **10-20%:** Moderate (signs of PMF)
-- **20-30%:** Strong (clear PMF)
-- **>30%:** Very strong (social/daily use products)
-
-**Unit Economics**
-
-- **LTV > 3x CAC:** Sustainable acquisition
-- **Payback period < 12 months:** Healthy cash flow
-- **Gross margin > 70%:** Software economics
-
-### 4. Measure Your PMF Score
-
-Create a PMF dashboard:
-
-| Signal | Metric | Your Score | Target |
-|--------|--------|------------|--------|
-| Sean Ellis Test | % "Very disappointed" | ? | >40% |
-| Month 3 Retention | % still active | ? | >30% |
-| NRR | Revenue retention | ? | >100% |
-| DAU/MAU | Engagement ratio | ? | >15% |
-| LTV:CAC | Unit economics | ? | >3:1 |
-| Organic % | % growth from organic | ? | >30% |
-
-**PMF strength levels:**
-
-- **0-2 signals:** Pre-PMF (keep iterating)
-- **3-4 signals:** Approaching PMF (validate and tune)
-- **5-6 signals:** PMF achieved (begin scaling)
-
-### 5. PMF for Different Business Models
-
-**B2C/Consumer:**
-- Focus on: Engagement (DAU/MAU), retention, viral coefficient
-- Key test: Would users be very disappointed?
-- Time to PMF: 6-18 months typically
-
-**B2B SaaS:**
-- Focus on: NRR, expansion revenue, sales cycle length
-- Key test: Are they renewing without discounts?
-- Time to PMF: 12-24 months typically
-
-**Marketplace:**
-- Focus on: Liquidity (matches made), repeat usage, NPS both sides
-- Key test: Do supply and demand keep coming back?
-- Time to PMF: 18-36 months typically
-
-**E-commerce:**
-- Focus on: Repeat purchase rate, LTV, CAC payback
-- Key test: Do customers buy again?
-- Time to PMF: 6-12 months typically
-
-### 6. False PMF Signals
-
-**Beware of:**
-
-- **Heavily subsidized growth** - Free/discounted users aren't PMF
-- **One customer concentration** - 50% revenue from one account
-- **Founder-led sales only** - Can others sell it?
-- **Feature-specific engagement** - One feature, rest ignored
-- **Vanity metrics** - Signups without activation
-- **Small sample size** - 10 happy users isn't PMF
-
-**Validate with:**
-- Remove discounts—do they still buy?
-- Have non-founders sell—does it work?
-- Track retention over 6+ months, not weeks
-- Measure across hundreds, not dozens of users
-
-### 7. What to Do at Each Stage
-
-**Pre-PMF (no clear signals):**
-- Talk to customers weekly
-- Run rapid experiments (weekly iterations)
-- Don't scale marketing/sales
-- Focus: Learn and iterate
-
-**Approaching PMF (some signals):**
-- Double down on what's working
-- Narrow focus to best segment
-- Begin building repeatable processes
-- Focus: Validate and tune
-
-**PMF achieved (strong signals):**
-- Scale marketing and sales
-- Hire beyond founders
-- Expand product scope carefully
-- Focus: Grow while maintaining quality
-
-### 8. Synthesis
-
-After assessing PMF:
-- Which signals do you have? Which are missing?
-- What would need to change to achieve the missing signals?
-- Is your current trajectory moving toward PMF?
-- What's the biggest blocker to PMF right now?
-- Should you continue iterating or is it time to pivot?
-
-## Example
-
-**Product**: B2B sales engagement platform
-
-### PMF Assessment (Month 12)
-
-**Qualitative signals:**
-
-| Signal | Evidence | Status |
-|--------|----------|--------|
-| Unprompted referrals | 4 referrals this month | 🟡 Weak |
-| Organic growth | 30% of new users organic | 🟢 Present |
-| Inbound > outbound | 60% inbound | 🟢 Present |
-| Sales cycle shortening | 45 days → 38 days | 🟢 Present |
-| Customer emotion | "Can't live without it" x 3 | 🟡 Weak |
-
-**Quantitative metrics:**
-
-| Metric | Score | Target | Status |
-|--------|-------|--------|--------|
-| Sean Ellis Test | 35% | 40% | 🟡 Close |
-| Month 3 Retention | 42% | 30% | 🟢 Achieved |
-| NRR | 108% | 100% | 🟢 Achieved |
-| DAU/MAU | 22% | 15% | 🟢 Achieved |
-| LTV:CAC | 2.8:1 | 3:1 | 🟡 Close |
-| Organic % | 30% | 30% | 🟢 Achieved |
-
-### Assessment
-
-**PMF Score: 4/6 strong, 2/6 close**
-
-**Diagnosis:** Approaching PMF but not fully there
-- Retention and engagement are strong
-- Unit economics nearly viable
-- Sean Ellis test just under threshold
-- Referrals not yet organic
-
-### Action Plan
-
-**To achieve full PMF:**
-
-1. **Improve Sean Ellis score:**
-   - Survey users who churned: why not "very disappointed"?
-   - Identify and double down on "must-have" features
-   - Target: 40%+ in 90 days
-
-2. **Improve LTV:CAC:**
-   - Test price increase (10%)
-   - Reduce CAC through content marketing
-   - Target: 3.5:1 in 90 days
-
-3. **Increase referrals:**
-   - Launch formal referral program
-   - Make sharing easier in-product
-   - Target: 8 referrals/month
-
-### 90-Day Re-Assessment
-
-| Metric | Before | After | Change |
-|--------|--------|-------|--------|
-| Sean Ellis Test | 35% | 44% | +9% ✓ |
-| LTV:CAC | 2.8:1 | 3.4:1 | +0.6 ✓ |
-| Referrals/month | 4 | 11 | +175% ✓ |
-
-**New PMF Score: 6/6**
-
-**Decision:** PMF achieved. Begin scaling.
-
-- Hire 2 additional salespeople
-- Increase marketing budget 3x
-- Begin Series A fundraising conversations
-
-**Insight:** PMF wasn't binary—it was a spectrum. The 90-day focus on the weakest signals (Sean Ellis, LTV:CAC, referrals) pushed us over the threshold. Measuring objectively prevented both premature scaling and unnecessary pivoting.