autodoc-agent-kit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (187) hide show
  1. package/README.md +362 -0
  2. package/package.json +49 -0
  3. package/src/core/module.yaml +5 -0
  4. package/src/modules/design/module.yaml +9 -0
  5. package/src/modules/design/skills/brand-guidelines/LICENSE.txt +202 -0
  6. package/src/modules/design/skills/brand-guidelines/SKILL.md +73 -0
  7. package/src/modules/design/skills/frontend-design/LICENSE.txt +177 -0
  8. package/src/modules/design/skills/frontend-design/SKILL.md +42 -0
  9. package/src/modules/design/skills/web-artifacts-builder/SKILL.md +229 -0
  10. package/src/modules/devops/module.yaml +10 -0
  11. package/src/modules/devops/skills/devops-helper/SKILL.md +60 -0
  12. package/src/modules/devops/skills/k8s-helm/SKILL.md +360 -0
  13. package/src/modules/devops/skills/monitoring-observability/SKILL.md +240 -0
  14. package/src/modules/devops/skills/security-auditor/SKILL.md +105 -0
  15. package/src/modules/engineering/module.yaml +22 -0
  16. package/src/modules/engineering/skills/ai-sdk/SKILL.md +314 -0
  17. package/src/modules/engineering/skills/api-designer/SKILL.md +77 -0
  18. package/src/modules/engineering/skills/code-reviewer/SKILL.md +71 -0
  19. package/src/modules/engineering/skills/db-architect/SKILL.md +50 -0
  20. package/src/modules/engineering/skills/debugger/SKILL.md +59 -0
  21. package/src/modules/engineering/skills/docs-generator/SKILL.md +51 -0
  22. package/src/modules/engineering/skills/git-workflow/SKILL.md +258 -0
  23. package/src/modules/engineering/skills/mcp-builder/LICENSE.txt +202 -0
  24. package/src/modules/engineering/skills/mcp-builder/SKILL.md +236 -0
  25. package/src/modules/engineering/skills/mcp-builder/reference/evaluation.md +602 -0
  26. package/src/modules/engineering/skills/mcp-builder/reference/mcp_best_practices.md +249 -0
  27. package/src/modules/engineering/skills/mcp-builder/reference/node_mcp_server.md +970 -0
  28. package/src/modules/engineering/skills/mcp-builder/reference/python_mcp_server.md +719 -0
  29. package/src/modules/engineering/skills/mcp-builder/scripts/connections.py +151 -0
  30. package/src/modules/engineering/skills/mcp-builder/scripts/evaluation.py +373 -0
  31. package/src/modules/engineering/skills/mcp-builder/scripts/example_evaluation.xml +22 -0
  32. package/src/modules/engineering/skills/mcp-builder/scripts/requirements.txt +2 -0
  33. package/src/modules/engineering/skills/nextjs-15/SKILL.md +312 -0
  34. package/src/modules/engineering/skills/perf-optimizer/SKILL.md +60 -0
  35. package/src/modules/engineering/skills/react-19/SKILL.md +257 -0
  36. package/src/modules/engineering/skills/refactorer/SKILL.md +60 -0
  37. package/src/modules/engineering/skills/skill-authoring-workflow/SKILL.md +183 -0
  38. package/src/modules/engineering/skills/skill-creator/LICENSE.txt +202 -0
  39. package/src/modules/engineering/skills/skill-creator/SKILL.md +356 -0
  40. package/src/modules/engineering/skills/skill-creator/references/output-patterns.md +82 -0
  41. package/src/modules/engineering/skills/skill-creator/references/workflows.md +28 -0
  42. package/src/modules/engineering/skills/skill-creator/scripts/__pycache__/quick_validate.cpython-313.pyc +0 -0
  43. package/src/modules/engineering/skills/skill-creator/scripts/init_skill.py +303 -0
  44. package/src/modules/engineering/skills/skill-creator/scripts/package_skill.py +110 -0
  45. package/src/modules/engineering/skills/skill-creator/scripts/quick_validate.py +95 -0
  46. package/src/modules/engineering/skills/typescript/SKILL.md +231 -0
  47. package/src/modules/engineering/skills/zod-4/SKILL.md +223 -0
  48. package/src/modules/product/module.yaml +51 -0
  49. package/src/modules/product/skills/acquisition-channel-advisor/SKILL.md +643 -0
  50. package/src/modules/product/skills/acquisition-channel-advisor/examples/conversation-flow.md +531 -0
  51. package/src/modules/product/skills/ai-shaped-readiness-advisor/SKILL.md +923 -0
  52. package/src/modules/product/skills/altitude-horizon-framework/SKILL.md +250 -0
  53. package/src/modules/product/skills/altitude-horizon-framework/examples/sample.md +85 -0
  54. package/src/modules/product/skills/business-health-diagnostic/SKILL.md +783 -0
  55. package/src/modules/product/skills/company-research/SKILL.md +385 -0
  56. package/src/modules/product/skills/company-research/examples/sample.md +164 -0
  57. package/src/modules/product/skills/company-research/template.md +60 -0
  58. package/src/modules/product/skills/context-engineering-advisor/SKILL.md +763 -0
  59. package/src/modules/product/skills/customer-journey-map/SKILL.md +346 -0
  60. package/src/modules/product/skills/customer-journey-map/examples/meta-product-manager-skills.md +40 -0
  61. package/src/modules/product/skills/customer-journey-map/examples/sample.md +33 -0
  62. package/src/modules/product/skills/customer-journey-map/template.md +28 -0
  63. package/src/modules/product/skills/customer-journey-mapping-workshop/SKILL.md +523 -0
  64. package/src/modules/product/skills/director-readiness-advisor/SKILL.md +351 -0
  65. package/src/modules/product/skills/director-readiness-advisor/examples/conversation-flow.md +96 -0
  66. package/src/modules/product/skills/discovery-interview-prep/SKILL.md +410 -0
  67. package/src/modules/product/skills/discovery-process/SKILL.md +504 -0
  68. package/src/modules/product/skills/discovery-process/examples/sample.md +60 -0
  69. package/src/modules/product/skills/discovery-process/template.md +39 -0
  70. package/src/modules/product/skills/eol-message/SKILL.md +348 -0
  71. package/src/modules/product/skills/eol-message/examples/sample.md +87 -0
  72. package/src/modules/product/skills/eol-message/template.md +74 -0
  73. package/src/modules/product/skills/epic-breakdown-advisor/SKILL.md +665 -0
  74. package/src/modules/product/skills/epic-hypothesis/SKILL.md +277 -0
  75. package/src/modules/product/skills/epic-hypothesis/examples/sample.md +104 -0
  76. package/src/modules/product/skills/epic-hypothesis/template.md +30 -0
  77. package/src/modules/product/skills/executive-onboarding-playbook/SKILL.md +280 -0
  78. package/src/modules/product/skills/executive-onboarding-playbook/examples/sample.md +116 -0
  79. package/src/modules/product/skills/feature-investment-advisor/SKILL.md +639 -0
  80. package/src/modules/product/skills/feature-investment-advisor/examples/conversation-flow.md +538 -0
  81. package/src/modules/product/skills/finance-based-pricing-advisor/SKILL.md +763 -0
  82. package/src/modules/product/skills/finance-metrics-quickref/SKILL.md +309 -0
  83. package/src/modules/product/skills/jobs-to-be-done/SKILL.md +370 -0
  84. package/src/modules/product/skills/jobs-to-be-done/examples/sample.md +80 -0
  85. package/src/modules/product/skills/jobs-to-be-done/template.md +65 -0
  86. package/src/modules/product/skills/lean-ux-canvas/SKILL.md +561 -0
  87. package/src/modules/product/skills/lean-ux-canvas/examples/sample.md +88 -0
  88. package/src/modules/product/skills/lean-ux-canvas/template.md +32 -0
  89. package/src/modules/product/skills/opportunity-solution-tree/SKILL.md +420 -0
  90. package/src/modules/product/skills/opportunity-solution-tree/examples/sample.md +104 -0
  91. package/src/modules/product/skills/opportunity-solution-tree/template.md +33 -0
  92. package/src/modules/product/skills/pestel-analysis/SKILL.md +376 -0
  93. package/src/modules/product/skills/pestel-analysis/examples/sample.md +143 -0
  94. package/src/modules/product/skills/pestel-analysis/template.md +53 -0
  95. package/src/modules/product/skills/pol-probe/SKILL.md +217 -0
  96. package/src/modules/product/skills/pol-probe/examples/sample.md +136 -0
  97. package/src/modules/product/skills/pol-probe/template.md +59 -0
  98. package/src/modules/product/skills/pol-probe-advisor/SKILL.md +492 -0
  99. package/src/modules/product/skills/positioning-statement/SKILL.md +230 -0
  100. package/src/modules/product/skills/positioning-statement/examples/sample.md +51 -0
  101. package/src/modules/product/skills/positioning-statement/template.md +25 -0
  102. package/src/modules/product/skills/positioning-workshop/SKILL.md +424 -0
  103. package/src/modules/product/skills/prd-development/SKILL.md +655 -0
  104. package/src/modules/product/skills/prd-development/examples/sample.md +43 -0
  105. package/src/modules/product/skills/prd-development/template.md +55 -0
  106. package/src/modules/product/skills/press-release/SKILL.md +269 -0
  107. package/src/modules/product/skills/press-release/examples/sample.md +73 -0
  108. package/src/modules/product/skills/press-release/template.md +39 -0
  109. package/src/modules/product/skills/prioritization-advisor/SKILL.md +448 -0
  110. package/src/modules/product/skills/problem-framing-canvas/SKILL.md +466 -0
  111. package/src/modules/product/skills/problem-framing-canvas/examples/sample.md +58 -0
  112. package/src/modules/product/skills/problem-framing-canvas/template.md +22 -0
  113. package/src/modules/product/skills/problem-statement/SKILL.md +246 -0
  114. package/src/modules/product/skills/problem-statement/examples/sample.md +82 -0
  115. package/src/modules/product/skills/problem-statement/template.md +37 -0
  116. package/src/modules/product/skills/product-strategy-session/SKILL.md +426 -0
  117. package/src/modules/product/skills/product-strategy-session/examples/sample.md +67 -0
  118. package/src/modules/product/skills/product-strategy-session/template.md +38 -0
  119. package/src/modules/product/skills/proto-persona/SKILL.md +326 -0
  120. package/src/modules/product/skills/proto-persona/examples/sample.md +97 -0
  121. package/src/modules/product/skills/proto-persona/template.md +45 -0
  122. package/src/modules/product/skills/recommendation-canvas/SKILL.md +375 -0
  123. package/src/modules/product/skills/recommendation-canvas/examples/sample.md +94 -0
  124. package/src/modules/product/skills/recommendation-canvas/template.md +86 -0
  125. package/src/modules/product/skills/roadmap-planning/SKILL.md +505 -0
  126. package/src/modules/product/skills/roadmap-planning/examples/sample.md +62 -0
  127. package/src/modules/product/skills/roadmap-planning/template.md +30 -0
  128. package/src/modules/product/skills/saas-economics-efficiency-metrics/SKILL.md +694 -0
  129. package/src/modules/product/skills/saas-economics-efficiency-metrics/examples/cash-trap.md +365 -0
  130. package/src/modules/product/skills/saas-economics-efficiency-metrics/examples/healthy-unit-economics.md +279 -0
  131. package/src/modules/product/skills/saas-economics-efficiency-metrics/template.md +263 -0
  132. package/src/modules/product/skills/saas-revenue-growth-metrics/SKILL.md +630 -0
  133. package/src/modules/product/skills/saas-revenue-growth-metrics/examples/healthy-saas.md +131 -0
  134. package/src/modules/product/skills/saas-revenue-growth-metrics/examples/warning-signs.md +229 -0
  135. package/src/modules/product/skills/saas-revenue-growth-metrics/template.md +192 -0
  136. package/src/modules/product/skills/storyboard/SKILL.md +252 -0
  137. package/src/modules/product/skills/storyboard/examples/sample.md +71 -0
  138. package/src/modules/product/skills/storyboard/template.md +41 -0
  139. package/src/modules/product/skills/tam-sam-som-calculator/SKILL.md +392 -0
  140. package/src/modules/product/skills/tam-sam-som-calculator/examples/sample.md +142 -0
  141. package/src/modules/product/skills/tam-sam-som-calculator/scripts/market-sizing.py +95 -0
  142. package/src/modules/product/skills/tam-sam-som-calculator/template.md +35 -0
  143. package/src/modules/product/skills/user-story/SKILL.md +272 -0
  144. package/src/modules/product/skills/user-story/examples/sample.md +110 -0
  145. package/src/modules/product/skills/user-story/scripts/user-story-template.py +65 -0
  146. package/src/modules/product/skills/user-story/template.md +32 -0
  147. package/src/modules/product/skills/user-story-mapping/SKILL.md +285 -0
  148. package/src/modules/product/skills/user-story-mapping/examples/sample.md +77 -0
  149. package/src/modules/product/skills/user-story-mapping/template.md +41 -0
  150. package/src/modules/product/skills/user-story-mapping-workshop/SKILL.md +477 -0
  151. package/src/modules/product/skills/user-story-mapping-workshop/template.md +28 -0
  152. package/src/modules/product/skills/user-story-splitting/SKILL.md +303 -0
  153. package/src/modules/product/skills/user-story-splitting/examples/sample.md +147 -0
  154. package/src/modules/product/skills/user-story-splitting/template.md +37 -0
  155. package/src/modules/product/skills/vp-cpo-readiness-advisor/SKILL.md +409 -0
  156. package/src/modules/product/skills/vp-cpo-readiness-advisor/examples/conversation-flow.md +95 -0
  157. package/src/modules/product/skills/workshop-facilitation/SKILL.md +87 -0
  158. package/src/modules/productivity/module.yaml +9 -0
  159. package/src/modules/productivity/skills/doc-coauthoring/SKILL.md +375 -0
  160. package/src/modules/productivity/skills/internal-comms/LICENSE.txt +202 -0
  161. package/src/modules/productivity/skills/internal-comms/SKILL.md +32 -0
  162. package/src/modules/productivity/skills/internal-comms/examples/3p-updates.md +47 -0
  163. package/src/modules/productivity/skills/internal-comms/examples/company-newsletter.md +65 -0
  164. package/src/modules/productivity/skills/internal-comms/examples/faq-answers.md +30 -0
  165. package/src/modules/productivity/skills/internal-comms/examples/general-comms.md +16 -0
  166. package/src/modules/productivity/skills/technical-writing/SKILL.md +266 -0
  167. package/src/modules/qa/module.yaml +9 -0
  168. package/src/modules/qa/skills/test-strategy/SKILL.md +263 -0
  169. package/src/modules/qa/skills/test-writer/SKILL.md +57 -0
  170. package/src/modules/qa/skills/webapp-testing/LICENSE.txt +202 -0
  171. package/src/modules/qa/skills/webapp-testing/SKILL.md +96 -0
  172. package/src/modules/qa/skills/webapp-testing/examples/console_logging.py +35 -0
  173. package/src/modules/qa/skills/webapp-testing/examples/element_discovery.py +40 -0
  174. package/src/modules/qa/skills/webapp-testing/examples/static_html_automation.py +33 -0
  175. package/src/modules/qa/skills/webapp-testing/scripts/with_server.py +106 -0
  176. package/tools/autodoc-npx-wrapper.js +34 -0
  177. package/tools/cli/autodoc-cli.js +55 -0
  178. package/tools/cli/commands/install.js +36 -0
  179. package/tools/cli/commands/status.js +35 -0
  180. package/tools/cli/commands/uninstall.js +60 -0
  181. package/tools/cli/installers/lib/core/installer.js +164 -0
  182. package/tools/cli/installers/lib/core/manifest.js +49 -0
  183. package/tools/cli/installers/lib/ide/manager.js +112 -0
  184. package/tools/cli/installers/lib/ide/platform-codes.yaml +207 -0
  185. package/tools/cli/installers/lib/modules/manager.js +59 -0
  186. package/tools/cli/lib/ui.js +199 -0
  187. package/tools/cli/lib/welcome.js +82 -0
