code-ai-installer 4.0.0 → 4.0.1-b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (471) hide show
  1. package/README.md +83 -67
  2. package/dist/index.js +2 -0
  3. package/dist/mcp/audit_ledger.d.ts +12 -0
  4. package/dist/mcp/audit_ledger.js +82 -0
  5. package/dist/mcp/cli.js +7 -1
  6. package/dist/mcp/config.d.ts +23 -0
  7. package/dist/mcp/config.js +44 -6
  8. package/dist/mcp/index.d.ts +1 -2
  9. package/dist/mcp/index.js +1 -2
  10. package/dist/mcp/paths.d.ts +20 -2
  11. package/dist/mcp/paths.js +29 -5
  12. package/dist/mcp/proposal_dedup.d.ts +32 -0
  13. package/dist/mcp/proposal_dedup.js +102 -0
  14. package/dist/mcp/proposal_store.d.ts +18 -0
  15. package/dist/mcp/proposal_store.js +74 -0
  16. package/dist/mcp/scorecard.d.ts +140 -0
  17. package/dist/mcp/scorecard.js +103 -0
  18. package/dist/mcp/skill_invocations.d.ts +15 -0
  19. package/dist/mcp/skill_invocations.js +28 -0
  20. package/dist/mcp/task_state.d.ts +77 -2
  21. package/dist/mcp/tools/_subprocess.d.ts +16 -0
  22. package/dist/mcp/tools/_subprocess.js +56 -0
  23. package/dist/mcp/tools/advance_gate.js +2 -2
  24. package/dist/mcp/tools/aggregate_run_metrics.d.ts +19 -0
  25. package/dist/mcp/tools/aggregate_run_metrics.js +139 -0
  26. package/dist/mcp/tools/apply_diff.d.ts +2 -0
  27. package/dist/mcp/tools/apply_diff.js +29 -0
  28. package/dist/mcp/tools/audit_bilocale_parity.d.ts +2 -0
  29. package/dist/mcp/tools/audit_bilocale_parity.js +146 -0
  30. package/dist/mcp/tools/audit_budget_compliance.d.ts +35 -0
  31. package/dist/mcp/tools/audit_budget_compliance.js +172 -0
  32. package/dist/mcp/tools/build.d.ts +2 -0
  33. package/dist/mcp/tools/build.js +47 -0
  34. package/dist/mcp/tools/check_lint.d.ts +2 -0
  35. package/dist/mcp/tools/check_lint.js +23 -0
  36. package/dist/mcp/tools/classify_gate.js +2 -2
  37. package/dist/mcp/tools/current_gate.js +2 -2
  38. package/dist/mcp/tools/dependency_supply_chain.d.ts +2 -0
  39. package/dist/mcp/tools/dependency_supply_chain.js +59 -0
  40. package/dist/mcp/tools/docker_compose.d.ts +2 -0
  41. package/dist/mcp/tools/docker_compose.js +24 -0
  42. package/dist/mcp/tools/e2e_playwright.d.ts +2 -0
  43. package/dist/mcp/tools/e2e_playwright.js +88 -0
  44. package/dist/mcp/tools/get_skill.js +17 -0
  45. package/dist/mcp/tools/git_commit.d.ts +2 -0
  46. package/dist/mcp/tools/git_commit.js +30 -0
  47. package/dist/mcp/tools/list_proposals.d.ts +6 -0
  48. package/dist/mcp/tools/list_proposals.js +16 -0
  49. package/dist/mcp/tools/list_skills.js +9 -1
  50. package/dist/mcp/tools/load_role.d.ts +3 -4
  51. package/dist/mcp/tools/load_role.js +11 -13
  52. package/dist/mcp/tools/propose_change.d.ts +8 -0
  53. package/dist/mcp/tools/propose_change.js +36 -0
  54. package/dist/mcp/tools/record_decision.js +25 -25
  55. package/dist/mcp/tools/review_proposal.d.ts +17 -0
  56. package/dist/mcp/tools/review_proposal.js +99 -0
  57. package/dist/mcp/tools/run_drift_audit.d.ts +11 -0
  58. package/dist/mcp/tools/run_drift_audit.js +79 -0
  59. package/dist/mcp/tools/run_tests.d.ts +2 -0
  60. package/dist/mcp/tools/run_tests.js +92 -0
  61. package/dist/mcp/tools/sign_off.js +14 -2
  62. package/dist/mcp/tools/stubs.js +30 -9
  63. package/dist/mcp/tools/verify_claim.js +33 -6
  64. package/dist/mcp_setup.d.ts +14 -3
  65. package/dist/mcp_setup.js +15 -6
  66. package/dist/shared/frontmatter.d.ts +44 -2
  67. package/dist/shared/frontmatter.js +54 -6
  68. package/dist/shared/index.d.ts +0 -5
  69. package/dist/shared/index.js +0 -5
  70. package/dist/shared/persona.d.ts +2 -2
  71. package/dist/shared/persona.js +1 -1
  72. package/dist/shared/pipeline.d.ts +46 -1
  73. package/dist/shared/tools.d.ts +1382 -16
  74. package/dist/shared/tools.js +229 -0
  75. package/dist/shared/vocabulary.d.ts +99 -4
  76. package/dist/shared/vocabulary.js +94 -5
  77. package/domains/analytics/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  78. package/domains/analytics/.agents/skills/bcg-matrix/SKILL.md +345 -329
  79. package/domains/analytics/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  80. package/domains/analytics/.agents/skills/board/SKILL.md +22 -0
  81. package/domains/analytics/.agents/skills/cohort-analysis/SKILL.md +338 -322
  82. package/domains/analytics/.agents/skills/competitive-analysis/SKILL.md +413 -395
  83. package/domains/analytics/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  84. package/domains/analytics/.agents/skills/gates/SKILL.md +388 -366
  85. package/domains/analytics/.agents/skills/handoff/SKILL.md +402 -380
  86. package/domains/analytics/.agents/skills/html-pdf-report/SKILL.md +21 -289
  87. package/domains/analytics/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  88. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  89. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  90. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  91. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  92. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  93. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  94. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/skill.yaml +23 -0
  95. package/domains/analytics/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  96. package/domains/analytics/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  97. package/domains/analytics/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  98. package/domains/analytics/.agents/skills/pest-analysis/SKILL.md +324 -305
  99. package/domains/analytics/.agents/skills/porters-five-forces/SKILL.md +377 -361
  100. package/domains/analytics/.agents/skills/report-design/SKILL.md +416 -398
  101. package/domains/analytics/.agents/skills/rfm-analysis/SKILL.md +330 -314
  102. package/domains/analytics/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  103. package/domains/analytics/.agents/skills/swot-analysis/SKILL.md +340 -324
  104. package/domains/analytics/.agents/skills/tam-sam-som/SKILL.md +329 -312
  105. package/domains/analytics/.agents/skills/trend-analysis/SKILL.md +347 -331
  106. package/domains/analytics/.agents/skills/unit-economics/SKILL.md +430 -413
  107. package/domains/analytics/.agents/skills/value-chain-analysis/SKILL.md +346 -330
  108. package/domains/analytics/.agents/skills/web-research/SKILL.md +323 -308
  109. package/domains/analytics/AGENTS.md +1 -0
  110. package/domains/analytics/agents/auditor.md +76 -0
  111. package/domains/analytics/agents/conductor.md +11 -0
  112. package/domains/analytics/agents/data_analyst.md +11 -0
  113. package/domains/analytics/agents/designer.md +11 -0
  114. package/domains/analytics/agents/interviewer.md +11 -0
  115. package/domains/analytics/agents/layouter.md +11 -0
  116. package/domains/analytics/agents/mediator.md +11 -0
  117. package/domains/analytics/agents/researcher.md +11 -0
  118. package/domains/analytics/agents/strategist.md +11 -0
  119. package/domains/analytics/locales/en/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  120. package/domains/analytics/locales/en/.agents/skills/bcg-matrix/SKILL.md +345 -329
  121. package/domains/analytics/locales/en/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  122. package/domains/analytics/locales/en/.agents/skills/board/SKILL.md +22 -0
  123. package/domains/analytics/locales/en/.agents/skills/cohort-analysis/SKILL.md +338 -322
  124. package/domains/analytics/locales/en/.agents/skills/competitive-analysis/SKILL.md +413 -395
  125. package/domains/analytics/locales/en/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  126. package/domains/analytics/locales/en/.agents/skills/gates/SKILL.md +388 -366
  127. package/domains/analytics/locales/en/.agents/skills/handoff/SKILL.md +402 -380
  128. package/domains/analytics/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -289
  129. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  130. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  131. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  132. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  133. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  134. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  135. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  136. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +29 -0
  137. package/domains/analytics/locales/en/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  138. package/domains/analytics/locales/en/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  139. package/domains/analytics/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  140. package/domains/analytics/locales/en/.agents/skills/pest-analysis/SKILL.md +324 -305
  141. package/domains/analytics/locales/en/.agents/skills/porters-five-forces/SKILL.md +377 -361
  142. package/domains/analytics/locales/en/.agents/skills/report-design/SKILL.md +416 -398
  143. package/domains/analytics/locales/en/.agents/skills/rfm-analysis/SKILL.md +330 -314
  144. package/domains/analytics/locales/en/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  145. package/domains/analytics/locales/en/.agents/skills/swot-analysis/SKILL.md +340 -324
  146. package/domains/analytics/locales/en/.agents/skills/tam-sam-som/SKILL.md +329 -312
  147. package/domains/analytics/locales/en/.agents/skills/trend-analysis/SKILL.md +347 -331
  148. package/domains/analytics/locales/en/.agents/skills/unit-economics/SKILL.md +430 -413
  149. package/domains/analytics/locales/en/.agents/skills/value-chain-analysis/SKILL.md +366 -350
  150. package/domains/analytics/locales/en/.agents/skills/web-research/SKILL.md +324 -309
  151. package/domains/analytics/locales/en/AGENTS.md +1 -0
  152. package/domains/analytics/locales/en/agents/auditor.md +76 -0
  153. package/domains/analytics/locales/en/agents/conductor.md +27 -0
  154. package/domains/analytics/locales/en/agents/data_analyst.md +29 -0
  155. package/domains/analytics/locales/en/agents/designer.md +27 -0
  156. package/domains/analytics/locales/en/agents/interviewer.md +11 -0
  157. package/domains/analytics/locales/en/agents/layouter.md +11 -0
  158. package/domains/analytics/locales/en/agents/mediator.md +11 -0
  159. package/domains/analytics/locales/en/agents/researcher.md +11 -0
  160. package/domains/analytics/locales/en/agents/strategist.md +11 -0
  161. package/domains/analytics/persona/persona-base.md +94 -0
  162. package/domains/analytics/pipeline.yaml +102 -0
  163. package/domains/content/.agents/skills/audience-analysis/SKILL.md +15 -0
  164. package/domains/content/.agents/skills/board/SKILL.md +20 -0
  165. package/domains/content/.agents/skills/brand-compliance/SKILL.md +15 -0
  166. package/domains/content/.agents/skills/brand-guidelines/SKILL.md +17 -0
  167. package/domains/content/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  168. package/domains/content/.agents/skills/content-brief/SKILL.md +15 -0
  169. package/domains/content/.agents/skills/content-calendar/SKILL.md +15 -0
  170. package/domains/content/.agents/skills/content-release-gate/SKILL.md +15 -0
  171. package/domains/content/.agents/skills/content-review-checklist/SKILL.md +15 -0
  172. package/domains/content/.agents/skills/cta-optimization/SKILL.md +15 -0
  173. package/domains/content/.agents/skills/data-storytelling/SKILL.md +15 -0
  174. package/domains/content/.agents/skills/email-copywriting/SKILL.md +15 -0
  175. package/domains/content/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  176. package/domains/content/.agents/skills/fact-checking/SKILL.md +15 -0
  177. package/domains/content/.agents/skills/gates/SKILL.md +20 -0
  178. package/domains/content/.agents/skills/google-stitch-content/SKILL.md +15 -0
  179. package/domains/content/.agents/skills/handoff/SKILL.md +24 -0
  180. package/domains/content/.agents/skills/headline-formulas/SKILL.md +15 -0
  181. package/domains/content/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  182. package/domains/content/.agents/skills/karpathy-guidelines/SKILL.md +28 -0
  183. package/domains/content/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  184. package/domains/content/.agents/skills/marketing-psychology/SKILL.md +15 -0
  185. package/domains/content/.agents/skills/moodboard/SKILL.md +15 -0
  186. package/domains/content/.agents/skills/platform-compliance/SKILL.md +15 -0
  187. package/domains/content/.agents/skills/platform-strategy/SKILL.md +15 -0
  188. package/domains/content/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  189. package/domains/content/.agents/skills/readability-scoring/SKILL.md +15 -0
  190. package/domains/content/.agents/skills/seo-copywriting/SKILL.md +15 -0
  191. package/domains/content/.agents/skills/social-media-formats/SKILL.md +15 -0
  192. package/domains/content/.agents/skills/source-verification/SKILL.md +15 -0
  193. package/domains/content/.agents/skills/storytelling-framework/SKILL.md +15 -0
  194. package/domains/content/.agents/skills/tone-of-voice/SKILL.md +15 -0
  195. package/domains/content/.agents/skills/topic-research/SKILL.md +15 -0
  196. package/domains/content/.agents/skills/trend-research/SKILL.md +15 -0
  197. package/domains/content/.agents/skills/visual-brief/SKILL.md +15 -0
  198. package/domains/content/AGENTS.md +4 -0
  199. package/domains/content/agents/auditor.md +76 -0
  200. package/domains/content/agents/conductor.md +11 -0
  201. package/domains/content/agents/copywriter.md +11 -0
  202. package/domains/content/agents/researcher.md +11 -0
  203. package/domains/content/agents/reviewer.md +11 -0
  204. package/domains/content/agents/strategist.md +11 -0
  205. package/domains/content/agents/visual_concept.md +11 -0
  206. package/domains/content/locales/en/.agents/skills/audience-analysis/SKILL.md +15 -0
  207. package/domains/content/locales/en/.agents/skills/board/SKILL.md +20 -0
  208. package/domains/content/locales/en/.agents/skills/brand-compliance/SKILL.md +15 -0
  209. package/domains/content/locales/en/.agents/skills/brand-guidelines/SKILL.md +17 -0
  210. package/domains/content/locales/en/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  211. package/domains/content/locales/en/.agents/skills/content-brief/SKILL.md +15 -0
  212. package/domains/content/locales/en/.agents/skills/content-calendar/SKILL.md +15 -0
  213. package/domains/content/locales/en/.agents/skills/content-release-gate/SKILL.md +15 -0
  214. package/domains/content/locales/en/.agents/skills/content-review-checklist/SKILL.md +15 -0
  215. package/domains/content/locales/en/.agents/skills/cta-optimization/SKILL.md +15 -0
  216. package/domains/content/locales/en/.agents/skills/data-storytelling/SKILL.md +15 -0
  217. package/domains/content/locales/en/.agents/skills/email-copywriting/SKILL.md +15 -0
  218. package/domains/content/locales/en/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  219. package/domains/content/locales/en/.agents/skills/fact-checking/SKILL.md +15 -0
  220. package/domains/content/locales/en/.agents/skills/gates/SKILL.md +20 -0
  221. package/domains/content/locales/en/.agents/skills/google-stitch-content/SKILL.md +15 -0
  222. package/domains/content/locales/en/.agents/skills/handoff/SKILL.md +24 -0
  223. package/domains/content/locales/en/.agents/skills/headline-formulas/SKILL.md +15 -0
  224. package/domains/content/locales/en/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  225. package/domains/content/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +30 -1
  226. package/domains/content/locales/en/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  227. package/domains/content/locales/en/.agents/skills/marketing-psychology/SKILL.md +15 -0
  228. package/domains/content/locales/en/.agents/skills/moodboard/SKILL.md +15 -0
  229. package/domains/content/locales/en/.agents/skills/platform-compliance/SKILL.md +15 -0
  230. package/domains/content/locales/en/.agents/skills/platform-strategy/SKILL.md +15 -0
  231. package/domains/content/locales/en/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  232. package/domains/content/locales/en/.agents/skills/readability-scoring/SKILL.md +15 -0
  233. package/domains/content/locales/en/.agents/skills/seo-copywriting/SKILL.md +15 -0
  234. package/domains/content/locales/en/.agents/skills/social-media-formats/SKILL.md +15 -0
  235. package/domains/content/locales/en/.agents/skills/source-verification/SKILL.md +15 -0
  236. package/domains/content/locales/en/.agents/skills/storytelling-framework/SKILL.md +15 -0
  237. package/domains/content/locales/en/.agents/skills/tone-of-voice/SKILL.md +15 -0
  238. package/domains/content/locales/en/.agents/skills/topic-research/SKILL.md +15 -0
  239. package/domains/content/locales/en/.agents/skills/trend-research/SKILL.md +15 -0
  240. package/domains/content/locales/en/.agents/skills/visual-brief/SKILL.md +15 -0
  241. package/domains/content/locales/en/AGENTS.md +4 -0
  242. package/domains/content/locales/en/agents/auditor.md +76 -0
  243. package/domains/content/locales/en/agents/conductor.md +12 -0
  244. package/domains/content/locales/en/agents/copywriter.md +12 -0
  245. package/domains/content/locales/en/agents/researcher.md +12 -0
  246. package/domains/content/locales/en/agents/reviewer.md +12 -0
  247. package/domains/content/locales/en/agents/strategist.md +12 -0
  248. package/domains/content/locales/en/agents/visual_concept.md +12 -0
  249. package/domains/content/persona/persona-base.md +94 -0
  250. package/domains/content/pipeline.yaml +96 -0
  251. package/domains/development/.agents/skills/adr-log/SKILL.md +1 -0
  252. package/domains/development/.agents/skills/design-intake/SKILL.md +0 -4
  253. package/domains/development/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  254. package/domains/development/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  255. package/domains/development/.agents/skills/mcp-integration/SKILL.md +211 -0
  256. package/domains/development/.agents/skills/mcp-integration/agents/claude.json +22 -0
  257. package/domains/development/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  258. package/domains/development/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  259. package/domains/development/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  260. package/domains/development/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  261. package/domains/development/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  262. package/domains/development/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  263. package/domains/development/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  264. package/domains/development/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  265. package/domains/development/AGENTS.md +1 -0
  266. package/domains/development/AGENTS.yaml +1 -0
  267. package/domains/development/agents/architect.md +13 -1
  268. package/domains/development/agents/auditor.md +74 -0
  269. package/domains/development/agents/conductor.md +14 -3
  270. package/domains/development/agents/devops.md +8 -9
  271. package/domains/development/agents/reviewer.md +12 -0
  272. package/domains/development/agents/senior_full_stack.md +12 -0
  273. package/domains/development/agents/tester.md +10 -16
  274. package/domains/development/locales/en/.agents/skills/adr-log/SKILL.md +1 -0
  275. package/domains/development/locales/en/.agents/skills/current-state-analysis/SKILL.md +256 -172
  276. package/domains/development/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  277. package/domains/development/locales/en/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  278. package/domains/development/locales/en/.agents/skills/mcp-integration/SKILL.md +211 -0
  279. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/claude.json +22 -0
  280. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  281. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  282. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  283. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  284. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  285. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  286. package/domains/development/locales/en/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  287. package/domains/development/locales/en/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  288. package/domains/development/locales/en/AGENTS.md +5 -0
  289. package/domains/development/locales/en/AGENTS.yaml +1 -0
  290. package/domains/development/locales/en/agents/architect.md +13 -1
  291. package/domains/development/locales/en/agents/auditor.md +74 -0
  292. package/domains/development/locales/en/agents/conductor.md +14 -3
  293. package/domains/development/locales/en/agents/devops.md +8 -9
  294. package/domains/development/locales/en/agents/reviewer.md +12 -0
  295. package/domains/development/locales/en/agents/senior_full_stack.md +12 -0
  296. package/domains/development/locales/en/agents/tester.md +10 -16
  297. package/domains/development/persona/persona-base.md +94 -0
  298. package/domains/product/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  299. package/domains/product/.agents/skills/ab-test-design/SKILL.md +428 -412
  300. package/domains/product/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  301. package/domains/product/.agents/skills/assumption-mapping/SKILL.md +323 -307
  302. package/domains/product/.agents/skills/board/SKILL.md +24 -0
  303. package/domains/product/.agents/skills/design-brief/SKILL.md +433 -418
  304. package/domains/product/.agents/skills/epic-breakdown/SKILL.md +435 -420
  305. package/domains/product/.agents/skills/gates/SKILL.md +470 -446
  306. package/domains/product/.agents/skills/gtm-brief/SKILL.md +18 -321
  307. package/domains/product/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  308. package/domains/product/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  309. package/domains/product/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  310. package/domains/product/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  311. package/domains/product/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  312. package/domains/product/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  313. package/domains/product/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  314. package/domains/product/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  315. package/domains/product/.agents/skills/handoff/SKILL.md +463 -439
  316. package/domains/product/.agents/skills/html-pdf-report/SKILL.md +21 -663
  317. package/domains/product/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  318. package/domains/product/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  319. package/domains/product/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  320. package/domains/product/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  321. package/domains/product/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  322. package/domains/product/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  323. package/domains/product/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  324. package/domains/product/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  325. package/domains/product/.agents/skills/hypothesis-template/SKILL.md +484 -469
  326. package/domains/product/.agents/skills/jtbd-canvas/SKILL.md +274 -258
  327. package/domains/product/.agents/skills/kano-model/SKILL.md +370 -355
  328. package/domains/product/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  329. package/domains/product/.agents/skills/launch-checklist/SKILL.md +434 -419
  330. package/domains/product/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  331. package/domains/product/.agents/skills/north-star-metric/SKILL.md +317 -301
  332. package/domains/product/.agents/skills/okr-framework/SKILL.md +299 -284
  333. package/domains/product/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  334. package/domains/product/.agents/skills/prd-template/SKILL.md +18 -258
  335. package/domains/product/.agents/skills/prd-template-reference/SKILL.md +285 -0
  336. package/domains/product/.agents/skills/prd-template-reference/agents/claude.json +17 -0
  337. package/domains/product/.agents/skills/prd-template-reference/agents/copilot.json +17 -0
  338. package/domains/product/.agents/skills/prd-template-reference/agents/gemini.json +17 -0
  339. package/domains/product/.agents/skills/prd-template-reference/agents/kimi.yaml +16 -0
  340. package/domains/product/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  341. package/domains/product/.agents/skills/prd-template-reference/agents/qwen.json +17 -0
  342. package/domains/product/.agents/skills/prd-template-reference/agents/skill.yaml +23 -0
  343. package/domains/product/.agents/skills/problem-statement/SKILL.md +327 -312
  344. package/domains/product/.agents/skills/product-roadmap/SKILL.md +320 -304
  345. package/domains/product/.agents/skills/product-vision/SKILL.md +409 -394
  346. package/domains/product/.agents/skills/release-notes/SKILL.md +18 -258
  347. package/domains/product/.agents/skills/release-notes-reference/SKILL.md +285 -0
  348. package/domains/product/.agents/skills/release-notes-reference/agents/claude.json +17 -0
  349. package/domains/product/.agents/skills/release-notes-reference/agents/copilot.json +17 -0
  350. package/domains/product/.agents/skills/release-notes-reference/agents/gemini.json +17 -0
  351. package/domains/product/.agents/skills/release-notes-reference/agents/kimi.yaml +15 -0
  352. package/domains/product/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  353. package/domains/product/.agents/skills/release-notes-reference/agents/qwen.json +17 -0
  354. package/domains/product/.agents/skills/release-notes-reference/agents/skill.yaml +22 -0
  355. package/domains/product/.agents/skills/report-design/SKILL.md +17 -307
  356. package/domains/product/.agents/skills/report-design-reference/SKILL.md +331 -0
  357. package/domains/product/.agents/skills/report-design-reference/agents/claude.json +17 -0
  358. package/domains/product/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  359. package/domains/product/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  360. package/domains/product/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  361. package/domains/product/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  362. package/domains/product/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  363. package/domains/product/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  364. package/domains/product/.agents/skills/rice-scoring/SKILL.md +266 -251
  365. package/domains/product/.agents/skills/saas-metrics/SKILL.md +422 -404
  366. package/domains/product/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  367. package/domains/product/.agents/skills/user-flow/SKILL.md +491 -476
  368. package/domains/product/.agents/skills/user-interview-script/SKILL.md +315 -298
  369. package/domains/product/.agents/skills/user-story/SKILL.md +401 -385
  370. package/domains/product/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  371. package/domains/product/AGENTS.md +5 -0
  372. package/domains/product/AGENTS.yaml +1 -0
  373. package/domains/product/agents/auditor.md +76 -0
  374. package/domains/product/agents/conductor.md +11 -0
  375. package/domains/product/agents/data_analyst.md +11 -0
  376. package/domains/product/agents/designer.md +11 -0
  377. package/domains/product/agents/discovery.md +11 -0
  378. package/domains/product/agents/layouter.md +11 -0
  379. package/domains/product/agents/mediator.md +11 -0
  380. package/domains/product/agents/pm.md +11 -0
  381. package/domains/product/agents/product_strategist.md +11 -0
  382. package/domains/product/agents/tech_lead.md +11 -0
  383. package/domains/product/agents/ux_designer.md +11 -0
  384. package/domains/product/locales/en/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  385. package/domains/product/locales/en/.agents/skills/ab-test-design/SKILL.md +428 -412
  386. package/domains/product/locales/en/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  387. package/domains/product/locales/en/.agents/skills/assumption-mapping/SKILL.md +323 -307
  388. package/domains/product/locales/en/.agents/skills/board/SKILL.md +24 -0
  389. package/domains/product/locales/en/.agents/skills/design-brief/SKILL.md +433 -418
  390. package/domains/product/locales/en/.agents/skills/epic-breakdown/SKILL.md +435 -420
  391. package/domains/product/locales/en/.agents/skills/gates/SKILL.md +470 -446
  392. package/domains/product/locales/en/.agents/skills/gtm-brief/SKILL.md +18 -321
  393. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  394. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  395. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  396. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  397. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  398. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  399. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  400. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  401. package/domains/product/locales/en/.agents/skills/handoff/SKILL.md +463 -439
  402. package/domains/product/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -663
  403. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  404. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  405. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  406. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  407. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  408. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  409. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  410. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  411. package/domains/product/locales/en/.agents/skills/hypothesis-template/SKILL.md +484 -469
  412. package/domains/product/locales/en/.agents/skills/jtbd-canvas/SKILL.md +273 -257
  413. package/domains/product/locales/en/.agents/skills/kano-model/SKILL.md +370 -355
  414. package/domains/product/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  415. package/domains/product/locales/en/.agents/skills/launch-checklist/SKILL.md +434 -419
  416. package/domains/product/locales/en/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  417. package/domains/product/locales/en/.agents/skills/north-star-metric/SKILL.md +317 -301
  418. package/domains/product/locales/en/.agents/skills/okr-framework/SKILL.md +299 -284
  419. package/domains/product/locales/en/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  420. package/domains/product/locales/en/.agents/skills/prd-template/SKILL.md +18 -258
  421. package/domains/product/locales/en/.agents/skills/prd-template-reference/SKILL.md +285 -0
  422. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/claude.json +16 -0
  423. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/copilot.json +16 -0
  424. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/gemini.json +16 -0
  425. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/kimi.yaml +15 -0
  426. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  427. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/qwen.json +16 -0
  428. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/skill.yaml +22 -0
  429. package/domains/product/locales/en/.agents/skills/problem-statement/SKILL.md +327 -312
  430. package/domains/product/locales/en/.agents/skills/product-roadmap/SKILL.md +321 -305
  431. package/domains/product/locales/en/.agents/skills/product-vision/SKILL.md +410 -395
  432. package/domains/product/locales/en/.agents/skills/release-notes/SKILL.md +18 -258
  433. package/domains/product/locales/en/.agents/skills/release-notes-reference/SKILL.md +285 -0
  434. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/claude.json +16 -0
  435. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/copilot.json +16 -0
  436. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/gemini.json +16 -0
  437. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/kimi.yaml +14 -0
  438. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  439. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/qwen.json +16 -0
  440. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/skill.yaml +21 -0
  441. package/domains/product/locales/en/.agents/skills/report-design/SKILL.md +17 -307
  442. package/domains/product/locales/en/.agents/skills/report-design-reference/SKILL.md +331 -0
  443. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/claude.json +17 -0
  444. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  445. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  446. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  447. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  448. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  449. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  450. package/domains/product/locales/en/.agents/skills/rice-scoring/SKILL.md +266 -251
  451. package/domains/product/locales/en/.agents/skills/saas-metrics/SKILL.md +422 -404
  452. package/domains/product/locales/en/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  453. package/domains/product/locales/en/.agents/skills/user-flow/SKILL.md +491 -476
  454. package/domains/product/locales/en/.agents/skills/user-interview-script/SKILL.md +314 -297
  455. package/domains/product/locales/en/.agents/skills/user-story/SKILL.md +401 -385
  456. package/domains/product/locales/en/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  457. package/domains/product/locales/en/AGENTS.md +5 -0
  458. package/domains/product/locales/en/agents/auditor.md +76 -0
  459. package/domains/product/locales/en/agents/conductor.md +11 -0
  460. package/domains/product/locales/en/agents/data_analyst.md +11 -0
  461. package/domains/product/locales/en/agents/designer.md +11 -0
  462. package/domains/product/locales/en/agents/discovery.md +11 -0
  463. package/domains/product/locales/en/agents/layouter.md +11 -0
  464. package/domains/product/locales/en/agents/mediator.md +11 -0
  465. package/domains/product/locales/en/agents/pm.md +11 -0
  466. package/domains/product/locales/en/agents/product_strategist.md +11 -0
  467. package/domains/product/locales/en/agents/tech_lead.md +11 -0
  468. package/domains/product/locales/en/agents/ux_designer.md +11 -0
  469. package/domains/product/persona/persona-base.md +94 -0
  470. package/domains/product/pipeline.yaml +115 -0
  471. package/package.json +72 -70
