code-ai-installer 4.0.0 → 4.0.1-b

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 (471) hide show
  1. package/README.md +83 -67
  2. package/dist/index.js +2 -0
  3. package/dist/mcp/audit_ledger.d.ts +12 -0
  4. package/dist/mcp/audit_ledger.js +82 -0
  5. package/dist/mcp/cli.js +7 -1
  6. package/dist/mcp/config.d.ts +23 -0
  7. package/dist/mcp/config.js +44 -6
  8. package/dist/mcp/index.d.ts +1 -2
  9. package/dist/mcp/index.js +1 -2
  10. package/dist/mcp/paths.d.ts +20 -2
  11. package/dist/mcp/paths.js +29 -5
  12. package/dist/mcp/proposal_dedup.d.ts +32 -0
  13. package/dist/mcp/proposal_dedup.js +102 -0
  14. package/dist/mcp/proposal_store.d.ts +18 -0
  15. package/dist/mcp/proposal_store.js +74 -0
  16. package/dist/mcp/scorecard.d.ts +140 -0
  17. package/dist/mcp/scorecard.js +103 -0
  18. package/dist/mcp/skill_invocations.d.ts +15 -0
  19. package/dist/mcp/skill_invocations.js +28 -0
  20. package/dist/mcp/task_state.d.ts +77 -2
  21. package/dist/mcp/tools/_subprocess.d.ts +16 -0
  22. package/dist/mcp/tools/_subprocess.js +56 -0
  23. package/dist/mcp/tools/advance_gate.js +2 -2
  24. package/dist/mcp/tools/aggregate_run_metrics.d.ts +19 -0
  25. package/dist/mcp/tools/aggregate_run_metrics.js +139 -0
  26. package/dist/mcp/tools/apply_diff.d.ts +2 -0
  27. package/dist/mcp/tools/apply_diff.js +29 -0
  28. package/dist/mcp/tools/audit_bilocale_parity.d.ts +2 -0
  29. package/dist/mcp/tools/audit_bilocale_parity.js +146 -0
  30. package/dist/mcp/tools/audit_budget_compliance.d.ts +35 -0
  31. package/dist/mcp/tools/audit_budget_compliance.js +172 -0
  32. package/dist/mcp/tools/build.d.ts +2 -0
  33. package/dist/mcp/tools/build.js +47 -0
  34. package/dist/mcp/tools/check_lint.d.ts +2 -0
  35. package/dist/mcp/tools/check_lint.js +23 -0
  36. package/dist/mcp/tools/classify_gate.js +2 -2
  37. package/dist/mcp/tools/current_gate.js +2 -2
  38. package/dist/mcp/tools/dependency_supply_chain.d.ts +2 -0
  39. package/dist/mcp/tools/dependency_supply_chain.js +59 -0
  40. package/dist/mcp/tools/docker_compose.d.ts +2 -0
  41. package/dist/mcp/tools/docker_compose.js +24 -0
  42. package/dist/mcp/tools/e2e_playwright.d.ts +2 -0
  43. package/dist/mcp/tools/e2e_playwright.js +88 -0
  44. package/dist/mcp/tools/get_skill.js +17 -0
  45. package/dist/mcp/tools/git_commit.d.ts +2 -0
  46. package/dist/mcp/tools/git_commit.js +30 -0
  47. package/dist/mcp/tools/list_proposals.d.ts +6 -0
  48. package/dist/mcp/tools/list_proposals.js +16 -0
  49. package/dist/mcp/tools/list_skills.js +9 -1
  50. package/dist/mcp/tools/load_role.d.ts +3 -4
  51. package/dist/mcp/tools/load_role.js +11 -13
  52. package/dist/mcp/tools/propose_change.d.ts +8 -0
  53. package/dist/mcp/tools/propose_change.js +36 -0
  54. package/dist/mcp/tools/record_decision.js +25 -25
  55. package/dist/mcp/tools/review_proposal.d.ts +17 -0
  56. package/dist/mcp/tools/review_proposal.js +99 -0
  57. package/dist/mcp/tools/run_drift_audit.d.ts +11 -0
  58. package/dist/mcp/tools/run_drift_audit.js +79 -0
  59. package/dist/mcp/tools/run_tests.d.ts +2 -0
  60. package/dist/mcp/tools/run_tests.js +92 -0
  61. package/dist/mcp/tools/sign_off.js +14 -2
  62. package/dist/mcp/tools/stubs.js +30 -9
  63. package/dist/mcp/tools/verify_claim.js +33 -6
  64. package/dist/mcp_setup.d.ts +14 -3
  65. package/dist/mcp_setup.js +15 -6
  66. package/dist/shared/frontmatter.d.ts +44 -2
  67. package/dist/shared/frontmatter.js +54 -6
  68. package/dist/shared/index.d.ts +0 -5
  69. package/dist/shared/index.js +0 -5
  70. package/dist/shared/persona.d.ts +2 -2
  71. package/dist/shared/persona.js +1 -1
  72. package/dist/shared/pipeline.d.ts +46 -1
  73. package/dist/shared/tools.d.ts +1382 -16
  74. package/dist/shared/tools.js +229 -0
  75. package/dist/shared/vocabulary.d.ts +99 -4
  76. package/dist/shared/vocabulary.js +94 -5
  77. package/domains/analytics/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  78. package/domains/analytics/.agents/skills/bcg-matrix/SKILL.md +345 -329
  79. package/domains/analytics/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  80. package/domains/analytics/.agents/skills/board/SKILL.md +22 -0
  81. package/domains/analytics/.agents/skills/cohort-analysis/SKILL.md +338 -322
  82. package/domains/analytics/.agents/skills/competitive-analysis/SKILL.md +413 -395
  83. package/domains/analytics/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  84. package/domains/analytics/.agents/skills/gates/SKILL.md +388 -366
  85. package/domains/analytics/.agents/skills/handoff/SKILL.md +402 -380
  86. package/domains/analytics/.agents/skills/html-pdf-report/SKILL.md +21 -289
  87. package/domains/analytics/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  88. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  89. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  90. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  91. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  92. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  93. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  94. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/skill.yaml +23 -0
  95. package/domains/analytics/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  96. package/domains/analytics/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  97. package/domains/analytics/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  98. package/domains/analytics/.agents/skills/pest-analysis/SKILL.md +324 -305
  99. package/domains/analytics/.agents/skills/porters-five-forces/SKILL.md +377 -361
  100. package/domains/analytics/.agents/skills/report-design/SKILL.md +416 -398
  101. package/domains/analytics/.agents/skills/rfm-analysis/SKILL.md +330 -314
  102. package/domains/analytics/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  103. package/domains/analytics/.agents/skills/swot-analysis/SKILL.md +340 -324
  104. package/domains/analytics/.agents/skills/tam-sam-som/SKILL.md +329 -312
  105. package/domains/analytics/.agents/skills/trend-analysis/SKILL.md +347 -331
  106. package/domains/analytics/.agents/skills/unit-economics/SKILL.md +430 -413
  107. package/domains/analytics/.agents/skills/value-chain-analysis/SKILL.md +346 -330
  108. package/domains/analytics/.agents/skills/web-research/SKILL.md +323 -308
  109. package/domains/analytics/AGENTS.md +1 -0
  110. package/domains/analytics/agents/auditor.md +76 -0
  111. package/domains/analytics/agents/conductor.md +11 -0
  112. package/domains/analytics/agents/data_analyst.md +11 -0
  113. package/domains/analytics/agents/designer.md +11 -0
  114. package/domains/analytics/agents/interviewer.md +11 -0
  115. package/domains/analytics/agents/layouter.md +11 -0
  116. package/domains/analytics/agents/mediator.md +11 -0
  117. package/domains/analytics/agents/researcher.md +11 -0
  118. package/domains/analytics/agents/strategist.md +11 -0
  119. package/domains/analytics/locales/en/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  120. package/domains/analytics/locales/en/.agents/skills/bcg-matrix/SKILL.md +345 -329
  121. package/domains/analytics/locales/en/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  122. package/domains/analytics/locales/en/.agents/skills/board/SKILL.md +22 -0
  123. package/domains/analytics/locales/en/.agents/skills/cohort-analysis/SKILL.md +338 -322
  124. package/domains/analytics/locales/en/.agents/skills/competitive-analysis/SKILL.md +413 -395
  125. package/domains/analytics/locales/en/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  126. package/domains/analytics/locales/en/.agents/skills/gates/SKILL.md +388 -366
  127. package/domains/analytics/locales/en/.agents/skills/handoff/SKILL.md +402 -380
  128. package/domains/analytics/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -289
  129. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  130. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  131. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  132. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  133. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  134. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  135. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  136. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +29 -0
  137. package/domains/analytics/locales/en/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  138. package/domains/analytics/locales/en/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  139. package/domains/analytics/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  140. package/domains/analytics/locales/en/.agents/skills/pest-analysis/SKILL.md +324 -305
  141. package/domains/analytics/locales/en/.agents/skills/porters-five-forces/SKILL.md +377 -361
  142. package/domains/analytics/locales/en/.agents/skills/report-design/SKILL.md +416 -398
  143. package/domains/analytics/locales/en/.agents/skills/rfm-analysis/SKILL.md +330 -314
  144. package/domains/analytics/locales/en/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  145. package/domains/analytics/locales/en/.agents/skills/swot-analysis/SKILL.md +340 -324
  146. package/domains/analytics/locales/en/.agents/skills/tam-sam-som/SKILL.md +329 -312
  147. package/domains/analytics/locales/en/.agents/skills/trend-analysis/SKILL.md +347 -331
  148. package/domains/analytics/locales/en/.agents/skills/unit-economics/SKILL.md +430 -413
  149. package/domains/analytics/locales/en/.agents/skills/value-chain-analysis/SKILL.md +366 -350
  150. package/domains/analytics/locales/en/.agents/skills/web-research/SKILL.md +324 -309
  151. package/domains/analytics/locales/en/AGENTS.md +1 -0
  152. package/domains/analytics/locales/en/agents/auditor.md +76 -0
  153. package/domains/analytics/locales/en/agents/conductor.md +27 -0
  154. package/domains/analytics/locales/en/agents/data_analyst.md +29 -0
  155. package/domains/analytics/locales/en/agents/designer.md +27 -0
  156. package/domains/analytics/locales/en/agents/interviewer.md +11 -0
  157. package/domains/analytics/locales/en/agents/layouter.md +11 -0
  158. package/domains/analytics/locales/en/agents/mediator.md +11 -0
  159. package/domains/analytics/locales/en/agents/researcher.md +11 -0
  160. package/domains/analytics/locales/en/agents/strategist.md +11 -0
  161. package/domains/analytics/persona/persona-base.md +94 -0
  162. package/domains/analytics/pipeline.yaml +102 -0
  163. package/domains/content/.agents/skills/audience-analysis/SKILL.md +15 -0
  164. package/domains/content/.agents/skills/board/SKILL.md +20 -0
  165. package/domains/content/.agents/skills/brand-compliance/SKILL.md +15 -0
  166. package/domains/content/.agents/skills/brand-guidelines/SKILL.md +17 -0
  167. package/domains/content/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  168. package/domains/content/.agents/skills/content-brief/SKILL.md +15 -0
  169. package/domains/content/.agents/skills/content-calendar/SKILL.md +15 -0
  170. package/domains/content/.agents/skills/content-release-gate/SKILL.md +15 -0
  171. package/domains/content/.agents/skills/content-review-checklist/SKILL.md +15 -0
  172. package/domains/content/.agents/skills/cta-optimization/SKILL.md +15 -0
  173. package/domains/content/.agents/skills/data-storytelling/SKILL.md +15 -0
  174. package/domains/content/.agents/skills/email-copywriting/SKILL.md +15 -0
  175. package/domains/content/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  176. package/domains/content/.agents/skills/fact-checking/SKILL.md +15 -0
  177. package/domains/content/.agents/skills/gates/SKILL.md +20 -0
  178. package/domains/content/.agents/skills/google-stitch-content/SKILL.md +15 -0
  179. package/domains/content/.agents/skills/handoff/SKILL.md +24 -0
  180. package/domains/content/.agents/skills/headline-formulas/SKILL.md +15 -0
  181. package/domains/content/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  182. package/domains/content/.agents/skills/karpathy-guidelines/SKILL.md +28 -0
  183. package/domains/content/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  184. package/domains/content/.agents/skills/marketing-psychology/SKILL.md +15 -0
  185. package/domains/content/.agents/skills/moodboard/SKILL.md +15 -0
  186. package/domains/content/.agents/skills/platform-compliance/SKILL.md +15 -0
  187. package/domains/content/.agents/skills/platform-strategy/SKILL.md +15 -0
  188. package/domains/content/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  189. package/domains/content/.agents/skills/readability-scoring/SKILL.md +15 -0
  190. package/domains/content/.agents/skills/seo-copywriting/SKILL.md +15 -0
  191. package/domains/content/.agents/skills/social-media-formats/SKILL.md +15 -0
  192. package/domains/content/.agents/skills/source-verification/SKILL.md +15 -0
  193. package/domains/content/.agents/skills/storytelling-framework/SKILL.md +15 -0
  194. package/domains/content/.agents/skills/tone-of-voice/SKILL.md +15 -0
  195. package/domains/content/.agents/skills/topic-research/SKILL.md +15 -0
  196. package/domains/content/.agents/skills/trend-research/SKILL.md +15 -0
  197. package/domains/content/.agents/skills/visual-brief/SKILL.md +15 -0
  198. package/domains/content/AGENTS.md +4 -0
  199. package/domains/content/agents/auditor.md +76 -0
  200. package/domains/content/agents/conductor.md +11 -0
  201. package/domains/content/agents/copywriter.md +11 -0
  202. package/domains/content/agents/researcher.md +11 -0
  203. package/domains/content/agents/reviewer.md +11 -0
  204. package/domains/content/agents/strategist.md +11 -0
  205. package/domains/content/agents/visual_concept.md +11 -0
  206. package/domains/content/locales/en/.agents/skills/audience-analysis/SKILL.md +15 -0
  207. package/domains/content/locales/en/.agents/skills/board/SKILL.md +20 -0
  208. package/domains/content/locales/en/.agents/skills/brand-compliance/SKILL.md +15 -0
  209. package/domains/content/locales/en/.agents/skills/brand-guidelines/SKILL.md +17 -0
  210. package/domains/content/locales/en/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  211. package/domains/content/locales/en/.agents/skills/content-brief/SKILL.md +15 -0
  212. package/domains/content/locales/en/.agents/skills/content-calendar/SKILL.md +15 -0
  213. package/domains/content/locales/en/.agents/skills/content-release-gate/SKILL.md +15 -0
  214. package/domains/content/locales/en/.agents/skills/content-review-checklist/SKILL.md +15 -0
  215. package/domains/content/locales/en/.agents/skills/cta-optimization/SKILL.md +15 -0
  216. package/domains/content/locales/en/.agents/skills/data-storytelling/SKILL.md +15 -0
  217. package/domains/content/locales/en/.agents/skills/email-copywriting/SKILL.md +15 -0
  218. package/domains/content/locales/en/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  219. package/domains/content/locales/en/.agents/skills/fact-checking/SKILL.md +15 -0
  220. package/domains/content/locales/en/.agents/skills/gates/SKILL.md +20 -0
  221. package/domains/content/locales/en/.agents/skills/google-stitch-content/SKILL.md +15 -0
  222. package/domains/content/locales/en/.agents/skills/handoff/SKILL.md +24 -0
  223. package/domains/content/locales/en/.agents/skills/headline-formulas/SKILL.md +15 -0
  224. package/domains/content/locales/en/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  225. package/domains/content/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +30 -1
  226. package/domains/content/locales/en/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  227. package/domains/content/locales/en/.agents/skills/marketing-psychology/SKILL.md +15 -0
  228. package/domains/content/locales/en/.agents/skills/moodboard/SKILL.md +15 -0
  229. package/domains/content/locales/en/.agents/skills/platform-compliance/SKILL.md +15 -0
  230. package/domains/content/locales/en/.agents/skills/platform-strategy/SKILL.md +15 -0
  231. package/domains/content/locales/en/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  232. package/domains/content/locales/en/.agents/skills/readability-scoring/SKILL.md +15 -0
  233. package/domains/content/locales/en/.agents/skills/seo-copywriting/SKILL.md +15 -0
  234. package/domains/content/locales/en/.agents/skills/social-media-formats/SKILL.md +15 -0
  235. package/domains/content/locales/en/.agents/skills/source-verification/SKILL.md +15 -0
  236. package/domains/content/locales/en/.agents/skills/storytelling-framework/SKILL.md +15 -0
  237. package/domains/content/locales/en/.agents/skills/tone-of-voice/SKILL.md +15 -0
  238. package/domains/content/locales/en/.agents/skills/topic-research/SKILL.md +15 -0
  239. package/domains/content/locales/en/.agents/skills/trend-research/SKILL.md +15 -0
  240. package/domains/content/locales/en/.agents/skills/visual-brief/SKILL.md +15 -0
  241. package/domains/content/locales/en/AGENTS.md +4 -0
  242. package/domains/content/locales/en/agents/auditor.md +76 -0
  243. package/domains/content/locales/en/agents/conductor.md +12 -0
  244. package/domains/content/locales/en/agents/copywriter.md +12 -0
  245. package/domains/content/locales/en/agents/researcher.md +12 -0
  246. package/domains/content/locales/en/agents/reviewer.md +12 -0
  247. package/domains/content/locales/en/agents/strategist.md +12 -0
  248. package/domains/content/locales/en/agents/visual_concept.md +12 -0
  249. package/domains/content/persona/persona-base.md +94 -0
  250. package/domains/content/pipeline.yaml +96 -0
  251. package/domains/development/.agents/skills/adr-log/SKILL.md +1 -0
  252. package/domains/development/.agents/skills/design-intake/SKILL.md +0 -4
  253. package/domains/development/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  254. package/domains/development/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  255. package/domains/development/.agents/skills/mcp-integration/SKILL.md +211 -0
  256. package/domains/development/.agents/skills/mcp-integration/agents/claude.json +22 -0
  257. package/domains/development/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  258. package/domains/development/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  259. package/domains/development/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  260. package/domains/development/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  261. package/domains/development/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  262. package/domains/development/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  263. package/domains/development/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  264. package/domains/development/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  265. package/domains/development/AGENTS.md +1 -0
  266. package/domains/development/AGENTS.yaml +1 -0
  267. package/domains/development/agents/architect.md +13 -1
  268. package/domains/development/agents/auditor.md +74 -0
  269. package/domains/development/agents/conductor.md +14 -3
  270. package/domains/development/agents/devops.md +8 -9
  271. package/domains/development/agents/reviewer.md +12 -0
  272. package/domains/development/agents/senior_full_stack.md +12 -0
  273. package/domains/development/agents/tester.md +10 -16
  274. package/domains/development/locales/en/.agents/skills/adr-log/SKILL.md +1 -0
  275. package/domains/development/locales/en/.agents/skills/current-state-analysis/SKILL.md +256 -172
  276. package/domains/development/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  277. package/domains/development/locales/en/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  278. package/domains/development/locales/en/.agents/skills/mcp-integration/SKILL.md +211 -0
  279. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/claude.json +22 -0
  280. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  281. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  282. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  283. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  284. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  285. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  286. package/domains/development/locales/en/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  287. package/domains/development/locales/en/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  288. package/domains/development/locales/en/AGENTS.md +5 -0
  289. package/domains/development/locales/en/AGENTS.yaml +1 -0
  290. package/domains/development/locales/en/agents/architect.md +13 -1
  291. package/domains/development/locales/en/agents/auditor.md +74 -0
  292. package/domains/development/locales/en/agents/conductor.md +14 -3
  293. package/domains/development/locales/en/agents/devops.md +8 -9
  294. package/domains/development/locales/en/agents/reviewer.md +12 -0
  295. package/domains/development/locales/en/agents/senior_full_stack.md +12 -0
  296. package/domains/development/locales/en/agents/tester.md +10 -16
  297. package/domains/development/persona/persona-base.md +94 -0
  298. package/domains/product/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  299. package/domains/product/.agents/skills/ab-test-design/SKILL.md +428 -412
  300. package/domains/product/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  301. package/domains/product/.agents/skills/assumption-mapping/SKILL.md +323 -307
  302. package/domains/product/.agents/skills/board/SKILL.md +24 -0
  303. package/domains/product/.agents/skills/design-brief/SKILL.md +433 -418
  304. package/domains/product/.agents/skills/epic-breakdown/SKILL.md +435 -420
  305. package/domains/product/.agents/skills/gates/SKILL.md +470 -446
  306. package/domains/product/.agents/skills/gtm-brief/SKILL.md +18 -321
  307. package/domains/product/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  308. package/domains/product/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  309. package/domains/product/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  310. package/domains/product/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  311. package/domains/product/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  312. package/domains/product/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  313. package/domains/product/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  314. package/domains/product/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  315. package/domains/product/.agents/skills/handoff/SKILL.md +463 -439
  316. package/domains/product/.agents/skills/html-pdf-report/SKILL.md +21 -663
  317. package/domains/product/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  318. package/domains/product/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  319. package/domains/product/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  320. package/domains/product/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  321. package/domains/product/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  322. package/domains/product/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  323. package/domains/product/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  324. package/domains/product/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  325. package/domains/product/.agents/skills/hypothesis-template/SKILL.md +484 -469
  326. package/domains/product/.agents/skills/jtbd-canvas/SKILL.md +274 -258
  327. package/domains/product/.agents/skills/kano-model/SKILL.md +370 -355
  328. package/domains/product/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  329. package/domains/product/.agents/skills/launch-checklist/SKILL.md +434 -419
  330. package/domains/product/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  331. package/domains/product/.agents/skills/north-star-metric/SKILL.md +317 -301
  332. package/domains/product/.agents/skills/okr-framework/SKILL.md +299 -284
  333. package/domains/product/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  334. package/domains/product/.agents/skills/prd-template/SKILL.md +18 -258
  335. package/domains/product/.agents/skills/prd-template-reference/SKILL.md +285 -0
  336. package/domains/product/.agents/skills/prd-template-reference/agents/claude.json +17 -0
  337. package/domains/product/.agents/skills/prd-template-reference/agents/copilot.json +17 -0
  338. package/domains/product/.agents/skills/prd-template-reference/agents/gemini.json +17 -0
  339. package/domains/product/.agents/skills/prd-template-reference/agents/kimi.yaml +16 -0
  340. package/domains/product/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  341. package/domains/product/.agents/skills/prd-template-reference/agents/qwen.json +17 -0
  342. package/domains/product/.agents/skills/prd-template-reference/agents/skill.yaml +23 -0
  343. package/domains/product/.agents/skills/problem-statement/SKILL.md +327 -312
  344. package/domains/product/.agents/skills/product-roadmap/SKILL.md +320 -304
  345. package/domains/product/.agents/skills/product-vision/SKILL.md +409 -394
  346. package/domains/product/.agents/skills/release-notes/SKILL.md +18 -258
  347. package/domains/product/.agents/skills/release-notes-reference/SKILL.md +285 -0
  348. package/domains/product/.agents/skills/release-notes-reference/agents/claude.json +17 -0
  349. package/domains/product/.agents/skills/release-notes-reference/agents/copilot.json +17 -0
  350. package/domains/product/.agents/skills/release-notes-reference/agents/gemini.json +17 -0
  351. package/domains/product/.agents/skills/release-notes-reference/agents/kimi.yaml +15 -0
  352. package/domains/product/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  353. package/domains/product/.agents/skills/release-notes-reference/agents/qwen.json +17 -0
  354. package/domains/product/.agents/skills/release-notes-reference/agents/skill.yaml +22 -0
  355. package/domains/product/.agents/skills/report-design/SKILL.md +17 -307
  356. package/domains/product/.agents/skills/report-design-reference/SKILL.md +331 -0
  357. package/domains/product/.agents/skills/report-design-reference/agents/claude.json +17 -0
  358. package/domains/product/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  359. package/domains/product/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  360. package/domains/product/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  361. package/domains/product/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  362. package/domains/product/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  363. package/domains/product/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  364. package/domains/product/.agents/skills/rice-scoring/SKILL.md +266 -251
  365. package/domains/product/.agents/skills/saas-metrics/SKILL.md +422 -404
  366. package/domains/product/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  367. package/domains/product/.agents/skills/user-flow/SKILL.md +491 -476
  368. package/domains/product/.agents/skills/user-interview-script/SKILL.md +315 -298
  369. package/domains/product/.agents/skills/user-story/SKILL.md +401 -385
  370. package/domains/product/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  371. package/domains/product/AGENTS.md +5 -0
  372. package/domains/product/AGENTS.yaml +1 -0
  373. package/domains/product/agents/auditor.md +76 -0
  374. package/domains/product/agents/conductor.md +11 -0
  375. package/domains/product/agents/data_analyst.md +11 -0
  376. package/domains/product/agents/designer.md +11 -0
  377. package/domains/product/agents/discovery.md +11 -0
  378. package/domains/product/agents/layouter.md +11 -0
  379. package/domains/product/agents/mediator.md +11 -0
  380. package/domains/product/agents/pm.md +11 -0
  381. package/domains/product/agents/product_strategist.md +11 -0
  382. package/domains/product/agents/tech_lead.md +11 -0
  383. package/domains/product/agents/ux_designer.md +11 -0
  384. package/domains/product/locales/en/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  385. package/domains/product/locales/en/.agents/skills/ab-test-design/SKILL.md +428 -412
  386. package/domains/product/locales/en/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  387. package/domains/product/locales/en/.agents/skills/assumption-mapping/SKILL.md +323 -307
  388. package/domains/product/locales/en/.agents/skills/board/SKILL.md +24 -0
  389. package/domains/product/locales/en/.agents/skills/design-brief/SKILL.md +433 -418
  390. package/domains/product/locales/en/.agents/skills/epic-breakdown/SKILL.md +435 -420
  391. package/domains/product/locales/en/.agents/skills/gates/SKILL.md +470 -446
  392. package/domains/product/locales/en/.agents/skills/gtm-brief/SKILL.md +18 -321
  393. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  394. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  395. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  396. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  397. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  398. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  399. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  400. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  401. package/domains/product/locales/en/.agents/skills/handoff/SKILL.md +463 -439
  402. package/domains/product/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -663
  403. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  404. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  405. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  406. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  407. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  408. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  409. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  410. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  411. package/domains/product/locales/en/.agents/skills/hypothesis-template/SKILL.md +484 -469
  412. package/domains/product/locales/en/.agents/skills/jtbd-canvas/SKILL.md +273 -257
  413. package/domains/product/locales/en/.agents/skills/kano-model/SKILL.md +370 -355
  414. package/domains/product/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  415. package/domains/product/locales/en/.agents/skills/launch-checklist/SKILL.md +434 -419
  416. package/domains/product/locales/en/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  417. package/domains/product/locales/en/.agents/skills/north-star-metric/SKILL.md +317 -301
  418. package/domains/product/locales/en/.agents/skills/okr-framework/SKILL.md +299 -284
  419. package/domains/product/locales/en/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  420. package/domains/product/locales/en/.agents/skills/prd-template/SKILL.md +18 -258
  421. package/domains/product/locales/en/.agents/skills/prd-template-reference/SKILL.md +285 -0
  422. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/claude.json +16 -0
  423. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/copilot.json +16 -0
  424. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/gemini.json +16 -0
  425. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/kimi.yaml +15 -0
  426. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  427. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/qwen.json +16 -0
  428. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/skill.yaml +22 -0
  429. package/domains/product/locales/en/.agents/skills/problem-statement/SKILL.md +327 -312
  430. package/domains/product/locales/en/.agents/skills/product-roadmap/SKILL.md +321 -305
  431. package/domains/product/locales/en/.agents/skills/product-vision/SKILL.md +410 -395
  432. package/domains/product/locales/en/.agents/skills/release-notes/SKILL.md +18 -258
  433. package/domains/product/locales/en/.agents/skills/release-notes-reference/SKILL.md +285 -0
  434. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/claude.json +16 -0
  435. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/copilot.json +16 -0
  436. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/gemini.json +16 -0
  437. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/kimi.yaml +14 -0
  438. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  439. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/qwen.json +16 -0
  440. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/skill.yaml +21 -0
  441. package/domains/product/locales/en/.agents/skills/report-design/SKILL.md +17 -307
  442. package/domains/product/locales/en/.agents/skills/report-design-reference/SKILL.md +331 -0
  443. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/claude.json +17 -0
  444. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  445. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  446. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  447. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  448. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  449. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  450. package/domains/product/locales/en/.agents/skills/rice-scoring/SKILL.md +266 -251
  451. package/domains/product/locales/en/.agents/skills/saas-metrics/SKILL.md +422 -404
  452. package/domains/product/locales/en/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  453. package/domains/product/locales/en/.agents/skills/user-flow/SKILL.md +491 -476
  454. package/domains/product/locales/en/.agents/skills/user-interview-script/SKILL.md +314 -297
  455. package/domains/product/locales/en/.agents/skills/user-story/SKILL.md +401 -385
  456. package/domains/product/locales/en/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  457. package/domains/product/locales/en/AGENTS.md +5 -0
  458. package/domains/product/locales/en/agents/auditor.md +76 -0
  459. package/domains/product/locales/en/agents/conductor.md +11 -0
  460. package/domains/product/locales/en/agents/data_analyst.md +11 -0
  461. package/domains/product/locales/en/agents/designer.md +11 -0
  462. package/domains/product/locales/en/agents/discovery.md +11 -0
  463. package/domains/product/locales/en/agents/layouter.md +11 -0
  464. package/domains/product/locales/en/agents/mediator.md +11 -0
  465. package/domains/product/locales/en/agents/pm.md +11 -0
  466. package/domains/product/locales/en/agents/product_strategist.md +11 -0
  467. package/domains/product/locales/en/agents/tech_lead.md +11 -0
  468. package/domains/product/locales/en/agents/ux_designer.md +11 -0
  469. package/domains/product/persona/persona-base.md +94 -0
  470. package/domains/product/pipeline.yaml +115 -0
  471. package/package.json +72 -70
