autodoc-agent-kit 1.0.0

package/src/modules/product/skills/saas-economics-efficiency-metrics/examples/cash-trap.md

@@ -0,0 +1,365 @@
+# Example: Cash Trap (Good LTV:CAC, Terrible Payback)
+
+**Company:** EnterpriseCRM (enterprise sales-led CRM)
+**Stage:** Series A, post-product-market fit
+**Customer Base:** 50 enterprise accounts
+**Period:** Q2 2024
+
+---
+
+## The Illusion: Great LTV:CAC Ratio
+
+### Unit Economics (Look Great!)
+```
+CAC: $80,000
+LTV: $400,000
+LTV:CAC: 5:1 ✅ (looks healthy!)
+Gross Margin: 85%
+```
+
+**First impression:** "5:1 LTV:CAC is amazing! Let's scale!"
+
+---
+
+## The Reality: Terrible Payback Period
+
+### Deep Dive on Payback
+```
+CAC: $80,000
+Monthly ARPU: $8,333 (from $100K annual contracts)
+Gross Margin: 85%
+
+Payback Period = $80,000 / ($8,333 × 85%)
+Payback Period = $80,000 / $7,083
+Payback Period = 11.3 months
+
+Wait... that doesn't look terrible?
+```
+
+### But Wait—Payment Terms Reality
+```
+Average Contract: $100,000/year
+Payment Terms: Quarterly invoicing (not annual upfront)
+Actual Monthly Cash Collection: $8,333/month
+
+CAC Spend Timing: Upfront (sales cycle complete)
+Revenue Collection: Monthly over 12+ months
+
+Cash Payback = Time until cash in > cash out
+Actual Cash Payback: 11.3 months ⚠️
+```
+
+### The Real Problem: Sales Cycle + Deal Size
+```
+Average Sales Cycle: 6 months
+CAC Timing: Spent over 6-month sales cycle ($80K total)
+First Payment: Month 7 (after deal closes)
+Monthly Cash: $8,333
+
+True Payback Timeline:
+- Month 0-6: Spend $80K acquiring customer (no revenue)
+- Month 7: First $8,333 payment
+- Month 18: Finally break even on cash ($8,333 × 11.3 = ~$94K collected)
+
+Effective Payback: 18 months from start of sales cycle ��
+```
+
+---
+
+## Capital Efficiency Reality Check
+
+### Burn Rate & Runway
+```
+Monthly Expenses:
+  - S&M: $500,000 (mostly sales team for 6-month cycles)
+  - R&D: $300,000
+  - G&A: $100,000
+  - COGS: $50,000
+Total Monthly Burn: $950,000
+
+Monthly Revenue: $416,665 ($5M ARR / 12)
+Net Burn: $533,335/month 🚨
+
+Cash Balance: $6,000,000
+Runway: $6M / $533K = 11.3 months 🚨
+```
+
+---
+
+## The Cash Trap Equation
+
+### What Happens When You Try to Scale
+
+**Current state:**
+- 50 customers
+- $5M ARR
+- 11.3 months runway
+
+**CEO decision:** "5:1 LTV:CAC is great! Let's double sales headcount and scale!"
+
+**What happens:**
+```
+Scenario: Double sales team (10 → 20 AEs)
+
+New Monthly Burn:
+  - S&M: $1,000,000 (doubled)
+  - R&D: $300,000 (same)
+  - G&A: $120,000 (+20% for ops support)
+  - COGS: $50,000 (same for now)
+Total: $1,470,000/month
+
+Revenue (first 6 months): Still $416K/month (deals haven't closed yet)
+Net Burn: $1,054,000/month 🚨🚨
+
+NEW Runway: $6M / $1.05M = 5.7 months 🚨🚨🚨
+```
+
+**Result:** You'll run out of money in 6 months, right when the new deals START to close. You've accelerated your own death.
+
+---
+
+## The Math of the Trap
+
+### Why 5:1 LTV:CAC Doesn't Save You
+
+**Year 1 Cash Flow (Before Scaling):**
+```
+Customers Added: 20 (existing sales team capacity)
+CAC Spent: 20 × $80K = $1.6M cash out
+Revenue Collected (Year 1): 20 × $100K × 11.3/12 = $1.88M cash in
+
+Net Cash from New Customers: +$280K (barely positive)
+```
+
+**Year 1 Cash Flow (After Scaling—Doubling Sales Team):**
+```
+Customers Added: 40 (doubled capacity)
+CAC Spent: 40 × $80K = $3.2M cash out
+Revenue Collected (Year 1): 40 × $100K × 11.3/12 = $3.77M cash in
+
+BUT: Existing S&M spend doubled for full year
+Additional S&M Burn: $500K × 12 = $6M extra per year
+
+Net Cash Impact: $3.77M revenue - $3.2M CAC - $6M extra S&M = -$5.43M 🚨
+```
+
+**You burned an extra $5.43M to add $4M in ARR. That's a 1.4:1 cash-to-ARR ratio—terrible.**
+
+---
+
+## Analysis
+
+### 🚨 The Cash Trap Mechanics
+
+**Why this happens:**
+1. **Long sales cycles** (6 months) delay revenue
+2. **Monthly/quarterly billing** delays cash collection
+3. **High CAC** ($80K) requires significant upfront investment
+4. **Payback period** (11.3 months) is manageable but not fast
+5. **Combined effect:** 18 months from sales start to cash payback
+
+**The trap:**
+- LTV:CAC ratio looks healthy (5:1)
+- But cash recovery takes 18 months from sales cycle start
+- Scaling burns cash faster than you can recover it
+- Runway shrinks even as you "grow"
+
+---
+
+### 📊 Why Traditional Metrics Mislead
+
+**What looks good:**
+- ✅ LTV:CAC = 5:1 (healthy by any standard)
+- ✅ Gross margin = 85% (excellent)
+- ✅ Average contract value = $100K (enterprise deals)
+- ✅ Customer lifetime = 4+ years (good retention)
+
+**What's hidden:**
+- 🚨 18-month effective payback from sales start
+- 🚨 6-month sales cycle delays revenue
+- 🚨 Quarterly billing delays cash
+- 🚨 High CAC requires patient capital
+- 🚨 Scaling accelerates cash burn before revenue arrives
+
+---
+
+## How to Escape the Cash Trap
+
+### Option 1: Shorten Payback Period (Best)
+
+**A. Negotiate Annual Upfront Payments**
+```
+Before: Quarterly billing = 11.3-month payback
+After: Annual upfront = 0.96-month payback ✅
+
+Impact on Payback:
+$80K CAC / ($100K × 85%) = 0.96 months (instant payback!)
+
+Impact on Runway:
+Collect $100K upfront vs. $25K quarterly
+4x cash acceleration
+Runway extends from 11 months to 30+ months
+```
+
+**B. Reduce CAC**
+```
+Strategies:
+- Shorten sales cycle from 6 months to 4 months (reduce CAC by 20%)
+- Improve win rate from 20% to 30% (reduce wasted sales effort)
+- Target warmer inbound leads (reduce prospecting costs)
+
+Target: Reduce CAC from $80K to $50K
+New Payback: $50K / ($8,333 × 85%) = 7 months ✅
+```
+
+**C. Increase ARPU**
+```
+Current: $8,333/month ($100K annual)
+Target: $12,500/month ($150K annual) via:
+- Premium tier pricing
+- Add-on modules
+- Seat expansion
+
+New Payback: $80K / ($12,500 × 85%) = 7.5 months ✅
+```
+
+---
+
+### Option 2: Raise Capital to Extend Runway
+
+**Reality check:**
+- You need 18+ months of runway to sustain sales cycle + payback
+- Current runway: 11 months (insufficient)
+- Need to raise: $12M+ to extend runway to 24 months
+
+**Pros:**
+- Buys time for revenue to catch up
+- Can continue scaling
+
+**Cons:**
+- Dilution
+- Sets high expectations for next round
+- Doesn't fix fundamental payback problem
+
+**Recommended if:**
+- Already in fundraising process
+- Confident you can negotiate annual upfront (fixes root cause)
+- Growth rate justifies dilution
+
+---
+
+### Option 3: Slow Down Growth (Survive)
+
+**Accept slower growth to preserve cash:**
+```
+Reduce sales team from 10 to 6 AEs
+S&M Spend: $300K/month (down from $500K)
+
+New Monthly Burn:
+- S&M: $300K
+- R&D: $300K
+- G&A: $100K
+- COGS: $50K
+Total: $750K/month
+
+Net Burn: $750K - $416K = $334K/month
+New Runway: $6M / $334K = 18 months ✅
+```
+
+**Pros:**
+- Extends runway to 18 months
+- Gives time to negotiate annual contracts
+- Reduces burn while maintaining existing revenue
+
+**Cons:**
+- Slower growth
+- May miss market window
+- Team morale impact
+
+**Recommended if:**
+- Can't raise capital
+- Need time to fix payment terms
+- Runway <6 months (emergency mode)
+
+---
+
+### Option 4: Change GTM Motion (Pivot)
+
+**Move upmarket to larger deals with better payment terms:**
+```
+Current: $100K ACV, quarterly billing
+Target: $300K ACV, annual upfront billing
+
+Impact:
+- CAC may increase to $120K (more complex sales)
+- But LTV increases to $1.2M (3x larger deals)
+- Payback: $120K / ($300K × 85%) = 0.47 months ✅
+- LTV:CAC improves to 10:1
+```
+
+**Or move to product-led growth (if feasible):**
+- Reduce CAC from $80K to $5K (self-serve)
+- Smaller deal sizes ($20K ACV)
+- But 4-month payback vs. 18-month payback
+- Can scale without burning cash
+
+---
+
+## Recommended Action Plan
+
+### Immediate (Weeks 1-4): Stop the Bleeding
+1. **Freeze hiring** — Don't add sales headcount until payback is fixed
+2. **Audit cash runway** — Calculate true runway with payment timing
+3. **Prioritize existing pipeline** — Close in-flight deals to boost near-term cash
+
+### Short-term (Months 1-3): Fix Payment Terms
+1. **Negotiate annual upfront** — Contact all new prospects, offer 10% discount for annual prepay
+2. **Target: 80% of new deals on annual upfront within 90 days**
+3. **Impact: Payback drops from 11 months to <2 months**
+
+### Medium-term (Months 3-6): Reduce CAC
+1. **Shorten sales cycle** — Improve qualification, reduce dead-end deals
+2. **Target: 6 months → 4 months sales cycle**
+3. **Optimize sales process** — Better demos, faster approvals, streamlined onboarding
+
+### Long-term (Months 6-12): Scale Sustainably
+1. **Validate new payback** — Ensure <6 month payback on annual contracts
+2. **Gradually scale** — Add sales headcount only when cash payback is proven
+3. **Monitor cash-to-ARR ratio** — Should be <1:1 (invest $1 cash, get $1+ ARR)
+
+---
+
+## Key Metrics to Track
+
+**Before you scale again, ensure:**
+- [ ] Payback period <6 months (with annual upfront)
+- [ ] 80%+ of deals on annual payment terms
+- [ ] Runway >18 months
+- [ ] Cash-to-ARR ratio <1:1 (sustainable growth)
+- [ ] Sales cycle <4 months
+
+**Weekly cash monitoring:**
+- [ ] Cash balance
+- [ ] Weekly burn rate
+- [ ] Weeks of runway remaining
+- [ ] New bookings (cash collected, not just ARR)
+
+---
+
+## Key Takeaway
+
+**LTV:CAC ratio is necessary but not sufficient.**
+
+This business has:
+- ✅ Great LTV:CAC (5:1)
+- ✅ Strong gross margin (85%)
+- ✅ Good retention (4+ year lifetime)
+
+But it also has:
+- 🚨 18-month effective payback (6-month sales cycle + 11-month cash recovery)
+- 🚨 Quarterly billing (delays cash)
+- 🚨 11-month runway (insufficient for sales cycle + payback)
+
+**The fix is simple:** Negotiate annual upfront payments. This turns an 11-month payback into a <1-month payback, unlocking sustainable scaling.
+
+**Lesson:** Always pair LTV:CAC with payback period AND cash collection timing. Otherwise, you'll scale yourself into bankruptcy while the metrics look great on paper.

