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,301 +1,317 @@
1
- ---
2
- name: north-star-metric
3
- description: Выбор NSM для B2B SaaS — баланс leading/lagging, alignment с customer value и business outcome
4
- ---
5
- # North Star Metric (NSM)
6
-
7
- > **Категория:** Strategy · **Slug:** `north-star-metric`
8
-
9
- ## Когда использовать
10
-
11
- - При определении продуктовой стратегии — единая метрика фокуса.
12
- - При alignment команды: decision-making через призму «это поднимает NSM?».
13
- - При board / investor reporting — single metric story.
14
- - При review существующей метрики — still meaningful?
15
-
16
- ## Вход
17
-
18
- | Поле | Обязательно | Описание |
19
- |------|:-----------:|----------|
20
- | Product vision | ✅ | North star должен отражать vision |
21
- | Business model | ✅ | Subscription / usage / hybrid |
22
- | Current metric stack | ✅ | MRR, DAU, retention, etc. |
23
- | Customer value definition | ✅ | Что считаем value для customer |
24
- | Adversarial camp (Full A) | ⬚ | alpha (Customer-first) / beta (Business-first) |
25
-
26
- ## Источники данных
27
-
28
- 1. Current product analytics (Amplitude, Mixpanel, custom).
29
- 2. Customer interviews what «valuable» means.
30
- 3. Business metricsNRR, churn.
31
- 4. Industry benchmarks (SaaS Capital, OpenView reports).
32
-
33
- ### Связь с другими скилами
34
-
35
- | Скил | Что берём | Когда вызывать |
36
- |------|-----------|----------------|
37
- | `product-vision` | Vision NSM alignment | Перед выбором NSM |
38
- | `aarrr-metrics` | Framework для decomposition | Для input metrics |
39
- | `saas-metrics` | Business metric layer | Для lagging alignment |
40
- | `okr-framework` | OKR KRs часто привязаны к NSM | После NSM |
41
-
42
- ## Критерии хорошей NSM
43
-
44
- 1. **Отражает customer value** когда NSM растёт, customers получают value.
45
- 2. **Leading indicator of revenue** движется раньше, чем MRR.
46
- 3. **Actionable**команда может влиять.
47
- 4. **Singular** не composite, не aggregate.
48
- 5. **Measurable** — numerically trackable.
49
- 6. **Resistant to gaming** — сложно накрутить без реального value.
50
-
51
- ## Протокол
52
-
53
- ### Шаг 0 Role Framing (Full A)
54
-
55
- - **Customer-Champion (alpha):** акцент на user-value metric
56
- - **Business-Champion (beta):** акцент на business-value metric
57
-
58
- ### Шаг 1 — Business Model Analysis
59
-
60
- - **Subscription SaaS:** NSM чаще related к weekly/monthly active teams, usage depth
61
- - **Usage-based:** raw consumption (API calls, workloads)
62
- - **Transaction-based:** successful transactions
63
- - **Platform:** marketplace size × match rate
64
-
65
- ### Шаг 2Generate Candidates
66
-
67
- Минимум 5 candidates. Каждый — через формулу:
68
-
69
- **[Action verb]** × **[Unit with value]** × **[Frequency/Cadence]** × **[Quality]**
70
-
71
- Примеры B2B SaaS:
72
- - «Weekly Active Teams with ≥5 seats» (платформа для команд)
73
- - «Monthly reports generated per paying account» (analytics tool)
74
- - «Weekly successful deployments per engineering team» (DevOps tool)
75
- - «Onboarded workspaces completing setup within 7 days» (product-led growth)
76
-
77
- ### Шаг 3 Evaluation
78
-
79
- | Metric | Customer Value | Leads Revenue | Actionable | Singular | Measurable | Anti-game | Total |
80
- |--------|:--------------:|:-------------:|:----------:|:--------:|:----------:|:---------:|:-----:|
81
- | [cand] | 5 | 4 | 4 | 5 | 5 | 3 | 26 |
82
-
83
- Ранжировать. Топ кандидат = NSM. Второй guardrail или input metric.
84
-
85
- ### Шаг 4 Decomposition (Metric Tree)
86
-
87
- NSM input metrics → leading indicators.
88
-
89
- ```
90
- NSM: Weekly Active Teams ≥5 seats
91
- ├── Input: New teams activating weekly
92
- │ ├── Signup → activation rate
93
- │ └── Time-to-5-seats (onboarding speed)
94
- ├── Input: Existing teams retaining
95
- │ ├── W/W retention rate
96
- │ └── Seats-per-team growth
97
- └── Guardrails:
98
- ├── Churn rate (capped)
99
- ├── NPS (no drop)
100
- └── Support ticket volume (no spike)
101
- ```
102
-
103
- ### Шаг 5 Guardrails
104
-
105
- Что **НЕ должно сломаться** в погоне за NSM:
106
- - Churn rate
107
- - NPS / CSAT
108
- - Gross margin
109
- - Support ticket volume
110
- - p95 latency / error rate
111
-
112
- Каждый guardrail = numeric threshold.
113
-
114
- ### Шаг 6 — Baseline + Target
115
-
116
- - Current value
117
- - 90-day target
118
- - 1-year aspirational
119
-
120
- ### Шаг 7 — Anti-Gaming Review
121
-
122
- Team brainstorm: «Как бы мы накрутили NSM?». Если легко — уточнить определение или изменить метрику.
123
-
124
- Пример: «Weekly Active Teams» можно «накрутить» через counting churned teams в последний раз активные → уточнение: «with activity in last 7 days».
125
-
126
- ## Валидация (Quality Gate)
127
-
128
- - [ ] Минимум 5 candidates рассмотрены
129
- - [ ] Evaluation по 6 критериям
130
- - [ ] Metric tree decomposition (NSM → inputs)
131
- - [ ] Guardrails с numeric thresholds
132
- - [ ] Baseline + target
133
- - [ ] Anti-gaming review проведён
134
- - [ ] Business model alignment verified
135
- - [ ] Vision alignment verified
136
-
137
- ## Handoff
138
-
139
- Результат является входом для:
140
- - **`okr-framework`** NSM = основа для several KRs
141
- - **`aarrr-metrics`** — NSM fits в AARRR как ключевой stage
142
- - **Data Analyst** — instrumentation requirements
143
- - **Mediator** (Full A) — alpha и beta NSM для synthesis
144
-
145
- Формат: NSM doc (one-pager) с metric tree. Через `$handoff`.
146
-
147
- ## Anti-patterns
148
-
149
- | Ошибка | Почему плохо | Как правильно |
150
- |--------|-------------|---------------|
151
- | Revenue как NSM | Lagging, не actionable | Используй leading value metric |
152
- | Vanity metric | Выглядит хорошо, не предсказывает | Customer value + revenue proxy |
153
- | Composite metric | Weighted sum не singular | Выбери ОДНУ |
154
- | No guardrails | Принимаем churn ростом NSM | Явные guardrails |
155
- | Change every quarter | Команда не может align | Стабильна ≥ год |
156
- | Copy other company | Context-specific | Твоя бизнес-модель |
157
-
158
- ## Шаблон
159
-
160
- ```markdown
161
- # North Star Metric: [Название]
162
-
163
- ## Определение
164
- **[Действие]** × **[Единица с ценностью]** × **[Частота/Каденс]** × **[Качество]**
165
- Точно: [точное определение с правилами включения/исключения]
166
-
167
- ## Обоснование
168
- [Почему эта метрика customer value + бизнес]
169
-
170
- ## Metric Tree
171
- NSM
172
- ├── Input: ...
173
- ├── Input: ...
174
- └── Guardrails:
175
- ├── ...
176
-
177
- ## Базовые значения и цели
178
- - Текущее: X
179
- - Цель на 90 дней: Y
180
- - Годовая aspirational: Z
181
-
182
- ## Anti-Gaming
183
- [Как это можно накрутить? Меры защиты]
184
-
185
- ## Ревью
186
- - Ежеквартально: still meaningful?
187
- - Ежегодно: пересмотр
188
- ```
189
-
190
- ## Worked Example — TeamFlow NSM Selection (post-Mediator synthesis)
191
-
192
- **Контекст:** После Mediator synthesis visions команда выбирает unified NSM. Alpha предлагала «weekly 1:1s with AI summaries used»; Beta — «ARR from accounts with ≥3 seats on AI tier». Ниже — full candidate evaluation.
193
-
194
- ### Анализ бизнес-модели
195
-
196
- - **Revenue model:** Подписка, tiered (Core / Team / Enterprise)
197
- - **Growth lever:** Seat expansion (mid-market, enterprise) + tier upgrade
198
- - **Основная доставка ценности:** Экономия на workflow на 1:1 + adoption менеджеров
199
-
200
- ### 5 кандидатов на NSM
201
-
202
- | # | Кандидат | Формула | Leading/Lagging | Связан с vision? |
203
- |---|-----------|---------|:---------------:|:---------------:|
204
- | C1 | Weekly Active Managers using AI summarization (≥ 1 per week) | count(WAM_ai) | Leading | Alpha ✓ |
205
- | C2 | ARR from AI-tier accounts | $ ARR tagged «AI tier» | Lagging | Beta ✓ |
206
- | C3 | «Sticky Manager Ratio» managers running 4 AI-assisted 1:1s per month | ratio | Leading + quality signal | Alpha ✓ |
207
- | C4 | «AI-assisted 1:1s completed per week» (total count across base) | count | Leading, usage-based | Alpha ✓ |
208
- | C5 | Net New AI Tier ARR / Quarter | $ | Lagging | Beta |
209
-
210
- ### Evaluation Matrix (6 критериев × 5 кандидатов, шкала 1-5)
211
-
212
- | Метрика | Customer Value | Leads Revenue | Actionable | Singular | Measurable | Anti-Game | **Итого** |
213
- |--------|:--------------:|:-------------:|:----------:|:--------:|:----------:|:---------:|:---------:|
214
- | C1 WAM_ai | 4 | 4 | 5 | 5 | 5 | 3 | **26** |
215
- | C2 ARR AI tier | 2 | 2 (= это И ЕСТЬ revenue) | 3 | 5 | 5 | 4 | 21 |
216
- | C3 Sticky Manager Ratio | 5 | 4 | 5 | 5 | 5 | 4 | **28** |
217
- | C4 AI 1:1s/week | 4 | 4 | 4 | 5 | 5 | 2 (легко накрутить bulk) | 24 |
218
- | C5 Net New AI ARR | 2 | 2 (= это И ЕСТЬ revenue) | 2 | 5 | 5 | 4 | 20 |
219
-
220
- **Победитель: C3 «Sticky Manager Ratio»** балансирует customer value signal (качество — 4+ 1:1s/month implies real habit) + anti-gaming (нельзя создать bulk; требует реального usage) + чёткий leading indicator для ARR.
221
-
222
- ### Выбранный NSMОпределение
223
-
224
- ```markdown
225
- # North Star Metric: Sticky Manager Ratio (AI Tier)
226
-
227
- ## Определение
228
- **Активные менеджеры** × **Использующие AI summarization** × **≥ 4 раза в месяц** × **с 1 подчинённым**
229
-
230
- **Точно:**
231
- - **Активный менеджер:** имеет 1 прямого подчинённого в TeamFlow + заходил в систему за последние 30 дней
232
- - **Использует AI summarization:** завершил 1:1 с AI summary, сгенерированным И просмотренным (не просто сгенерированным, но проигнорированным)
233
- - **≥ 4 в месяц:** скользящее 30-дневное окно
234
- - **Исключения:** внутренние сотрудники TeamFlow; аккаунты <30 дней (onboarding); trial-аккаунты
235
-
236
- **Формула:**
237
- ```
238
- Sticky Manager Ratio = Менеджеры, соответствующие критериям / Все активные менеджеры в AI-tier аккаунтах
239
- ```
240
-
241
- ## Обоснование
242
-
243
- **Почему эта метрика:**
244
-
245
- - **Customer value signal:** 4 использования/месяц ≈ еженедельные 1:1s = настоящая привычка, а не эксперимент. Привычка = продукт встроен в workflow → high retention.
246
- - **Leading revenue:** Sticky managers → удержание аккаунта → expansion → NRR. Исторические данные TeamFlow: функции, используемые ≥ 4×/месяц, имеют 3× LTV.
247
- - **Actionable:** Команда может влиять (onboarding, reminders, качество функции).
248
- - **Singular:** Одно число, понятный дашборд.
249
- - **Resistant to gaming:** нельзя «bulk» реальное использование. Можно inflate через trial seats, поэтому trial-аккаунты исключены.
250
-
251
- **Почему не альтернативы:**
252
- - C1 WAM_ai: не различает случайное и habitual использование
253
- - C2 ARR tier: lagging, не предсказывает expansion до того как это произойдёт
254
- - C4 1:1s/week: легко накрутить («создай 20 фейковых 1:1s»)
255
- - C5 Net new ARR: та же lagging проблема
256
-
257
- ## Metric Tree
258
-
259
- ```
260
- NSM: Sticky Manager Ratio (AI Tier)
261
- ├── Input: AI Tier account count (expansion)
262
- │ ├── New AI Tier conversions per week
263
- │ └── AI Tier churn
264
- ├── Input: Active manager activation rate (% new managers reaching ≥ 4 1:1s)
265
- │ ├── Time to first AI summary
266
- │ └── Onboarding checklist completion
267
- ├── Input: Feature quality signal
268
- │ ├── Summary approval rate (kept vs edited >50%)
269
- │ └── Summary NPS (in-product rating)
270
- └── Guardrails:
271
- ├── Overall NPS (не должен дропать > 5 points)
272
- ├── Gross churn rate (не должен расти >1pp QoQ)
273
- ├── Support ticket volume / AI issues (monitor для abuse / dissatisfaction)
274
- └── p95 summary generation latency (< 30 sec)
275
- ```
276
-
277
- ## Baseline & Targets
278
-
279
- | Горизонт | Цель | Обоснование |
280
- |---------|:------:|-----------|
281
- | Текущий (Q1 2026) | 0% (функция не запущена) | До запуска |
282
- | 90 дней после запуска (конец Q2) | **20%** | Консервативно — на основе схожих запусков AI-функций в смежном B2B |
283
- | Конец 2026 | 45% | Уровень лидера категории |
284
- | Конец 2027 (aspirational) | 65% | Уровень «не могу представить работу без этого» |
285
-
286
- ## Анализ Anti-Gaming
287
-
288
- **Как это можно накрутить?**
289
-
290
- - **Массовое создание фейковых 1:1s:** Меры защиты — требовать AI summary сгенерированным И просмотренным (событие видимого редактирования или подтверждения)
291
- - **Один крупный аккаунт раздувает ratio:** Меры защиты — взвешивать по размеру аккаунта + отчитываться отдельно
292
- - **Менеджеры «поддерживают streak» формальными 1:1s:** Меры защиты — минимальная продолжительность 1:1 (не менее ≥ 10 мин по расписанию)
293
- - **Команда раздувает показатели, отмечая нереальные 1:1s:** Меры защиты — периодический выборочный аудит с разговорами customer success
294
-
295
- ## Ревью
296
- - **Еженедельно:** ratio отслеживается в exec dashboard
297
- - **Ежеквартально:** выборочный anti-gaming аудит (3 аккаунта проверяется вручную)
298
- - **Ежегодно:** NSM пересматривается в соответствии со стратегическими изменениями
299
- ```
300
-
301
- > **Урок NSM:** Изначальный «WAM_ai» Alpha был хорош, но слишком груб — не различал trial adoption от привычки. «ARR AI tier» Beta был слишком lagging. Синтез («Sticky Manager Ratio») взял user-centric формулировку Alpha, но применил строгость Beta в отношении порога качества (4+ в месяц = настоящая привычка). Результат — метрика, которая **опережает** revenue, **измеряет** customer value и **сопротивляется** лёгкому накручиванию. Такой уровень уточнения сложно получить с первой попытки — evaluation matrix заставила вести разговор.
1
+ ---
2
+ name: north-star-metric
3
+ description: Выбор NSM для B2B SaaS — баланс leading/lagging, alignment с customer value и business outcome
4
+ type: triggered
5
+ domain: product
6
+ owners:
7
+ - product_strategist
8
+ gates:
9
+ - PRODUCT_STRATEGIST
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - "north-star-metric"
14
+ - "north star"
15
+ - "NSM"
16
+ - "ведущая метрика"
17
+ related: []
18
+ budget_lines: 317
19
+ schema_version: 1
20
+ ---
21
+ # North Star Metric (NSM)
22
+
23
+ > **Категория:** Strategy · **Slug:** `north-star-metric`
24
+
25
+ ## Когда использовать
26
+
27
+ - При определении продуктовой стратегии — единая метрика фокуса.
28
+ - При alignment команды: decision-making через призму «это поднимает NSM?».
29
+ - При board / investor reporting — single metric story.
30
+ - При review существующей метрики still meaningful?
31
+
32
+ ## Вход
33
+
34
+ | Поле | Обязательно | Описание |
35
+ |------|:-----------:|----------|
36
+ | Product vision | ✅ | North star должен отражать vision |
37
+ | Business model | | Subscription / usage / hybrid |
38
+ | Current metric stack | | MRR, DAU, retention, etc. |
39
+ | Customer value definition | | Что считаем value для customer |
40
+ | Adversarial camp (Full A) | | alpha (Customer-first) / beta (Business-first) |
41
+
42
+ ## Источники данных
43
+
44
+ 1. Current product analytics (Amplitude, Mixpanel, custom).
45
+ 2. Customer interviews what «valuable» means.
46
+ 3. Business metrics NRR, churn.
47
+ 4. Industry benchmarks (SaaS Capital, OpenView reports).
48
+
49
+ ### Связь с другими скилами
50
+
51
+ | Скил | Что берём | Когда вызывать |
52
+ |------|-----------|----------------|
53
+ | `product-vision` | Vision NSM alignment | Перед выбором NSM |
54
+ | `aarrr-metrics` | Framework для decomposition | Для input metrics |
55
+ | `saas-metrics` | Business metric layer | Для lagging alignment |
56
+ | `okr-framework` | OKR KRs часто привязаны к NSM | После NSM |
57
+
58
+ ## Критерии хорошей NSM
59
+
60
+ 1. **Отражает customer value** когда NSM растёт, customers получают value.
61
+ 2. **Leading indicator of revenue** движется раньше, чем MRR.
62
+ 3. **Actionable** команда может влиять.
63
+ 4. **Singular** не composite, не aggregate.
64
+ 5. **Measurable** — numerically trackable.
65
+ 6. **Resistant to gaming** сложно накрутить без реального value.
66
+
67
+ ## Протокол
68
+
69
+ ### Шаг 0 Role Framing (Full A)
70
+
71
+ - **Customer-Champion (alpha):** акцент на user-value metric
72
+ - **Business-Champion (beta):** акцент на business-value metric
73
+
74
+ ### Шаг 1 Business Model Analysis
75
+
76
+ - **Subscription SaaS:** NSM чаще related к weekly/monthly active teams, usage depth
77
+ - **Usage-based:** raw consumption (API calls, workloads)
78
+ - **Transaction-based:** successful transactions
79
+ - **Platform:** marketplace size × match rate
80
+
81
+ ### Шаг 2 Generate Candidates
82
+
83
+ Минимум 5 candidates. Каждый через формулу:
84
+
85
+ **[Action verb]** × **[Unit with value]** × **[Frequency/Cadence]** × **[Quality]**
86
+
87
+ Примеры B2B SaaS:
88
+ - «Weekly Active Teams with ≥5 seats» (платформа для команд)
89
+ - «Monthly reports generated per paying account» (analytics tool)
90
+ - «Weekly successful deployments per engineering team» (DevOps tool)
91
+ - «Onboarded workspaces completing setup within 7 days» (product-led growth)
92
+
93
+ ### Шаг 3 — Evaluation
94
+
95
+ | Metric | Customer Value | Leads Revenue | Actionable | Singular | Measurable | Anti-game | Total |
96
+ |--------|:--------------:|:-------------:|:----------:|:--------:|:----------:|:---------:|:-----:|
97
+ | [cand] | 5 | 4 | 4 | 5 | 5 | 3 | 26 |
98
+
99
+ Ранжировать. Топ кандидат = NSM. Второй → guardrail или input metric.
100
+
101
+ ### Шаг 4 — Decomposition (Metric Tree)
102
+
103
+ NSM input metrics → leading indicators.
104
+
105
+ ```
106
+ NSM: Weekly Active Teams ≥5 seats
107
+ ├── Input: New teams activating weekly
108
+ │ ├── Signup → activation rate
109
+ │ └── Time-to-5-seats (onboarding speed)
110
+ ├── Input: Existing teams retaining
111
+ │ ├── W/W retention rate
112
+ │ └── Seats-per-team growth
113
+ └── Guardrails:
114
+ ├── Churn rate (capped)
115
+ ├── NPS (no drop)
116
+ └── Support ticket volume (no spike)
117
+ ```
118
+
119
+ ### Шаг 5 — Guardrails
120
+
121
+ Что **НЕ должно сломаться** в погоне за NSM:
122
+ - Churn rate
123
+ - NPS / CSAT
124
+ - Gross margin
125
+ - Support ticket volume
126
+ - p95 latency / error rate
127
+
128
+ Каждый guardrail = numeric threshold.
129
+
130
+ ### Шаг 6 Baseline + Target
131
+
132
+ - Current value
133
+ - 90-day target
134
+ - 1-year aspirational
135
+
136
+ ### Шаг 7 — Anti-Gaming Review
137
+
138
+ Team brainstorm: «Как бы мы накрутили NSM?». Если легко — уточнить определение или изменить метрику.
139
+
140
+ Пример: «Weekly Active Teams» можно «накрутить» через counting churned teams в последний раз активные → уточнение: «with activity in last 7 days».
141
+
142
+ ## Валидация (Quality Gate)
143
+
144
+ - [ ] Минимум 5 candidates рассмотрены
145
+ - [ ] Evaluation по 6 критериям
146
+ - [ ] Metric tree decomposition (NSM → inputs)
147
+ - [ ] Guardrails с numeric thresholds
148
+ - [ ] Baseline + target
149
+ - [ ] Anti-gaming review проведён
150
+ - [ ] Business model alignment verified
151
+ - [ ] Vision alignment verified
152
+
153
+ ## Handoff
154
+
155
+ Результат является входом для:
156
+ - **`okr-framework`** NSM = основа для several KRs
157
+ - **`aarrr-metrics`** — NSM fits в AARRR как ключевой stage
158
+ - **Data Analyst** — instrumentation requirements
159
+ - **Mediator** (Full A) — alpha и beta NSM для synthesis
160
+
161
+ Формат: NSM doc (one-pager) с metric tree. Через `$handoff`.
162
+
163
+ ## Anti-patterns
164
+
165
+ | Ошибка | Почему плохо | Как правильно |
166
+ |--------|-------------|---------------|
167
+ | Revenue как NSM | Lagging, не actionable | Используй leading value metric |
168
+ | Vanity metric | Выглядит хорошо, не предсказывает | Customer value + revenue proxy |
169
+ | Composite metric | Weighted sum не singular | Выбери ОДНУ |
170
+ | No guardrails | Принимаем churn ростом NSM | Явные guardrails |
171
+ | Change every quarter | Команда не может align | Стабильна ≥ год |
172
+ | Copy other company | Context-specific | Твоя бизнес-модель |
173
+
174
+ ## Шаблон
175
+
176
+ ```markdown
177
+ # North Star Metric: [Название]
178
+
179
+ ## Определение
180
+ **[Действие]** × **[Единица с ценностью]** × **[Частота/Каденс]** × **[Качество]**
181
+ Точно: [точное определение с правилами включения/исключения]
182
+
183
+ ## Обоснование
184
+ [Почему эта метрика — customer value + бизнес]
185
+
186
+ ## Metric Tree
187
+ NSM
188
+ ├── Input: ...
189
+ ├── Input: ...
190
+ └── Guardrails:
191
+ ├── ...
192
+
193
+ ## Базовые значения и цели
194
+ - Текущее: X
195
+ - Цель на 90 дней: Y
196
+ - Годовая aspirational: Z
197
+
198
+ ## Anti-Gaming
199
+ [Как это можно накрутить? Меры защиты]
200
+
201
+ ## Ревью
202
+ - Ежеквартально: still meaningful?
203
+ - Ежегодно: пересмотр
204
+ ```
205
+
206
+ ## Worked ExampleTeamFlow NSM Selection (post-Mediator synthesis)
207
+
208
+ **Контекст:** После Mediator synthesis visions команда выбирает unified NSM. Alpha предлагала «weekly 1:1s with AI summaries used»; Beta — «ARR from accounts with ≥3 seats on AI tier». Ниже — full candidate evaluation.
209
+
210
+ ### Анализ бизнес-модели
211
+
212
+ - **Revenue model:** Подписка, tiered (Core / Team / Enterprise)
213
+ - **Growth lever:** Seat expansion (mid-market, enterprise) + tier upgrade
214
+ - **Основная доставка ценности:** Экономия на workflow на 1:1 + adoption менеджеров
215
+
216
+ ### 5 кандидатов на NSM
217
+
218
+ | # | Кандидат | Формула | Leading/Lagging | Связан с vision? |
219
+ |---|-----------|---------|:---------------:|:---------------:|
220
+ | C1 | Weekly Active Managers using AI summarization ( 1 per week) | count(WAM_ai) | Leading | Alpha |
221
+ | C2 | ARR from AI-tier accounts | $ ARR tagged «AI tier» | Lagging | Beta ✓ |
222
+ | C3 | «Sticky Manager Ratio» managers running ≥ 4 AI-assisted 1:1s per month | ratio | Leading + quality signal | Alpha ✓ |
223
+ | C4 | «AI-assisted 1:1s completed per week» (total count across base) | count | Leading, usage-based | Alpha ✓ |
224
+ | C5 | Net New AI Tier ARR / Quarter | $ | Lagging | Beta ✓ |
225
+
226
+ ### Evaluation Matrix (6 критериев × 5 кандидатов, шкала 1-5)
227
+
228
+ | Метрика | Customer Value | Leads Revenue | Actionable | Singular | Measurable | Anti-Game | **Итого** |
229
+ |--------|:--------------:|:-------------:|:----------:|:--------:|:----------:|:---------:|:---------:|
230
+ | C1 WAM_ai | 4 | 4 | 5 | 5 | 5 | 3 | **26** |
231
+ | C2 ARR AI tier | 2 | 2 (= это И ЕСТЬ revenue) | 3 | 5 | 5 | 4 | 21 |
232
+ | C3 Sticky Manager Ratio | 5 | 4 | 5 | 5 | 5 | 4 | **28** |
233
+ | C4 AI 1:1s/week | 4 | 4 | 4 | 5 | 5 | 2 (легко накрутить bulk) | 24 |
234
+ | C5 Net New AI ARR | 2 | 2 (= это И ЕСТЬ revenue) | 2 | 5 | 5 | 4 | 20 |
235
+
236
+ **Победитель: C3 «Sticky Manager Ratio»** — балансирует customer value signal (качество — 4+ 1:1s/month implies real habit) + anti-gaming (нельзя создать bulk; требует реального usage) + чёткий leading indicator для ARR.
237
+
238
+ ### Выбранный NSM Определение
239
+
240
+ ```markdown
241
+ # North Star Metric: Sticky Manager Ratio (AI Tier)
242
+
243
+ ## Определение
244
+ **Активные менеджеры** × **Использующие AI summarization** × **≥ 4 раза в месяц** × **с ≥ 1 подчинённым**
245
+
246
+ **Точно:**
247
+ - **Активный менеджер:** имеет 1 прямого подчинённого в TeamFlow + заходил в систему за последние 30 дней
248
+ - **Использует AI summarization:** завершил 1:1 с AI summary, сгенерированным И просмотренным (не просто сгенерированным, но проигнорированным)
249
+ - **≥ 4 в месяц:** скользящее 30-дневное окно
250
+ - **Исключения:** внутренние сотрудники TeamFlow; аккаунты <30 дней (onboarding); trial-аккаунты
251
+
252
+ **Формула:**
253
+ ```
254
+ Sticky Manager Ratio = Менеджеры, соответствующие критериям / Все активные менеджеры в AI-tier аккаунтах
255
+ ```
256
+
257
+ ## Обоснование
258
+
259
+ **Почему эта метрика:**
260
+
261
+ - **Customer value signal:** 4 использования/месяц ≈ еженедельные 1:1s = настоящая привычка, а не эксперимент. Привычка = продукт встроен в workflow → high retention.
262
+ - **Leading revenue:** Sticky managers удержание аккаунта → expansion → NRR. Исторические данные TeamFlow: функции, используемые ≥ 4×/месяц, имеют 3× LTV.
263
+ - **Actionable:** Команда может влиять (onboarding, reminders, качество функции).
264
+ - **Singular:** Одно число, понятный дашборд.
265
+ - **Resistant to gaming:** нельзя «bulk» реальное использование. Можно inflate через trial seats, поэтому trial-аккаунты исключены.
266
+
267
+ **Почему не альтернативы:**
268
+ - C1 WAM_ai: не различает случайное и habitual использование
269
+ - C2 ARR tier: lagging, не предсказывает expansion до того как это произойдёт
270
+ - C4 1:1s/week: легко накрутить («создай 20 фейковых 1:1s»)
271
+ - C5 Net new ARR: та же lagging проблема
272
+
273
+ ## Metric Tree
274
+
275
+ ```
276
+ NSM: Sticky Manager Ratio (AI Tier)
277
+ ├── Input: AI Tier account count (expansion)
278
+ │ ├── New AI Tier conversions per week
279
+ │ └── AI Tier churn
280
+ ├── Input: Active manager activation rate (% new managers reaching ≥ 4 1:1s)
281
+ │ ├── Time to first AI summary
282
+ │ └── Onboarding checklist completion
283
+ ├── Input: Feature quality signal
284
+ │ ├── Summary approval rate (kept vs edited >50%)
285
+ │ └── Summary NPS (in-product rating)
286
+ └── Guardrails:
287
+ ├── Overall NPS (не должен дропать > 5 points)
288
+ ├── Gross churn rate (не должен расти >1pp QoQ)
289
+ ├── Support ticket volume / AI issues (monitor для abuse / dissatisfaction)
290
+ └── p95 summary generation latency (< 30 sec)
291
+ ```
292
+
293
+ ## Baseline & Targets
294
+
295
+ | Горизонт | Цель | Обоснование |
296
+ |---------|:------:|-----------|
297
+ | Текущий (Q1 2026) | 0% (функция не запущена) | До запуска |
298
+ | 90 дней после запуска (конец Q2) | **20%** | Консервативно — на основе схожих запусков AI-функций в смежном B2B |
299
+ | Конец 2026 | 45% | Уровень лидера категории |
300
+ | Конец 2027 (aspirational) | 65% | Уровень «не могу представить работу без этого» |
301
+
302
+ ## Анализ Anti-Gaming
303
+
304
+ **Как это можно накрутить?**
305
+
306
+ - **Массовое создание фейковых 1:1s:** Меры защиты — требовать AI summary сгенерированным И просмотренным (событие видимого редактирования или подтверждения)
307
+ - **Один крупный аккаунт раздувает ratio:** Меры защиты — взвешивать по размеру аккаунта + отчитываться отдельно
308
+ - **Менеджеры «поддерживают streak» формальными 1:1s:** Меры защиты — минимальная продолжительность 1:1 (не менее ≥ 10 мин по расписанию)
309
+ - **Команда раздувает показатели, отмечая нереальные 1:1s:** Меры защиты — периодический выборочный аудит с разговорами customer success
310
+
311
+ ## Ревью
312
+ - **Еженедельно:** ratio отслеживается в exec dashboard
313
+ - **Ежеквартально:** выборочный anti-gaming аудит (3 аккаунта проверяется вручную)
314
+ - **Ежегодно:** NSM пересматривается в соответствии со стратегическими изменениями
315
+ ```
316
+
317
+ > **Урок NSM:** Изначальный «WAM_ai» Alpha был хорош, но слишком груб — не различал trial adoption от привычки. «ARR AI tier» Beta был слишком lagging. Синтез («Sticky Manager Ratio») взял user-centric формулировку Alpha, но применил строгость Beta в отношении порога качества (4+ в месяц = настоящая привычка). Результат — метрика, которая **опережает** revenue, **измеряет** customer value и **сопротивляется** лёгкому накручиванию. Такой уровень уточнения сложно получить с первой попытки — evaluation matrix заставила вести разговор.