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,327 @@
1
- ---
2
- name: problem-statement
3
- description: Product problem formulation — actor, context, pain, root cause, evidence
4
- ---
5
- # Problem Statement
6
-
7
- > **Category:** Discovery · **Slug:** `problem-statement`
8
-
9
- ## When to Use
10
-
11
- - At the start of the Discovery phase — as a focusing artifact.
12
- - Before a PRD — a clearly formulated problem = half the solution.
13
- - When the team diverges: "what exactly are we solving?".
14
- - As a filter for the backlog: not related to active problem → not in scope.
15
-
16
- ## Input
17
-
18
- | Field | Required | Description |
19
- |-------|:--------:|-------------|
20
- | Evidence (interviews, tickets, metrics) | ✅ | What points to the problem |
21
- | Target role | ✅ | Buyer / end-user / admin |
22
- | Context / trigger | ✅ | When the problem occurs |
23
- | Existing workaround | ⬚ | How they currently cope |
24
-
25
- ## Data Sources
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 — what they do that you don't.
31
-
32
- ### Related Skills
33
-
34
- | Skill | What we take | When to invoke |
35
- |-------|-------------|----------------|
36
- | `user-interview-script` | Evidence quotes | For each problem |
37
- | `jtbd-canvas` | Actor + desired outcome | For formulation |
38
- | `assumption-mapping` | Root cause assumptions | If root cause is unclear |
39
- | `opportunity-solution-tree` | Problem → opportunities | After formulating |
40
-
41
- ## Protocol
42
-
43
- ### Step 0Raw Signal Collection
44
-
45
- Collect all signals: quotes, tickets, metrics. Group by similar themes.
46
-
47
- ### Step 1 — Formulation Frame
48
-
49
- Use the structure:
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
- ### Step 2Five Whys
59
-
60
- For each problem drill to root cause via 5 "why?"s:
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
- Stop when you reach a fix-able root cause (usually at level 3-4).
69
-
70
- ### Step 3 — Impact Quantification
71
-
72
- - **Reach** — how many users affected (weekly/monthly)
73
- - **Frequency**how often they encounter it
74
- - **Severity** — how bad (blocker / frustrating / minor)
75
- - **Business impact**churn risk / conversion drop / CAC increase / NRR impact
76
-
77
- Priority = Reach × Frequency × Severity.
78
-
79
- ### Step 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 for the problem. Problem what we're solving.
86
-
87
- ### Step 5 Non-problems
88
-
89
- Explicit out-of-scope: what we are **NOT** solving in this framing:
90
- - «We are not solving compliance onboarding (legal concern)»
91
- - «We are not solving onboarding for external contractors (different flow)»
92
-
93
- ### Step 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 (for discovery)
102
-
103
- ## Validation (Quality Gate)
104
-
105
- - [ ] Problem formulated as structured: actor / context / pain / root cause
106
- - [ ] Evidence 2 sources (interviews + quantitative)
107
- - [ ] Five-whys conducted to fix-able root
108
- - [ ] Impact quantified (reach × frequency × severity)
109
- - [ ] Distinguish problem from symptom
110
- - [ ] Non-problems explicit
111
- - [ ] Quantified impact tied to business metric
112
-
113
- ## Handoff
114
-
115
- The result is input for:
116
- - **`opportunity-solution-tree`** problem → opportunity space
117
- - **`rice-scoring`** — reach + impact feeds scoring
118
- - **`prd-template`** problem section
119
- - **`hypothesis-template`** — testable predictions from root cause
120
-
121
- Format: problem statement doc (markdown). Via `$handoff`.
122
-
123
- ## Anti-patterns
124
-
125
- | Error | Why it's bad | How to do it right |
126
- |-------|-------------|-------------------|
127
- | Solution embedded | «Problem: no dashboard» | Problem — pain, not absence of feature |
128
- | Vague actor | «Users» | Specific role: «Engineering manager in mid-market» |
129
- | No evidence | Speculation | Min 2 sources, quantitative + qualitative |
130
- | No root cause | Stay at surface | Five-whys is mandatory |
131
- | Not quantified | «Serious problem» | Reach × Frequency × Severity |
132
- | Scope creep | «All onboarding issues» | Narrow + non-problems |
133
-
134
- ## Template
135
-
136
- ```markdown
137
- # Problem Statement: [Short Name]
138
-
139
- ## Statement
140
- [Actor] in [context] experiences [pain] because [root cause].
141
- Evidence: [sources]. Impact: [quantified].
142
-
143
- ## Evidence
144
- - Quote 1: «...» (Interview 3, mid-market Engineering Manager)
145
- - Ticket volume: [N] Q3-Q4 2025
146
- - Metric: [drop-off X% at step Y]
147
-
148
- ## Root Cause (Five Whys)
149
- 1. Why X? → A
150
- 2. Why A? → B
151
- ...
152
-
153
- ## Impact
154
- - Reach: [N users / week]
155
- - Frequency: [N times / month]
156
- - Severity: Blocker / Major / Minor
157
- - Business: [$X NRR impact / Y% conversion drop]
158
-
159
- ## Non-problems (out of scope)
160
- - ...
161
- ```
162
-
163
- ## Worked Example TeamFlow Top 3 Problem Statements
164
-
165
- **Context:** TeamFlow (B2B SaaS HR-tech, $8M ARR, 200 customers). After 8 interviews + JTBD canvas — the team formulated the Top 3 problem statements for the Discovery Brief. All 3 — candidates for the AI 1:1 summarization initiative, but with different priority.
166
-
167
- ### Problem Statement #1: Manager Admin Overhead
168
-
169
- #### Statement
170
-
171
- **People managers** (primarily at mid-market / enterprise B2B SaaS, 100-1000 employees) **managing 5-15 direct reports** experience **45-60 min/week per report on 1:1 prep + note-taking + follow-up** (3-4 hrs/week total for a manager with 8 reports), **because** TeamFlow provides a structured template but no capture or synthesis capability — managers must manually type notes during the 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 minutes prep every week for each of my 8 reports. Total ~3 hours per week.» — Interview E3 (Engineering Manager, mid-market, 250 emp)
178
- - **Quote 2:** «Typing during the meeting lose the conversation. After the meeting → forget context. I often just write headlines and lose context.» — E3
179
- - **Quote 3:** «I skipped prep for a 1:1 with a junior engineer because I was too overloaded. The meeting was scrappy, he was clearly disappointed. I felt guilty.» — E3
180
- - **Quote 4:** «If I could just speak during the meeting and the system would write notes and highlight action itemsI'd pay for that 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 in 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. **Why do managers spend 45-60 min/week on 1:1 admin?**
188
- Because prep + note-taking + follow-up are manual, require mental context-switching.
189
-
190
- 2. **Why manual?**
191
- → Because no tool captures conversation content and synthesizes action items automatically.
192
-
193
- 3. **Why no tool?**
194
- Historical: tools required accurate transcription (not solved), privacy concerns, HR data sensitivity. Now LLM APIs make this tractable, but TeamFlow hasn't invested.
195
-
196
- 4. **Why hasn't TeamFlow invested?**
197
- Historically focused on structured-data features (OKR, reviews). Note-taking seen as commodity. No one made a business case for AI integration.
198
-
199
- 5. **Why no business case?**
200
- NRR / churn data show that the top churn reason is «manager adoption low» (60% from customer interviews + CRM data). The connection between manager admin load → adoption drop was not explicitly traced until recent analysis.
201
-
202
- **Root cause (actionable level):** Lack of AI-powered capture + synthesis in 1:1 workflow — addressable through an integrated AI summarization feature.
203
-
204
- #### Impact
205
-
206
- - **Reach:** ~3,000 active people managers across 200 customers (weighted: SMB 120 × 5 avg managers = 600, mid-market 70 × 20 avg = 1,400, enterprise 10 × 100 avg = 1,000)
207
- - **Frequency:** Weekly (3-4 hrs/week per manager → 9,000-12,000 hrs/week total across base)
208
- - **Severity:** Major (not blocking, but drives 30% of manager-tool churn signal)
209
- - **Business impact:**
210
- - Direct: $3-5M ARR expansion opportunity in 4 quarters through premium AI tier ($8-12/seat/mo)
211
- - Indirect: NRR lift 5-10pp if manager activation / retention improves
212
- - Defensive: Lattice / 15Five may launch similar; first-mover gives moat
213
-
214
- #### Non-problems (out of scope)
215
-
216
- - **Not solving** transcription accuracy below 95% for non-English languages (defer to future; English-first)
217
- - **Not solving** meeting recording / video archival (legal / privacy implications differ across jurisdictions)
218
- - **Not solving** automated coaching suggestions («manager should have asked X») — requires deeper training data, future work
219
- - **Not solving** integration with external meeting tools (Zoom/Meet/Teams) in the first release — TeamFlow-native 1:1s only
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** at **mid-market and enterprise customers (100-1000 employees)** lack **visibility into 1:1 cadence, quality, and action items completion rate across the organization**, forcing them to rely on self-report + anecdote + post-departure exit interviews. **Because** TeamFlow's analytics surface team-level OKR data but not 1:1 health metrics (frequency, duration, action items velocity, sentiment).
228
-
229
- Evidence: 4 of 4 buyer interviews — direct quote pain + specific asks for dashboard. Impact: blocker for expansion from Team tier ($15/seat) to Enterprise tier ($50+/seat + analytics). Addressing this = $2-3M ARR expansion opportunity within existing base.
230
-
231
- #### Evidence
232
-
233
- - **Quote 1:** «Some managers run amazing 1:1s, others literally cancel them. I have no visibility, no levers.» B2 (VP HR, 450-emp B2B SaaS)
234
- - **Quote 2:** «When CFO asks about retention spend ROI, I have to weave a story. I don't have data.» B1 (CPO, 800-emp enterprise)
235
- - **Quote 3:** «Sarah left the company because her manager never did 1:1s. We only found out after the fact. I should have known.» — B3 (VP HR, 200-emp mid-market)
236
- - **CRM data:** 8 of 10 enterprise prospects ask «do you have 1:1 analytics?» during evaluation calls — this is a current blocker for Enterprise tier conversion
237
- - **Product analytics:** Currently buyer-role logins (VP/CPO) — 35% monthly active vs end-user 78% — indicates the buyer doesn't have enough reason to use the product regularly
238
-
239
- #### Root Cause (Five Whys)
240
-
241
- 1. **Why does VP HR lack visibility?** → TeamFlow doesn't surface 1:1 health metrics.
242
- 2. **Why not surface?** Existing analytics focus on goals (OKR) and reviews, not on meeting patterns.
243
- 3. **Why?** → Product roadmap prioritized OKR-centric features historically (last 2 years).
244
- 4. **Why?** Because sales-led signals pointed to OKR as differentiator vs competitors.
245
- 5. **Why those signals?** → Sales never segmented buyer personas — VP HR vs CPO have different priorities, but the pitch was uniform.
246
-
247
- **Root cause (actionable):** Missing buyer-persona-specific analytics layer. Addressable through a new dashboard feature.
248
-
249
- #### Impact
250
-
251
- - **Reach:** 80 buyer accounts (mid-market + enterprise), some overlap with enterprise tier
252
- - **Frequency:** Quarterly (critical for board prep)
253
- - **Severity:** Major — blocker for Enterprise tier expansion
254
- - **Business impact:** $2-3M ARR if Enterprise conversion rate improves from 15% to 30% in 4 quarters
255
-
256
- #### Non-problems (out of scope)
257
-
258
- - **Not solving** individual 1:1 content surveillance (privacy line VP HR sees aggregate only)
259
- - **Not solving** compensation-linked coaching insights (separate initiative)
260
-
261
- ---
262
-
263
- ### Problem Statement #3: Action Items Drop Rate ~40%
264
-
265
- #### Statement
266
-
267
- **Managers with 5+ direct reports** experience **~40% action items drop rate** from 1:1 meetings (forgotten, not tracked, never marked complete), **because** TeamFlow creates action items as records but provides no proactive reminder / re-surfacing mechanism — managers must self-police checking completion.
268
-
269
- Evidence: 5 of 8 end-user interviews + internal product analytics (action items created vs completed ratio). Impact: indirect on end-user satisfaction + retention.
270
-
271
- #### Evidence
272
-
273
- - **Quote 1:** «I probably have 20-30 open action items, half of which are no longer relevant... and actually just forgotten.» — E3
274
- - **Quote 2:** «Action items tracking is weak. Forget to check. They pile up.» — 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. **Why 40% drop?** → Action items don't surface proactively, only manual check.
281
- 2. **Why not proactive?** → No notification / reminder system for action items.
282
- 3. **Why?** Original design assumption: manager will review manually.
283
- 4. **Why that assumption?** → Pre-AI era design: manual was the only option.
284
- 5. **Why still manual?** Feature not re-evaluated since original launch (2 years ago).
285
-
286
- **Root cause (actionable):** Missing proactive reminder layer. Low-hanging fruit — no AI required, rule-based is OK.
287
-
288
- #### Impact
289
-
290
- - **Reach:** ~3,000 managers
291
- - **Frequency:** Weekly
292
- - **Severity:** Minor (doesn't break workflow, but compounds frustration)
293
- - **Business impact:** Indirect — contributes to manager adoption rate + NPS
294
-
295
- #### Non-problems (out of scope)
296
-
297
- - **Not solving** automatic action items extraction from unstructured notes (this is part of the AI summarization initiative)
298
- - **Not solving** cross-team action items visibility (future)
299
-
300
- ---
301
-
302
- ### Summary of Top 3 Priorities
303
-
304
- | # | Problem | Actor | Severity | Reach | Business Impact | Priority |
305
- |---|---------|-------|:--------:|:-----:|:---------------:|:--------:|
306
- | 1 | Manager admin overhead | End-user manager | Major | ~3,000 | $3-5M ARR expansion | **P0** |
307
- | 2 | Buyer visibility gap | VP HR / CPO | Major | 80 accounts | $2-3M ARR (Enterprise conv) | **P0** |
308
- | 3 | Action items drop rate | End-user manager | Minor | ~3,000 | Indirect | **P1** |
309
-
310
- **Implication:** Problem #1 and #2 can be addressed through the **same feature** (AI summarization + aggregate dashboard), making the initiative highly leveraged. Problem #3 — complementary but independent (rule-based reminders, quick win).
311
-
312
- > **Problem-statement lesson:** Every problem formally structured prevents hidden assumptions. Problem #1's five-whys surfaced the question of **«why historically there was no investment»** — a strategic question, not just a product question. This is information for a CEO / Board session, not just the engineering roadmap.
1
+ ---
2
+ name: problem-statement
3
+ description: Product problem formulation — 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
+ > **Category:** Discovery · **Slug:** `problem-statement`
23
+
24
+ ## When to Use
25
+
26
+ - At the start of the Discovery phase — as a focusing artifact.
27
+ - Before a PRD a clearly formulated problem = half the solution.
28
+ - When the team diverges: "what exactly are we solving?".
29
+ - As a filter for the backlog: not related to active problem → not in scope.
30
+
31
+ ## Input
32
+
33
+ | Field | Required | Description |
34
+ |-------|:--------:|-------------|
35
+ | Evidence (interviews, tickets, metrics) | ✅ | What points to the problem |
36
+ | Target role | | Buyer / end-user / admin |
37
+ | Context / trigger | | When the problem occurs |
38
+ | Existing workaround | | How they currently cope |
39
+
40
+ ## Data Sources
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 what they do that you don't.
46
+
47
+ ### Related Skills
48
+
49
+ | Skill | What we take | When to invoke |
50
+ |-------|-------------|----------------|
51
+ | `user-interview-script` | Evidence quotes | For each problem |
52
+ | `jtbd-canvas` | Actor + desired outcome | For formulation |
53
+ | `assumption-mapping` | Root cause assumptions | If root cause is unclear |
54
+ | `opportunity-solution-tree` | Problem opportunities | After formulating |
55
+
56
+ ## Protocol
57
+
58
+ ### Step 0Raw Signal Collection
59
+
60
+ Collect all signals: quotes, tickets, metrics. Group by similar themes.
61
+
62
+ ### Step 1 Formulation Frame
63
+
64
+ Use the structure:
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
+ ### Step 2 Five Whys
74
+
75
+ For each problemdrill to root cause via 5 "why?"s:
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
+ Stop when you reach a fix-able root cause (usually at level 3-4).
84
+
85
+ ### Step 3Impact Quantification
86
+
87
+ - **Reach**how many users affected (weekly/monthly)
88
+ - **Frequency** — how often they encounter it
89
+ - **Severity** how bad (blocker / frustrating / minor)
90
+ - **Business impact** churn risk / conversion drop / CAC increase / NRR impact
91
+
92
+ Priority = Reach × Frequency × Severity.
93
+
94
+ ### Step 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 for the problem. Problem — what we're solving.
101
+
102
+ ### Step 5 — Non-problems
103
+
104
+ Explicit out-of-scope: what we are **NOT** solving in this framing:
105
+ - «We are not solving compliance onboarding (legal concern)»
106
+ - «We are not solving onboarding for external contractors (different flow)»
107
+
108
+ ### Step 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 (for discovery)
117
+
118
+ ## Validation (Quality Gate)
119
+
120
+ - [ ] Problem formulated as structured: actor / context / pain / root cause
121
+ - [ ] Evidence ≥ 2 sources (interviews + quantitative)
122
+ - [ ] Five-whys conducted to fix-able root
123
+ - [ ] Impact quantified (reach × frequency × severity)
124
+ - [ ] Distinguish problem from symptom
125
+ - [ ] Non-problems explicit
126
+ - [ ] Quantified impact tied to business metric
127
+
128
+ ## Handoff
129
+
130
+ The result is input for:
131
+ - **`opportunity-solution-tree`** problem opportunity space
132
+ - **`rice-scoring`** reach + impact feeds scoring
133
+ - **`prd-template`** — problem section
134
+ - **`hypothesis-template`** — testable predictions from root cause
135
+
136
+ Format: problem statement doc (markdown). Via `$handoff`.
137
+
138
+ ## Anti-patterns
139
+
140
+ | Error | Why it's bad | How to do it right |
141
+ |-------|-------------|-------------------|
142
+ | Solution embedded | «Problem: no dashboard» | Problem — pain, not absence of feature |
143
+ | Vague actor | «Users» | Specific role: «Engineering manager in mid-market» |
144
+ | No evidence | Speculation | Min 2 sources, quantitative + qualitative |
145
+ | No root cause | Stay at surface | Five-whys is mandatory |
146
+ | Not quantified | «Serious problem» | Reach × Frequency × Severity |
147
+ | Scope creep | «All onboarding issues» | Narrow + non-problems |
148
+
149
+ ## Template
150
+
151
+ ```markdown
152
+ # Problem Statement: [Short Name]
153
+
154
+ ## Statement
155
+ [Actor] in [context] experiences [pain] because [root cause].
156
+ Evidence: [sources]. Impact: [quantified].
157
+
158
+ ## Evidence
159
+ - Quote 1: «...» (Interview 3, mid-market Engineering Manager)
160
+ - Ticket volume: [N] Q3-Q4 2025
161
+ - Metric: [drop-off X% at step Y]
162
+
163
+ ## Root Cause (Five Whys)
164
+ 1. Why X? → A
165
+ 2. Why A? B
166
+ ...
167
+
168
+ ## Impact
169
+ - Reach: [N users / week]
170
+ - Frequency: [N times / month]
171
+ - Severity: Blocker / Major / Minor
172
+ - Business: [$X NRR impact / Y% conversion drop]
173
+
174
+ ## Non-problems (out of scope)
175
+ - ...
176
+ ```
177
+
178
+ ## Worked Example TeamFlow Top 3 Problem Statements
179
+
180
+ **Context:** TeamFlow (B2B SaaS HR-tech, $8M ARR, 200 customers). After 8 interviews + JTBD canvas — the team formulated the Top 3 problem statements for the Discovery Brief. All 3 candidates for the AI 1:1 summarization initiative, but with different priority.
181
+
182
+ ### Problem Statement #1: Manager Admin Overhead
183
+
184
+ #### Statement
185
+
186
+ **People managers** (primarily at mid-market / enterprise B2B SaaS, 100-1000 employees) **managing 5-15 direct reports** experience **45-60 min/week per report on 1:1 prep + note-taking + follow-up** (3-4 hrs/week total for a manager with 8 reports), **because** TeamFlow provides a structured template but no capture or synthesis capability — managers must manually type notes during the 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 minutes prep every week for each of my 8 reports. Total ~3 hours per week.» — Interview E3 (Engineering Manager, mid-market, 250 emp)
193
+ - **Quote 2:** «Typing during the meeting → lose the conversation. After the meeting → forget context. I often just write headlines and lose context.» — E3
194
+ - **Quote 3:** «I skipped prep for a 1:1 with a junior engineer because I was too overloaded. The meeting was scrappy, he was clearly disappointed. I felt guilty.» — E3
195
+ - **Quote 4:** «If I could just speak during the meeting and the system would write notes and highlight action items — I'd pay for that 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 in 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. **Why do managers spend 45-60 min/week on 1:1 admin?**
203
+ → Because prep + note-taking + follow-up are manual, require mental context-switching.
204
+
205
+ 2. **Why manual?**
206
+ Because no tool captures conversation content and synthesizes action items automatically.
207
+
208
+ 3. **Why no tool?**
209
+ Historical: tools required accurate transcription (not solved), privacy concerns, HR data sensitivity. Now LLM APIs make this tractable, but TeamFlow hasn't invested.
210
+
211
+ 4. **Why hasn't TeamFlow invested?**
212
+ Historically focused on structured-data features (OKR, reviews). Note-taking seen as commodity. No one made a business case for AI integration.
213
+
214
+ 5. **Why no business case?**
215
+ → NRR / churn data show that the top churn reason is «manager adoption low» (60% from customer interviews + CRM data). The connection between manager admin load → adoption drop was not explicitly traced until recent analysis.
216
+
217
+ **Root cause (actionable level):** Lack of AI-powered capture + synthesis in 1:1 workflow addressable through an integrated AI summarization feature.
218
+
219
+ #### Impact
220
+
221
+ - **Reach:** ~3,000 active people managers across 200 customers (weighted: SMB 120 × 5 avg managers = 600, mid-market 70 × 20 avg = 1,400, enterprise 10 × 100 avg = 1,000)
222
+ - **Frequency:** Weekly (3-4 hrs/week per manager → 9,000-12,000 hrs/week total across base)
223
+ - **Severity:** Major (not blocking, but drives 30% of manager-tool churn signal)
224
+ - **Business impact:**
225
+ - Direct: $3-5M ARR expansion opportunity in 4 quarters through premium AI tier ($8-12/seat/mo)
226
+ - Indirect: NRR lift 5-10pp if manager activation / retention improves
227
+ - Defensive: Lattice / 15Five may launch similar; first-mover gives moat
228
+
229
+ #### Non-problems (out of scope)
230
+
231
+ - **Not solving** transcription accuracy below 95% for non-English languages (defer to future; English-first)
232
+ - **Not solving** meeting recording / video archival (legal / privacy implications differ across jurisdictions)
233
+ - **Not solving** automated coaching suggestions («manager should have asked X») requires deeper training data, future work
234
+ - **Not solving** integration with external meeting tools (Zoom/Meet/Teams) in the first releaseTeamFlow-native 1:1s only
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** at **mid-market and enterprise customers (100-1000 employees)** lack **visibility into 1:1 cadence, quality, and action items completion rate across the organization**, forcing them to rely on self-report + anecdote + post-departure exit interviews. **Because** TeamFlow's analytics surface team-level OKR data but not 1:1 health metrics (frequency, duration, action items velocity, sentiment).
243
+
244
+ Evidence: 4 of 4 buyer interviews — direct quote pain + specific asks for dashboard. Impact: blocker for expansion from Team tier ($15/seat) to Enterprise tier ($50+/seat + analytics). Addressing this = $2-3M ARR expansion opportunity within existing base.
245
+
246
+ #### Evidence
247
+
248
+ - **Quote 1:** «Some managers run amazing 1:1s, others literally cancel them. I have no visibility, no levers.» — B2 (VP HR, 450-emp B2B SaaS)
249
+ - **Quote 2:** «When CFO asks about retention spend ROI, I have to weave a story. I don't have data.» — B1 (CPO, 800-emp enterprise)
250
+ - **Quote 3:** «Sarah left the company because her manager never did 1:1s. We only found out after the fact. I should have known.» — B3 (VP HR, 200-emp mid-market)
251
+ - **CRM data:** 8 of 10 enterprise prospects ask «do you have 1:1 analytics?» during evaluation calls — this is a current blocker for Enterprise tier conversion
252
+ - **Product analytics:** Currently buyer-role logins (VP/CPO) 35% monthly active vs end-user 78% — indicates the buyer doesn't have enough reason to use the product regularly
253
+
254
+ #### Root Cause (Five Whys)
255
+
256
+ 1. **Why does VP HR lack visibility?** → TeamFlow doesn't surface 1:1 health metrics.
257
+ 2. **Why not surface?** → Existing analytics focus on goals (OKR) and reviews, not on meeting patterns.
258
+ 3. **Why?** Product roadmap prioritized OKR-centric features historically (last 2 years).
259
+ 4. **Why?** Because sales-led signals pointed to OKR as differentiator vs competitors.
260
+ 5. **Why those signals?** → Sales never segmented buyer personas — VP HR vs CPO have different priorities, but the pitch was uniform.
261
+
262
+ **Root cause (actionable):** Missing buyer-persona-specific analytics layer. Addressable through a new dashboard feature.
263
+
264
+ #### Impact
265
+
266
+ - **Reach:** 80 buyer accounts (mid-market + enterprise), some overlap with enterprise tier
267
+ - **Frequency:** Quarterly (critical for board prep)
268
+ - **Severity:** Major — blocker for Enterprise tier expansion
269
+ - **Business impact:** $2-3M ARR if Enterprise conversion rate improves from 15% to 30% in 4 quarters
270
+
271
+ #### Non-problems (out of scope)
272
+
273
+ - **Not solving** individual 1:1 content surveillance (privacy line VP HR sees aggregate only)
274
+ - **Not solving** compensation-linked coaching insights (separate initiative)
275
+
276
+ ---
277
+
278
+ ### Problem Statement #3: Action Items Drop Rate ~40%
279
+
280
+ #### Statement
281
+
282
+ **Managers with 5+ direct reports** experience **~40% action items drop rate** from 1:1 meetings (forgotten, not tracked, never marked complete), **because** TeamFlow creates action items as records but provides no proactive reminder / re-surfacing mechanism — managers must self-police checking completion.
283
+
284
+ Evidence: 5 of 8 end-user interviews + internal product analytics (action items created vs completed ratio). Impact: indirect on end-user satisfaction + retention.
285
+
286
+ #### Evidence
287
+
288
+ - **Quote 1:** «I probably have 20-30 open action items, half of which are no longer relevant... and actually just forgotten.» — E3
289
+ - **Quote 2:** «Action items tracking is weak. Forget to check. They pile up.» — 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. **Why 40% drop?** → Action items don't surface proactively, only manual check.
296
+ 2. **Why not proactive?** → No notification / reminder system for action items.
297
+ 3. **Why?** Original design assumption: manager will review manually.
298
+ 4. **Why that assumption?** → Pre-AI era design: manual was the only option.
299
+ 5. **Why still manual?** → Feature not re-evaluated since original launch (2 years ago).
300
+
301
+ **Root cause (actionable):** Missing proactive reminder layer. Low-hanging fruit — no AI required, rule-based is OK.
302
+
303
+ #### Impact
304
+
305
+ - **Reach:** ~3,000 managers
306
+ - **Frequency:** Weekly
307
+ - **Severity:** Minor (doesn't break workflow, but compounds frustration)
308
+ - **Business impact:** Indirect contributes to manager adoption rate + NPS
309
+
310
+ #### Non-problems (out of scope)
311
+
312
+ - **Not solving** automatic action items extraction from unstructured notes (this is part of the AI summarization initiative)
313
+ - **Not solving** cross-team action items visibility (future)
314
+
315
+ ---
316
+
317
+ ### Summary of Top 3 Priorities
318
+
319
+ | # | Problem | Actor | Severity | Reach | Business Impact | Priority |
320
+ |---|---------|-------|:--------:|:-----:|:---------------:|:--------:|
321
+ | 1 | Manager admin overhead | End-user manager | Major | ~3,000 | $3-5M ARR expansion | **P0** |
322
+ | 2 | Buyer visibility gap | VP HR / CPO | Major | 80 accounts | $2-3M ARR (Enterprise conv) | **P0** |
323
+ | 3 | Action items drop rate | End-user manager | Minor | ~3,000 | Indirect | **P1** |
324
+
325
+ **Implication:** Problem #1 and #2 can be addressed through the **same feature** (AI summarization + aggregate dashboard), making the initiative highly leveraged. Problem #3 — complementary but independent (rule-based reminders, quick win).
326
+
327
+ > **Problem-statement lesson:** Every problem formally structured prevents hidden assumptions. Problem #1's five-whys surfaced the question of **«why historically there was no investment»** — a strategic question, not just a product question. This is information for a CEO / Board session, not just the engineering roadmap.