package/src/modules/product/skills/saas-economics-efficiency-metrics/examples/healthy-unit-economics.md

@@ -0,0 +1,279 @@
+# Example: Healthy Unit Economics & Efficient Scaling
+
+**Company:** CloudAnalytics (mid-market business intelligence SaaS)
+**Stage:** Series B growth stage
+**Customer Base:** 500 accounts, 12,000 users
+**Period:** Q2 2024
+
+---
+
+## Unit Economics
+
+### Gross Margin
+```
+Quarterly Revenue: $6,000,000
+COGS:
+  - AWS hosting & infrastructure: $600,000
+  - Payment processing (2.5%): $150,000
+  - Customer onboarding: $150,000
+Total COGS: $900,000
+
+Gross Profit: $5,100,000
+Gross Margin: 85% ✅
+```
+
+### CAC by Segment
+```
+SMB:
+  - S&M Spend: $200K/quarter
+  - New Customers: 50
+  - CAC: $4,000
+
+Mid-Market:
+  - S&M Spend: $400K/quarter
+  - New Customers: 40
+  - CAC: $10,000
+
+Enterprise:
+  - S&M Spend: $300K/quarter
+  - New Customers: 10
+  - CAC: $30,000
+
+Blended CAC: $9,000
+```
+
+### LTV by Segment
+```
+SMB:
+  - ARPU: $250/month
+  - Monthly Churn: 3%
+  - Gross Margin: 82%
+  - LTV: ($250 × 82%) / 3% = $6,833
+
+Mid-Market:
+  - ARPU: $1,200/month
+  - Monthly Churn: 2%
+  - Gross Margin: 85%
+  - LTV: ($1,200 × 85%) / 2% = $51,000
+
+Enterprise:
+  - ARPU: $5,000/month
+  - Monthly Churn: 1%
+  - Gross Margin: 88%
+  - LTV: ($5,000 × 88%) / 1% = $440,000
+
+Blended LTV: $45,000
+```
+
+### LTV:CAC Ratios
+```
+SMB: $6,833 / $4,000 = 1.7:1 ⚠️ (marginal)
+Mid-Market: $51,000 / $10,000 = 5.1:1 ✅ (excellent)
+Enterprise: $440,000 / $30,000 = 14.7:1 ✅ (outstanding)
+
+Blended: $45,000 / $9,000 = 5:1 ✅
+```
+
+### Payback Periods
+```
+SMB: $4,000 / ($250 × 82%) = 19.5 months ⚠️
+Mid-Market: $10,000 / ($1,200 × 85%) = 9.8 months ✅
+Enterprise: $30,000 / ($5,000 × 88%) = 6.8 months ✅
+
+Blended: 11 months ✅
+```
+
+---
+
+## Capital Efficiency
+
+### Burn Rate & Runway
+```
+Monthly Expenses:
+  - S&M: $300,000
+  - R&D: $400,000
+  - G&A: $150,000
+  - COGS: $300,000
+Gross Burn: $1,150,000/month
+
+Monthly Revenue: $2,000,000
+Net Burn: -$850,000/month (profitable! ✅)
+
+Cash Balance: $25,000,000
+Runway: Infinite (profitable)
+```
+
+### Operating Expenses
+```
+Annual Revenue: $24M
+
+OpEx:
+  - S&M: $3.6M (15% of revenue) ✅
+  - R&D: $4.8M (20% of revenue) ✅
+  - G&A: $1.8M (7.5% of revenue) ✅
+Total OpEx: $10.2M (42.5% of revenue)
+
+Net Income: $24M - $3.6M - $10.2M = $10.2M
+Profit Margin: 42.5% ✅
+```
+
+---
+
+## Efficiency Ratios
+
+### Rule of 40
+```
+Revenue Growth Rate: 45% YoY
+Profit Margin: 42.5%
+Rule of 40 = 45% + 42.5% = 87.5 ✅ (outstanding!)
+```
+
+### Magic Number
+```
+Q2 Revenue: $6M
+Q1 Revenue: $5.2M
+Increase: $800K
+
+Q1 S&M Spend: $850K
+Magic Number: ($800K × 4) / $850K = $3.2M / $850K = 3.76 ✅ (excellent!)
+```
+
+### Operating Leverage (Last 4 Quarters)
+| Quarter | Revenue | Rev Growth | OpEx | OpEx Growth | Leverage |
+|---------|---------|------------|------|-------------|----------|
+| Q3 2023 | $4.5M | - | $2.2M | - | - |
+| Q4 2023 | $5.0M | 11% | $2.4M | 9% | Positive ✅ |
+| Q1 2024 | $5.2M | 4% | $2.5M | 4% | Neutral |
+| Q2 2024 | $6.0M | 15% | $2.55M | 2% | Positive ✅ |
+
+**Analysis:** Revenue growing faster than OpEx = positive operating leverage.
+
+---
+
+## Analysis
+
+### ✅ Exceptional Strengths
+
+**Outstanding unit economics:**
+- 5:1 blended LTV:CAC (healthy range: 3-5:1)
+- 11-month blended payback (target: <12 months)
+- 85% gross margin (well above 70% SaaS benchmark)
+- Mid-market and enterprise segments have stellar economics
+
+**Profitable growth:**
+- 42.5% profit margin (exceptional for growth-stage SaaS)
+- Rule of 40 = 87.5 (nearly double the 40 threshold)
+- Infinite runway (profitable, no burn)
+
+**Efficient go-to-market:**
+- Magic number = 3.76 (well above 0.75 threshold)
+- For every $1 in S&M spend, generating $3.76 in new ARR
+- Positive operating leverage (revenue growing faster than costs)
+
+**Segment optimization:**
+- Enterprise: 14.7:1 LTV:CAC, 7-month payback (amazing)
+- Mid-market: 5.1:1 LTV:CAC, 10-month payback (excellent)
+- SMB: 1.7:1 LTV:CAC, 19.5-month payback (marginal)
+
+---
+
+### 📊 Opportunities for Optimization
+
+**SMB segment underperformance:**
+- 1.7:1 LTV:CAC is below 3:1 threshold
+- 19.5-month payback is concerning
+- Contributing to blended metrics, but dragging them down
+
+**Potential actions:**
+1. **Reduce SMB CAC** (improve conversion, shorten sales cycle)
+2. **Increase SMB LTV** (reduce churn, add expansion paths)
+3. **Deprioritize SMB** (shift budget to mid-market/enterprise)
+
+**Channel allocation:**
+- Enterprise has 14.7:1 LTV:CAC but only 10 new customers/quarter
+- Could scale enterprise acquisition more aggressively
+
+---
+
+## Recommended Actions
+
+### 1. Scale Enterprise Acquisition (High Priority)
+**Why:** 14.7:1 LTV:CAC and 7-month payback = massive opportunity.
+
+**Actions:**
+- Increase enterprise S&M budget from $300K to $500K/quarter
+- Hire 2 enterprise AEs
+- Target 20 enterprise logos/quarter (up from 10)
+
+**Expected impact:**
+- Additional $200K/quarter S&M spend
+- 10 additional enterprise customers
+- 10 × $30K CAC = $300K investment
+- 10 × $440K LTV = $4.4M in LTV created
+- Net value creation: $4.1M
+
+---
+
+### 2. Optimize or Exit SMB Segment (Medium Priority)
+**Why:** 1.7:1 LTV:CAC is marginal; 19.5-month payback strains cash (even though profitable overall).
+
+**Option A: Optimize SMB**
+- Reduce CAC through self-serve onboarding (target $2K CAC)
+- Improve retention to 2% monthly churn (boost LTV to $10,250)
+- New LTV:CAC: 5.1:1 (healthy)
+
+**Option B: Exit SMB**
+- Stop SMB acquisition, reallocate $200K/quarter to mid-market/enterprise
+- Focus on higher-quality segments with better economics
+
+**Recommendation:** Try Option A for 2 quarters. If LTV:CAC doesn't improve to >3:1, exit SMB.
+
+---
+
+### 3. Maintain Profitability While Scaling (Ongoing)
+**Why:** 42.5% profit margin + 45% growth is exceptional. Don't sacrifice this.
+
+**Actions:**
+- Continue positive operating leverage (revenue growth > cost growth)
+- Maintain Rule of 40 >40 (ideally >60)
+- Reinvest profits strategically in highest-ROI channels
+
+---
+
+### 4. Monitor Magic Number by Segment (Ongoing)
+**Current blended magic number:** 3.76 (excellent)
+
+**Calculate by segment:**
+- If enterprise magic number is 5+, scale aggressively
+- If SMB magic number is <0.5, consider exiting
+
+---
+
+## Success Metrics (Next 12 Months)
+
+**Growth targets:**
+- [ ] Reach $36M ARR (50% YoY growth)
+- [ ] Maintain >40% profit margin
+- [ ] Rule of 40 >70
+
+**Unit economics targets:**
+- [ ] Blended LTV:CAC remains >4:1
+- [ ] Blended payback remains <12 months
+- [ ] SMB LTV:CAC improves to >3:1 or exit segment
+
+**Efficiency targets:**
+- [ ] Magic number remains >2.0
+- [ ] Positive operating leverage every quarter
+- [ ] S&M efficiency: <20% of revenue
+
+---
+
+## Key Takeaway
+
+This is a model SaaS business:
+- Profitable AND growing (rare combination)
+- Exceptional unit economics (5:1 LTV:CAC, 11-month payback)
+- Highly efficient GTM (3.76 magic number)
+- Strong balance (Rule of 40 = 87.5)
+
+**Main opportunity:** Scale enterprise aggressively while optimizing or exiting SMB segment. The business can sustain aggressive growth without burning cash.