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: Selecting the NSM for B2B SaaS — balancing leading/lagging, alignment with customer value and business outcome
4
- ---
5
- # North Star Metric (NSM)
6
-
7
- > **Category:** Strategy · **Slug:** `north-star-metric`
8
-
9
- ## When to Use
10
-
11
- - When defining product strategy — a single metric of focus.
12
- - When aligning the team: decision-making through the lens of "does this lift the NSM?".
13
- - For board / investor reporting — single metric story.
14
- - When reviewing an existing metric — still meaningful?
15
-
16
- ## Input
17
-
18
- | Field | Required | Description |
19
- |-------|:--------:|-------------|
20
- | Product vision | ✅ | The north star must reflect the vision |
21
- | Business model | ✅ | Subscription / usage / hybrid |
22
- | Current metric stack | ✅ | MRR, DAU, retention, etc. |
23
- | Customer value definition | ✅ | What we consider value for the customer |
24
- | Adversarial camp (Full A) | ⬚ | alpha (Customer-first) / beta (Business-first) |
25
-
26
- ## Data Sources
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
- ### Related Skills
34
-
35
- | Skill | What we take | When to invoke |
36
- |-------|-------------|----------------|
37
- | `product-vision` | Vision NSM alignment | Before choosing NSM |
38
- | `aarrr-metrics` | Framework for decomposition | For input metrics |
39
- | `saas-metrics` | Business metric layer | For lagging alignment |
40
- | `okr-framework` | OKR KRs often tied to NSM | After NSM |
41
-
42
- ## Criteria for a Good NSM
43
-
44
- 1. **Reflects customer value** when NSM grows, customers receive value.
45
- 2. **Leading indicator of revenue** moves before MRR.
46
- 3. **Actionable**the team can influence it.
47
- 4. **Singular** not composite, not aggregate.
48
- 5. **Measurable** — numerically trackable.
49
- 6. **Resistant to gaming** — hard to inflate without real value.
50
-
51
- ## Protocol
52
-
53
- ### Step 0 Role Framing (Full A)
54
-
55
- - **Customer-Champion (alpha):** emphasis on user-value metric
56
- - **Business-Champion (beta):** emphasis on business-value metric
57
-
58
- ### Step 1 Business Model Analysis
59
-
60
- - **Subscription SaaS:** NSM often related to 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
- ### Step 2Generate Candidates
66
-
67
- Minimum 5 candidates. Each — through the formula:
68
-
69
- **[Action verb]** × **[Unit with value]** × **[Frequency/Cadence]** × **[Quality]**
70
-
71
- B2B SaaS examples:
72
- - "Weekly Active Teams with ≥5 seats" (team platform)
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
- ### Step 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
- Rank. Top candidate = NSM. Second guardrail or input metric.
84
-
85
- ### Step 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
- ### Step 5 Guardrails
104
-
105
- What **MUST NOT break** in the pursuit of NSM:
106
- - Churn rate
107
- - NPS / CSAT
108
- - Gross margin
109
- - Support ticket volume
110
- - p95 latency / error rate
111
-
112
- Each guardrail = numeric threshold.
113
-
114
- ### Step 6 — Baseline + Target
115
-
116
- - Current value
117
- - 90-day target
118
- - 1-year aspirational
119
-
120
- ### Step 7 — Anti-Gaming Review
121
-
122
- Team brainstorm: "How would we game the NSM?". If it's easy — enhance the definition or change the metric.
123
-
124
- Example: "Weekly Active Teams" can be gamed by counting churned teams that were active for the last time → clarification: "with activity in last 7 days".
125
-
126
- ## Validation (Quality Gate)
127
-
128
- - [ ] Minimum 5 candidates reviewed
129
- - [ ] Evaluation across 6 criteria
130
- - [ ] Metric tree decomposition (NSM → inputs)
131
- - [ ] Guardrails with numeric thresholds
132
- - [ ] Baseline + target
133
- - [ ] Anti-gaming review conducted
134
- - [ ] Business model alignment verified
135
- - [ ] Vision alignment verified
136
-
137
- ## Handoff
138
-
139
- The result is input for:
140
- - **`okr-framework`** NSM = basis for several KRs
141
- - **`aarrr-metrics`** — NSM fits into AARRR as the key stage
142
- - **Data Analyst** — instrumentation requirements
143
- - **Mediator** (Full A) — alpha and beta NSM for synthesis
144
-
145
- Format: NSM doc (one-pager) with metric tree. Via `$handoff`.
146
-
147
- ## Anti-patterns
148
-
149
- | Error | Why it's bad | How to do it right |
150
- |-------|-------------|-------------------|
151
- | Revenue as NSM | Lagging, not actionable | Use leading value metric |
152
- | Vanity metric | Looks good, doesn't predict | Customer value + revenue proxy |
153
- | Composite metric | Weighted sum is not singular | Pick ONE |
154
- | No guardrails | Accept churn growing with NSM | Explicit guardrails |
155
- | Change every quarter | Team can't align | Stable for ≥ year |
156
- | Copy other company | Context-specific | Your business model |
157
-
158
- ## Template
159
-
160
- ```markdown
161
- # North Star Metric: [Name]
162
-
163
- ## Definition
164
- **[Action]** × **[Unit]** × **[Frequency]** × **[Quality]**
165
- Precise: [exact definition with inclusion/exclusion rules]
166
-
167
- ## Rationale
168
- [Why this metric customer value + business]
169
-
170
- ## Metric Tree
171
- NSM
172
- ├── Input: ...
173
- ├── Input: ...
174
- └── Guardrails:
175
- ├── ...
176
-
177
- ## Baseline & Targets
178
- - Current: X
179
- - 90-day target: Y
180
- - 1-year aspirational: Z
181
-
182
- ## Anti-Gaming
183
- [How could this be gamed? Mitigation]
184
-
185
- ## Review
186
- - Quarterly: still meaningful?
187
- - Annually: re-evaluate
188
- ```
189
-
190
- ## Worked Example — TeamFlow NSM Selection (post-Mediator synthesis)
191
-
192
- **Context:** After Mediator synthesis of visions, the team chooses a unified NSM. Alpha proposed "weekly 1:1s with AI summaries used"; Beta — "ARR from accounts with ≥3 seats on AI tier". Below — full candidate evaluation.
193
-
194
- ### Business Model Analysis
195
-
196
- - **Revenue model:** Subscription, tiered (Core / Team / Enterprise)
197
- - **Growth lever:** Seat expansion (mid-market, enterprise) + tier upgrade
198
- - **Primary value delivery:** Per-1:1 workflow savings + per-manager adoption
199
-
200
- ### 5 Candidate NSMs
201
-
202
- | # | Candidate | Formula | Leading/Lagging | Ties to 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 criteria × 5 candidates, scale 1-5)
211
-
212
- | Metric | Customer Value | Leads Revenue | Actionable | Singular | Measurable | Anti-Game | **Total** |
213
- |--------|:--------------:|:-------------:|:----------:|:--------:|:----------:|:---------:|:---------:|
214
- | C1 WAM_ai | 4 | 4 | 5 | 5 | 5 | 3 | **26** |
215
- | C2 ARR AI tier | 2 | 2 (= it IS 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 (easy to bulk) | 24 |
218
- | C5 Net New AI ARR | 2 | 2 (= it IS revenue) | 2 | 5 | 5 | 4 | 20 |
219
-
220
- **Winner: C3 «Sticky Manager Ratio»** balances customer value signal (quality — 4+ 1:1s/month implies real habit) + anti-gaming (can't be bulk-created; requires genuine usage) + clear leading indicator for ARR.
221
-
222
- ### Chosen NSMDefinition
223
-
224
- ```markdown
225
- # North Star Metric: Sticky Manager Ratio (AI Tier)
226
-
227
- ## Definition
228
- **Active managers** × **Using AI summarization** × **≥ 4 times per month** × **on 1 direct report**
229
-
230
- **Precise:**
231
- - **Active manager:** has 1 direct report in TeamFlow + logged in in last 30 days
232
- - **Using AI summarization:** completed 1:1 with AI summary generated AND reviewed (not just generated but ignored)
233
- - **≥ 4 per month:** rolling 30-day window
234
- - **Exclusions:** internal TeamFlow employees; accounts <30 days old (onboarding); trial accounts
235
-
236
- **Formula:**
237
- ```
238
- Sticky Manager Ratio = Managers meeting criteria / Total active managers in AI-tier accounts
239
- ```
240
-
241
- ## Rationale
242
-
243
- **Why this metric:**
244
-
245
- - **Customer value signal:** 4 uses/month ≈ weekly 1:1s = genuine habit, not experimentation. Habit = product embedded in workflow → high retention.
246
- - **Leading revenue:** Sticky managers → account retention → expansion → NRR. Historical TeamFlow data: features used ≥ 4×/month have 3× LTV.
247
- - **Actionable:** Team can drive (onboarding, reminders, feature quality).
248
- - **Singular:** One number, clear dashboard.
249
- - **Resistant to gaming:** can't «bulk» real usage. Can be inflated via trial seats, so trial accounts excluded.
250
-
251
- **Why not alternatives:**
252
- - C1 WAM_ai: doesn't distinguish casual from habitual usage
253
- - C2 ARR tier: lagging, doesn't predict expansion before it happens
254
- - C4 1:1s/week: easily gamed («create 20 fake 1:1s»)
255
- - C5 Net new ARR: same lagging issue
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 (must not drop > 5 points)
272
- ├── Gross churn rate (must not grow >1pp QoQ)
273
- ├── Support ticket volume / AI issues (monitor for abuse / dissatisfaction)
274
- └── p95 summary generation latency (< 30 sec)
275
- ```
276
-
277
- ## Baseline & Targets
278
-
279
- | Horizon | Target | Rationale |
280
- |---------|:------:|-----------|
281
- | Current (Q1 2026) | 0% (feature not live) | Pre-launch |
282
- | 90 days post-launch (end Q2) | **20%** | Conservative — based on similar AI feature launches in adjacent B2B |
283
- | End of 2026 | 45% | Category-leading level |
284
- | End of 2027 (aspirational) | 65% | «Cannot imagine working without it» level |
285
-
286
- ## Anti-Gaming Analysis
287
-
288
- **How could this be gamed?**
289
-
290
- - **Bulk fake 1:1 creation:** Mitigation — require AI summary generated AND reviewed (visible edit or approval event)
291
- - **Single massive account inflating ratio:** Mitigation — weight by account size + report separately
292
- - **Managers «maintaining streak» with perfunctory 1:1s:** Mitigation — 1:1 duration floor (must be ≥ 10 min scheduled)
293
- - **Team inflating by marking non-actual 1:1s:** Mitigation — periodic sample audit with customer success conversations
294
-
295
- ## Review
296
- - **Weekly:** ratio tracked in exec dashboard
297
- - **Quarterly:** anti-gaming sample audit (3 accounts reviewed manually)
298
- - **Annually:** NSM re-evaluated against strategy shift
299
- ```
300
-
301
- > **NSM lesson:** Alpha's initial «WAM_ai» was good but too blunt — didn't distinguish trial adoption from habit. Beta's «ARR AI tier» was too lagging. Synthesis («Sticky Manager Ratio») borrowed Alpha's user-centric formulation but applied Beta's rigor about quality threshold (4+ per month = real habit). Result is a metric that **leads** revenue, **measures** customer value, and **resists** easy gaming. This is the kind of refinement that's hard to get on first try — the evaluation matrix forced the conversation.
1
+ ---
2
+ name: north-star-metric
3
+ description: Selecting the NSM for B2B SaaS — balancing leading/lagging, alignment with customer value and 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
+ > **Category:** Strategy · **Slug:** `north-star-metric`
24
+
25
+ ## When to Use
26
+
27
+ - When defining product strategy — a single metric of focus.
28
+ - When aligning the team: decision-making through the lens of "does this lift the NSM?".
29
+ - For board / investor reporting — single metric story.
30
+ - When reviewing an existing metric still meaningful?
31
+
32
+ ## Input
33
+
34
+ | Field | Required | Description |
35
+ |-------|:--------:|-------------|
36
+ | Product vision | ✅ | The north star must reflect the vision |
37
+ | Business model | | Subscription / usage / hybrid |
38
+ | Current metric stack | | MRR, DAU, retention, etc. |
39
+ | Customer value definition | | What we consider value for the customer |
40
+ | Adversarial camp (Full A) | | alpha (Customer-first) / beta (Business-first) |
41
+
42
+ ## Data Sources
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
+ ### Related Skills
50
+
51
+ | Skill | What we take | When to invoke |
52
+ |-------|-------------|----------------|
53
+ | `product-vision` | Vision NSM alignment | Before choosing NSM |
54
+ | `aarrr-metrics` | Framework for decomposition | For input metrics |
55
+ | `saas-metrics` | Business metric layer | For lagging alignment |
56
+ | `okr-framework` | OKR KRs often tied to NSM | After NSM |
57
+
58
+ ## Criteria for a Good NSM
59
+
60
+ 1. **Reflects customer value** when NSM grows, customers receive value.
61
+ 2. **Leading indicator of revenue** moves before MRR.
62
+ 3. **Actionable** the team can influence it.
63
+ 4. **Singular** not composite, not aggregate.
64
+ 5. **Measurable** — numerically trackable.
65
+ 6. **Resistant to gaming** hard to inflate without real value.
66
+
67
+ ## Protocol
68
+
69
+ ### Step 0 Role Framing (Full A)
70
+
71
+ - **Customer-Champion (alpha):** emphasis on user-value metric
72
+ - **Business-Champion (beta):** emphasis on business-value metric
73
+
74
+ ### Step 1 Business Model Analysis
75
+
76
+ - **Subscription SaaS:** NSM often related to 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
+ ### Step 2 Generate Candidates
82
+
83
+ Minimum 5 candidates. Each through the formula:
84
+
85
+ **[Action verb]** × **[Unit with value]** × **[Frequency/Cadence]** × **[Quality]**
86
+
87
+ B2B SaaS examples:
88
+ - "Weekly Active Teams with ≥5 seats" (team platform)
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
+ ### Step 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
+ Rank. Top candidate = NSM. Second → guardrail or input metric.
100
+
101
+ ### Step 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
+ ### Step 5 — Guardrails
120
+
121
+ What **MUST NOT break** in the pursuit of NSM:
122
+ - Churn rate
123
+ - NPS / CSAT
124
+ - Gross margin
125
+ - Support ticket volume
126
+ - p95 latency / error rate
127
+
128
+ Each guardrail = numeric threshold.
129
+
130
+ ### Step 6 Baseline + Target
131
+
132
+ - Current value
133
+ - 90-day target
134
+ - 1-year aspirational
135
+
136
+ ### Step 7 — Anti-Gaming Review
137
+
138
+ Team brainstorm: "How would we game the NSM?". If it's easy — enhance the definition or change the metric.
139
+
140
+ Example: "Weekly Active Teams" can be gamed by counting churned teams that were active for the last time → clarification: "with activity in last 7 days".
141
+
142
+ ## Validation (Quality Gate)
143
+
144
+ - [ ] Minimum 5 candidates reviewed
145
+ - [ ] Evaluation across 6 criteria
146
+ - [ ] Metric tree decomposition (NSM → inputs)
147
+ - [ ] Guardrails with numeric thresholds
148
+ - [ ] Baseline + target
149
+ - [ ] Anti-gaming review conducted
150
+ - [ ] Business model alignment verified
151
+ - [ ] Vision alignment verified
152
+
153
+ ## Handoff
154
+
155
+ The result is input for:
156
+ - **`okr-framework`** NSM = basis for several KRs
157
+ - **`aarrr-metrics`** — NSM fits into AARRR as the key stage
158
+ - **Data Analyst** — instrumentation requirements
159
+ - **Mediator** (Full A) — alpha and beta NSM for synthesis
160
+
161
+ Format: NSM doc (one-pager) with metric tree. Via `$handoff`.
162
+
163
+ ## Anti-patterns
164
+
165
+ | Error | Why it's bad | How to do it right |
166
+ |-------|-------------|-------------------|
167
+ | Revenue as NSM | Lagging, not actionable | Use leading value metric |
168
+ | Vanity metric | Looks good, doesn't predict | Customer value + revenue proxy |
169
+ | Composite metric | Weighted sum is not singular | Pick ONE |
170
+ | No guardrails | Accept churn growing with NSM | Explicit guardrails |
171
+ | Change every quarter | Team can't align | Stable for ≥ year |
172
+ | Copy other company | Context-specific | Your business model |
173
+
174
+ ## Template
175
+
176
+ ```markdown
177
+ # North Star Metric: [Name]
178
+
179
+ ## Definition
180
+ **[Action]** × **[Unit]** × **[Frequency]** × **[Quality]**
181
+ Precise: [exact definition with inclusion/exclusion rules]
182
+
183
+ ## Rationale
184
+ [Why this metric — customer value + business]
185
+
186
+ ## Metric Tree
187
+ NSM
188
+ ├── Input: ...
189
+ ├── Input: ...
190
+ └── Guardrails:
191
+ ├── ...
192
+
193
+ ## Baseline & Targets
194
+ - Current: X
195
+ - 90-day target: Y
196
+ - 1-year aspirational: Z
197
+
198
+ ## Anti-Gaming
199
+ [How could this be gamed? Mitigation]
200
+
201
+ ## Review
202
+ - Quarterly: still meaningful?
203
+ - Annually: re-evaluate
204
+ ```
205
+
206
+ ## Worked ExampleTeamFlow NSM Selection (post-Mediator synthesis)
207
+
208
+ **Context:** After Mediator synthesis of visions, the team chooses a unified NSM. Alpha proposed "weekly 1:1s with AI summaries used"; Beta — "ARR from accounts with ≥3 seats on AI tier". Below — full candidate evaluation.
209
+
210
+ ### Business Model Analysis
211
+
212
+ - **Revenue model:** Subscription, tiered (Core / Team / Enterprise)
213
+ - **Growth lever:** Seat expansion (mid-market, enterprise) + tier upgrade
214
+ - **Primary value delivery:** Per-1:1 workflow savings + per-manager adoption
215
+
216
+ ### 5 Candidate NSMs
217
+
218
+ | # | Candidate | Formula | Leading/Lagging | Ties to 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 criteria × 5 candidates, scale 1-5)
227
+
228
+ | Metric | Customer Value | Leads Revenue | Actionable | Singular | Measurable | Anti-Game | **Total** |
229
+ |--------|:--------------:|:-------------:|:----------:|:--------:|:----------:|:---------:|:---------:|
230
+ | C1 WAM_ai | 4 | 4 | 5 | 5 | 5 | 3 | **26** |
231
+ | C2 ARR AI tier | 2 | 2 (= it IS 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 (easy to bulk) | 24 |
234
+ | C5 Net New AI ARR | 2 | 2 (= it IS revenue) | 2 | 5 | 5 | 4 | 20 |
235
+
236
+ **Winner: C3 «Sticky Manager Ratio»** — balances customer value signal (quality — 4+ 1:1s/month implies real habit) + anti-gaming (can't be bulk-created; requires genuine usage) + clear leading indicator for ARR.
237
+
238
+ ### Chosen NSM Definition
239
+
240
+ ```markdown
241
+ # North Star Metric: Sticky Manager Ratio (AI Tier)
242
+
243
+ ## Definition
244
+ **Active managers** × **Using AI summarization** × **≥ 4 times per month** × **on ≥ 1 direct report**
245
+
246
+ **Precise:**
247
+ - **Active manager:** has 1 direct report in TeamFlow + logged in in last 30 days
248
+ - **Using AI summarization:** completed 1:1 with AI summary generated AND reviewed (not just generated but ignored)
249
+ - **≥ 4 per month:** rolling 30-day window
250
+ - **Exclusions:** internal TeamFlow employees; accounts <30 days old (onboarding); trial accounts
251
+
252
+ **Formula:**
253
+ ```
254
+ Sticky Manager Ratio = Managers meeting criteria / Total active managers in AI-tier accounts
255
+ ```
256
+
257
+ ## Rationale
258
+
259
+ **Why this metric:**
260
+
261
+ - **Customer value signal:** 4 uses/month ≈ weekly 1:1s = genuine habit, not experimentation. Habit = product embedded in workflow → high retention.
262
+ - **Leading revenue:** Sticky managers account retention → expansion → NRR. Historical TeamFlow data: features used ≥ 4×/month have 3× LTV.
263
+ - **Actionable:** Team can drive (onboarding, reminders, feature quality).
264
+ - **Singular:** One number, clear dashboard.
265
+ - **Resistant to gaming:** can't «bulk» real usage. Can be inflated via trial seats, so trial accounts excluded.
266
+
267
+ **Why not alternatives:**
268
+ - C1 WAM_ai: doesn't distinguish casual from habitual usage
269
+ - C2 ARR tier: lagging, doesn't predict expansion before it happens
270
+ - C4 1:1s/week: easily gamed («create 20 fake 1:1s»)
271
+ - C5 Net new ARR: same lagging issue
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 (must not drop > 5 points)
288
+ ├── Gross churn rate (must not grow >1pp QoQ)
289
+ ├── Support ticket volume / AI issues (monitor for abuse / dissatisfaction)
290
+ └── p95 summary generation latency (< 30 sec)
291
+ ```
292
+
293
+ ## Baseline & Targets
294
+
295
+ | Horizon | Target | Rationale |
296
+ |---------|:------:|-----------|
297
+ | Current (Q1 2026) | 0% (feature not live) | Pre-launch |
298
+ | 90 days post-launch (end Q2) | **20%** | Conservative based on similar AI feature launches in adjacent B2B |
299
+ | End of 2026 | 45% | Category-leading level |
300
+ | End of 2027 (aspirational) | 65% | «Cannot imagine working without it» level |
301
+
302
+ ## Anti-Gaming Analysis
303
+
304
+ **How could this be gamed?**
305
+
306
+ - **Bulk fake 1:1 creation:** Mitigation — require AI summary generated AND reviewed (visible edit or approval event)
307
+ - **Single massive account inflating ratio:** Mitigation — weight by account size + report separately
308
+ - **Managers «maintaining streak» with perfunctory 1:1s:** Mitigation — 1:1 duration floor (must be ≥ 10 min scheduled)
309
+ - **Team inflating by marking non-actual 1:1s:** Mitigation — periodic sample audit with customer success conversations
310
+
311
+ ## Review
312
+ - **Weekly:** ratio tracked in exec dashboard
313
+ - **Quarterly:** anti-gaming sample audit (3 accounts reviewed manually)
314
+ - **Annually:** NSM re-evaluated against strategy shift
315
+ ```
316
+
317
+ > **NSM lesson:** Alpha's initial «WAM_ai» was good but too blunt — didn't distinguish trial adoption from habit. Beta's «ARR AI tier» was too lagging. Synthesis («Sticky Manager Ratio») borrowed Alpha's user-centric formulation but applied Beta's rigor about quality threshold (4+ per month = real habit). Result is a metric that **leads** revenue, **measures** customer value, and **resists** easy gaming. This is the kind of refinement that's hard to get on first try — the evaluation matrix forced the conversation.