@@ -1,312 +1,329 @@
1
- ---
2
- name: tam-sam-som
3
- description: Оценка размера рынка — общий, доступный и достижимый объём
4
- ---
5
- # TAM/SAM/SOM — Оценка размера рынка
6
-
7
- ## Когда использовать
8
- - При выходе на новый рынок или запуске нового продукта — для обоснования потенциала.
9
- - При подготовке инвестиционных материалов (pitch deck, бизнес-план) — инвесторы требуют размер рынка.
10
- - При стратегическом планировании — выбор между рынками, вертикалями или географиями.
11
- - При пересмотре стратегии — если рынок изменился (регуляция, технологии, конкуренция).
12
-
13
- ## Вход
14
-
15
- | Поле | Обязательно | Описание |
16
- |------|:-----------:|----------|
17
- | Продукт / сервис | ✅ | Что именно предлагаем рынку |
18
- | Целевая география | ✅ | Страны / регионы для оценки |
19
- | Бизнес-модель | ✅ | B2B / B2C / B2B2C / SaaS / Marketplace и т.д. |
20
- | Ценовая модель | ✅ | Подписка / транзакция / лицензия / freemium |
21
- | Средний чек (ACV) | ⬚ | Если известен; иначе будет оценён |
22
- | Целевые сегменты | | Если уже определены (размер компании, отрасль, демография) |
23
- | Конкуренты | ⬚ | Известные игроки на рынке |
24
- | Горизонт прогноза | ⬚ | На сколько лет (по умолчанию — 3-5 лет) |
25
-
26
- > Если обязательные поля не предоставлены **запросить у пользователя** до начала анализа. Не додумывать.
27
-
28
- ## Источники данных
29
- 1. **Веб-поиск** — отраслевые отчёты (Statista, Grand View Research, Mordor Intelligence, IBISWorld, McKinsey, Gartner).
30
- 2. **Финансовые данные** — публичная отчётность конкурентов (SEC filings, годовые отчёты).
31
- 3. **Статистические базы** — данные госстатистик (Росстат, Eurostat, Census Bureau, World Bank).
32
- 4. **Отраслевые ассоциации** профильные объединения, торговые палаты.
33
- 5. **Данные от пользователя** — внутренняя аналитика, CRM, текущие продажи.
34
-
35
- > Для каждой цифры указать источник и дату. Данные старше 24 месяцев — пометить ⚠️ и верифицировать через `web-research`. Экстраполяции — помечать как 🔮 Assumed.
36
-
37
- ### Связь с другими скилами
38
- | Скил | Что берём | Когда вызывать |
39
- |------|-----------|----------------|
40
- | `web-research` | Отраслевые отчёты, размеры рынков, CAGR (шаги 2-4) | Основной инструмент вызывать для каждого уровня воронки |
41
- | `pest-analysis` | Макро-ограничения на TAM: регуляторные, экономические (шаг 3) | Если регуляция или макросреда ограничивают рынок |
42
- | `competitive-analysis` | Доли конкурентов для обоснования capture rate SOM (шаг 4) | Если неизвестна конкурентная структура рынка |
43
- | `icp-buyer-persona` | Фильтры SAM: ICP определяет целевой сегмент (шаг 3) | Если целевые сегменты не определены |
44
- | `ansoff-matrix` | TAM новых рынков для стратегий Market Development и Diversification | После расчёта — для оценки стратегий роста |
45
- | `blue-ocean-strategy` | TAM нового рыночного пространства (не-клиенты) | Если основной рынок мал — оценить Blue Ocean TAM |
46
-
47
- ## Протокол
48
-
49
- ### Шаг 0Сбор контекста
50
- 1. Проверить наличие всех обязательных входных данных. Если чего-то не хватает — запросить у пользователя.
51
- 2. Определить единицу измерения (USD, EUR, RUB) и временной горизонт.
52
- 3. Чётко сформулировать, какую проблему решает продукт.
53
- 4. Определить категорию рынка (индустрия → подкатегория → ниша).
54
- 5. Зафиксировать границы рынка: что включаем, что исключаем.
55
-
56
- ### Шаг 1 — TAM (Total Addressable Market)
57
- Оценить **двумя методами** для перекрёстной проверки:
58
-
59
- **Top-down:**
60
- 1. Найти общий объём индустрии (из отраслевых отчётов).
61
- 2. Применить фильтр по категории продукта.
62
- 3. Применить фильтр по географии.
63
- 4. Зафиксировать: источник, год, методологию отчёта.
64
-
65
- **Bottom-up:**
66
- 1. Определить общее количество потенциальных клиентов в категории.
67
- 2. Умножить на средний чек (ACV) × частоту покупок в год.
68
- 3. `TAM (bottom-up) = Кол-во клиентов × ACV × Частота`.
69
- 4. Зафиксировать: источник данных о кол-ве клиентов, обоснование ACV.
70
-
71
- **Сверка методов:**
72
-
73
- | Условие | Действие |
74
- |---------|----------|
75
- | Разброс < 30% | Использовать среднее. Нормальное расхождение |
76
- | Разброс 30-100% | Исследовать причину. Зафиксировать оба числа, обосновать выбор финального |
77
- | Разброс > 100% | 🔴 Проблема: пересмотреть границы рынка или источники. Не усреднять — найти ошибку |
78
-
79
- ### Шаг 2 SAM (Serviceable Addressable Market)
80
- Применить фильтры к TAM:
81
-
82
- | # | Фильтр | Описание | Множитель | Обоснование | Источник |
83
- |---|--------|----------|:---------:|-------------|----------|
84
- | 1 | География | Где реально работаем | ×XX% | [Почему] | [Источник] |
85
- | 2 | Сегмент | B2B: размер, отрасль; B2C: демография | ×XX% | [Почему] | [Источник] |
86
- | 3 | Регуляция | Лицензии, сертификации, запреты | ×XX% | [Почему] | [Источник] |
87
- | 4 | Технологии | Язык, платформа, интеграции | ×XX% | [Почему] | [Источник] |
88
-
89
- `SAM = TAM × Фильтр₁ × Фильтр₂ × ... × ФильтрN`
90
-
91
- > Если есть `$icp-buyer-persona` — использовать ICP-критерии как фильтры SAM (идеальный + приемлемый).
92
-
93
- ### Шаг 3 SOM (Serviceable Obtainable Market)
94
- Определить реалистичную долю SAM:
95
-
96
- 1. Оценить capture rate:
97
-
98
- | Стадия | Типичный capture rate | Обоснование |
99
- |--------|:---------------------:|-------------|
100
- | Pre-product (идея) | 0.5-1% | Нет продукта, нет клиентов |
101
- | Стартап (MVP, <$1M ARR) | 1-3% | Первые клиенты, PMF ищется |
102
- | Растущий ($1M-10M ARR) | 3-5% | PMF найден, масштабирование |
103
- | Зрелый (>$10M ARR) | 5-15% | Устоявшийся бренд и каналы |
104
- | Лидер рынка | 15-30% | Доминирующая позиция |
105
-
106
- 2. Учесть конкурентную интенсивность:
107
- - Если есть `$competitive-analysis` — использовать доли конкурентов для обоснования.
108
- - Если нетоценить по количеству игроков и их размеру.
109
-
110
- 3. `SOM = SAM × Capture Rate`.
111
- 4. Рассчитать для 3 горизонтов: год 1, год 3, год 5.
112
-
113
- ### Шаг 4 — Анализ чувствительности
114
- Оценить, как изменится SOM при вариации ключевых параметров:
115
-
116
- | Параметр | Вариация | Влияние на SOM |
117
- |----------|:--------:|:--------------:|
118
- | ACV | ±20% | SOM ±20% |
119
- | Capture rate | ±50% | SOM ±50% |
120
- | Размер целевого сегмента | ±30% | SAM/SOM ±30% |
121
-
122
- 3 сценария:
123
-
124
- | Сценарий | TAM | SAM | SOM (год 3) | Ключевое допущение |
125
- |----------|:---:|:---:|:-----------:|---------------------|
126
- | Оптимистичный | $XB | $XM | $XM | [Что должно сбыться] |
127
- | Базовый | $XB | $XM | $XM | [Текущие тренды] |
128
- | Пессимистичный | $XB | $XM | $XM | [Что может пойти не так] |
129
-
130
- ### Шаг 5Динамика и рост (YoY)
131
- 1. Определить CAGR рынка (историческая + прогнозная).
132
- 2. Факторы роста: технологии, регуляция, поведение потребителей.
133
- 3. Факторы торможения: насыщение, замещение, кризисы.
134
- 4. Прогноз TAM/SAM/SOM на горизонте 3-5 лет.
135
-
136
- ## Пример B2B SaaS: платформа корпоративного обучения, РФ
137
-
138
- **Контекст:** AI-powered платформа корпоративного обучения, B2B SaaS, подписка per seat, РФ. ACV $6K/год. Горизонт: 2026-2031.
139
-
140
- ### TAM
141
-
142
- **Top-down:**
143
- - Рынок EdTech РФ = $4.2B (Smart Ranking, 2026)
144
- - Корпоративное обучение = 43% EdTech = $1.8B (ВШЭ, 2026)
145
- - **TAM (top-down) = $1.8B**
146
-
147
- **Bottom-up:**
148
- - Компании в РФ с 50+ сотрудниками: ~85 000 (Росстат, 2025)
149
- - Средний бюджет на обучение: $18K/год (HH.ru Research, 2026) ⚠️ (1 источник)
150
- - **TAM (bottom-up) = 85 000 × $18K = $1.53B**
151
-
152
- **Сверка:** разброс 15% ($1.53B vs $1.8B) — нормальный. **TAM = $1.65B** (среднее).
153
-
154
- ### SAM
155
-
156
- | # | Фильтр | Множитель | Обоснование | Источник |
157
- |---|--------|:---------:|-------------|----------|
158
- | 1 | Только SaaS-решения (не тренеры, не офлайн) | ×35% | 35% бюджетов идёт на digital | ВШЭ, 2026 ✅ |
159
- | 2 | Компании 50-2000 чел. (наш sweet spot) | ×60% | Ent >2000 — SAP/Oracle; <50 — не покупают | CRM + бенчмарк |
160
- | 3 | IT, финтех, ритейл, производство | ×70% | Остальные отрасли — низкая цифровизация | Росстат ⚠️ |
161
-
162
- **SAM = $1.65B × 0.35 × 0.60 × 0.70 = $243M**
163
-
164
- ### SOM
165
-
166
- | Горизонт | Capture Rate | SOM | Обоснование |
167
- |:--------:|:-----------:|:---:|-------------|
168
- | Год 1 | 1.5% | $3.6M | Стартап, 50 клиентов, $6K ACV |
169
- | Год 3 | 4% | $9.7M | PMF найден, 160 клиентов |
170
- | Год 5 | 8% | $19.4M | Лидер в нише AI-обучение |
171
-
172
- ### Анализ чувствительности (SOM год 3)
173
-
174
- | Сценарий | TAM | SAM | SOM | Допущение |
175
- |----------|:---:|:---:|:---:|-----------|
176
- | Оптимистичный | $2.1B | $310M | $15.5M | CAGR 25% + госсубсидии на 50% |
177
- | Базовый | $1.65B | $243M | $9.7M | CAGR 18%, текущая конкуренция |
178
- | Пессимистичный | $1.3B | $182M | $5.5M | Инфляция давит бюджеты, capture 3% |
179
-
180
- ### Динамика
181
-
182
- | Год | TAM | CAGR | SAM | SOM |
183
- |:---:|:---:|:----:|:---:|:---:|
184
- | 2026 | $1.65B | — | $243M | $3.6M |
185
- | 2027 | $1.95B | 18% | $287M | $5.7M |
186
- | 2029 | $2.71B | 18% | $399M | $15.9M |
187
- | 2031 | $3.77B | 18% | $555M | $44.4M |
188
-
189
- **Факторы роста:** дефицит кадров (HR-бюджеты ), AI-персонализация, госпрограмма «Кадры».
190
- **Факторы торможения:** инфляция (8-10%), конкуренция (Яндекс, Skillbox), регуляторные барьеры (ФЗ-152).
191
-
192
- ## Валидация (Quality Gate)
193
-
194
- - [ ] TAM рассчитан двумя методами (top-down + bottom-up)
195
- - [ ] Разброс между методами зафиксирован и обработан по правилу (<30% / 30-100% / >100%)
196
- - [ ] SAM имеет чёткие фильтры, каждый обоснован с множителем и источником
197
- - [ ] SOM основан на реалистичном capture rate с обоснованием стадией компании
198
- - [ ] SOM рассчитан для 3 горизонтов (год 1 / 3 / 5)
199
- - [ ] Анализ чувствительности: 3 сценария с вариацией ACV, capture rate, сегмента
200
- - [ ] CAGR и прогноз на 3-5 лет с факторами роста и торможения
201
- - [ ] TAM SAM SOM (нет внутренних противоречий)
202
- - [ ] Единицы измерения и валюта консистентны
203
- - [ ] Все цифры имеют источник; >24 мес = ⚠️; экстраполяции = 🔮
204
- - [ ] Конфликтующие источники зафиксированы с объяснением выбора
205
-
206
- > Если валидация не пройдена доработать до повторного прохождения, а не передавать дальше.
207
-
208
- ## Handoff
209
- Результат `$tam-sam-som` является входом для:
210
- - **Стратег / Медиатор** — размер рынка как фактор при выборе стратегии.
211
- - **`unit-economics`** размер рынка для калькуляции потенциальной выручки.
212
- - **`competitive-analysis`** рыночные доли конкурентов для бенчмаркинга.
213
- - **`ansoff-matrix`** TAM новых рынков для стратегий Market Development.
214
- - **`bcg-matrix`** рост рынка для классификации бизнес-единиц.
215
- - **`blue-ocean-strategy`** TAM нового пространства (не-клиенты).
216
-
217
- Формат передачи: воронка TAM/SAM/SOM + фильтры + чувствительность + динамика + допущения. При передаче — использовать `$handoff`.
218
-
219
- ## Anti-patterns
220
-
221
- | Ошибка | Почему плохо | Как правильно |
222
- |--------|-------------|---------------|
223
- | Только top-down | Одна методология даёт искажённую картину | Всегда два метода: top-down + bottom-up + сверка |
224
- | TAM = вся индустрия | Завышение в десятки раз, потеря доверия | Чётко ограничить категорию продукта |
225
- | SOM без capture rate | Фантазия, а не прогноз | Обосновать capture rate стадией компании и конкурентной средой |
226
- | Старые данные | Рынки меняются быстро | Источники ≤ 24 мес; старше = ⚠️ + верификация |
227
- | Без анализа чувствительности | Ложная точность одно число вместо диапазона | 3 сценария: ACV ±20%, capture ±50%, сегмент ±30% |
228
- | SAM = TAM | Нет фильтрации, бесполезная оценка | Фильтры: гео, сегмент, регуляция, технологии — каждый с множителем |
229
- | Без указания допущений | Невозможно оценить надёжность оценки | Каждое допущение с влиянием на результат |
230
- | Top-down и bottom-up расходятся > 100% | Один из методов ошибочен, нельзя усреднять | Найти источник ошибки, не усреднять |
231
-
232
- ## Шаблон вывода
233
-
234
- ```
235
- ### Оценка размера рынка — [Продукт / Сервис]
236
-
237
- **Категория рынка:** [индустрия → подкатегория → ниша]
238
- **География:** [регионы]
239
- **Бизнес-модель:** [модель]
240
- **Валюта:** [USD / EUR / RUB]
241
- **Горизонт:** [год год]
242
- **Дата оценки:** [дата]
243
-
244
- ---
245
-
246
- #### Воронка TAM SAM SOM
247
-
248
- | Метрика | Объём | Метод | Источник | Достоверность |
249
- |---------|:-----:|-------|----------|:-------------:|
250
- | **TAM** (top-down) | $[X]B | [метод] | [источник, год] | ✅ / ⚠️ / 🔮 |
251
- | **TAM** (bottom-up) | $[Y]B | [кол-во] × [ACV] × [частота] | [источник] | ✅ / ⚠️ / 🔮 |
252
- | **TAM** (финальная) | $[Z]B | [Среднее / взвешенное / выбор] | Разброс: X% | |
253
- | **SAM** | $[X]M | TAM × фильтры | [источники] | |
254
- | **SOM** (год 1) | $[X]M | SAM × [X]% capture | [обоснование] | |
255
- | **SOM** (год 3) | $[X]M | SAM × [X]% capture | [обоснование] | |
256
- | **SOM** (год 5) | $[X]M | SAM × [X]% capture | [обоснование] | |
257
-
258
- ---
259
-
260
- #### Фильтры SAM
261
-
262
- | # | Фильтр | Множитель | Обоснование | Источник |
263
- |---|--------|:---------:|-------------|----------|
264
- | 1 | [Гео] | ×XX% | [Почему] | [Источник] |
265
- | 2 | [Сегмент] | ×XX% | [Почему] | [Источник] |
266
-
267
- `SAM = TAM × Ф₁ × Ф₂ × ... = $[X]M`
268
-
269
- ---
270
-
271
- #### Capture Rate (SOM)
272
-
273
- | Горизонт | Capture Rate | SOM | Обоснование |
274
- |:--------:|:-----------:|:---:|-------------|
275
- | Год 1 | X% | $XM | [Стадия + конкуренция] |
276
- | Год 3 | X% | $XM | [Стадия + конкуренция] |
277
- | Год 5 | X% | $XM | [Стадия + конкуренция] |
278
-
279
- ---
280
-
281
- #### Анализ чувствительности
282
-
283
- | Сценарий | TAM | SAM | SOM (год 3) | Ключевое допущение |
284
- |----------|:---:|:---:|:-----------:|---------------------|
285
- | Оптимистичный | $XB | $XM | $XM | [Что должно сбыться] |
286
- | Базовый | $XB | $XM | $XM | [Текущие тренды] |
287
- | Пессимистичный | $XB | $XM | $XM | [Что может пойти не так] |
288
-
289
- ---
290
-
291
- #### Динамика рынка (YoY)
292
-
293
- | Год | TAM | CAGR | SAM | SOM |
294
- |:---:|:---:|:----:|:---:|:---:|
295
- | [текущий] | $XB | — | $XM | $XM |
296
- | [+1] | $XB | X% | $XM | $XM |
297
- | [+3] | $XB | X% | $XM | $XM |
298
- | [+5] | $XB | X% | $XM | $XM |
299
-
300
- **Факторы роста:** [перечень]
301
- **Факторы торможения:** [перечень]
302
-
303
- ---
304
-
305
- #### Источники и допущения
306
-
307
- | # | Факт / допущение | Источник | Дата | Достоверность |
308
- |---|-------------------|----------|------|:-------------:|
309
- | 1 | [Факт] | [Источник] | [Дата] | ✅ / ⚠️ / 🔮 |
310
-
311
- Легенда: ✅ Verified (2+ источника) | ⚠️ Estimated (1 источник) | 🔮 Assumed (экстраполяция / расчёт)
312
- ```
1
+ ---
2
+ name: tam-sam-som
3
+ description: Оценка размера рынка — общий, доступный и достижимый объём
4
+ type: triggered
5
+ domain: analytics
6
+ owners:
7
+ - strategist
8
+ gates:
9
+ - STRATEGIST
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - "tam-sam-som"
14
+ - "TAM"
15
+ - "SAM"
16
+ - "SOM"
17
+ - "размер рынка"
18
+ related: []
19
+ budget_lines: 329
20
+ schema_version: 1
21
+ ---
22
+ # TAM/SAM/SOM Оценка размера рынка
23
+
24
+ ## Когда использовать
25
+ - При выходе на новый рынок или запуске нового продукта — для обоснования потенциала.
26
+ - При подготовке инвестиционных материалов (pitch deck, бизнес-план) инвесторы требуют размер рынка.
27
+ - При стратегическом планировании — выбор между рынками, вертикалями или географиями.
28
+ - При пересмотре стратегии — если рынок изменился (регуляция, технологии, конкуренция).
29
+
30
+ ## Вход
31
+
32
+ | Поле | Обязательно | Описание |
33
+ |------|:-----------:|----------|
34
+ | Продукт / сервис | ✅ | Что именно предлагаем рынку |
35
+ | Целевая география | | Страны / регионы для оценки |
36
+ | Бизнес-модель | ✅ | B2B / B2C / B2B2C / SaaS / Marketplace и т.д. |
37
+ | Ценовая модель | ✅ | Подписка / транзакция / лицензия / freemium |
38
+ | Средний чек (ACV) | | Если известен; иначе будет оценён |
39
+ | Целевые сегменты | ⬚ | Если уже определены (размер компании, отрасль, демография) |
40
+ | Конкуренты | | Известные игроки на рынке |
41
+ | Горизонт прогноза | | На сколько лет (по умолчанию 3-5 лет) |
42
+
43
+ > Если обязательные поля не предоставлены **запросить у пользователя** до начала анализа. Не додумывать.
44
+
45
+ ## Источники данных
46
+ 1. **Веб-поиск** — отраслевые отчёты (Statista, Grand View Research, Mordor Intelligence, IBISWorld, McKinsey, Gartner).
47
+ 2. **Финансовые данные** — публичная отчётность конкурентов (SEC filings, годовые отчёты).
48
+ 3. **Статистические базы** — данные госстатистик (Росстат, Eurostat, Census Bureau, World Bank).
49
+ 4. **Отраслевые ассоциации**профильные объединения, торговые палаты.
50
+ 5. **Данные от пользователя** внутренняя аналитика, CRM, текущие продажи.
51
+
52
+ > Для каждой цифры указать источник и дату. Данные старше 24 месяцев — пометить ⚠️ и верифицировать через `web-research`. Экстраполяции — помечать как 🔮 Assumed.
53
+
54
+ ### Связь с другими скилами
55
+ | Скил | Что берём | Когда вызывать |
56
+ |------|-----------|----------------|
57
+ | `web-research` | Отраслевые отчёты, размеры рынков, CAGR (шаги 2-4) | Основной инструмент — вызывать для каждого уровня воронки |
58
+ | `pest-analysis` | Макро-ограничения на TAM: регуляторные, экономические (шаг 3) | Если регуляция или макросреда ограничивают рынок |
59
+ | `competitive-analysis` | Доли конкурентов для обоснования capture rate SOM (шаг 4) | Если неизвестна конкурентная структура рынка |
60
+ | `icp-buyer-persona` | Фильтры SAM: ICP определяет целевой сегмент (шаг 3) | Если целевые сегменты не определены |
61
+ | `ansoff-matrix` | TAM новых рынков для стратегий Market Development и Diversification | После расчёта — для оценки стратегий роста |
62
+ | `blue-ocean-strategy` | TAM нового рыночного пространства (не-клиенты) | Если основной рынок мал — оценить Blue Ocean TAM |
63
+
64
+ ## Протокол
65
+
66
+ ### Шаг 0 Сбор контекста
67
+ 1. Проверить наличие всех обязательных входных данных. Если чего-то не хватает — запросить у пользователя.
68
+ 2. Определить единицу измерения (USD, EUR, RUB) и временной горизонт.
69
+ 3. Чётко сформулировать, какую проблему решает продукт.
70
+ 4. Определить категорию рынка (индустрия → подкатегория → ниша).
71
+ 5. Зафиксировать границы рынка: что включаем, что исключаем.
72
+
73
+ ### Шаг 1 TAM (Total Addressable Market)
74
+ Оценить **двумя методами** для перекрёстной проверки:
75
+
76
+ **Top-down:**
77
+ 1. Найти общий объём индустрии (из отраслевых отчётов).
78
+ 2. Применить фильтр по категории продукта.
79
+ 3. Применить фильтр по географии.
80
+ 4. Зафиксировать: источник, год, методологию отчёта.
81
+
82
+ **Bottom-up:**
83
+ 1. Определить общее количество потенциальных клиентов в категории.
84
+ 2. Умножить на средний чек (ACV) × частоту покупок в год.
85
+ 3. `TAM (bottom-up) = Кол-во клиентов × ACV × Частота`.
86
+ 4. Зафиксировать: источник данных о кол-ве клиентов, обоснование ACV.
87
+
88
+ **Сверка методов:**
89
+
90
+ | Условие | Действие |
91
+ |---------|----------|
92
+ | Разброс < 30% | Использовать среднее. Нормальное расхождение |
93
+ | Разброс 30-100% | Исследовать причину. Зафиксировать оба числа, обосновать выбор финального |
94
+ | Разброс > 100% | 🔴 Проблема: пересмотреть границы рынка или источники. Не усреднять — найти ошибку |
95
+
96
+ ### Шаг 2 — SAM (Serviceable Addressable Market)
97
+ Применить фильтры к TAM:
98
+
99
+ | # | Фильтр | Описание | Множитель | Обоснование | Источник |
100
+ |---|--------|----------|:---------:|-------------|----------|
101
+ | 1 | География | Где реально работаем | ×XX% | [Почему] | [Источник] |
102
+ | 2 | Сегмент | B2B: размер, отрасль; B2C: демография | ×XX% | [Почему] | [Источник] |
103
+ | 3 | Регуляция | Лицензии, сертификации, запреты | ×XX% | [Почему] | [Источник] |
104
+ | 4 | Технологии | Язык, платформа, интеграции | ×XX% | [Почему] | [Источник] |
105
+
106
+ `SAM = TAM × Фильтр₁ × Фильтр₂ × ... × ФильтрN`
107
+
108
+ > Если есть `$icp-buyer-persona` использовать ICP-критерии как фильтры SAM (идеальный + приемлемый).
109
+
110
+ ### Шаг 3 SOM (Serviceable Obtainable Market)
111
+ Определить реалистичную долю SAM:
112
+
113
+ 1. Оценить capture rate:
114
+
115
+ | Стадия | Типичный capture rate | Обоснование |
116
+ |--------|:---------------------:|-------------|
117
+ | Pre-product (идея) | 0.5-1% | Нет продукта, нет клиентов |
118
+ | Стартап (MVP, <$1M ARR) | 1-3% | Первые клиенты, PMF ищется |
119
+ | Растущий ($1M-10M ARR) | 3-5% | PMF найден, масштабирование |
120
+ | Зрелый (>$10M ARR) | 5-15% | Устоявшийся бренд и каналы |
121
+ | Лидер рынка | 15-30% | Доминирующая позиция |
122
+
123
+ 2. Учесть конкурентную интенсивность:
124
+ - Если есть `$competitive-analysis` использовать доли конкурентов для обоснования.
125
+ - Если нет — оценить по количеству игроков и их размеру.
126
+
127
+ 3. `SOM = SAM × Capture Rate`.
128
+ 4. Рассчитать для 3 горизонтов: год 1, год 3, год 5.
129
+
130
+ ### Шаг 4Анализ чувствительности
131
+ Оценить, как изменится SOM при вариации ключевых параметров:
132
+
133
+ | Параметр | Вариация | Влияние на SOM |
134
+ |----------|:--------:|:--------------:|
135
+ | ACV | ±20% | SOM ±20% |
136
+ | Capture rate | ±50% | SOM ±50% |
137
+ | Размер целевого сегмента | ±30% | SAM/SOM ±30% |
138
+
139
+ 3 сценария:
140
+
141
+ | Сценарий | TAM | SAM | SOM (год 3) | Ключевое допущение |
142
+ |----------|:---:|:---:|:-----------:|---------------------|
143
+ | Оптимистичный | $XB | $XM | $XM | [Что должно сбыться] |
144
+ | Базовый | $XB | $XM | $XM | [Текущие тренды] |
145
+ | Пессимистичный | $XB | $XM | $XM | [Что может пойти не так] |
146
+
147
+ ### Шаг 5 — Динамика и рост (YoY)
148
+ 1. Определить CAGR рынка (историческая + прогнозная).
149
+ 2. Факторы роста: технологии, регуляция, поведение потребителей.
150
+ 3. Факторы торможения: насыщение, замещение, кризисы.
151
+ 4. Прогноз TAM/SAM/SOM на горизонте 3-5 лет.
152
+
153
+ ## Пример — B2B SaaS: платформа корпоративного обучения, РФ
154
+
155
+ **Контекст:** AI-powered платформа корпоративного обучения, B2B SaaS, подписка per seat, РФ. ACV $6K/год. Горизонт: 2026-2031.
156
+
157
+ ### TAM
158
+
159
+ **Top-down:**
160
+ - Рынок EdTech РФ = $4.2B (Smart Ranking, 2026)
161
+ - Корпоративное обучение = 43% EdTech = $1.8B (ВШЭ, 2026) ✅
162
+ - **TAM (top-down) = $1.8B**
163
+
164
+ **Bottom-up:**
165
+ - Компании в РФ с 50+ сотрудниками: ~85 000 (Росстат, 2025) ✅
166
+ - Средний бюджет на обучение: $18K/год (HH.ru Research, 2026) ⚠️ (1 источник)
167
+ - **TAM (bottom-up) = 85 000 × $18K = $1.53B**
168
+
169
+ **Сверка:** разброс 15% ($1.53B vs $1.8B) нормальный. **TAM = $1.65B** (среднее).
170
+
171
+ ### SAM
172
+
173
+ | # | Фильтр | Множитель | Обоснование | Источник |
174
+ |---|--------|:---------:|-------------|----------|
175
+ | 1 | Только SaaS-решения (не тренеры, не офлайн) | ×35% | 35% бюджетов идёт на digital | ВШЭ, 2026 ✅ |
176
+ | 2 | Компании 50-2000 чел. (наш sweet spot) | ×60% | Ent >2000 SAP/Oracle; <50 — не покупают | CRM + бенчмарк |
177
+ | 3 | IT, финтех, ритейл, производство | ×70% | Остальные отрасли низкая цифровизация | Росстат ⚠️ |
178
+
179
+ **SAM = $1.65B × 0.35 × 0.60 × 0.70 = $243M**
180
+
181
+ ### SOM
182
+
183
+ | Горизонт | Capture Rate | SOM | Обоснование |
184
+ |:--------:|:-----------:|:---:|-------------|
185
+ | Год 1 | 1.5% | $3.6M | Стартап, 50 клиентов, $6K ACV |
186
+ | Год 3 | 4% | $9.7M | PMF найден, 160 клиентов |
187
+ | Год 5 | 8% | $19.4M | Лидер в нише AI-обучение |
188
+
189
+ ### Анализ чувствительности (SOM год 3)
190
+
191
+ | Сценарий | TAM | SAM | SOM | Допущение |
192
+ |----------|:---:|:---:|:---:|-----------|
193
+ | Оптимистичный | $2.1B | $310M | $15.5M | CAGR 25% + госсубсидии на 50% |
194
+ | Базовый | $1.65B | $243M | $9.7M | CAGR 18%, текущая конкуренция |
195
+ | Пессимистичный | $1.3B | $182M | $5.5M | Инфляция давит бюджеты, capture 3% |
196
+
197
+ ### Динамика
198
+
199
+ | Год | TAM | CAGR | SAM | SOM |
200
+ |:---:|:---:|:----:|:---:|:---:|
201
+ | 2026 | $1.65B | | $243M | $3.6M |
202
+ | 2027 | $1.95B | 18% | $287M | $5.7M |
203
+ | 2029 | $2.71B | 18% | $399M | $15.9M |
204
+ | 2031 | $3.77B | 18% | $555M | $44.4M |
205
+
206
+ **Факторы роста:** дефицит кадров (HR-бюджеты ↑), AI-персонализация, госпрограмма «Кадры».
207
+ **Факторы торможения:** инфляция (8-10%), конкуренция (Яндекс, Skillbox), регуляторные барьеры (ФЗ-152).
208
+
209
+ ## Валидация (Quality Gate)
210
+
211
+ - [ ] TAM рассчитан двумя методами (top-down + bottom-up)
212
+ - [ ] Разброс между методами зафиксирован и обработан по правилу (<30% / 30-100% / >100%)
213
+ - [ ] SAM имеет чёткие фильтры, каждый обоснован с множителем и источником
214
+ - [ ] SOM основан на реалистичном capture rate с обоснованием стадией компании
215
+ - [ ] SOM рассчитан для 3 горизонтов (год 1 / 3 / 5)
216
+ - [ ] Анализ чувствительности: 3 сценария с вариацией ACV, capture rate, сегмента
217
+ - [ ] CAGR и прогноз на 3-5 лет с факторами роста и торможения
218
+ - [ ] TAM ≥ SAM ≥ SOM (нет внутренних противоречий)
219
+ - [ ] Единицы измерения и валюта консистентны
220
+ - [ ] Все цифры имеют источник; >24 мес = ⚠️; экстраполяции = 🔮
221
+ - [ ] Конфликтующие источники зафиксированы с объяснением выбора
222
+
223
+ > Если валидация не пройдена доработать до повторного прохождения, а не передавать дальше.
224
+
225
+ ## Handoff
226
+ Результат `$tam-sam-som` является входом для:
227
+ - **Стратег / Медиатор**размер рынка как фактор при выборе стратегии.
228
+ - **`unit-economics`** размер рынка для калькуляции потенциальной выручки.
229
+ - **`competitive-analysis`**рыночные доли конкурентов для бенчмаркинга.
230
+ - **`ansoff-matrix`** TAM новых рынков для стратегий Market Development.
231
+ - **`bcg-matrix`** — рост рынка для классификации бизнес-единиц.
232
+ - **`blue-ocean-strategy`** — TAM нового пространства (не-клиенты).
233
+
234
+ Формат передачи: воронка TAM/SAM/SOM + фильтры + чувствительность + динамика + допущения. При передаче — использовать `$handoff`.
235
+
236
+ ## Anti-patterns
237
+
238
+ | Ошибка | Почему плохо | Как правильно |
239
+ |--------|-------------|---------------|
240
+ | Только top-down | Одна методология даёт искажённую картину | Всегда два метода: top-down + bottom-up + сверка |
241
+ | TAM = вся индустрия | Завышение в десятки раз, потеря доверия | Чётко ограничить категорию продукта |
242
+ | SOM без capture rate | Фантазия, а не прогноз | Обосновать capture rate стадией компании и конкурентной средой |
243
+ | Старые данные | Рынки меняются быстро | Источники ≤ 24 мес; старше = ⚠️ + верификация |
244
+ | Без анализа чувствительности | Ложная точность — одно число вместо диапазона | 3 сценария: ACV ±20%, capture ±50%, сегмент ±30% |
245
+ | SAM = TAM | Нет фильтрации, бесполезная оценка | Фильтры: гео, сегмент, регуляция, технологии — каждый с множителем |
246
+ | Без указания допущений | Невозможно оценить надёжность оценки | Каждое допущение — с влиянием на результат |
247
+ | Top-down и bottom-up расходятся > 100% | Один из методов ошибочен, нельзя усреднять | Найти источник ошибки, не усреднять |
248
+
249
+ ## Шаблон вывода
250
+
251
+ ```
252
+ ### Оценка размера рынка [Продукт / Сервис]
253
+
254
+ **Категория рынка:** [индустрия подкатегория ниша]
255
+ **География:** [регионы]
256
+ **Бизнес-модель:** [модель]
257
+ **Валюта:** [USD / EUR / RUB]
258
+ **Горизонт:** [год — год]
259
+ **Дата оценки:** [дата]
260
+
261
+ ---
262
+
263
+ #### Воронка TAM → SAM → SOM
264
+
265
+ | Метрика | Объём | Метод | Источник | Достоверность |
266
+ |---------|:-----:|-------|----------|:-------------:|
267
+ | **TAM** (top-down) | $[X]B | [метод] | [источник, год] | ✅ / ⚠️ / 🔮 |
268
+ | **TAM** (bottom-up) | $[Y]B | [кол-во] × [ACV] × [частота] | [источник] | ✅ / ⚠️ / 🔮 |
269
+ | **TAM** (финальная) | $[Z]B | [Среднее / взвешенное / выбор] | Разброс: X% | |
270
+ | **SAM** | $[X]M | TAM × фильтры | [источники] | |
271
+ | **SOM** (год 1) | $[X]M | SAM × [X]% capture | [обоснование] | |
272
+ | **SOM** (год 3) | $[X]M | SAM × [X]% capture | [обоснование] | |
273
+ | **SOM** (год 5) | $[X]M | SAM × [X]% capture | [обоснование] | |
274
+
275
+ ---
276
+
277
+ #### Фильтры SAM
278
+
279
+ | # | Фильтр | Множитель | Обоснование | Источник |
280
+ |---|--------|:---------:|-------------|----------|
281
+ | 1 | [Гео] | ×XX% | [Почему] | [Источник] |
282
+ | 2 | [Сегмент] | ×XX% | [Почему] | [Источник] |
283
+
284
+ `SAM = TAM × Ф₁ × Ф₂ × ... = $[X]M`
285
+
286
+ ---
287
+
288
+ #### Capture Rate (SOM)
289
+
290
+ | Горизонт | Capture Rate | SOM | Обоснование |
291
+ |:--------:|:-----------:|:---:|-------------|
292
+ | Год 1 | X% | $XM | [Стадия + конкуренция] |
293
+ | Год 3 | X% | $XM | [Стадия + конкуренция] |
294
+ | Год 5 | X% | $XM | [Стадия + конкуренция] |
295
+
296
+ ---
297
+
298
+ #### Анализ чувствительности
299
+
300
+ | Сценарий | TAM | SAM | SOM (год 3) | Ключевое допущение |
301
+ |----------|:---:|:---:|:-----------:|---------------------|
302
+ | Оптимистичный | $XB | $XM | $XM | [Что должно сбыться] |
303
+ | Базовый | $XB | $XM | $XM | [Текущие тренды] |
304
+ | Пессимистичный | $XB | $XM | $XM | [Что может пойти не так] |
305
+
306
+ ---
307
+
308
+ #### Динамика рынка (YoY)
309
+
310
+ | Год | TAM | CAGR | SAM | SOM |
311
+ |:---:|:---:|:----:|:---:|:---:|
312
+ | [текущий] | $XB | — | $XM | $XM |
313
+ | [+1] | $XB | X% | $XM | $XM |
314
+ | [+3] | $XB | X% | $XM | $XM |
315
+ | [+5] | $XB | X% | $XM | $XM |
316
+
317
+ **Факторы роста:** [перечень]
318
+ **Факторы торможения:** [перечень]
319
+
320
+ ---
321
+
322
+ #### Источники и допущения
323
+
324
+ | # | Факт / допущение | Источник | Дата | Достоверность |
325
+ |---|-------------------|----------|------|:-------------:|
326
+ | 1 | [Факт] | [Источник] | [Дата] | ✅ / ⚠️ / 🔮 |
327
+
328
+ Легенда: ✅ Verified (2+ источника) | ⚠️ Estimated (1 источник) | 🔮 Assumed (экстраполяция / расчёт)
329
+ ```