@sylix/coworker 2.0.11 → 2.0.12

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 (169) hide show
  1. package/dist/commands/slash/config.d.ts.map +1 -1
  2. package/dist/commands/slash/config.js +22 -4
  3. package/dist/commands/slash/config.js.map +1 -1
  4. package/dist/core/CoWorkerAgent.d.ts.map +1 -1
  5. package/dist/core/CoWorkerAgent.js +6 -3
  6. package/dist/core/CoWorkerAgent.js.map +1 -1
  7. package/dist/skills/defaults/accessibility/screen-reader-testing.md +545 -0
  8. package/dist/skills/defaults/accessibility/wcag-audit-patterns.md +555 -0
  9. package/dist/skills/defaults/ai-ml/rag.md +276 -0
  10. package/dist/skills/defaults/backend-development/api-design-principles.md +528 -0
  11. package/dist/skills/defaults/backend-development/api-design.md +285 -0
  12. package/dist/skills/defaults/backend-development/architecture-patterns.md +494 -0
  13. package/dist/skills/defaults/backend-development/async-python.md +237 -0
  14. package/dist/skills/defaults/backend-development/auth-implementation-patterns.md +638 -0
  15. package/dist/skills/defaults/backend-development/bazel-build-optimization.md +387 -0
  16. package/dist/skills/defaults/backend-development/billing-automation/SKILL.md +566 -0
  17. package/dist/skills/defaults/backend-development/code-review-excellence.md +538 -0
  18. package/dist/skills/defaults/backend-development/cqrs-implementation.md +554 -0
  19. package/dist/skills/defaults/backend-development/database-design.md +305 -0
  20. package/dist/skills/defaults/backend-development/debugging-strategies.md +536 -0
  21. package/dist/skills/defaults/backend-development/e2e-testing-patterns.md +544 -0
  22. package/dist/skills/defaults/backend-development/error-handling-patterns.md +641 -0
  23. package/dist/skills/defaults/backend-development/fastapi-templates.md +559 -0
  24. package/dist/skills/defaults/backend-development/fastapi.md +309 -0
  25. package/dist/skills/defaults/backend-development/git-advanced-workflows.md +405 -0
  26. package/dist/skills/defaults/backend-development/microservices-patterns.md +595 -0
  27. package/dist/skills/defaults/backend-development/microservices.md +284 -0
  28. package/dist/skills/defaults/backend-development/monorepo-management.md +623 -0
  29. package/dist/skills/defaults/backend-development/nodejs-backend-patterns.md +1048 -0
  30. package/dist/skills/defaults/backend-development/nx-workspace-patterns.md +457 -0
  31. package/dist/skills/defaults/backend-development/paypal-integration/SKILL.md +478 -0
  32. package/dist/skills/defaults/backend-development/pci-compliance/SKILL.md +480 -0
  33. package/dist/skills/defaults/backend-development/python-anti-patterns.md +349 -0
  34. package/dist/skills/defaults/backend-development/python-background-jobs.md +364 -0
  35. package/dist/skills/defaults/backend-development/python-code-style.md +360 -0
  36. package/dist/skills/defaults/backend-development/python-configuration.md +368 -0
  37. package/dist/skills/defaults/backend-development/python-design-patterns.md +296 -0
  38. package/dist/skills/defaults/backend-development/python-error-handling.md +323 -0
  39. package/dist/skills/defaults/backend-development/python-packaging.md +887 -0
  40. package/dist/skills/defaults/backend-development/python-performance-optimization.md +874 -0
  41. package/dist/skills/defaults/backend-development/python-project-structure.md +252 -0
  42. package/dist/skills/defaults/backend-development/python-resilience.md +376 -0
  43. package/dist/skills/defaults/backend-development/python-resource-management.md +421 -0
  44. package/dist/skills/defaults/backend-development/python-type-safety.md +428 -0
  45. package/dist/skills/defaults/backend-development/sql-optimization-patterns.md +509 -0
  46. package/dist/skills/defaults/backend-development/stripe-integration/SKILL.md +522 -0
  47. package/dist/skills/defaults/backend-development/turborepo-caching.md +376 -0
  48. package/dist/skills/defaults/blockchain/defi-protocol-templates.md +430 -0
  49. package/dist/skills/defaults/blockchain/nft-standards.md +364 -0
  50. package/dist/skills/defaults/blockchain/solidity-security.md +514 -0
  51. package/dist/skills/defaults/blockchain/web3-testing.md +360 -0
  52. package/dist/skills/defaults/business/competitive-landscape/SKILL.md +527 -0
  53. package/dist/skills/defaults/business/market-sizing-analysis/SKILL.md +451 -0
  54. package/dist/skills/defaults/business/startup-financial-modeling/SKILL.md +494 -0
  55. package/dist/skills/defaults/business/startup-metrics-framework/SKILL.md +564 -0
  56. package/dist/skills/defaults/business/team-composition-analysis.md +437 -0
  57. package/dist/skills/defaults/compliance/employment-contract-templates/SKILL.md +527 -0
  58. package/dist/skills/defaults/compliance/gdpr-data-handling/SKILL.md +630 -0
  59. package/dist/skills/defaults/data-engineering/airflow-dag-patterns.md +436 -0
  60. package/dist/skills/defaults/data-engineering/airflow.md +519 -0
  61. package/dist/skills/defaults/data-engineering/data-quality.md +583 -0
  62. package/dist/skills/defaults/data-engineering/dbt-transformation-patterns.md +482 -0
  63. package/dist/skills/defaults/data-engineering/dbt.md +556 -0
  64. package/dist/skills/defaults/data-engineering/ml-pipeline-workflow/SKILL.md +247 -0
  65. package/dist/skills/defaults/data-engineering/spark-optimization.md +348 -0
  66. package/dist/skills/defaults/data-engineering/spark.md +411 -0
  67. package/dist/skills/defaults/database/postgresql.md +202 -0
  68. package/dist/skills/defaults/debugging/systematic-debugging.md +249 -0
  69. package/dist/skills/defaults/devops/architecture-decision-records.md +448 -0
  70. package/dist/skills/defaults/devops/changelog-automation.md +580 -0
  71. package/dist/skills/defaults/devops/cicd.md +314 -0
  72. package/dist/skills/defaults/devops/cloud.md +263 -0
  73. package/dist/skills/defaults/devops/code-review-excellence.md +299 -0
  74. package/dist/skills/defaults/devops/cost-optimization.md +295 -0
  75. package/dist/skills/defaults/devops/deployment-pipeline-design.md +356 -0
  76. package/dist/skills/defaults/devops/docker.md +281 -0
  77. package/dist/skills/defaults/devops/git-workflows.md +205 -0
  78. package/dist/skills/defaults/devops/github-actions.md +311 -0
  79. package/dist/skills/defaults/devops/gitlab-ci-patterns.md +266 -0
  80. package/dist/skills/defaults/devops/hybrid-cloud-networking.md +241 -0
  81. package/dist/skills/defaults/devops/istio-traffic-management.md +327 -0
  82. package/dist/skills/defaults/devops/kubernetes.md +339 -0
  83. package/dist/skills/defaults/devops/linkerd-patterns.md +311 -0
  84. package/dist/skills/defaults/devops/multi-cloud-architecture.md +181 -0
  85. package/dist/skills/defaults/devops/observability.md +243 -0
  86. package/dist/skills/defaults/devops/openapi-spec-generation.md +1024 -0
  87. package/dist/skills/defaults/devops/postmortem-writing.md +396 -0
  88. package/dist/skills/defaults/devops/prometheus-configuration.md +265 -0
  89. package/dist/skills/defaults/devops/secrets-management.md +341 -0
  90. package/dist/skills/defaults/devops/service-mesh-observability.md +385 -0
  91. package/dist/skills/defaults/devops/terraform-module-library.md +244 -0
  92. package/dist/skills/defaults/finance/backtesting-frameworks/SKILL.md +663 -0
  93. package/dist/skills/defaults/finance/risk-metrics-calculation/SKILL.md +557 -0
  94. package/dist/skills/defaults/frontend/accessibility-compliance.md +420 -0
  95. package/dist/skills/defaults/frontend/design-system-patterns.md +337 -0
  96. package/dist/skills/defaults/frontend/interaction-design.md +327 -0
  97. package/dist/skills/defaults/frontend/javascript.md +311 -0
  98. package/dist/skills/defaults/frontend/modern-javascript-patterns.md +927 -0
  99. package/dist/skills/defaults/frontend/react-native-design.md +440 -0
  100. package/dist/skills/defaults/frontend/react.md +345 -0
  101. package/dist/skills/defaults/frontend/responsive-design.md +472 -0
  102. package/dist/skills/defaults/frontend/tailwind-design-system.md +337 -0
  103. package/dist/skills/defaults/frontend/typescript-advanced-types.md +724 -0
  104. package/dist/skills/defaults/frontend/typescript.md +334 -0
  105. package/dist/skills/defaults/frontend/visual-design-foundations.md +326 -0
  106. package/dist/skills/defaults/frontend/web-component-design.md +279 -0
  107. package/dist/skills/defaults/game-development/godot-gdscript-patterns.md +188 -0
  108. package/dist/skills/defaults/game-development/unity-ecs-patterns.md +594 -0
  109. package/dist/skills/defaults/kubernetes/gitops-workflow.md +285 -0
  110. package/dist/skills/defaults/kubernetes/gitops.md +280 -0
  111. package/dist/skills/defaults/kubernetes/helm-chart-scaffolding.md +553 -0
  112. package/dist/skills/defaults/kubernetes/helm.md +343 -0
  113. package/dist/skills/defaults/kubernetes/k8s-manifest-generator.md +501 -0
  114. package/dist/skills/defaults/kubernetes/k8s-security-policies.md +342 -0
  115. package/dist/skills/defaults/kubernetes/manifests.md +330 -0
  116. package/dist/skills/defaults/kubernetes/security.md +337 -0
  117. package/dist/skills/defaults/llm-application/embedding-strategies.md +608 -0
  118. package/dist/skills/defaults/llm-application/hybrid-search-implementation.md +570 -0
  119. package/dist/skills/defaults/llm-application/hybrid-search.md +570 -0
  120. package/dist/skills/defaults/llm-application/langchain-architecture.md +666 -0
  121. package/dist/skills/defaults/llm-application/langchain.md +259 -0
  122. package/dist/skills/defaults/llm-application/llm-evaluation.md +695 -0
  123. package/dist/skills/defaults/llm-application/prompt-engineering-patterns.md +449 -0
  124. package/dist/skills/defaults/llm-application/prompt-engineering.md +219 -0
  125. package/dist/skills/defaults/llm-application/rag-implementation.md +434 -0
  126. package/dist/skills/defaults/llm-application/similarity-search-patterns.md +560 -0
  127. package/dist/skills/defaults/llm-application/similarity-search.md +560 -0
  128. package/dist/skills/defaults/llm-application/vector-index-tuning.md +523 -0
  129. package/dist/skills/defaults/mobile/mobile-android-design.md +440 -0
  130. package/dist/skills/defaults/mobile/mobile-ios-design.md +266 -0
  131. package/dist/skills/defaults/monitoring/distributed-tracing.md +436 -0
  132. package/dist/skills/defaults/monitoring/grafana-dashboards.md +370 -0
  133. package/dist/skills/defaults/monitoring/prometheus-configuration.md +379 -0
  134. package/dist/skills/defaults/monitoring/slo-implementation.md +323 -0
  135. package/dist/skills/defaults/refactoring/code-refactoring.md +349 -0
  136. package/dist/skills/defaults/security/anti-reversing-techniques/SKILL.md +559 -0
  137. package/dist/skills/defaults/security/auditor.md +168 -0
  138. package/dist/skills/defaults/security/binary-analysis-patterns/SKILL.md +438 -0
  139. package/dist/skills/defaults/security/memory-forensics/SKILL.md +483 -0
  140. package/dist/skills/defaults/security/mtls-configuration.md +349 -0
  141. package/dist/skills/defaults/security/protocol-reverse-engineering/SKILL.md +520 -0
  142. package/dist/skills/defaults/security/sast-configuration.md +182 -0
  143. package/dist/skills/defaults/security/security.md +313 -0
  144. package/dist/skills/defaults/security/stride-analysis.md +273 -0
  145. package/dist/skills/defaults/security/threat-mitigation-mapping.md +290 -0
  146. package/dist/skills/defaults/systems/bash-defensive-patterns/SKILL.md +539 -0
  147. package/dist/skills/defaults/systems/bats-testing-patterns/SKILL.md +631 -0
  148. package/dist/skills/defaults/systems/go-concurrency-patterns.md +657 -0
  149. package/dist/skills/defaults/systems/memory-safety-patterns.md +605 -0
  150. package/dist/skills/defaults/systems/rust-async-patterns.md +519 -0
  151. package/dist/skills/defaults/systems/shellcheck-configuration/SKILL.md +456 -0
  152. package/dist/skills/defaults/team-collaboration/multi-reviewer-patterns.md +126 -0
  153. package/dist/skills/defaults/team-collaboration/parallel-feature-development.md +151 -0
  154. package/dist/skills/defaults/testing/javascript-testing-patterns.md +1021 -0
  155. package/dist/skills/defaults/testing/python-testing-patterns.md +351 -0
  156. package/dist/skills/defaults/testing/testing.md +332 -0
  157. package/dist/skills/defaults/workflows/context-driven-development.md +384 -0
  158. package/dist/skills/defaults/workflows/track-management.md +592 -0
  159. package/dist/skills/defaults/workflows/workflow-patterns.md +622 -0
  160. package/dist/skills/index.d.ts +11 -0
  161. package/dist/skills/index.d.ts.map +1 -0
  162. package/dist/skills/index.js +129 -0
  163. package/dist/skills/index.js.map +1 -0
  164. package/dist/utils/character.js +4 -4
  165. package/dist/utils/character.js.map +1 -1
  166. package/dist/utils/inputbar.d.ts.map +1 -1
  167. package/dist/utils/inputbar.js +7 -0
  168. package/dist/utils/inputbar.js.map +1 -1
  169. package/package.json +1 -1