@@ -1,314 +1,330 @@
1
- ---
2
- name: rfm-analysis
3
- description: Сегментация клиентов по давности, частоте и сумме покупок
4
- ---
5
- # RFM-анализ — Сегментация клиентов по давности, частоте и сумме покупок
6
-
7
- ## Когда использовать
8
- - При построении стратегии удержания клиентов — понять, кого удерживать, а кого реактивировать.
9
- - При оптимизации маркетингового бюджета — направить ресурсы на наиболее ценные сегменты.
10
- - При запуске персонализированных кампаний — разный месседж для разных сегментов.
11
- - При анализе клиентской базы — выявление Champions, лояльных, рисковых и потерянных клиентов.
12
-
13
- ## Вход
14
-
15
- | Поле | Обязательно | Описание |
16
- |------|:-----------:|----------|
17
- | Бизнес / продукт | ✅ | Что анализируем |
18
- | Бизнес-модель | ✅ | E-commerce / SaaS / Marketplace / Сервис |
19
- | Данные транзакций | ⬚ | Таблица: клиент, дата, сумма (если есть реальные данные) |
20
- | Период анализа | ⬚ | За какой период (по умолчанию — 12 месяцев) |
21
- | Количество клиентов | | Размер базы для калибровки шкалы |
22
- | Средний чек | ⬚ | Для моделирования, если нет реальных данных |
23
- | Частота покупок | ⬚ | Средняя частота для моделирования |
24
-
25
- > Если обязательные поля не предоставлены **запросить у пользователя** до начала анализа. Не додумывать.
26
-
27
- > Если реальных данных нетскил работает с **моделированными данными**, явно помеченными как гипотетические. Методология остаётся применимой при появлении реальных данных.
28
-
29
- ## Источники данных
30
- 1. **Транзакционные данные** — CRM, платёжная система, ERP (если предоставлены).
31
- 2. **Веб-поиск** бенчмарки по отрасли (средний чек, частота покупок, retention rate).
32
- 3. **Отраслевые отчёты** — типичные RFM-распределения для данного типа бизнеса.
33
- 4. **Аналитика продукта** данные активности пользователей (для SaaS — логины, действия).
34
- 5. **Данные от пользователя** выгрузки из CRM, Google Analytics, платёжного провайдера.
35
-
36
- > При работе с моделированными данными указать источники бенчмарков. Данные старше 12 месяцев — пометить ⚠️.
37
-
38
- ### Связь с другими скилами
39
- | Скил | Что берём | Когда вызывать |
40
- |------|-----------|----------------|
41
- | `web-research` | Отраслевые бенчмарки: средний чек, частота, retention | Если нет реальных данных — для моделирования |
42
- | `cohort-analysis` | Retention curves для калибровки Recency-порогов (шаг 2) | Если есть когортные данные |
43
- | `competitive-analysis` | Бенчмарки конкурентов по retention и LTV | Для сравнения с рыночными стандартами |
44
- | `icp-buyer-persona` | Профиль Champions → обогащение ICP (шаг 8) | После сегментации: Champions = эталон ICP |
45
- | `unit-economics` | LTV per segment для расчёта бюджета на реактивацию | Для оценки ROI по сегментам |
46
- | `customer-journey-mapping` | Точки оттока для At Risk / About to Sleep | Для понимания, где именно теряем клиентов |
47
-
48
- ## Протокол
49
-
50
- ### Шаг 0Сбор контекста
51
- 1. Проверить наличие обязательных данных.
52
- 2. Определить режим: **реальные данные** или **моделированные**.
53
- 3. Зафиксировать период анализа.
54
- 4. Определить адаптацию под бизнес-модель:
55
-
56
- | Бизнес-модель | Recency = | Frequency = | Monetary = |
57
- |---------------|-----------|-------------|------------|
58
- | E-commerce | Дни с последнего заказа | Кол-во заказов | Общая сумма заказов |
59
- | SaaS (подписка) | Дни с последнего логина/действия | Кол-во активных месяцев | MRR или план подписки |
60
- | SaaS (usage-based) | Дни с последнего использования | Кол-во сессий/действий | Общая сумма оплат |
61
- | Marketplace | Дни с последней сделки | Кол-во сделок | GMV (объём сделок) |
62
- | Сервис (офлайн) | Дни с последнего визита | Кол-во визитов | Общая сумма чеков |
63
-
64
- ### Шаг 1 — Определение области данных
65
- - Определить единицу анализа: клиент / аккаунт / подписчик.
66
- - Определить «транзакцию» для данной бизнес-модели (см. таблицу шага 0).
67
- - Определить период: начальная и конечная дата.
68
- - Исключить аномалии: тестовые аккаунты, возвраты, аномальные суммы (>3σ).
69
-
70
- ### Шаг 2 Recency Score (R)
71
- 1. Рассчитать дни с последней транзакции для каждого клиента.
72
- 2. Определить пороги на основе бизнес-цикла:
73
-
74
- | Score | E-commerce | SaaS (подписка) | Marketplace |
75
- |:-----:|:----------:|:---------------:|:-----------:|
76
- | R=5 | 0-30 дней | 0-7 дней | 0-14 дней |
77
- | R=4 | 31-90 | 8-30 | 15-45 |
78
- | R=3 | 91-180 | 31-60 | 46-90 |
79
- | R=2 | 181-365 | 61-120 | 91-180 |
80
- | R=1 | >365 | >120 | >180 |
81
-
82
- > Пороги ориентир. Калибровать под реальное распределение (квинтили) если есть данные.
83
-
84
- ### Шаг 3 Frequency Score (F)
85
- 1. Подсчитать количество транзакций на клиента за период.
86
- 2. Разбить на 5 групп (квинтили или бизнес-логика).
87
- 3. F=5: топ-20% по частоте. F=1: однократная / минимальная.
88
-
89
- ### Шаг 4 — Monetary Score (M)
90
- 1. Рассчитать общую сумму на клиента за период.
91
- 2. Разбить на 5 групп (квинтили или бизнес-логика).
92
- 3. M=5: топ-20% по сумме. M=1: минимальные траты.
93
- 4. Для SaaS с фиксированной подпиской: заменить M на **Engagement Score** (глубина использования: фичи, интеграции, кол-во пользователей в аккаунте).
94
-
95
- ### Шаг 5 Сегментация
96
- Присвоить каждому клиенту RFM-код (111-555) и сгруппировать:
97
-
98
- | Сегмент | RFM-диапазон | Описание | Типичная доля |
99
- |---------|:------------:|----------|:-------------:|
100
- | **Champions** | R=5, F=4-5, M=4-5 | Лучшие клиенты, покупают часто и много | 5-10% |
101
- | **Loyal Customers** | R=4-5, F=3-5, M=3-5 | Регулярные и ценные | 10-15% |
102
- | **Potential Loyalists** | R=4-5, F=1-3, M=1-3 | Новые с потенциалом роста | 10-15% |
103
- | **Recent Customers** | R=5, F=1, M=1 | Только пришли, первая покупка | 5-10% |
104
- | **Promising** | R=3-4, F=1-2, M=1-2 | Есть интерес, нужна активация | 10-15% |
105
- | **Need Attention** | R=3, F=3, M=3 | Средние, рискуют уйти | 5-10% |
106
- | **About to Sleep** | R=2-3, F=1-2, M=1-2 | Теряют интерес | 10-15% |
107
- | **At Risk** | R=1-2, F=3-5, M=3-5 | Были активны и ценны, уходят | 5-10% |
108
- | **Cannot Lose** | R=1, F=5, M=5 | VIP, которые ушли критично вернуть | 1-3% |
109
- | **Hibernating** | R=1-2, F=1-2, M=1-2 | Давно неактивны, низкая ценность | 10-15% |
110
- | **Lost** | R=1, F=1, M=1 | Потеряны | 5-10% |
111
-
112
- ### Шаг 6 Оценка ценности сегментов
113
- Для каждого сегмента рассчитать:
114
-
115
- | Сегмент | % базы | % выручки | Ср. LTV | Revenue/клиент | Приоритет бюджета |
116
- |---------|:------:|:---------:|:-------:|:--------------:|:-----------------:|
117
- | Champions | X% | X% | $XXX | $XXX | Высокий (удержание) |
118
- | At Risk | X% | X% | $XXX | $XXX | Высокий (реактивация) |
119
- | Lost | X% | X% | $XXX | $XXX | Низкий (отпустить) |
120
-
121
- **Правило Парето:** обычно Champions + Loyal = 15-25% базы, но 60-80% выручки. Если распределение другое — зафиксировать как аномалию.
122
-
123
- ### Шаг 7 Стратегия и персонализация по сегментам
124
-
125
- | Сегмент | Цель | Действие | Канал | Тон | Предложение | KPI |
126
- |---------|------|----------|-------|-----|-------------|-----|
127
- | Champions | Удержание + адвокация | Эксклюзивный доступ, реферальная программа | Email, personal | Благодарный, VIP | Ранний доступ, бонус за реферал | NPS, referral rate |
128
- | Loyal | Upsell + лояльность | Кросс-продажи, программа лояльности | Email, in-app | Дружеский, экспертный | Upgrade, bundle | ARPU, retention |
129
- | Potential Loyalists | Вовлечение + онбординг | Guided onboarding, серия обучающих писем | Email, in-app | Поддерживающий | Бонус за 2-ю покупку | F→2+, activation |
130
- | Recent | Активация | Welcome-серия, aha-moment | Email, push | Приветливый | Промокод на 2-й заказ | Day-7 retention |
131
- | At Risk | Реактивация | «Мы скучаем», специальное предложение | Email, SMS | Заботливый, срочный | Скидка 20%, персональный оффер | Win-back rate |
132
- | Cannot Lose | Срочная реактивация | Звонок менеджера, персональное предложение | Звонок, email | Личный, VIP | Максимальная скидка, upgrade | Win-back rate |
133
- | Lost | Win-back или отпустить | Финальное письмо, опрос причины ухода | Email | Нейтральный | Опрос + последний шанс | Churn reason data |
134
-
135
- ### Шаг 8 Миграционный анализ
136
- Отслеживать перемещение клиентов между сегментами:
137
-
138
- 1. Сравнить RFM-сегменты за текущий и предыдущий период:
139
-
140
- | Миграция | Количество | % | Интерпретация | Действие |
141
- |----------|:----------:|:-:|---------------|----------|
142
- | Champions → At Risk | [N] | X% | Потеря лучших клиентов — критично | Немедленная реактивация |
143
- | Potential Loyalists Loyal | [N] | X% | Здоровый рост онбординг работает | Масштабировать подход |
144
- | At Risk Lost | [N] | X% | Реактивация не сработала | Пересмотреть стратегию |
145
- | Recent Promising | [N] | X% | Активация работает | Продолжать |
146
-
147
- 2. Ключевые миграции для мониторинга:
148
- - **Негативные:** Champions/Loyal At Risk, At Risk Lost, Potential Hibernating.
149
- - **Позитивные:** Recent Potential Loyal Champions.
150
- 3. Рекомендуемая частота пересчёта:
151
-
152
- | Бизнес-модель | Частота |
153
- |---------------|---------|
154
- | E-commerce (FMCG) | Еженедельно |
155
- | E-commerce (дорогие товары) | Ежемесячно |
156
- | SaaS | Ежемесячно |
157
- | Marketplace | Раз в 2 недели |
158
- | Сервис (офлайн) | Ежеквартально |
159
-
160
- ## Пример E-commerce: магазин спортивного питания
161
-
162
- **Контекст:** Онлайн-магазин спортивного питания, B2C, 12 000 клиентов, период 12 мес. Средний чек $45, средняя частота 3.2 покупки/год.
163
-
164
- ### Шкала оценки
165
-
166
- | Метрика | 5 | 4 | 3 | 2 | 1 |
167
- |---------|:-:|:-:|:-:|:-:|:-:|
168
- | **Recency** (дни) | 0-30 | 31-60 | 61-120 | 121-240 | >240 |
169
- | **Frequency** (заказов) | ≥6 | 4-5 | 3 | 2 | 1 |
170
- | **Monetary** ($) | >$300 | $200-300 | $100-200 | $50-100 | <$50 |
171
-
172
- ### Сегменты
173
-
174
- | Сегмент | % базы | % выручки | Кол-во | Ср. LTV | Стратегия |
175
- |---------|:------:|:---------:|:------:|:-------:|-----------|
176
- | Champions | 8% | 35% | 960 | $520 | Реферальная программа, VIP-доступ |
177
- | Loyal | 12% | 28% | 1440 | $340 | Upsell на подписку, программа лояльности |
178
- | Potential Loyalists | 11% | 8% | 1320 | $105 | Онбординг: «3-й заказ = бесплатная доставка» |
179
- | At Risk | 7% | 12% | 840 | $250 | «Мы скучаем» + скидка 15% на любимую категорию |
180
- | Cannot Lose | 2% | 5% | 240 | $360 | Звонок менеджера, персональный оффер |
181
- | Lost | 15% | 2% | 1800 | $25 | Финальный email + опрос причины ухода |
182
-
183
- **Проверка Парето:** Champions + Loyal = 20% базы, 63% выручки ✅ (здоровое распределение).
184
-
185
- ### Миграционный анализ (мес. мес.)
186
-
187
- | Миграция | Кол-во | % | Сигнал |
188
- |----------|:------:|:-:|--------|
189
- | Champions → At Risk | 45 | 4.7% | 🔴 Потеря VIP — запустить win-back |
190
- | Potential Loyal | 180 | 13.6% | 🟢 Онбординг работает |
191
- | At Risk → Lost | 120 | 14.3% | 🟡 Реактивация недостаточно эффективна |
192
-
193
- **Рекомендация:** Champions At Risk = 4.7% выше бенчмарка (3%). Расследовать: цена? качество? конкурент?
194
-
195
- ## Валидация (Quality Gate)
196
-
197
- - [ ] Определены все три метрики (R, F, M) с чёткими порогами, адаптированными под бизнес-модель
198
- - [ ] Пороги квинтилей обоснованы бизнес-циклом (или квинтилями реальных данных)
199
- - [ ] Выделены минимум 6 именованных сегментов с RFM-диапазонами
200
- - [ ] Для каждого сегмента: стратегия, действие, канал, тон, KPI
201
- - [ ] Ценность сегментов оценена: % базы, % выручки, средний LTV
202
- - [ ] Парето-проверка: Champions + Loyal ≈ 15-25% базы, 60-80% выручки
203
- - [ ] Миграционный анализ: ключевые переходы между сегментами зафиксированы
204
- - [ ] Частота пересчёта рекомендована для данной бизнес-модели
205
- - [ ] Если данные моделированные явно указано с источниками бенчмарков
206
- - [ ] Нет логических противоречий в сегментации (RFM-коды корректны)
207
- - [ ] Источники данных указаны; данные старше 12 мес помечены ⚠️
208
-
209
- > Если валидация не пройденадоработать до повторного прохождения, а не передавать дальше.
210
-
211
- ## Handoff
212
- Результат `$rfm-analysis` является входом для:
213
- - **Стратег / Медиатор** сегменты клиентов для стратегических решений.
214
- - **`unit-economics`** LTV по сегментам, retention rates, бюджет на реактивацию.
215
- - **`cohort-analysis`** группировка по когортам внутри сегментов.
216
- - **`customer-journey-mapping`** точки оттока для At Risk / About to Sleep.
217
- - **`icp-buyer-persona`** профиль Champions = эталон ICP.
218
-
219
- Формат передачи: таблица сегментов (% базы, % выручки, LTV) + стратегии + миграционный анализ. При передаче — использовать `$handoff`.
220
-
221
- ## Anti-patterns
222
-
223
- | Ошибка | Почему плохо | Как правильно |
224
- |--------|-------------|---------------|
225
- | Одинаковые пороги для всех бизнесов | У SaaS и e-commerce разные циклы покупки | Калибровать пороги под бизнес-модель (таблица шаг 0) |
226
- | Моделированные данные без пометки | Решения на основе гипотез, а не фактов | Явно помечать, указывать источники бенчмарков |
227
- | Слишком много сегментов (>11) | Невозможно создать уникальную стратегию для каждого | 6-11 именованных сегментов |
228
- | Сегментация без стратегии | RFM ради RFM, нет actionable-выводов | Каждый сегмент = цель + действие + канал + KPI |
229
- | Игнорирование M при подписке | В SaaS Monetary менее вариативна | Заменить M на Engagement Score для SaaS |
230
- | Статичный анализ без миграции | Не видно, как клиенты перемещаются между сегментами | Миграционный анализ: негативные и позитивные переходы |
231
- | Без персонализации | Одинаковое сообщение для Champions и At Risk | Разный тон, канал, предложение, частота по сегментам |
232
- | Сегменты без ценности | Непонятно, куда направить бюджет | % базы + % выручки + LTV per segment + Парето-проверка |
233
- | Бенчмарки без источника | Невозможно верифицировать | Каждый бенчмарк с источником и датой |
234
-
235
- ## Шаблон вывода
236
-
237
- ```
238
- ### RFM-анализ — [Бизнес / Продукт]
239
-
240
- **Бизнес-модель:** [модель]
241
- **Период анализа:** [дата дата]
242
- **Размер базы:** [N клиентов]
243
- **Тип данных:** Реальные / Моделированные (бенчмарк: [источник])
244
- **Дата анализа:** [дата]
245
-
246
- ---
247
-
248
- #### Адаптация метрик
249
-
250
- | Метрика | Определение для данного бизнеса |
251
- |---------|-------------------------------|
252
- | Recency | [Что измеряем: дни с последнего X] |
253
- | Frequency | [Что считаем: кол-во X за период] |
254
- | Monetary | [Что считаем: сумма X / engagement score] |
255
-
256
- #### Шкала оценки
257
-
258
- | Метрика | Score 5 | Score 4 | Score 3 | Score 2 | Score 1 |
259
- |---------|:-------:|:-------:|:-------:|:-------:|:-------:|
260
- | **Recency** | 0-[X] | [X]-[X] | [X]-[X] | [X]-[X] | >[X] |
261
- | **Frequency** | >[X] | [X]-[X] | [X]-[X] | [X]-[X] | [X] |
262
- | **Monetary** | >[X] | [X]-[X] | [X]-[X] | [X]-[X] | <[X] |
263
-
264
- ---
265
-
266
- #### Сегменты клиентов
267
-
268
- | Сегмент | RFM-диапазон | % базы | % выручки | Кол-во | Ср. LTV | Приоритет |
269
- |---------|:------------:|:------:|:---------:|:------:|:-------:|:---------:|
270
- | Champions | R5, F4-5, M4-5 | X% | X% | [N] | $XXX | Высокий |
271
- | Loyal | R4-5, F3-5, M3-5 | X% | X% | [N] | $XXX | Высокий |
272
- | ... | ... | ... | ... | ... | ... | ... |
273
-
274
- **Парето-проверка:** Champions + Loyal = X% базы, X% выручки [Здоровое / Аномальное]
275
-
276
- ---
277
-
278
- #### Стратегия и персонализация
279
-
280
- | Сегмент | Цель | Действие | Канал | Тон | Предложение | KPI |
281
- |---------|------|----------|-------|-----|-------------|-----|
282
- | Champions | [Цель] | [Действие] | [Канал] | [Тон] | [Оффер] | [KPI] |
283
- | At Risk | [Цель] | [Действие] | [Канал] | [Тон] | [Оффер] | [KPI] |
284
-
285
- ---
286
-
287
- #### Миграционный анализ
288
-
289
- | Миграция | Кол-во | % сегмента | Сигнал | Действие |
290
- |----------|:------:|:----------:|:------:|----------|
291
- | Champions → At Risk | [N] | X% | 🔴 | [Что делать] |
292
- | Potential → Loyal | [N] | X% | 🟢 | [Что делать] |
293
- | At Risk → Lost | [N] | X% | 🟡 | [Что делать] |
294
-
295
- **Частота пересчёта:** [еженедельно / ежемесячно / ежеквартально]
296
-
297
- ---
298
-
299
- #### Рекомендации
300
- 1. **Немедленные:** [At Risk / Cannot Lose — что делать сейчас]
301
- 2. **Среднесрочные:** [Potential Loyalists — как активировать]
302
- 3. **Долгосрочные:** [Champions — программа лояльности / адвокации]
303
- 4. **Пересчёт:** каждые [N] дней
304
-
305
- ---
306
-
307
- #### Источники и допущения
308
-
309
- | # | Факт / допущение | Источник | Дата | Достоверность |
310
- |---|-------------------|----------|------|:-------------:|
311
- | 1 | [Факт] | [Источник] | [Дата] | ✅ / ⚠️ / 🔮 |
312
-
313
- Легенда: ✅ Verified (реальные данные) | ⚠️ Estimated (бенчмарк) | 🔮 Assumed (моделирование)
314
- ```
1
+ ---
2
+ name: rfm-analysis
3
+ description: Сегментация клиентов по давности, частоте и сумме покупок
4
+ type: triggered
5
+ domain: analytics
6
+ owners:
7
+ - data_analyst
8
+ gates:
9
+ - DATA_ANALYST
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - "rfm-analysis"
14
+ - "RFM"
15
+ - "RFM-анализ"
16
+ - "сегментация клиентов"
17
+ related: []
18
+ budget_lines: 330
19
+ schema_version: 1
20
+ ---
21
+ # RFM-анализ Сегментация клиентов по давности, частоте и сумме покупок
22
+
23
+ ## Когда использовать
24
+ - При построении стратегии удержания клиентов — понять, кого удерживать, а кого реактивировать.
25
+ - При оптимизации маркетингового бюджетанаправить ресурсы на наиболее ценные сегменты.
26
+ - При запуске персонализированных кампаний — разный месседж для разных сегментов.
27
+ - При анализе клиентской базывыявление Champions, лояльных, рисковых и потерянных клиентов.
28
+
29
+ ## Вход
30
+
31
+ | Поле | Обязательно | Описание |
32
+ |------|:-----------:|----------|
33
+ | Бизнес / продукт | | Что анализируем |
34
+ | Бизнес-модель | | E-commerce / SaaS / Marketplace / Сервис |
35
+ | Данные транзакций | ⬚ | Таблица: клиент, дата, сумма (если есть реальные данные) |
36
+ | Период анализа | | За какой период (по умолчанию 12 месяцев) |
37
+ | Количество клиентов | ⬚ | Размер базы для калибровки шкалы |
38
+ | Средний чек | ⬚ | Для моделирования, если нет реальных данных |
39
+ | Частота покупок | | Средняя частота для моделирования |
40
+
41
+ > Если обязательные поля не предоставлены **запросить у пользователя** до начала анализа. Не додумывать.
42
+
43
+ > Если реальных данных нет скил работает с **моделированными данными**, явно помеченными как гипотетические. Методология остаётся применимой при появлении реальных данных.
44
+
45
+ ## Источники данных
46
+ 1. **Транзакционные данные** CRM, платёжная система, ERP (если предоставлены).
47
+ 2. **Веб-поиск** — бенчмарки по отрасли (средний чек, частота покупок, retention rate).
48
+ 3. **Отраслевые отчёты** — типичные RFM-распределения для данного типа бизнеса.
49
+ 4. **Аналитика продукта** — данные активности пользователей (для SaaS — логины, действия).
50
+ 5. **Данные от пользователя** выгрузки из CRM, Google Analytics, платёжного провайдера.
51
+
52
+ > При работе с моделированными данными — указать источники бенчмарков. Данные старше 12 месяцев — пометить ⚠️.
53
+
54
+ ### Связь с другими скилами
55
+ | Скил | Что берём | Когда вызывать |
56
+ |------|-----------|----------------|
57
+ | `web-research` | Отраслевые бенчмарки: средний чек, частота, retention | Если нет реальных данных — для моделирования |
58
+ | `cohort-analysis` | Retention curves для калибровки Recency-порогов (шаг 2) | Если есть когортные данные |
59
+ | `competitive-analysis` | Бенчмарки конкурентов по retention и LTV | Для сравнения с рыночными стандартами |
60
+ | `icp-buyer-persona` | Профиль Champions обогащение ICP (шаг 8) | После сегментации: Champions = эталон ICP |
61
+ | `unit-economics` | LTV per segment для расчёта бюджета на реактивацию | Для оценки ROI по сегментам |
62
+ | `customer-journey-mapping` | Точки оттока для At Risk / About to Sleep | Для понимания, где именно теряем клиентов |
63
+
64
+ ## Протокол
65
+
66
+ ### Шаг 0 Сбор контекста
67
+ 1. Проверить наличие обязательных данных.
68
+ 2. Определить режим: **реальные данные** или **моделированные**.
69
+ 3. Зафиксировать период анализа.
70
+ 4. Определить адаптацию под бизнес-модель:
71
+
72
+ | Бизнес-модель | Recency = | Frequency = | Monetary = |
73
+ |---------------|-----------|-------------|------------|
74
+ | E-commerce | Дни с последнего заказа | Кол-во заказов | Общая сумма заказов |
75
+ | SaaS (подписка) | Дни с последнего логина/действия | Кол-во активных месяцев | MRR или план подписки |
76
+ | SaaS (usage-based) | Дни с последнего использования | Кол-во сессий/действий | Общая сумма оплат |
77
+ | Marketplace | Дни с последней сделки | Кол-во сделок | GMV (объём сделок) |
78
+ | Сервис (офлайн) | Дни с последнего визита | Кол-во визитов | Общая сумма чеков |
79
+
80
+ ### Шаг 1 Определение области данных
81
+ - Определить единицу анализа: клиент / аккаунт / подписчик.
82
+ - Определить «транзакцию» для данной бизнес-модели (см. таблицу шага 0).
83
+ - Определить период: начальная и конечная дата.
84
+ - Исключить аномалии: тестовые аккаунты, возвраты, аномальные суммы (>3σ).
85
+
86
+ ### Шаг 2 Recency Score (R)
87
+ 1. Рассчитать дни с последней транзакции для каждого клиента.
88
+ 2. Определить пороги на основе бизнес-цикла:
89
+
90
+ | Score | E-commerce | SaaS (подписка) | Marketplace |
91
+ |:-----:|:----------:|:---------------:|:-----------:|
92
+ | R=5 | 0-30 дней | 0-7 дней | 0-14 дней |
93
+ | R=4 | 31-90 | 8-30 | 15-45 |
94
+ | R=3 | 91-180 | 31-60 | 46-90 |
95
+ | R=2 | 181-365 | 61-120 | 91-180 |
96
+ | R=1 | >365 | >120 | >180 |
97
+
98
+ > Пороги ориентир. Калибровать под реальное распределение (квинтили) если есть данные.
99
+
100
+ ### Шаг 3 Frequency Score (F)
101
+ 1. Подсчитать количество транзакций на клиента за период.
102
+ 2. Разбить на 5 групп (квинтили или бизнес-логика).
103
+ 3. F=5: топ-20% по частоте. F=1: однократная / минимальная.
104
+
105
+ ### Шаг 4 Monetary Score (M)
106
+ 1. Рассчитать общую сумму на клиента за период.
107
+ 2. Разбить на 5 групп (квинтили или бизнес-логика).
108
+ 3. M=5: топ-20% по сумме. M=1: минимальные траты.
109
+ 4. Для SaaS с фиксированной подпиской: заменить M на **Engagement Score** (глубина использования: фичи, интеграции, кол-во пользователей в аккаунте).
110
+
111
+ ### Шаг 5 — Сегментация
112
+ Присвоить каждому клиенту RFM-код (111-555) и сгруппировать:
113
+
114
+ | Сегмент | RFM-диапазон | Описание | Типичная доля |
115
+ |---------|:------------:|----------|:-------------:|
116
+ | **Champions** | R=5, F=4-5, M=4-5 | Лучшие клиенты, покупают часто и много | 5-10% |
117
+ | **Loyal Customers** | R=4-5, F=3-5, M=3-5 | Регулярные и ценные | 10-15% |
118
+ | **Potential Loyalists** | R=4-5, F=1-3, M=1-3 | Новые с потенциалом роста | 10-15% |
119
+ | **Recent Customers** | R=5, F=1, M=1 | Только пришли, первая покупка | 5-10% |
120
+ | **Promising** | R=3-4, F=1-2, M=1-2 | Есть интерес, нужна активация | 10-15% |
121
+ | **Need Attention** | R=3, F=3, M=3 | Средние, рискуют уйти | 5-10% |
122
+ | **About to Sleep** | R=2-3, F=1-2, M=1-2 | Теряют интерес | 10-15% |
123
+ | **At Risk** | R=1-2, F=3-5, M=3-5 | Были активны и ценны, уходят | 5-10% |
124
+ | **Cannot Lose** | R=1, F=5, M=5 | VIP, которые ушли — критично вернуть | 1-3% |
125
+ | **Hibernating** | R=1-2, F=1-2, M=1-2 | Давно неактивны, низкая ценность | 10-15% |
126
+ | **Lost** | R=1, F=1, M=1 | Потеряны | 5-10% |
127
+
128
+ ### Шаг 6 Оценка ценности сегментов
129
+ Для каждого сегмента рассчитать:
130
+
131
+ | Сегмент | % базы | % выручки | Ср. LTV | Revenue/клиент | Приоритет бюджета |
132
+ |---------|:------:|:---------:|:-------:|:--------------:|:-----------------:|
133
+ | Champions | X% | X% | $XXX | $XXX | Высокий (удержание) |
134
+ | At Risk | X% | X% | $XXX | $XXX | Высокий (реактивация) |
135
+ | Lost | X% | X% | $XXX | $XXX | Низкий (отпустить) |
136
+
137
+ **Правило Парето:** обычно Champions + Loyal = 15-25% базы, но 60-80% выручки. Если распределение другое — зафиксировать как аномалию.
138
+
139
+ ### Шаг 7 — Стратегия и персонализация по сегментам
140
+
141
+ | Сегмент | Цель | Действие | Канал | Тон | Предложение | KPI |
142
+ |---------|------|----------|-------|-----|-------------|-----|
143
+ | Champions | Удержание + адвокация | Эксклюзивный доступ, реферальная программа | Email, personal | Благодарный, VIP | Ранний доступ, бонус за реферал | NPS, referral rate |
144
+ | Loyal | Upsell + лояльность | Кросс-продажи, программа лояльности | Email, in-app | Дружеский, экспертный | Upgrade, bundle | ARPU, retention |
145
+ | Potential Loyalists | Вовлечение + онбординг | Guided onboarding, серия обучающих писем | Email, in-app | Поддерживающий | Бонус за 2-ю покупку | F→2+, activation |
146
+ | Recent | Активация | Welcome-серия, aha-moment | Email, push | Приветливый | Промокод на 2-й заказ | Day-7 retention |
147
+ | At Risk | Реактивация | «Мы скучаем», специальное предложение | Email, SMS | Заботливый, срочный | Скидка 20%, персональный оффер | Win-back rate |
148
+ | Cannot Lose | Срочная реактивация | Звонок менеджера, персональное предложение | Звонок, email | Личный, VIP | Максимальная скидка, upgrade | Win-back rate |
149
+ | Lost | Win-back или отпустить | Финальное письмо, опрос причины ухода | Email | Нейтральный | Опрос + последний шанс | Churn reason data |
150
+
151
+ ### Шаг 8 — Миграционный анализ
152
+ Отслеживать перемещение клиентов между сегментами:
153
+
154
+ 1. Сравнить RFM-сегменты за текущий и предыдущий период:
155
+
156
+ | Миграция | Количество | % | Интерпретация | Действие |
157
+ |----------|:----------:|:-:|---------------|----------|
158
+ | Champions At Risk | [N] | X% | Потеря лучших клиентов — критично | Немедленная реактивация |
159
+ | Potential Loyalists → Loyal | [N] | X% | Здоровый рост — онбординг работает | Масштабировать подход |
160
+ | At Risk Lost | [N] | X% | Реактивация не сработала | Пересмотреть стратегию |
161
+ | Recent → Promising | [N] | X% | Активация работает | Продолжать |
162
+
163
+ 2. Ключевые миграции для мониторинга:
164
+ - **Негативные:** Champions/Loyal → At Risk, At Risk → Lost, Potential → Hibernating.
165
+ - **Позитивные:** Recent → Potential → Loyal → Champions.
166
+ 3. Рекомендуемая частота пересчёта:
167
+
168
+ | Бизнес-модель | Частота |
169
+ |---------------|---------|
170
+ | E-commerce (FMCG) | Еженедельно |
171
+ | E-commerce (дорогие товары) | Ежемесячно |
172
+ | SaaS | Ежемесячно |
173
+ | Marketplace | Раз в 2 недели |
174
+ | Сервис (офлайн) | Ежеквартально |
175
+
176
+ ## Пример E-commerce: магазин спортивного питания
177
+
178
+ **Контекст:** Онлайн-магазин спортивного питания, B2C, 12 000 клиентов, период 12 мес. Средний чек $45, средняя частота 3.2 покупки/год.
179
+
180
+ ### Шкала оценки
181
+
182
+ | Метрика | 5 | 4 | 3 | 2 | 1 |
183
+ |---------|:-:|:-:|:-:|:-:|:-:|
184
+ | **Recency** (дни) | 0-30 | 31-60 | 61-120 | 121-240 | >240 |
185
+ | **Frequency** (заказов) | ≥6 | 4-5 | 3 | 2 | 1 |
186
+ | **Monetary** ($) | >$300 | $200-300 | $100-200 | $50-100 | <$50 |
187
+
188
+ ### Сегменты
189
+
190
+ | Сегмент | % базы | % выручки | Кол-во | Ср. LTV | Стратегия |
191
+ |---------|:------:|:---------:|:------:|:-------:|-----------|
192
+ | Champions | 8% | 35% | 960 | $520 | Реферальная программа, VIP-доступ |
193
+ | Loyal | 12% | 28% | 1440 | $340 | Upsell на подписку, программа лояльности |
194
+ | Potential Loyalists | 11% | 8% | 1320 | $105 | Онбординг: «3-й заказ = бесплатная доставка» |
195
+ | At Risk | 7% | 12% | 840 | $250 | «Мы скучаем» + скидка 15% на любимую категорию |
196
+ | Cannot Lose | 2% | 5% | 240 | $360 | Звонок менеджера, персональный оффер |
197
+ | Lost | 15% | 2% | 1800 | $25 | Финальный email + опрос причины ухода |
198
+
199
+ **Проверка Парето:** Champions + Loyal = 20% базы, 63% выручки ✅ (здоровое распределение).
200
+
201
+ ### Миграционный анализ (мес. мес.)
202
+
203
+ | Миграция | Кол-во | % | Сигнал |
204
+ |----------|:------:|:-:|--------|
205
+ | Champions At Risk | 45 | 4.7% | 🔴 Потеря VIP — запустить win-back |
206
+ | Potential Loyal | 180 | 13.6% | 🟢 Онбординг работает |
207
+ | At Risk Lost | 120 | 14.3% | 🟡 Реактивация недостаточно эффективна |
208
+
209
+ **Рекомендация:** Champions At Risk = 4.7% выше бенчмарка (3%). Расследовать: цена? качество? конкурент?
210
+
211
+ ## Валидация (Quality Gate)
212
+
213
+ - [ ] Определены все три метрики (R, F, M) с чёткими порогами, адаптированными под бизнес-модель
214
+ - [ ] Пороги квинтилей обоснованы бизнес-циклом (или квинтилями реальных данных)
215
+ - [ ] Выделены минимум 6 именованных сегментов с RFM-диапазонами
216
+ - [ ] Для каждого сегмента: стратегия, действие, канал, тон, KPI
217
+ - [ ] Ценность сегментов оценена: % базы, % выручки, средний LTV
218
+ - [ ] Парето-проверка: Champions + Loyal ≈ 15-25% базы, 60-80% выручки
219
+ - [ ] Миграционный анализ: ключевые переходы между сегментами зафиксированы
220
+ - [ ] Частота пересчёта рекомендована для данной бизнес-модели
221
+ - [ ] Если данные моделированные — явно указано с источниками бенчмарков
222
+ - [ ] Нет логических противоречий в сегментации (RFM-коды корректны)
223
+ - [ ] Источники данных указаны; данные старше 12 мес помечены ⚠️
224
+
225
+ > Если валидация не пройдена доработать до повторного прохождения, а не передавать дальше.
226
+
227
+ ## Handoff
228
+ Результат `$rfm-analysis` является входом для:
229
+ - **Стратег / Медиатор** сегменты клиентов для стратегических решений.
230
+ - **`unit-economics`** LTV по сегментам, retention rates, бюджет на реактивацию.
231
+ - **`cohort-analysis`** группировка по когортам внутри сегментов.
232
+ - **`customer-journey-mapping`** точки оттока для At Risk / About to Sleep.
233
+ - **`icp-buyer-persona`**профиль Champions = эталон ICP.
234
+
235
+ Формат передачи: таблица сегментов (% базы, % выручки, LTV) + стратегии + миграционный анализ. При передаче — использовать `$handoff`.
236
+
237
+ ## Anti-patterns
238
+
239
+ | Ошибка | Почему плохо | Как правильно |
240
+ |--------|-------------|---------------|
241
+ | Одинаковые пороги для всех бизнесов | У SaaS и e-commerce разные циклы покупки | Калибровать пороги под бизнес-модель (таблица шаг 0) |
242
+ | Моделированные данные без пометки | Решения на основе гипотез, а не фактов | Явно помечать, указывать источники бенчмарков |
243
+ | Слишком много сегментов (>11) | Невозможно создать уникальную стратегию для каждого | 6-11 именованных сегментов |
244
+ | Сегментация без стратегии | RFM ради RFM, нет actionable-выводов | Каждый сегмент = цель + действие + канал + KPI |
245
+ | Игнорирование M при подписке | В SaaS Monetary менее вариативна | Заменить M на Engagement Score для SaaS |
246
+ | Статичный анализ без миграции | Не видно, как клиенты перемещаются между сегментами | Миграционный анализ: негативные и позитивные переходы |
247
+ | Без персонализации | Одинаковое сообщение для Champions и At Risk | Разный тон, канал, предложение, частота по сегментам |
248
+ | Сегменты без ценности | Непонятно, куда направить бюджет | % базы + % выручки + LTV per segment + Парето-проверка |
249
+ | Бенчмарки без источника | Невозможно верифицировать | Каждый бенчмарк — с источником и датой |
250
+
251
+ ## Шаблон вывода
252
+
253
+ ```
254
+ ### RFM-анализ [Бизнес / Продукт]
255
+
256
+ **Бизнес-модель:** [модель]
257
+ **Период анализа:** [дата — дата]
258
+ **Размер базы:** [N клиентов]
259
+ **Тип данных:** Реальные / Моделированные (бенчмарк: [источник])
260
+ **Дата анализа:** [дата]
261
+
262
+ ---
263
+
264
+ #### Адаптация метрик
265
+
266
+ | Метрика | Определение для данного бизнеса |
267
+ |---------|-------------------------------|
268
+ | Recency | [Что измеряем: дни с последнего X] |
269
+ | Frequency | [Что считаем: кол-во X за период] |
270
+ | Monetary | [Что считаем: сумма X / engagement score] |
271
+
272
+ #### Шкала оценки
273
+
274
+ | Метрика | Score 5 | Score 4 | Score 3 | Score 2 | Score 1 |
275
+ |---------|:-------:|:-------:|:-------:|:-------:|:-------:|
276
+ | **Recency** | 0-[X] | [X]-[X] | [X]-[X] | [X]-[X] | >[X] |
277
+ | **Frequency** | >[X] | [X]-[X] | [X]-[X] | [X]-[X] | [X] |
278
+ | **Monetary** | >[X] | [X]-[X] | [X]-[X] | [X]-[X] | <[X] |
279
+
280
+ ---
281
+
282
+ #### Сегменты клиентов
283
+
284
+ | Сегмент | RFM-диапазон | % базы | % выручки | Кол-во | Ср. LTV | Приоритет |
285
+ |---------|:------------:|:------:|:---------:|:------:|:-------:|:---------:|
286
+ | Champions | R5, F4-5, M4-5 | X% | X% | [N] | $XXX | Высокий |
287
+ | Loyal | R4-5, F3-5, M3-5 | X% | X% | [N] | $XXX | Высокий |
288
+ | ... | ... | ... | ... | ... | ... | ... |
289
+
290
+ **Парето-проверка:** Champions + Loyal = X% базы, X% выручки → [Здоровое / Аномальное]
291
+
292
+ ---
293
+
294
+ #### Стратегия и персонализация
295
+
296
+ | Сегмент | Цель | Действие | Канал | Тон | Предложение | KPI |
297
+ |---------|------|----------|-------|-----|-------------|-----|
298
+ | Champions | [Цель] | [Действие] | [Канал] | [Тон] | [Оффер] | [KPI] |
299
+ | At Risk | [Цель] | [Действие] | [Канал] | [Тон] | [Оффер] | [KPI] |
300
+
301
+ ---
302
+
303
+ #### Миграционный анализ
304
+
305
+ | Миграция | Кол-во | % сегмента | Сигнал | Действие |
306
+ |----------|:------:|:----------:|:------:|----------|
307
+ | Champions At Risk | [N] | X% | 🔴 | [Что делать] |
308
+ | Potential → Loyal | [N] | X% | 🟢 | [Что делать] |
309
+ | At Risk Lost | [N] | X% | 🟡 | [Что делать] |
310
+
311
+ **Частота пересчёта:** [еженедельно / ежемесячно / ежеквартально]
312
+
313
+ ---
314
+
315
+ #### Рекомендации
316
+ 1. **Немедленные:** [At Risk / Cannot Lose — что делать сейчас]
317
+ 2. **Среднесрочные:** [Potential Loyalists — как активировать]
318
+ 3. **Долгосрочные:** [Champions — программа лояльности / адвокации]
319
+ 4. **Пересчёт:** каждые [N] дней
320
+
321
+ ---
322
+
323
+ #### Источники и допущения
324
+
325
+ | # | Факт / допущение | Источник | Дата | Достоверность |
326
+ |---|-------------------|----------|------|:-------------:|
327
+ | 1 | [Факт] | [Источник] | [Дата] | ✅ / ⚠️ / 🔮 |
328
+
329
+ Легенда: ✅ Verified (реальные данные) | ⚠️ Estimated (бенчмарк) | 🔮 Assumed (моделирование)
330
+ ```