@@ -0,0 +1,783 @@
1
+ ---
2
+ name: business-health-diagnostic
3
+ description: Diagnose SaaS business health across growth, retention, efficiency, and capital. Use when preparing a business review or prioritizing urgent fixes.
4
+ intent: >-
5
+ Diagnose overall SaaS business health by analyzing growth, retention, unit economics, and capital efficiency metrics together. Use this to identify problems early, prioritize actions by urgency, and deliver a comprehensive health scorecard for board meetings, quarterly reviews, or fundraising preparation.
6
+ type: interactive
7
+ theme: finance-metrics
8
+ best_for:
9
+ - "Getting a complete read on your SaaS business health across all dimensions"
10
+ - "Identifying which metrics are red flags vs. leading indicators"
11
+ - "Preparing for a board meeting or investor review"
12
+ scenarios:
13
+ - "Our growth is strong but we're burning cash fast — I need to understand our unit economics before the board meeting"
14
+ - "I'm preparing for a Series A board meeting and need to assess our business health across growth, retention, and efficiency"
15
+ estimated_time: "20-30 min"
16
+ ---
17
+
18
+
19
+ ## Purpose
20
+
21
+ Diagnose overall SaaS business health by analyzing growth, retention, unit economics, and capital efficiency metrics together. Use this to identify problems early, prioritize actions by urgency, and deliver a comprehensive health scorecard for board meetings, quarterly reviews, or fundraising preparation.
22
+
23
+ This is not a single-metric check—it's a holistic diagnostic that connects revenue, retention, economics, and efficiency to reveal systemic issues and opportunities.
24
+
25
+ ## Key Concepts
26
+
27
+ ### The Business Health Framework
28
+
29
+ A SaaS business is healthy when four dimensions work together:
30
+
31
+ 1. **Growth & Retention** — Are you growing and keeping customers?
32
+ - Revenue growth rate
33
+ - NRR (Net Revenue Retention)
34
+ - Churn rate
35
+ - Quick Ratio
36
+
37
+ 2. **Unit Economics** — Is the business model profitable at the customer level?
38
+ - CAC (Customer Acquisition Cost)
39
+ - LTV (Lifetime Value)
40
+ - LTV:CAC ratio
41
+ - Payback period
42
+ - Gross margin
43
+
44
+ 3. **Capital Efficiency** — Are you using cash efficiently?
45
+ - Burn rate
46
+ - Runway
47
+ - Rule of 40
48
+ - Magic Number
49
+
50
+ 4. **Strategic Position** — Are you positioned for sustainable success?
51
+ - Market positioning (below, at, above market pricing)
52
+ - Competitive moat (network effects, data, brand)
53
+ - Revenue concentration risk
54
+ - Operating leverage
55
+
56
+ ### Stage-Specific Benchmarks
57
+
58
+ **Early Stage (Pre-$10M ARR):**
59
+ - Focus: Product-market fit, unit economics
60
+ - Growth: >50% YoY
61
+ - LTV:CAC: >3:1
62
+ - Gross Margin: >70%
63
+ - Runway: >12 months
64
+ - Acceptable: Negative margins, high burn (if unit economics work)
65
+
66
+ **Growth Stage ($10M-$50M ARR):**
67
+ - Focus: Scaling efficiently
68
+ - Growth: >40% YoY
69
+ - NRR: >100%
70
+ - Rule of 40: >40
71
+ - Magic Number: >0.75
72
+ - Acceptable: Moderate burn if growth is strong
73
+
74
+ **Scale Stage ($50M+ ARR):**
75
+ - Focus: Profitability, efficiency
76
+ - Growth: >25% YoY
77
+ - NRR: >110%
78
+ - Rule of 40: >40
79
+ - Profit Margin: >10%
80
+ - Required: Positive or near-positive cash flow
81
+
82
+ ### Red Flag Categories
83
+
84
+ **Critical (Fix immediately):**
85
+ - Runway <6 months
86
+ - LTV:CAC <1.5:1
87
+ - Churn accelerating cohort-over-cohort
88
+ - NRR <90%
89
+ - Magic Number <0.3
90
+
91
+ **High Priority (Fix within quarter):**
92
+ - Rule of 40 <25
93
+ - Payback >24 months
94
+ - Quick Ratio <2
95
+ - Gross margin <60%
96
+ - Revenue concentration >50% in top 10 customers
97
+
98
+ **Medium Priority (Address within 6 months):**
99
+ - NRR 90-100% (flat, not growing)
100
+ - Magic Number 0.3-0.5
101
+ - Operating leverage negative
102
+ - Churn rate stable but high (>5% monthly)
103
+
104
+ ### Anti-Patterns (What This Is NOT)
105
+
106
+ - **Not a single metric:** "Revenue is growing 50%, we're great!" (ignoring burn, churn, unit economics)
107
+ - **Not stage-agnostic:** Early-stage burn is acceptable; scale-stage burn is a problem
108
+ - **Not static:** Health is directional—are metrics improving or degrading?
109
+ - **Not just numbers:** Context matters (competitive pressure, market changes, team capacity)
110
+
111
+ ### When to Use This Framework
112
+
113
+ **Use this when:**
114
+ - Preparing for board meetings or investor updates
115
+ - Quarterly business reviews (QBR)
116
+ - Fundraising preparation (know your numbers)
117
+ - Annual planning (identify improvement areas)
118
+ - You suspect problems but can't pinpoint them
119
+ - New PM/exec joining and needs health assessment
120
+
121
+ **Don't use this when:**
122
+ - You're pre-revenue (focus on product-market fit first)
123
+ - You're in pure research mode (not enough data)
124
+ - You need tactical guidance (use specific skills: feature, channel, pricing)
125
+
126
+ ---
127
+
128
+ ### Facilitation Source of Truth
129
+
130
+ Use [`workshop-facilitation`](../workshop-facilitation/SKILL.md) as the default interaction protocol for this skill.
131
+
132
+ It defines:
133
+ - session heads-up + entry mode (Guided, Context dump, Best guess)
134
+ - one-question turns with plain-language prompts
135
+ - progress labels (for example, Context Qx/8 and Scoring Qx/5)
136
+ - interruption handling and pause/resume behavior
137
+ - numbered recommendations at decision points
138
+ - quick-select numbered response options for regular questions (include `Other (specify)` when useful)
139
+
140
+ This file defines the domain-specific assessment content. If there is a conflict, follow this file's domain logic.
141
+
142
+ ## Application
143
+
144
+ This interactive skill asks **up to 4 adaptive questions**, then delivers a comprehensive diagnostic with prioritized recommendations.
145
+
146
+ ---
147
+
148
+ ### Step 0: Gather Context
149
+
150
+ **Agent asks:**
151
+
152
+ "Let's diagnose your business health. I'll need metrics across four dimensions: growth, retention, unit economics, and capital efficiency.
153
+
154
+ **Company context:**
155
+ - Stage: (Pre-$10M ARR, $10M-$50M ARR, $50M+ ARR)
156
+ - Business model: (PLG, sales-led, hybrid)
157
+ - Target market: (SMB, mid-market, enterprise, mixed)
158
+
159
+ **Why this matters:** Benchmarks vary by stage. Early-stage optimizes for growth; scale-stage optimizes for efficiency.
160
+
161
+ Please provide the following metrics. Use 'unknown' if you don't have a metric."
162
+
163
+ ---
164
+
165
+ ### Step 1: Growth & Retention Metrics
166
+
167
+ **Agent asks:**
168
+
169
+ "**Growth & Retention:**
170
+
171
+ 1. **Revenue:**
172
+ - Current MRR or ARR: $___
173
+ - Revenue growth rate: ___% (MoM or YoY)
174
+
175
+ 2. **Retention:**
176
+ - Monthly churn rate: ___%
177
+ - NRR (Net Revenue Retention): ___%
178
+ - Quick Ratio: ___ (or I can calculate it)
179
+
180
+ 3. **Expansion:**
181
+ - Expansion revenue as % of total MRR: ___%
182
+
183
+ 4. **Cohort trends:**
184
+ - Are recent cohorts retaining better or worse than older cohorts?
185
+ 1. Better (improving)
186
+ 2. Same (stable)
187
+ 3. Worse (degrading)
188
+ 4. Unknown"
189
+
190
+ **Based on answers, agent evaluates:**
191
+ - ✅ **Healthy growth:** Growth >40% YoY (growth stage) or >25% (scale stage)
192
+ - ✅ **Healthy retention:** NRR >100%, churn <5% monthly, Quick Ratio >2
193
+ - 🚨 **Growth problems:** Growth <20% YoY
194
+ - 🚨 **Retention problems:** NRR <100%, churn >5%, cohort degradation
195
+
196
+ ---
197
+
198
+ ### Step 2: Unit Economics Metrics
199
+
200
+ **Agent asks:**
201
+
202
+ "**Unit Economics:**
203
+
204
+ 1. **Acquisition:**
205
+ - CAC (Customer Acquisition Cost): $___
206
+ - Blended or by channel? (If by channel, what's your best channel CAC?)
207
+
208
+ 2. **Value:**
209
+ - LTV (Lifetime Value): $___
210
+ - LTV:CAC ratio: ___ (or I can calculate it)
211
+ - Payback period: ___ months (or I can calculate it)
212
+
213
+ 3. **Margins:**
214
+ - Gross margin: ___%
215
+ - Contribution margin (if known): ___%
216
+
217
+ 4. **Trends:**
218
+ - Is CAC increasing, stable, or decreasing over time?
219
+ 1. Decreasing (improving efficiency)
220
+ 2. Stable
221
+ 3. Increasing (diminishing returns)
222
+ 4. Unknown"
223
+
224
+ **Based on answers, agent evaluates:**
225
+ - ✅ **Healthy economics:** LTV:CAC >3:1, payback <12 months, gross margin >70%
226
+ - ⚠️ **Marginal economics:** LTV:CAC 2-3:1, payback 12-18 months
227
+ - 🚨 **Poor economics:** LTV:CAC <2:1, payback >24 months, gross margin <60%
228
+
229
+ ---
230
+
231
+ ### Step 3: Capital Efficiency Metrics
232
+
233
+ **Agent asks:**
234
+
235
+ "**Capital Efficiency:**
236
+
237
+ 1. **Cash:**
238
+ - Cash balance: $___
239
+ - Monthly net burn rate: $___
240
+ - Runway: ___ months (or I can calculate it)
241
+
242
+ 2. **Efficiency ratios:**
243
+ - Rule of 40: ___ (Growth % + Profit Margin %) (or I can calculate it)
244
+ - Magic Number: ___ (S&M efficiency) (or I can calculate it)
245
+
246
+ 3. **Operating expenses:**
247
+ - S&M as % of revenue: ___%
248
+ - R&D as % of revenue: ___%
249
+ - Is OpEx growing faster than revenue?
250
+ 1. No (positive operating leverage)
251
+ 2. Yes (negative operating leverage)
252
+ 3. Unknown
253
+
254
+ 4. **Profitability:**
255
+ - Profit margin: ___%
256
+ - Path to profitability: (already profitable, 6-12 months, 12-24 months, >24 months, unknown)"
257
+
258
+ **Based on answers, agent evaluates:**
259
+ - ✅ **Healthy efficiency:** Rule of 40 >40, magic number >0.75, runway >12 months
260
+ - ⚠️ **Acceptable efficiency:** Rule of 40 25-40, magic number 0.5-0.75, runway 6-12 months
261
+ - 🚨 **Poor efficiency:** Rule of 40 <25, magic number <0.5, runway <6 months
262
+
263
+ ---
264
+
265
+ ### Step 4: Deliver Comprehensive Diagnostic
266
+
267
+ **Agent synthesizes all metrics and delivers:**
268
+
269
+ 1. **Overall Health Score** — Healthy / Moderate / Concerning / Critical
270
+ 2. **Dimension Scores** — Growth, Retention, Economics, Efficiency
271
+ 3. **Red Flags** — Critical, High Priority, Medium Priority
272
+ 4. **Prioritized Recommendations** — Top 3-5 actions with expected impact
273
+ 5. **Stage-Appropriate Benchmarks** — How you compare to peers
274
+
275
+ ---
276
+
277
+ #### Diagnostic Pattern 1: Healthy Business
278
+
279
+ **When:**
280
+ - Growth, retention, economics, and efficiency all meet stage-appropriate benchmarks
281
+ - No critical red flags
282
+ - Improving trends
283
+
284
+ **Output:**
285
+
286
+ "## ✅ Overall Health: **Healthy**
287
+
288
+ Your business shows strong fundamentals across all dimensions.
289
+
290
+ ---
291
+
292
+ ### Health Scorecard
293
+
294
+ | Dimension | Score | Status |
295
+ |-----------|-------|--------|
296
+ | **Growth & Retention** | ✅ Healthy | Growth ___% YoY, NRR ___%, Churn ___% |
297
+ | **Unit Economics** | ✅ Healthy | LTV:CAC ___:1, Payback ___ months |
298
+ | **Capital Efficiency** | ✅ Healthy | Rule of 40: ___, Runway ___ months |
299
+ | **Overall** | ✅ **Healthy** | Strong position for scaling |
300
+
301
+ ---
302
+
303
+ ### Key Strengths
304
+
305
+ 1. **[Specific strength 1]**
306
+ - Metric: [e.g., NRR 120%]
307
+ - Why it matters: [Expanding within base without new logos]
308
+
309
+ 2. **[Specific strength 2]**
310
+ - Metric: [e.g., LTV:CAC 5:1]
311
+ - Why it matters: [Sustainable unit economics support scaling]
312
+
313
+ 3. **[Specific strength 3]**
314
+ - Metric: [e.g., Rule of 40 = 65]
315
+ - Why it matters: [Excellent balance of growth and efficiency]
316
+
317
+ ---
318
+
319
+ ### Opportunities for Optimization
320
+
321
+ Even healthy businesses can improve. Here are your top opportunities:
322
+
323
+ **1. [Opportunity 1]**
324
+ - Current: [e.g., Magic Number 0.9]
325
+ - Opportunity: [Could scale S&M spend 2x and maintain efficiency]
326
+ - Impact: [+$___ MRR/month]
327
+
328
+ **2. [Opportunity 2]**
329
+ - Current: [e.g., Expansion revenue 15% of total]
330
+ - Opportunity: [Build upsell paths, target 25% expansion revenue]
331
+ - Impact: [NRR 110% → 120%]
332
+
333
+ **3. [Opportunity 3]**
334
+ - Current: [e.g., CAC $500, stable]
335
+ - Opportunity: [Improve conversion, reduce CAC to $400]
336
+ - Impact: [Faster payback, better LTV:CAC]
337
+
338
+ ---
339
+
340
+ ### Recommended Actions (Next Quarter)
341
+
342
+ **Priority 1: Scale what's working**
343
+ - [e.g., Double content marketing budget (best channel)]
344
+ - Expected impact: [+___ customers/month, +$___ MRR]
345
+
346
+ **Priority 2: Expand within base**
347
+ - [e.g., Launch premium tier for 20% of customers]
348
+ - Expected impact: [NRR 110% → 115%]
349
+
350
+ **Priority 3: Improve efficiency**
351
+ - [e.g., Optimize paid acquisition (reduce CAC 10%)]
352
+ - Expected impact: [Payback 8mo → 7mo]
353
+
354
+ ---
355
+
356
+ ### Monitor These Metrics
357
+
358
+ **Weekly:**
359
+ - NRR (should stay >___%)
360
+ - Churn rate (should stay <___%)
361
+ - Quick Ratio (should stay >___)
362
+
363
+ **Monthly:**
364
+ - Rule of 40 (should stay >___)
365
+ - Magic Number (should stay >___)
366
+ - LTV:CAC (should stay >___:1)
367
+
368
+ **Quarterly:**
369
+ - Cohort retention trends
370
+ - Revenue concentration risk
371
+ - Operating leverage
372
+
373
+ ---
374
+
375
+ ### Benchmarks (Your Stage: [Growth/Scale])
376
+
377
+ | Metric | Your Performance | Benchmark | Status |
378
+ |--------|------------------|-----------|--------|
379
+ | Growth Rate | ___% | >40% (growth) / >25% (scale) | ✅ |
380
+ | NRR | ___% | >100% | ✅ |
381
+ | LTV:CAC | ___:1 | >3:1 | ✅ |
382
+ | Rule of 40 | ___ | >40 | ✅ |
383
+ | Gross Margin | ___% | >70% | ✅ |
384
+
385
+ You're performing at or above benchmarks across the board."
386
+
387
+ ---
388
+
389
+ #### Diagnostic Pattern 2: Moderate Health (Fixable Issues)
390
+
391
+ **When:**
392
+ - Most metrics acceptable, but 1-2 dimensions have problems
393
+ - Medium-priority red flags
394
+ - Solvable with focus
395
+
396
+ **Output:**
397
+
398
+ "## ⚠️ Overall Health: **Moderate** (Fixable Issues)
399
+
400
+ Your business has good fundamentals but needs attention in [specific dimension].
401
+
402
+ ---
403
+
404
+ ### Health Scorecard
405
+
406
+ | Dimension | Score | Status |
407
+ |-----------|-------|--------|
408
+ | **Growth & Retention** | [✅ / ⚠️ / 🚨] | [Details] |
409
+ | **Unit Economics** | [✅ / ⚠️ / 🚨] | [Details] |
410
+ | **Capital Efficiency** | [✅ / ⚠️ / 🚨] | [Details] |
411
+ | **Overall** | ⚠️ **Moderate** | [Primary issue area] needs attention |
412
+
413
+ ---
414
+
415
+ ### Red Flags Identified
416
+
417
+ **High Priority** 🚨
418
+ 1. **[Specific red flag]**
419
+ - Metric: [e.g., NRR 95%]
420
+ - Threshold: [Should be >100%]
421
+ - Impact: [Base is contracting, not expanding]
422
+ - Fix by: [End of quarter]
423
+
424
+ **Medium Priority** ⚠️
425
+ 1. **[Specific issue]**
426
+ - Metric: [e.g., Magic Number 0.6]
427
+ - Threshold: [Should be >0.75]
428
+ - Impact: [S&M spend moderately efficient, room for improvement]
429
+ - Fix by: [6 months]
430
+
431
+ ---
432
+
433
+ ### Root Cause Analysis
434
+
435
+ **Primary Issue: [e.g., Retention & Expansion]**
436
+
437
+ **Symptoms:**
438
+ - NRR 95% (should be >100%)
439
+ - Churn rate 5% monthly (should be <3%)
440
+ - Expansion revenue only 10% of MRR (should be 20-30%)
441
+
442
+ **Diagnosis:**
443
+ [e.g., Customers are churning before they expand. Onboarding is weak, no clear upsell paths.]
444
+
445
+ **Impact:**
446
+ - Lost MRR: [Calculate churn impact]
447
+ - Missed expansion: [Calculate expansion opportunity]
448
+ - Total impact: [Combined revenue loss]
449
+
450
+ ---
451
+
452
+ ### Prioritized Action Plan
453
+
454
+ **Immediate (Next 30 days):**
455
+
456
+ **1. Fix [Primary Issue]**
457
+ - Action: [Specific step, e.g., "Launch onboarding improvement program"]
458
+ - Owner: [PM, Customer Success]
459
+ - Target: [Reduce churn 5% → 4%]
460
+ - Impact: [Save $___K MRR/month]
461
+
462
+ **Short-term (Next Quarter):**
463
+
464
+ **2. [Secondary Action]**
465
+ - Action: [e.g., "Build premium tier for upsell"]
466
+ - Target: [NRR 95% → 105%]
467
+ - Impact: [+$___K expansion MRR]
468
+
469
+ **3. [Tertiary Action]**
470
+ - Action: [e.g., "Optimize S&M spend, improve magic number"]
471
+ - Target: [Magic Number 0.6 → 0.8]
472
+ - Impact: [More efficient growth]
473
+
474
+ ---
475
+
476
+ ### What Success Looks Like (90 Days)
477
+
478
+ **Target metrics:**
479
+ - NRR: 95% → 105% (+10pp)
480
+ - Churn: 5% → 3.5% (-30%)
481
+ - Magic Number: 0.6 → 0.8 (+33%)
482
+
483
+ **Impact:**
484
+ - Monthly revenue saved from churn: +$___K
485
+ - Expansion revenue: +$___K
486
+ - More efficient S&M: [details]
487
+
488
+ **If you hit these targets, you'll be in 'Healthy' territory.**
489
+
490
+ ---
491
+
492
+ ### Monitor Weekly
493
+
494
+ **Must-track metrics:**
495
+ - Churn rate (track to ensure it's decreasing)
496
+ - NRR (track to ensure it's improving)
497
+ - Customer feedback (are improvements working?)
498
+
499
+ **Leading indicators:**
500
+ - Onboarding completion rate
501
+ - Time-to-value
502
+ - Usage metrics (activation, engagement)
503
+
504
+ ---
505
+
506
+ ### What Not to Do
507
+
508
+ **Don't:**
509
+ - Scale acquisition until retention is fixed (you'll just churn faster)
510
+ - Ignore expansion (it's easier than new acquisition)
511
+ - Wait too long (retention problems compound)"
512
+
513
+ ---
514
+
515
+ #### Diagnostic Pattern 3: Concerning Health (Urgent Action Required)
516
+
517
+ **When:**
518
+ - Multiple critical red flags
519
+ - 2+ dimensions problematic
520
+ - Requires immediate intervention
521
+
522
+ **Output:**
523
+
524
+ "## 🚨 Overall Health: **Concerning** (Urgent Action Required)
525
+
526
+ Your business has multiple critical issues that need immediate attention.
527
+
528
+ ---
529
+
530
+ ### Health Scorecard
531
+
532
+ | Dimension | Score | Status |
533
+ |-----------|-------|--------|
534
+ | **Growth & Retention** | 🚨 Concerning | [Details] |
535
+ | **Unit Economics** | 🚨 Concerning | [Details] |
536
+ | **Capital Efficiency** | 🚨 Critical | [Details] |
537
+ | **Overall** | 🚨 **Concerning** | Multiple urgent issues |
538
+
539
+ ---
540
+
541
+ ### Critical Red Flags 🚨
542
+
543
+ **1. [Critical Issue 1 - e.g., Runway]**
544
+ - Current: [6 months runway]
545
+ - Threshold: [<6 months = crisis]
546
+ - Impact: [Survival risk]
547
+ - Action: [Raise capital OR cut burn immediately]
548
+ - Timeline: [30 days]
549
+
550
+ **2. [Critical Issue 2 - e.g., Unit Economics]**
551
+ - Current: [LTV:CAC 1.2:1]
552
+ - Threshold: [<1.5:1 = unsustainable]
553
+ - Impact: [Losing money on every customer]
554
+ - Action: [Reduce CAC OR increase LTV]
555
+ - Timeline: [60 days]
556
+
557
+ **3. [Critical Issue 3 - e.g., Cohort Degradation]**
558
+ - Current: [Newer cohorts churning 2x faster than old]
559
+ - Threshold: [Degrading PMF]
560
+ - Impact: [Scaling makes problem worse]
561
+ - Action: [Stop scaling, fix retention]
562
+ - Timeline: [90 days]
563
+
564
+ ---
565
+
566
+ ### Survival Plan (Next 90 Days)
567
+
568
+ **Week 1-2: Triage**
569
+
570
+ **Immediate actions:**
571
+ 1. **Extend runway** (if <6 months)
572
+ - Option A: Raise bridge round ($___K)
573
+ - Option B: Cut burn by ___%
574
+ - Option C: Combination
575
+ - Decision by: [Date]
576
+
577
+ 2. **Stop scaling broken channels**
578
+ - Pause S&M spend on channels with LTV:CAC <2:1
579
+ - Reallocate budget to [best-performing channel]
580
+
581
+ 3. **Assemble crisis team**
582
+ - Daily standups on key metrics
583
+ - Weekly progress reviews
584
+
585
+ ---
586
+
587
+ **Month 1: Stop the Bleeding**
588
+
589
+ **Priority 1: Fix Unit Economics**
590
+ - Current: LTV:CAC ___:1 (unsustainable)
591
+ - Actions:
592
+ 1. Reduce CAC: [Specific tactics]
593
+ 2. Increase LTV: [Improve retention, add expansion]
594
+ - Target: LTV:CAC >2:1 within 30 days
595
+
596
+ **Priority 2: Improve Retention**
597
+ - Current: Churn ___% (too high)
598
+ - Actions:
599
+ 1. Interview churned customers (identify top 3 reasons)
600
+ 2. Fix onboarding (reduce early churn)
601
+ 3. Proactive outreach to at-risk accounts
602
+ - Target: Reduce churn by 20% within 30 days
603
+
604
+ ---
605
+
606
+ **Month 2-3: Stabilize**
607
+
608
+ **Milestone 1: Positive Unit Economics**
609
+ - LTV:CAC >2:1 ✅
610
+ - Payback <18 months ✅
611
+ - Gross margin >60% ✅
612
+
613
+ **Milestone 2: Slowing Churn**
614
+ - Churn decreasing month-over-month
615
+ - Cohort degradation stopped
616
+ - NRR improving toward 100%
617
+
618
+ **Milestone 3: Runway Extended**
619
+ - 12+ months runway (via fundraise or burn reduction)
620
+ - Clear path to next milestone
621
+
622
+ ---
623
+
624
+ ### What Success Looks Like (Day 90)
625
+
626
+ **Metrics:**
627
+ - Runway: ___ months → 12+ months ✅
628
+ - LTV:CAC: ___:1 → >2:1 ✅
629
+ - Churn: ___% → reduced by 30% ✅
630
+ - NRR: ___% → improving toward 100%
631
+
632
+ **Position:**
633
+ - Out of crisis mode
634
+ - Stable foundation to rebuild growth
635
+ - Clear plan for next 6-12 months
636
+
637
+ ---
638
+
639
+ ### What to Avoid
640
+
641
+ **Don't:**
642
+ - Try to grow your way out of this (fix unit economics first)
643
+ - Ignore the data (hope is not a strategy)
644
+ - Scale before you fix retention (accelerates failure)
645
+ - Wait until runway <3 months to fundraise (too late)
646
+
647
+ **Do:**
648
+ - Focus ruthlessly on retention and unit economics
649
+ - Cut costs to extend runway
650
+ - Be honest with board/investors about problems
651
+ - Move fast (you don't have time to waste)"
652
+
653
+ ---
654
+
655
+ #### Diagnostic Pattern 4: Critical Health (Existential Crisis)
656
+
657
+ **When:**
658
+ - Runway <3 months OR
659
+ - Multiple critical failures (LTV:CAC <1:1, massive churn, no path to profitability)
660
+
661
+ **Output:**
662
+
663
+ "## 🚨🚨 Overall Health: **Critical** (Existential Crisis)
664
+
665
+ Your business is in survival mode. Immediate drastic action required.
666
+
667
+ [Similar structure to Pattern 3, but more urgent tone, shorter timelines, more drastic measures]
668
+
669
+ **Immediate Actions (This Week):**
670
+ 1. Emergency board meeting
671
+ 2. Fundraise immediately OR cut burn 50%+
672
+ 3. Stop all non-essential spend
673
+ 4. Fix top 1-2 critical issues (runway, unit economics)"
674
+
675
+ ---
676
+
677
+ ## Examples
678
+
679
+ See `examples/` folder. Mini examples below:
680
+
681
+ ### Example 1: Healthy Growth-Stage SaaS
682
+
683
+ **Metrics:**
684
+ - ARR: $20M, Growth: 60% YoY
685
+ - NRR: 115%, Churn: 2.5%
686
+ - LTV:CAC: 4:1, Payback: 10 months
687
+ - Rule of 40: 50, Runway: 18 months
688
+
689
+ **Diagnosis:** Healthy. Scale aggressively.
690
+
691
+ ---
692
+
693
+ ### Example 2: Moderate Health (Retention Issue)
694
+
695
+ **Metrics:**
696
+ - ARR: $15M, Growth: 40% YoY
697
+ - NRR: 95%, Churn: 5%
698
+ - LTV:CAC: 3.5:1, Payback: 12 months
699
+ - Rule of 40: 38, Runway: 12 months
700
+
701
+ **Diagnosis:** Moderate. Fix retention before scaling further.
702
+
703
+ ---
704
+
705
+ ### Example 3: Concerning (Multiple Issues)
706
+
707
+ **Metrics:**
708
+ - ARR: $8M, Growth: 25% YoY (slowing)
709
+ - NRR: 88%, Churn: 7% (increasing)
710
+ - LTV:CAC: 1.8:1, Payback: 20 months
711
+ - Rule of 40: 15, Runway: 8 months
712
+
713
+ **Diagnosis:** Concerning. Urgent action on retention and unit economics required.
714
+
715
+ ---
716
+
717
+ ## Common Pitfalls
718
+
719
+ ### Pitfall 1: Celebrating Single Metrics
720
+ **Symptom:** "Revenue growing 50%!" (ignoring burn, churn, unit economics)
721
+
722
+ **Consequence:** Unsustainable growth. Scaling broken model.
723
+
724
+ **Fix:** Look at all four dimensions together.
725
+
726
+ ---
727
+
728
+ ### Pitfall 2: Ignoring Stage-Specific Benchmarks
729
+ **Symptom:** "We're not profitable yet, is that bad?" (early-stage company)
730
+
731
+ **Consequence:** Misplaced worry. Early-stage should optimize for growth and unit economics, not profitability.
732
+
733
+ **Fix:** Use stage-appropriate benchmarks.
734
+
735
+ ---
736
+
737
+ ### Pitfall 3: Focusing on Lagging Indicators Only
738
+ **Symptom:** "Churn is 5%, let's watch it"
739
+
740
+ **Consequence:** By the time lagging indicators (churn, NRR) show problems, it's late.
741
+
742
+ **Fix:** Track leading indicators (usage, engagement, onboarding completion).
743
+
744
+ ---
745
+
746
+ ### Pitfall 4: Not Acting on Red Flags
747
+ **Symptom:** "NRR <100% for 3 quarters, but we'll fix it eventually"
748
+
749
+ **Consequence:** Problems compound. Becomes crisis.
750
+
751
+ **Fix:** Set clear timelines. If metric doesn't improve in X time, escalate.
752
+
753
+ ---
754
+
755
+ ### Pitfall 5: Trying to Fix Everything at Once
756
+ **Symptom:** "Let's improve growth, retention, CAC, and efficiency simultaneously"
757
+
758
+ **Consequence:** Resources spread thin. Nothing improves.
759
+
760
+ **Fix:** Prioritize top 1-3 issues. Fix sequentially.
761
+
762
+ ---
763
+
764
+ ## References
765
+
766
+ ### Related Skills
767
+ - `saas-revenue-growth-metrics` — Detailed growth and retention metrics
768
+ - `saas-economics-efficiency-metrics` — Detailed unit economics and capital efficiency
769
+ - `finance-metrics-quickref` — Fast lookup for all metrics and benchmarks
770
+ - `feature-investment-advisor` — Uses health diagnostic to inform feature priorities
771
+ - `acquisition-channel-advisor` — Uses health diagnostic to inform channel priorities
772
+ - `finance-based-pricing-advisor` — Uses health diagnostic to inform pricing decisions
773
+
774
+ ### External Frameworks
775
+ - **Bessemer Venture Partners:** "SaaS Metrics 2.0" — Comprehensive benchmarks
776
+ - **David Skok:** "SaaS Metrics" — Unit economics benchmarks
777
+ - **OpenView Partners:** SaaS benchmarking reports
778
+ - **Battery Ventures:** "State of SaaS" annual report
779
+
780
+ ### Provenance
781
+ - Adapted from `research/finance/Finance_QuickRef.md` (Red flags table)
782
+ - Decision frameworks from `research/finance/Finance_For_PMs.Putting_It_Together_Synthesis.md`
783
+ - Benchmarks from `research/finance/Finance for Product Managers.md`