@@ -0,0 +1,451 @@
1
+ ---
2
+ name: market-sizing-analysis
3
+ description: This skill should be used when the user asks to "calculate TAM", "determine SAM", "estimate SOM", "size the market", "calculate market opportunity", "what's the total addressable market", or requests market sizing analysis for a startup or business opportunity.
4
+ version: 1.0.0
5
+ ---
6
+
7
+ # Market Sizing Analysis
8
+
9
+ Comprehensive market sizing methodologies for calculating Total Addressable Market (TAM), Serviceable Available Market (SAM), and Serviceable Obtainable Market (SOM) for startup opportunities.
10
+
11
+ ## Overview
12
+
13
+ Market sizing provides the foundation for startup strategy, fundraising, and business planning. Calculate market opportunity using three complementary methodologies: top-down (industry reports), bottom-up (customer segment calculations), and value theory (willingness to pay).
14
+
15
+ ## Core Concepts
16
+
17
+ ### The Three-Tier Market Framework
18
+
19
+ **TAM (Total Addressable Market)**
20
+
21
+ - Total revenue opportunity if achieving 100% market share
22
+ - Defines the universe of potential customers
23
+ - Used for long-term vision and market validation
24
+ - Example: All email marketing software revenue globally
25
+
26
+ **SAM (Serviceable Available Market)**
27
+
28
+ - Portion of TAM targetable with current product/service
29
+ - Accounts for geographic, segment, or capability constraints
30
+ - Represents realistic addressable opportunity
31
+ - Example: AI-powered email marketing for e-commerce in North America
32
+
33
+ **SOM (Serviceable Obtainable Market)**
34
+
35
+ - Realistic market share achievable in 3-5 years
36
+ - Accounts for competition, resources, and market dynamics
37
+ - Used for financial projections and fundraising
38
+ - Example: 2-5% of SAM based on competitive landscape
39
+
40
+ ### When to Use Each Methodology
41
+
42
+ **Top-Down Analysis**
43
+
44
+ - Use when established market research exists
45
+ - Best for mature, well-defined markets
46
+ - Validates market existence and growth
47
+ - Starts with industry reports and narrows down
48
+
49
+ **Bottom-Up Analysis**
50
+
51
+ - Use when targeting specific customer segments
52
+ - Best for new or niche markets
53
+ - Most credible for investors
54
+ - Builds from customer data and pricing
55
+
56
+ **Value Theory**
57
+
58
+ - Use when creating new market categories
59
+ - Best for disruptive innovations
60
+ - Estimates based on value creation
61
+ - Calculates willingness to pay for problem solution
62
+
63
+ ## Three-Methodology Framework
64
+
65
+ ### Methodology 1: Top-Down Analysis
66
+
67
+ Start with total market size and narrow to addressable segments.
68
+
69
+ **Process:**
70
+
71
+ 1. Identify total market category from research reports
72
+ 2. Apply geographic filters (target regions)
73
+ 3. Apply segment filters (target industries/customers)
74
+ 4. Calculate competitive positioning adjustments
75
+
76
+ **Formula:**
77
+
78
+ ```
79
+ TAM = Total Market Category Size
80
+ SAM = TAM × Geographic % × Segment %
81
+ SOM = SAM × Realistic Capture Rate (2-5%)
82
+ ```
83
+
84
+ **When to use:** Established markets with available research (e.g., SaaS, fintech, e-commerce)
85
+
86
+ **Strengths:** Quick, uses credible data, validates market existence
87
+
88
+ **Limitations:** May overestimate for new categories, less granular
89
+
90
+ ### Methodology 2: Bottom-Up Analysis
91
+
92
+ Build market size from customer segment calculations.
93
+
94
+ **Process:**
95
+
96
+ 1. Define target customer segments
97
+ 2. Estimate number of potential customers per segment
98
+ 3. Determine average revenue per customer
99
+ 4. Calculate realistic penetration rates
100
+
101
+ **Formula:**
102
+
103
+ ```
104
+ TAM = Σ (Segment Size × Annual Revenue per Customer)
105
+ SAM = TAM × (Segments You Can Serve / Total Segments)
106
+ SOM = SAM × Realistic Penetration Rate (Year 3-5)
107
+ ```
108
+
109
+ **When to use:** B2B, niche markets, specific customer segments
110
+
111
+ **Strengths:** Most credible for investors, granular, defensible
112
+
113
+ **Limitations:** Requires detailed customer research, time-intensive
114
+
115
+ ### Methodology 3: Value Theory
116
+
117
+ Calculate based on value created and willingness to pay.
118
+
119
+ **Process:**
120
+
121
+ 1. Identify problem being solved
122
+ 2. Quantify current cost of problem (time, money, inefficiency)
123
+ 3. Calculate value of solution (savings, gains, efficiency)
124
+ 4. Estimate willingness to pay (typically 10-30% of value)
125
+ 5. Multiply by addressable customer base
126
+
127
+ **Formula:**
128
+
129
+ ```
130
+ Value per Customer = Problem Cost × % Solved by Solution
131
+ Price per Customer = Value × Willingness to Pay % (10-30%)
132
+ TAM = Total Potential Customers × Price per Customer
133
+ SAM = TAM × % Meeting Buy Criteria
134
+ SOM = SAM × Realistic Adoption Rate
135
+ ```
136
+
137
+ **When to use:** New categories, disruptive innovations, unclear existing markets
138
+
139
+ **Strengths:** Shows value creation, works for new markets
140
+
141
+ **Limitations:** Requires assumptions, harder to validate
142
+
143
+ ## Step-by-Step Process
144
+
145
+ ### Step 1: Define the Market
146
+
147
+ Clearly specify what market is being measured.
148
+
149
+ **Questions to answer:**
150
+
151
+ - What problem is being solved?
152
+ - Who are the target customers?
153
+ - What's the product/service category?
154
+ - What's the geographic scope?
155
+ - What's the time horizon?
156
+
157
+ **Example:**
158
+
159
+ - Problem: E-commerce companies struggle with email marketing automation
160
+ - Customers: E-commerce stores with >$1M annual revenue
161
+ - Category: AI-powered email marketing software
162
+ - Geography: North America initially, global expansion
163
+ - Horizon: 3-5 year opportunity
164
+
165
+ ### Step 2: Gather Data Sources
166
+
167
+ Identify credible data for calculations.
168
+
169
+ **Top-Down Sources:**
170
+
171
+ - Industry research reports (Gartner, Forrester, IDC)
172
+ - Government statistics (Census, BLS, trade associations)
173
+ - Public company filings and earnings
174
+ - Market research firms (Statista, CB Insights, PitchBook)
175
+
176
+ **Bottom-Up Sources:**
177
+
178
+ - Customer interviews and surveys
179
+ - Sales data and CRM records
180
+ - Industry databases (LinkedIn, ZoomInfo, Crunchbase)
181
+ - Competitive intelligence
182
+ - Academic research
183
+
184
+ **Value Theory Sources:**
185
+
186
+ - Customer problem quantification
187
+ - Time/cost studies
188
+ - ROI case studies
189
+ - Pricing research and willingness-to-pay surveys
190
+
191
+ ### Step 3: Calculate TAM
192
+
193
+ Apply chosen methodology to determine total market.
194
+
195
+ **For Top-Down:**
196
+
197
+ 1. Find total category size from research
198
+ 2. Document data source and year
199
+ 3. Apply growth rate if needed
200
+ 4. Validate with multiple sources
201
+
202
+ **For Bottom-Up:**
203
+
204
+ 1. Count total potential customers
205
+ 2. Calculate average annual revenue per customer
206
+ 3. Multiply to get TAM
207
+ 4. Break down by segment
208
+
209
+ **For Value Theory:**
210
+
211
+ 1. Quantify total addressable customer base
212
+ 2. Calculate value per customer
213
+ 3. Estimate pricing based on value
214
+ 4. Multiply for TAM
215
+
216
+ ### Step 4: Calculate SAM
217
+
218
+ Narrow TAM to serviceable addressable market.
219
+
220
+ **Apply Filters:**
221
+
222
+ - Geographic constraints (regions you can serve)
223
+ - Product limitations (features you currently have)
224
+ - Customer requirements (size, industry, use case)
225
+ - Distribution channel access
226
+ - Regulatory or compliance restrictions
227
+
228
+ **Formula:**
229
+
230
+ ```
231
+ SAM = TAM × (% matching all filters)
232
+ ```
233
+
234
+ **Example:**
235
+
236
+ - TAM: $10B global email marketing
237
+ - Geographic filter: 40% (North America)
238
+ - Product filter: 30% (e-commerce focus)
239
+ - Feature filter: 60% (need AI capabilities)
240
+ - SAM = $10B × 0.40 × 0.30 × 0.60 = $720M
241
+
242
+ ### Step 5: Calculate SOM
243
+
244
+ Determine realistic obtainable market share.
245
+
246
+ **Consider:**
247
+
248
+ - Current market share of competitors
249
+ - Typical market share for new entrants (2-5%)
250
+ - Resources available (funding, team, time)
251
+ - Go-to-market effectiveness
252
+ - Competitive advantages
253
+ - Time to achieve (3-5 years typically)
254
+
255
+ **Conservative Approach:**
256
+
257
+ ```
258
+ SOM (Year 3) = SAM × 2%
259
+ SOM (Year 5) = SAM × 5%
260
+ ```
261
+
262
+ **Example:**
263
+
264
+ - SAM: $720M
265
+ - Year 3 SOM: $720M × 2% = $14.4M
266
+ - Year 5 SOM: $720M × 5% = $36M
267
+
268
+ ### Step 6: Validate and Triangulate
269
+
270
+ Cross-check using multiple methods.
271
+
272
+ **Validation Techniques:**
273
+
274
+ 1. Compare top-down and bottom-up results (should be within 30%)
275
+ 2. Check against public company revenues in space
276
+ 3. Validate customer count assumptions
277
+ 4. Sense-check pricing assumptions
278
+ 5. Review with industry experts
279
+ 6. Compare to similar market categories
280
+
281
+ **Red Flags:**
282
+
283
+ - TAM that's too small (< $1B for VC-backed startups)
284
+ - TAM that's too large (unsupported by data)
285
+ - SOM that's too aggressive (> 10% in 5 years for new entrant)
286
+ - Inconsistency between methodologies (> 50% difference)
287
+
288
+ ## Industry-Specific Considerations
289
+
290
+ ### SaaS Markets
291
+
292
+ **Key Metrics:**
293
+
294
+ - Number of potential businesses in target segment
295
+ - Average contract value (ACV)
296
+ - Typical market penetration rates
297
+ - Expansion revenue potential
298
+
299
+ **TAM Calculation:**
300
+
301
+ ```
302
+ TAM = Total Target Companies × Average ACV × (1 + Expansion Rate)
303
+ ```
304
+
305
+ ### Marketplace Markets
306
+
307
+ **Key Metrics:**
308
+
309
+ - Gross Merchandise Value (GMV) of category
310
+ - Take rate (% of GMV you capture)
311
+ - Total transactions or users
312
+
313
+ **TAM Calculation:**
314
+
315
+ ```
316
+ TAM = Total Category GMV × Expected Take Rate
317
+ ```
318
+
319
+ ### Consumer Markets
320
+
321
+ **Key Metrics:**
322
+
323
+ - Total addressable users/households
324
+ - Average revenue per user (ARPU)
325
+ - Engagement frequency
326
+
327
+ **TAM Calculation:**
328
+
329
+ ```
330
+ TAM = Total Users × ARPU × Purchase Frequency per Year
331
+ ```
332
+
333
+ ### B2B Services
334
+
335
+ **Key Metrics:**
336
+
337
+ - Number of target companies by size/industry
338
+ - Average project value or retainer
339
+ - Typical buying frequency
340
+
341
+ **TAM Calculation:**
342
+
343
+ ```
344
+ TAM = Total Target Companies × Average Deal Size × Deals per Year
345
+ ```
346
+
347
+ ## Presenting Market Sizing
348
+
349
+ ### For Investors
350
+
351
+ **Structure:**
352
+
353
+ 1. Market definition and problem scope
354
+ 2. TAM/SAM/SOM with methodology
355
+ 3. Data sources and assumptions
356
+ 4. Growth projections and drivers
357
+ 5. Competitive landscape context
358
+
359
+ **Key Points:**
360
+
361
+ - Lead with bottom-up calculation (most credible)
362
+ - Show triangulation with top-down
363
+ - Explain conservative assumptions
364
+ - Link to revenue projections
365
+ - Highlight market growth rate
366
+
367
+ ### For Strategy
368
+
369
+ **Structure:**
370
+
371
+ 1. Addressable customer segments
372
+ 2. Prioritization by opportunity size
373
+ 3. Entry strategy by segment
374
+ 4. Expected penetration timeline
375
+ 5. Resource requirements
376
+
377
+ **Key Points:**
378
+
379
+ - Focus on SAM and SOM
380
+ - Show segment-level detail
381
+ - Connect to go-to-market plan
382
+ - Identify expansion opportunities
383
+ - Discuss competitive positioning
384
+
385
+ ## Common Mistakes to Avoid
386
+
387
+ **Mistake 1: Confusing TAM with SAM**
388
+
389
+ - Don't claim entire market as addressable
390
+ - Apply realistic product/geographic constraints
391
+ - Be honest about serviceable market
392
+
393
+ **Mistake 2: Overly Aggressive SOM**
394
+
395
+ - New entrants rarely capture > 5% in 5 years
396
+ - Account for competition and resources
397
+ - Show realistic ramp timeline
398
+
399
+ **Mistake 3: Using Only Top-Down**
400
+
401
+ - Investors prefer bottom-up validation
402
+ - Top-down alone lacks credibility
403
+ - Always triangulate with multiple methods
404
+
405
+ **Mistake 4: Cherry-Picking Data**
406
+
407
+ - Use consistent, recent data sources
408
+ - Don't mix methodologies inappropriately
409
+ - Document all assumptions clearly
410
+
411
+ **Mistake 5: Ignoring Market Dynamics**
412
+
413
+ - Account for market growth/decline
414
+ - Consider competitive intensity
415
+ - Factor in switching costs and barriers
416
+
417
+ ## Additional Resources
418
+
419
+ ### Reference Files
420
+
421
+ For detailed methodologies and frameworks:
422
+
423
+ - **`references/methodology-deep-dive.md`** - Comprehensive guide to each methodology with step-by-step worksheets
424
+ - **`references/data-sources.md`** - Curated list of market research sources, databases, and tools
425
+ - **`references/industry-templates.md`** - Specific templates for SaaS, marketplace, consumer, B2B, and fintech markets
426
+
427
+ ### Example Files
428
+
429
+ Working examples with complete calculations:
430
+
431
+ - **`examples/saas-market-sizing.md`** - Complete TAM/SAM/SOM for a B2B SaaS product
432
+ - **`examples/marketplace-sizing.md`** - Marketplace platform market opportunity calculation
433
+ - **`examples/value-theory-example.md`** - Value-based market sizing for disruptive innovation
434
+
435
+ Use these examples as templates for your own market sizing analysis. Each includes real numbers, data sources, and assumptions documented clearly.
436
+
437
+ ## Quick Start
438
+
439
+ To perform market sizing analysis:
440
+
441
+ 1. **Define the market** - Problem, customers, category, geography
442
+ 2. **Choose methodology** - Bottom-up (preferred) or top-down + triangulation
443
+ 3. **Gather data** - Industry reports, customer data, competitive intelligence
444
+ 4. **Calculate TAM** - Apply methodology formula
445
+ 5. **Narrow to SAM** - Apply product, geographic, segment filters
446
+ 6. **Estimate SOM** - 2-5% realistic capture rate
447
+ 7. **Validate** - Cross-check with alternative methods
448
+ 8. **Document** - Show methodology, sources, assumptions
449
+ 9. **Present** - Structure for audience (investors, strategy, operations)
450
+
451
+ For detailed step-by-step guidance on each methodology, reference the files in `references/` directory. For complete worked examples, see `examples/` directory.