code-ai-installer 4.0.0 → 4.0.1-a

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 +36 -0
  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 +8 -0
  65. package/dist/mcp_setup.js +4 -1
  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,327 @@
1
- ---
2
- name: problem-statement
3
- description: Формулировка проблемы продукта — actor, context, pain, root cause, evidence
4
- ---
5
- # Problem Statement
6
-
7
- > **Категория:** Discovery · **Slug:** `problem-statement`
8
-
9
- ## Когда использовать
10
-
11
- - В начале Discovery phase — как фокусирующий артефакт.
12
- - Перед PRD — чётко сформулированная проблема = половина решения.
13
- - Когда команда расходится: «что именно мы решаем?».
14
- - Как filter для backlog: не relates к active problem → not in scope.
15
-
16
- ## Вход
17
-
18
- | Поле | Обязательно | Описание |
19
- |------|:-----------:|----------|
20
- | Evidence (interviews, tickets, metrics) | ✅ | Что указывает на проблему |
21
- | Target role | ✅ | Buyer / end-user / admin |
22
- | Context / trigger | ✅ | Когда проблема возникает |
23
- | Existing workaround | ⬚ | Как сейчас справляются |
24
-
25
- ## Источники данных
26
-
27
- 1. `$user-interview-script` quotespain descriptions.
28
- 2. Support tickets volume + categorization.
29
- 3. Product analytics drop-off points, error rates.
30
- 4. Competitor comparison — что они делают, а вы нет.
31
-
32
- ### Связь с другими скилами
33
-
34
- | Скил | Что берём | Когда вызывать |
35
- |------|-----------|----------------|
36
- | `user-interview-script` | Evidence quotes | Для каждой problem |
37
- | `jtbd-canvas` | Actor + desired outcome | Для формулировки |
38
- | `assumption-mapping` | Root cause assumptions | Если root cause неясен |
39
- | `opportunity-solution-tree` | Problem → opportunities | После formulating |
40
-
41
- ## Протокол
42
-
43
- ### Шаг 0Raw Signal Collection
44
-
45
- Собрать все signals: quotes, tickets, metrics. Группировать по похожим themes.
46
-
47
- ### Шаг 1 Formulation Frame
48
-
49
- Используй структуру:
50
-
51
- > **[Actor]** in **[context]** experiences **[pain]** because **[root cause]**. Evidence: **[data]**. Impact: **[quantified]**.
52
-
53
- Good:
54
- «**End-user engineers** at **mid-market SaaS companies** experience **2-3 hour delays to onboard new teammates** because **our role-based access setup requires 7 manual admin steps**. Evidence: 14 interviews + 230 support tickets Q3-Q4 2025. Impact: ~40% of new-hire first-week productivity lost.»
55
-
56
- Bad: «Onboarding is slow.»
57
-
58
- ### Шаг 2Five Whys
59
-
60
- Для каждой problem drill to root cause через 5 «почему?»:
61
-
62
- 1. Why is onboarding slow? → Manual admin steps.
63
- 2. Why manual? → No role templates.
64
- 3. Why no templates? → Product doesn't support.
65
- 4. Why not? → Not prioritized.
66
- 5. Why? No data on impact.
67
-
68
- Остановиться, когда дошёл до fix-able root cause (обычно на 3-4 уровне).
69
-
70
- ### Шаг 3 — Impact Quantification
71
-
72
- - **Reach** — сколько пользователей affected (weekly/monthly)
73
- - **Frequency**как часто они encounter
74
- - **Severity** — насколько плохо (блокирует / frustrating / minor)
75
- - **Business impact**churn risk / conversion drop / CAC increase / NRR impact
76
-
77
- Priority = Reach × Frequency × Severity.
78
-
79
- ### Шаг 4 Problem vs Symptom
80
-
81
- Distinguish:
82
- - **Problem:** «Can't easily onboard new teammates» (root)
83
- - **Symptom:** «Support tickets about SSO setup» (surface)
84
-
85
- Symptoms evidence для problem. Problem то, что решаем.
86
-
87
- ### Шаг 5 Non-problems
88
-
89
- Explicit out-of-scope: что **НЕ** решаем в этом framing:
90
- - «Мы не решаем compliance onboarding (legal concern)»
91
- - «Мы не решаем onboarding for external contractors (different flow)»
92
-
93
- ### Шаг 6 — Problem Statement Document
94
-
95
- Final artifact:
96
- - Problem statement (1 sentence structured format)
97
- - Evidence section (quotes, data, metrics)
98
- - Five-whys analysis
99
- - Impact quantification
100
- - Non-problems (explicit)
101
- - Open questions (для discovery)
102
-
103
- ## Валидация (Quality Gate)
104
-
105
- - [ ] Problem formulated как structured: actor / context / pain / root cause
106
- - [ ] Evidence 2 sources (interviews + quantitative)
107
- - [ ] Five-whys проведён до fix-able root
108
- - [ ] Impact quantified (reach × frequency × severity)
109
- - [ ] Distinguish problem от symptom
110
- - [ ] Non-problems explicit
111
- - [ ] Quantified impact связан с business metric
112
-
113
- ## Handoff
114
-
115
- Результат является входом для:
116
- - **`opportunity-solution-tree`** problem → opportunity space
117
- - **`rice-scoring`** — reach + impact feeds scoring
118
- - **`prd-template`** problem section
119
- - **`hypothesis-template`** — testable predictions из root cause
120
-
121
- Формат: problem statement doc (markdown). Через `$handoff`.
122
-
123
- ## Anti-patterns
124
-
125
- | Ошибка | Почему плохо | Как правильно |
126
- |--------|-------------|---------------|
127
- | Solution embedded | «Проблема: нет dashboard» | Проблема — боль, не отсутствие функции |
128
- | Vague actor | «Пользователи» | Конкретная роль: «Engineering manager в mid-market» |
129
- | No evidence | Спекуляция | Мин 2 источника, количественный + качественный |
130
- | No root cause | Остаёмся на поверхности | Five-whys обязателен |
131
- | Not quantified | «Серьёзная проблема» | Reach × Frequency × Severity |
132
- | Scope creep | «Все проблемы onboarding» | Узкий + non-problems |
133
-
134
- ## Шаблон
135
-
136
- ```markdown
137
- # Problem Statement: [Краткое название]
138
-
139
- ## Statement
140
- [Actor] в [контексте] испытывает [боль] потому что [root cause].
141
- Подтверждение: [источники]. Impact: [количественный].
142
-
143
- ## Подтверждение
144
- - Quote 1: «...» (Interview 3, mid-market Engineering Manager)
145
- - Объём тикетов: [N] Q3-Q4 2025
146
- - Метрика: [drop-off X% на шаге Y]
147
-
148
- ## Root Cause (Five Whys)
149
- 1. Почему X? → A
150
- 2. Почему A? → B
151
- ...
152
-
153
- ## Impact
154
- - Reach: [N пользователей / неделю]
155
- - Frequency: [N раз / месяц]
156
- - Severity: Blocker / Major / Minor
157
- - Business: [$X NRR impact / Y% conversion drop]
158
-
159
- ## Non-problems (вне scope)
160
- - ...
161
- ```
162
-
163
- ## Worked Example TeamFlow Top 3 Problem Statements
164
-
165
- **Контекст:** TeamFlow (B2B SaaS HR-tech, $8M ARR, 200 customers). После 8 interviews + JTBD canvas — команда сформулировала Top 3 problem statements для Discovery Brief. Все 3 — candidates для AI 1:1 summarization initiative, но разного приоритета.
166
-
167
- ### Problem Statement #1: Manager Admin Overhead
168
-
169
- #### Statement
170
-
171
- **People managers** (primarily в mid-market / enterprise B2B SaaS, 100-1000 employees) **managing 5-15 direct reports** experience **45-60 мин/неделю per report на 1:1 prep + note-taking + follow-up** (3-4 hrs/неделю total для manager с 8 reports), **because** TeamFlow provides a structured template but no capture or synthesis capability — managers должны manually type notes during conversation (losing focus) or after (losing context).
172
-
173
- Evidence: 6 of 8 customer interviews + 120 related support tickets Q1 2026 + internal analytics (averaged prep time inferred from session duration data). Impact: 3,000 active managers × 2 hrs/week saved × 50 weeks × $150/hr loaded cost = $45M gross annual value; business case assumes ~10% realizable as paid TeamFlow expansion → $3-5M ARR opportunity through premium AI tier.
174
-
175
- #### Evidence
176
-
177
- - **Quote 1:** «25 минут prep каждую неделю на каждого из 8 reports. Итого ~3 часа в неделю.» — Interview E3 (Engineering Manager, mid-market, 250 emp)
178
- - **Quote 2:** «Печатать во время встречи lose conversation. После встречи → forget context. Часто пишу только headlines и теряю context.» — E3
179
- - **Quote 3:** «Я скипнул подготовку к 1:1 с Junior engineer потому что был слишком загружен. Встреча получилась скомканной, он явно был disappointed. Я чувствовал себя виноватым.» — E3
180
- - **Quote 4:** «Если бы я мог просто говорить вслух во время встречи, а система сама бы писала notes, выделяла action itemsя бы за это заплатил personally.» E3
181
- - **Support tickets:** 120 tickets Q1 2026 tagged «1:1 notes / notes / meeting» — recurring themes: «can I export?», «why does TeamFlow not do X automatically?», «how do other teams handle notes?»
182
- - **Product analytics:** Session duration (time spent в 1:1 notes interface) avg 12 min per 1:1 prep + 8 min post — matches self-reported numbers
183
- - **Competitor comparison:** Lattice, 15Five — same gap. Industry-wide unmet need, not TeamFlow-specific.
184
-
185
- #### Root Cause (Five Whys)
186
-
187
- 1. **Почему менеджеры тратят 45-60 мин/неделю на 1:1 admin?**
188
- Потому что prep + note-taking + follow-up ручной труд, требующий ментального переключения контекста.
189
-
190
- 2. **Почему вручную?**
191
- → Потому что нет инструмента, который автоматически захватывает контент разговора и синтезирует action items.
192
-
193
- 3. **Почему нет инструмента?**
194
- Исторически: инструменты требовали точной транскрипции (не решено), privacy concerns, чувствительность HR данных. Теперь LLM APIs делают это осуществимым, но TeamFlow не инвестировал.
195
-
196
- 4. **Почему TeamFlow не инвестировал?**
197
- Исторически фокус на structured-data features (OKR, reviews). Note-taking воспринималось как commodity. Никто не строил business case для AI integration.
198
-
199
- 5. **Почему нет business case?**
200
- NRR / churn данные показывают что top-churn reason — «manager adoption low» (60% из customer interviews + CRM data). Связь между нагрузкой admin на менеджера → снижение adoption не была явно прослежена до недавнего анализа.
201
-
202
- **Root cause (уровень действий):** Отсутствие AI-powered capture + synthesis в 1:1 workflow — решается через integrated AI summarization feature.
203
-
204
- #### Impact
205
-
206
- - **Reach:** ~3,000 активных people managers по 200 customers (взвешенно: SMB 120 × 5 avg managers = 600, mid-market 70 × 20 avg = 1,400, enterprise 10 × 100 avg = 1,000)
207
- - **Frequency:** Еженедельно (3-4 часа/неделю на менеджера → 9,000-12,000 часов/неделю всего по базе)
208
- - **Severity:** Major (не блокирует, но генерирует 30% churn signal manager-tool)
209
- - **Business impact:**
210
- - Прямой: $3-5M ARR expansion opportunity в 4 кварталах через premium AI tier ($8-12/seat/mo)
211
- - Косвенный: NRR lift 5-10pp если улучшится manager activation / retention
212
- - Защитный: Lattice / 15Five могут запустить аналогичное; first-mover даёт moat
213
-
214
- #### Non-problems (out of scope)
215
-
216
- - **Не решаем** transcription accuracy ниже 95% для non-English languages (defer to future; English-first)
217
- - **Не решаем** meeting recording / video archival (legal / privacy implications различны в разных юрисдикциях)
218
- - **Не решаем** automated coaching suggestions («manager should have asked X») — требует deeper training data, future work
219
- - **Не решаем** integration с external meeting tools (Zoom/Meet/Teams) в первом релизе — только TeamFlow-native 1:1s
220
-
221
- ---
222
-
223
- ### Problem Statement #2: VP HR Lacks Visibility into 1:1 Quality / Frequency
224
-
225
- #### Statement
226
-
227
- **VPs of People / CPOs** у **mid-market и enterprise customers (100-1000 сотрудников)** лишены **видимости частоты 1:1, качества и completion rate action items по всей организации**, что вынуждает их полагаться на самоотчёты + анекдоты + exit interviews после ухода сотрудников. **Потому что** аналитика TeamFlow отображает team-level OKR данные, но не health метрики 1:1 (частота, длительность, velocity action items, sentiment).
228
-
229
- Подтверждение: 4 из 4 buyer interviews — прямые цитаты боли + конкретные запросы на dashboard. Impact: blocker для expansion с Team tier ($15/seat) на Enterprise tier ($50+/seat + analytics). Решение этой проблемы = $2-3M ARR expansion opportunity в существующей базе.
230
-
231
- #### Evidence
232
-
233
- - **Quote 1:** «Некоторые менеджеры проводят потрясающие 1:1s, другие буквально их отменяют. У меня нет видимости, нет рычагов влияния.» — B2 (VP HR, 450-emp B2B SaaS)
234
- - **Quote 2:** «Когда CFO спрашивает о ROI затрат на retention, мне приходится плести историю. У меня нет данных.» B1 (CPO, 800-emp enterprise)
235
- - **Quote 3:** «Sarah оставила компанию потому что её менеджер никогда не делал 1:1s. Мы узнали только потом. Я должна была знать.» — B3 (VP HR, 200-emp mid-market)
236
- - **CRM data:** 8 из 10 enterprise prospects спрашивают «есть ли у вас 1:1 analytics?» во время оценочных звонков — это текущий blocker для Enterprise tier conversion
237
- - **Product analytics:** В настоящее время buyer-role logins (VP/CPO) — 35% monthly active vs end-user 78% — указывает что у buyer недостаточно причин использовать продукт регулярно
238
-
239
- #### Root Cause (Five Whys)
240
-
241
- 1. **Почему VP HR лишён видимости?** → TeamFlow не отображает health метрики 1:1.
242
- 2. **Почему не отображает?** Существующая аналитика фокусируется на goals (OKR) и reviews, не на паттернах встреч.
243
- 3. **Почему?** → Product roadmap исторически приоритизировал OKR-centric features (последние 2 года).
244
- 4. **Почему?** Потому что sales-led сигналы указывали на OKR как дифференциатор vs конкуренты.
245
- 5. **Почему такие сигналы?** → Sales никогда не сегментировал buyer personas — VP HR vs CPO имеют разные приоритеты, но pitch был унифицирован.
246
-
247
- **Root cause (уровень действий):** Отсутствует buyer-persona-specific analytics layer. Решается через новую dashboard feature.
248
-
249
- #### Impact
250
-
251
- - **Reach:** 80 buyer аккаунтов (mid-market + enterprise), некоторое совпадение с enterprise tier
252
- - **Frequency:** Ежеквартально (критично для board prep)
253
- - **Severity:** Major — blocker для Enterprise tier expansion
254
- - **Business impact:** $2-3M ARR если Enterprise conversion rate улучшится с 15% до 30% в 4 кварталах
255
-
256
- #### Non-problems (out of scope)
257
-
258
- - **Не решаем** individual 1:1 content surveillance (privacy line VP HR sees aggregate only)
259
- - **Не решаем** compensation-linked coaching insights (separate initiative)
260
-
261
- ---
262
-
263
- ### Problem Statement #3: Action Items Drop Rate ~40%
264
-
265
- #### Statement
266
-
267
- **Менеджеры с 5+ прямыми подчинёнными** испытывают **~40% drop rate action items** из 1:1 встреч (забытые, не отслеживаемые, никогда не отмеченные как выполненные), **потому что** TeamFlow создаёт action items как записи, но не предоставляет механизма проактивных напоминаний / повторного отображения — менеджеры вынуждены самостоятельно контролировать выполнение.
268
-
269
- Подтверждение: 5 из 8 end-user interviews + internal product analytics (соотношение созданных и завершённых action items). Impact: косвенный на end-user satisfaction + retention.
270
-
271
- #### Evidence
272
-
273
- - **Quote 1:** «У меня наверное 20-30 открытых action items, половина из которых уже не актуальна... да и вообще уже забытые.» — E3
274
- - **Quote 2:** «Action items tracking слабо. Забываю проверить. Накапливаются.» — E3
275
- - **Product analytics:** Average action items created per 1:1 = 3.2. Average marked completed within 14 days = 1.9. Completion rate 60% = drop rate 40%.
276
- - **Support tickets:** 42 tickets Q1 2026 «action items not reminders / notifications»
277
-
278
- #### Root Cause (Five Whys)
279
-
280
- 1. **Почему 40% drop?** → Action items не отображаются проактивно, только ручная проверка.
281
- 2. **Почему не проактивно?** → Нет системы уведомлений / напоминаний для action items.
282
- 3. **Почему?** Изначальное дизайн-допущение: менеджер будет проверять вручную.
283
- 4. **Почему такое допущение?** → Дизайн эпохи до AI: ручной труд был единственным вариантом.
284
- 5. **Почему всё ещё вручную?** Функция не пересматривалась с момента первоначального запуска (2 года назад).
285
-
286
- **Root cause (уровень действий):** Отсутствует проактивный reminder layer. Low-hanging fruit — не требует AI, rule-based достаточно.
287
-
288
- #### Impact
289
-
290
- - **Reach:** ~3,000 менеджеров
291
- - **Frequency:** Еженедельно
292
- - **Severity:** Minor (не нарушает workflow, но накапливает раздражение)
293
- - **Business impact:** Косвенный — влияет на manager adoption rate + NPS
294
-
295
- #### Non-problems (out of scope)
296
-
297
- - **Не решаем** automatic action items extraction from unstructured notes (это часть AI summarization initiative)
298
- - **Не решаем** cross-team action items visibility (future)
299
-
300
- ---
301
-
302
- ### Сводка топ 3 приоритетов
303
-
304
- | # | Проблема | Actor | Severity | Охват | Business Impact | Приоритет |
305
- |---|---------|-------|:--------:|:-----:|:---------------:|:--------:|
306
- | 1 | Admin overhead менеджера | End-user manager | Major | ~3,000 | $3-5M ARR expansion | **P0** |
307
- | 2 | Разрыв видимости для buyer | VP HR / CPO | Major | 80 аккаунтов | $2-3M ARR (Enterprise conv) | **P0** |
308
- | 3 | Drop rate action items | End-user manager | Minor | ~3,000 | Косвенный | **P1** |
309
-
310
- **Вывод:** Проблемы #1 и #2 могут быть решены через **одну и ту же функцию** (AI summarization + aggregate dashboard), что делает initiative высокорычажным. Проблема #3 — complementary, но независимая (rule-based reminders, quick win).
311
-
312
- > **Урок problem-statement:** Каждая формально структурированная проблема предотвращает скрытые допущения. Five-whys Проблемы #1 выявили что **«почему исторически не инвестировали»** — стратегический вопрос, не просто продуктовый. Это информация для CEO / Board сессии, не просто engineering roadmap.
1
+ ---
2
+ name: problem-statement
3
+ description: Формулировка проблемы продукта — actor, context, pain, root cause, evidence
4
+ type: triggered
5
+ domain: product
6
+ owners:
7
+ - discovery
8
+ gates:
9
+ - DISCOVERY
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - problem-statement
14
+ - problem framing
15
+ - формулировка проблемы
16
+ related: []
17
+ budget_lines: 327
18
+ schema_version: 1
19
+ ---
20
+ # Problem Statement
21
+
22
+ > **Категория:** Discovery · **Slug:** `problem-statement`
23
+
24
+ ## Когда использовать
25
+
26
+ - В начале Discovery phase — как фокусирующий артефакт.
27
+ - Перед PRD чётко сформулированная проблема = половина решения.
28
+ - Когда команда расходится: «что именно мы решаем?».
29
+ - Как filter для backlog: не relates к active problem → not in scope.
30
+
31
+ ## Вход
32
+
33
+ | Поле | Обязательно | Описание |
34
+ |------|:-----------:|----------|
35
+ | Evidence (interviews, tickets, metrics) | ✅ | Что указывает на проблему |
36
+ | Target role | | Buyer / end-user / admin |
37
+ | Context / trigger | | Когда проблема возникает |
38
+ | Existing workaround | | Как сейчас справляются |
39
+
40
+ ## Источники данных
41
+
42
+ 1. `$user-interview-script` quotes — pain descriptions.
43
+ 2. Support ticketsvolume + categorization.
44
+ 3. Product analytics — drop-off points, error rates.
45
+ 4. Competitor comparison что они делают, а вы нет.
46
+
47
+ ### Связь с другими скилами
48
+
49
+ | Скил | Что берём | Когда вызывать |
50
+ |------|-----------|----------------|
51
+ | `user-interview-script` | Evidence quotes | Для каждой problem |
52
+ | `jtbd-canvas` | Actor + desired outcome | Для формулировки |
53
+ | `assumption-mapping` | Root cause assumptions | Если root cause неясен |
54
+ | `opportunity-solution-tree` | Problem opportunities | После formulating |
55
+
56
+ ## Протокол
57
+
58
+ ### Шаг 0Raw Signal Collection
59
+
60
+ Собрать все signals: quotes, tickets, metrics. Группировать по похожим themes.
61
+
62
+ ### Шаг 1 Formulation Frame
63
+
64
+ Используй структуру:
65
+
66
+ > **[Actor]** in **[context]** experiences **[pain]** because **[root cause]**. Evidence: **[data]**. Impact: **[quantified]**.
67
+
68
+ Good:
69
+ «**End-user engineers** at **mid-market SaaS companies** experience **2-3 hour delays to onboard new teammates** because **our role-based access setup requires 7 manual admin steps**. Evidence: 14 interviews + 230 support tickets Q3-Q4 2025. Impact: ~40% of new-hire first-week productivity lost.»
70
+
71
+ ❌ Bad: «Onboarding is slow.»
72
+
73
+ ### Шаг 2 Five Whys
74
+
75
+ Для каждой problemdrill to root cause через 5 «почему?»:
76
+
77
+ 1. Why is onboarding slow? Manual admin steps.
78
+ 2. Why manual? → No role templates.
79
+ 3. Why no templates? Product doesn't support.
80
+ 4. Why not? → Not prioritized.
81
+ 5. Why? → No data on impact.
82
+
83
+ Остановиться, когда дошёл до fix-able root cause (обычно на 3-4 уровне).
84
+
85
+ ### Шаг 3Impact Quantification
86
+
87
+ - **Reach**сколько пользователей affected (weekly/monthly)
88
+ - **Frequency** — как часто они encounter
89
+ - **Severity** насколько плохо (блокирует / frustrating / minor)
90
+ - **Business impact** churn risk / conversion drop / CAC increase / NRR impact
91
+
92
+ Priority = Reach × Frequency × Severity.
93
+
94
+ ### Шаг 4 — Problem vs Symptom
95
+
96
+ Distinguish:
97
+ - **Problem:** «Can't easily onboard new teammates» (root)
98
+ - **Symptom:** «Support tickets about SSO setup» (surface)
99
+
100
+ Symptoms evidence для problem. Problem — то, что решаем.
101
+
102
+ ### Шаг 5 — Non-problems
103
+
104
+ Explicit out-of-scope: что **НЕ** решаем в этом framing:
105
+ - «Мы не решаем compliance onboarding (legal concern)»
106
+ - «Мы не решаем onboarding for external contractors (different flow)»
107
+
108
+ ### Шаг 6 Problem Statement Document
109
+
110
+ Final artifact:
111
+ - Problem statement (1 sentence structured format)
112
+ - Evidence section (quotes, data, metrics)
113
+ - Five-whys analysis
114
+ - Impact quantification
115
+ - Non-problems (explicit)
116
+ - Open questions (для discovery)
117
+
118
+ ## Валидация (Quality Gate)
119
+
120
+ - [ ] Problem formulated как structured: actor / context / pain / root cause
121
+ - [ ] Evidence ≥ 2 sources (interviews + quantitative)
122
+ - [ ] Five-whys проведён до fix-able root
123
+ - [ ] Impact quantified (reach × frequency × severity)
124
+ - [ ] Distinguish problem от symptom
125
+ - [ ] Non-problems explicit
126
+ - [ ] Quantified impact связан с business metric
127
+
128
+ ## Handoff
129
+
130
+ Результат является входом для:
131
+ - **`opportunity-solution-tree`** problem opportunity space
132
+ - **`rice-scoring`** reach + impact feeds scoring
133
+ - **`prd-template`** — problem section
134
+ - **`hypothesis-template`** — testable predictions из root cause
135
+
136
+ Формат: problem statement doc (markdown). Через `$handoff`.
137
+
138
+ ## Anti-patterns
139
+
140
+ | Ошибка | Почему плохо | Как правильно |
141
+ |--------|-------------|---------------|
142
+ | Solution embedded | «Проблема: нет dashboard» | Проблема — боль, не отсутствие функции |
143
+ | Vague actor | «Пользователи» | Конкретная роль: «Engineering manager в mid-market» |
144
+ | No evidence | Спекуляция | Мин 2 источника, количественный + качественный |
145
+ | No root cause | Остаёмся на поверхности | Five-whys обязателен |
146
+ | Not quantified | «Серьёзная проблема» | Reach × Frequency × Severity |
147
+ | Scope creep | «Все проблемы onboarding» | Узкий + non-problems |
148
+
149
+ ## Шаблон
150
+
151
+ ```markdown
152
+ # Problem Statement: [Краткое название]
153
+
154
+ ## Statement
155
+ [Actor] в [контексте] испытывает [боль] потому что [root cause].
156
+ Подтверждение: [источники]. Impact: [количественный].
157
+
158
+ ## Подтверждение
159
+ - Quote 1: «...» (Interview 3, mid-market Engineering Manager)
160
+ - Объём тикетов: [N] Q3-Q4 2025
161
+ - Метрика: [drop-off X% на шаге Y]
162
+
163
+ ## Root Cause (Five Whys)
164
+ 1. Почему X? → A
165
+ 2. Почему A? B
166
+ ...
167
+
168
+ ## Impact
169
+ - Reach: [N пользователей / неделю]
170
+ - Frequency: [N раз / месяц]
171
+ - Severity: Blocker / Major / Minor
172
+ - Business: [$X NRR impact / Y% conversion drop]
173
+
174
+ ## Non-problems (вне scope)
175
+ - ...
176
+ ```
177
+
178
+ ## Worked Example TeamFlow Top 3 Problem Statements
179
+
180
+ **Контекст:** TeamFlow (B2B SaaS HR-tech, $8M ARR, 200 customers). После 8 interviews + JTBD canvas команда сформулировала Top 3 problem statements для Discovery Brief. Все 3 candidates для AI 1:1 summarization initiative, но разного приоритета.
181
+
182
+ ### Problem Statement #1: Manager Admin Overhead
183
+
184
+ #### Statement
185
+
186
+ **People managers** (primarily в mid-market / enterprise B2B SaaS, 100-1000 employees) **managing 5-15 direct reports** experience **45-60 мин/неделю per report на 1:1 prep + note-taking + follow-up** (3-4 hrs/неделю total для manager с 8 reports), **because** TeamFlow provides a structured template but no capture or synthesis capability — managers должны manually type notes during conversation (losing focus) or after (losing context).
187
+
188
+ Evidence: 6 of 8 customer interviews + 120 related support tickets Q1 2026 + internal analytics (averaged prep time inferred from session duration data). Impact: 3,000 active managers × 2 hrs/week saved × 50 weeks × $150/hr loaded cost = $45M gross annual value; business case assumes ~10% realizable as paid TeamFlow expansion → $3-5M ARR opportunity through premium AI tier.
189
+
190
+ #### Evidence
191
+
192
+ - **Quote 1:** «25 минут prep каждую неделю на каждого из 8 reports. Итого ~3 часа в неделю.» — Interview E3 (Engineering Manager, mid-market, 250 emp)
193
+ - **Quote 2:** «Печатать во время встречи → lose conversation. После встречи → forget context. Часто пишу только headlines и теряю context.» — E3
194
+ - **Quote 3:** «Я скипнул подготовку к 1:1 с Junior engineer потому что был слишком загружен. Встреча получилась скомканной, он явно был disappointed. Я чувствовал себя виноватым.» — E3
195
+ - **Quote 4:** «Если бы я мог просто говорить вслух во время встречи, а система сама бы писала notes, выделяла action items — я бы за это заплатил personally.» — E3
196
+ - **Support tickets:** 120 tickets Q1 2026 tagged «1:1 notes / notes / meeting» — recurring themes: «can I export?», «why does TeamFlow not do X automatically?», «how do other teams handle notes?»
197
+ - **Product analytics:** Session duration (time spent в 1:1 notes interface) avg 12 min per 1:1 prep + 8 min post matches self-reported numbers
198
+ - **Competitor comparison:** Lattice, 15Five — same gap. Industry-wide unmet need, not TeamFlow-specific.
199
+
200
+ #### Root Cause (Five Whys)
201
+
202
+ 1. **Почему менеджеры тратят 45-60 мин/неделю на 1:1 admin?**
203
+ → Потому что prep + note-taking + follow-up — ручной труд, требующий ментального переключения контекста.
204
+
205
+ 2. **Почему вручную?**
206
+ Потому что нет инструмента, который автоматически захватывает контент разговора и синтезирует action items.
207
+
208
+ 3. **Почему нет инструмента?**
209
+ Исторически: инструменты требовали точной транскрипции (не решено), privacy concerns, чувствительность HR данных. Теперь LLM APIs делают это осуществимым, но TeamFlow не инвестировал.
210
+
211
+ 4. **Почему TeamFlow не инвестировал?**
212
+ Исторически фокус на structured-data features (OKR, reviews). Note-taking воспринималось как commodity. Никто не строил business case для AI integration.
213
+
214
+ 5. **Почему нет business case?**
215
+ → NRR / churn данные показывают что top-churn reason — «manager adoption low» (60% из customer interviews + CRM data). Связь между нагрузкой admin на менеджера → снижение adoption не была явно прослежена до недавнего анализа.
216
+
217
+ **Root cause (уровень действий):** Отсутствие AI-powered capture + synthesis в 1:1 workflow решается через integrated AI summarization feature.
218
+
219
+ #### Impact
220
+
221
+ - **Reach:** ~3,000 активных people managers по 200 customers (взвешенно: SMB 120 × 5 avg managers = 600, mid-market 70 × 20 avg = 1,400, enterprise 10 × 100 avg = 1,000)
222
+ - **Frequency:** Еженедельно (3-4 часа/неделю на менеджера → 9,000-12,000 часов/неделю всего по базе)
223
+ - **Severity:** Major (не блокирует, но генерирует 30% churn signal manager-tool)
224
+ - **Business impact:**
225
+ - Прямой: $3-5M ARR expansion opportunity в 4 кварталах через premium AI tier ($8-12/seat/mo)
226
+ - Косвенный: NRR lift 5-10pp если улучшится manager activation / retention
227
+ - Защитный: Lattice / 15Five могут запустить аналогичное; first-mover даёт moat
228
+
229
+ #### Non-problems (out of scope)
230
+
231
+ - **Не решаем** transcription accuracy ниже 95% для non-English languages (defer to future; English-first)
232
+ - **Не решаем** meeting recording / video archival (legal / privacy implications различны в разных юрисдикциях)
233
+ - **Не решаем** automated coaching suggestions («manager should have asked X») требует deeper training data, future work
234
+ - **Не решаем** integration с external meeting tools (Zoom/Meet/Teams) в первом релизетолько TeamFlow-native 1:1s
235
+
236
+ ---
237
+
238
+ ### Problem Statement #2: VP HR Lacks Visibility into 1:1 Quality / Frequency
239
+
240
+ #### Statement
241
+
242
+ **VPs of People / CPOs** у **mid-market и enterprise customers (100-1000 сотрудников)** лишены **видимости частоты 1:1, качества и completion rate action items по всей организации**, что вынуждает их полагаться на самоотчёты + анекдоты + exit interviews после ухода сотрудников. **Потому что** аналитика TeamFlow отображает team-level OKR данные, но не health метрики 1:1 (частота, длительность, velocity action items, sentiment).
243
+
244
+ Подтверждение: 4 из 4 buyer interviews — прямые цитаты боли + конкретные запросы на dashboard. Impact: blocker для expansion с Team tier ($15/seat) на Enterprise tier ($50+/seat + analytics). Решение этой проблемы = $2-3M ARR expansion opportunity в существующей базе.
245
+
246
+ #### Evidence
247
+
248
+ - **Quote 1:** «Некоторые менеджеры проводят потрясающие 1:1s, другие буквально их отменяют. У меня нет видимости, нет рычагов влияния.» — B2 (VP HR, 450-emp B2B SaaS)
249
+ - **Quote 2:** «Когда CFO спрашивает о ROI затрат на retention, мне приходится плести историю. У меня нет данных.» — B1 (CPO, 800-emp enterprise)
250
+ - **Quote 3:** «Sarah оставила компанию потому что её менеджер никогда не делал 1:1s. Мы узнали только потом. Я должна была знать.» — B3 (VP HR, 200-emp mid-market)
251
+ - **CRM data:** 8 из 10 enterprise prospects спрашивают «есть ли у вас 1:1 analytics?» во время оценочных звонков — это текущий blocker для Enterprise tier conversion
252
+ - **Product analytics:** В настоящее время buyer-role logins (VP/CPO) 35% monthly active vs end-user 78% — указывает что у buyer недостаточно причин использовать продукт регулярно
253
+
254
+ #### Root Cause (Five Whys)
255
+
256
+ 1. **Почему VP HR лишён видимости?** → TeamFlow не отображает health метрики 1:1.
257
+ 2. **Почему не отображает?** → Существующая аналитика фокусируется на goals (OKR) и reviews, не на паттернах встреч.
258
+ 3. **Почему?** Product roadmap исторически приоритизировал OKR-centric features (последние 2 года).
259
+ 4. **Почему?** Потому что sales-led сигналы указывали на OKR как дифференциатор vs конкуренты.
260
+ 5. **Почему такие сигналы?** → Sales никогда не сегментировал buyer personas — VP HR vs CPO имеют разные приоритеты, но pitch был унифицирован.
261
+
262
+ **Root cause (уровень действий):** Отсутствует buyer-persona-specific analytics layer. Решается через новую dashboard feature.
263
+
264
+ #### Impact
265
+
266
+ - **Reach:** 80 buyer аккаунтов (mid-market + enterprise), некоторое совпадение с enterprise tier
267
+ - **Frequency:** Ежеквартально (критично для board prep)
268
+ - **Severity:** Major — blocker для Enterprise tier expansion
269
+ - **Business impact:** $2-3M ARR если Enterprise conversion rate улучшится с 15% до 30% в 4 кварталах
270
+
271
+ #### Non-problems (out of scope)
272
+
273
+ - **Не решаем** individual 1:1 content surveillance (privacy line VP HR sees aggregate only)
274
+ - **Не решаем** compensation-linked coaching insights (separate initiative)
275
+
276
+ ---
277
+
278
+ ### Problem Statement #3: Action Items Drop Rate ~40%
279
+
280
+ #### Statement
281
+
282
+ **Менеджеры с 5+ прямыми подчинёнными** испытывают **~40% drop rate action items** из 1:1 встреч (забытые, не отслеживаемые, никогда не отмеченные как выполненные), **потому что** TeamFlow создаёт action items как записи, но не предоставляет механизма проактивных напоминаний / повторного отображения — менеджеры вынуждены самостоятельно контролировать выполнение.
283
+
284
+ Подтверждение: 5 из 8 end-user interviews + internal product analytics (соотношение созданных и завершённых action items). Impact: косвенный на end-user satisfaction + retention.
285
+
286
+ #### Evidence
287
+
288
+ - **Quote 1:** «У меня наверное 20-30 открытых action items, половина из которых уже не актуальна... да и вообще уже забытые.» — E3
289
+ - **Quote 2:** «Action items tracking слабо. Забываю проверить. Накапливаются.» — E3
290
+ - **Product analytics:** Average action items created per 1:1 = 3.2. Average marked completed within 14 days = 1.9. Completion rate 60% = drop rate 40%.
291
+ - **Support tickets:** 42 tickets Q1 2026 «action items not reminders / notifications»
292
+
293
+ #### Root Cause (Five Whys)
294
+
295
+ 1. **Почему 40% drop?** → Action items не отображаются проактивно, только ручная проверка.
296
+ 2. **Почему не проактивно?** → Нет системы уведомлений / напоминаний для action items.
297
+ 3. **Почему?** Изначальное дизайн-допущение: менеджер будет проверять вручную.
298
+ 4. **Почему такое допущение?** Дизайн эпохи до AI: ручной труд был единственным вариантом.
299
+ 5. **Почему всё ещё вручную?** → Функция не пересматривалась с момента первоначального запуска (2 года назад).
300
+
301
+ **Root cause (уровень действий):** Отсутствует проактивный reminder layer. Low-hanging fruit — не требует AI, rule-based достаточно.
302
+
303
+ #### Impact
304
+
305
+ - **Reach:** ~3,000 менеджеров
306
+ - **Frequency:** Еженедельно
307
+ - **Severity:** Minor (не нарушает workflow, но накапливает раздражение)
308
+ - **Business impact:** Косвенный влияет на manager adoption rate + NPS
309
+
310
+ #### Non-problems (out of scope)
311
+
312
+ - **Не решаем** automatic action items extraction from unstructured notes (это часть AI summarization initiative)
313
+ - **Не решаем** cross-team action items visibility (future)
314
+
315
+ ---
316
+
317
+ ### Сводка топ 3 приоритетов
318
+
319
+ | # | Проблема | Actor | Severity | Охват | Business Impact | Приоритет |
320
+ |---|---------|-------|:--------:|:-----:|:---------------:|:--------:|
321
+ | 1 | Admin overhead менеджера | End-user manager | Major | ~3,000 | $3-5M ARR expansion | **P0** |
322
+ | 2 | Разрыв видимости для buyer | VP HR / CPO | Major | 80 аккаунтов | $2-3M ARR (Enterprise conv) | **P0** |
323
+ | 3 | Drop rate action items | End-user manager | Minor | ~3,000 | Косвенный | **P1** |
324
+
325
+ **Вывод:** Проблемы #1 и #2 могут быть решены через **одну и ту же функцию** (AI summarization + aggregate dashboard), что делает initiative высокорычажным. Проблема #3 — complementary, но независимая (rule-based reminders, quick win).
326
+
327
+ > **Урок problem-statement:** Каждая формально структурированная проблема предотвращает скрытые допущения. Five-whys Проблемы #1 выявили что **«почему исторически не инвестировали»** — стратегический вопрос, не просто продуктовый. Это информация для CEO / Board сессии, не просто engineering roadmap.