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,390 +1,407 @@
1
- ---
2
- name: icp-buyer-persona
3
- description: Ideal customer profile and buyer personas — firmographics, demographics, decision-making process
4
- ---
5
- # ICP / Buyer Persona — Ideal customer profile and buyer personas
6
-
7
- ## When to Use
8
- - When launching a new product or entering a new market — to define the target customer.
9
- - When setting up marketing and sales — for targeting and communication personalization.
10
- - When conversion is low — to rethink who the efforts are directed at.
11
- - When scaling — to refine the ICP for new segments and geographies.
12
-
13
- ## Input
14
-
15
- | Field | Required | Description |
16
- |------|:-----------:|----------|
17
- | Product / service | ✅ | What we offer |
18
- | Business model | ✅ | B2B / B2C / B2B2C / DTC |
19
- | Target geography | ✅ | Markets and regions |
20
- | Pricing model | ⬚ | Subscription / transaction / license |
21
- | Current customers | ⬚ | Description or data of the best current customers |
22
- | CRM data | | Deals, average check, sales cycle, reasons for loss |
23
- | Competitors | ⬚ | Who the customers consider as alternatives |
24
- | Hypotheses | ⬚ | Preliminary assumptions regarding the target audience |
25
-
26
- > If mandatory fields are not provided**request them from the user** before starting the analysis. Do not make assumptions.
27
-
28
- ## Data Sources
29
- 1. **Web Search** — industry reports on demographics / firmographics of the target market.
30
- 2. **CRM data** — profile of the best customers (if provided).
31
- 3. **Competitive analysis** — who competitors are targeting (landing pages, case studies).
32
- 4. **Social platforms** LinkedIn (for B2B), social networks, specialized communities.
33
- 5. **Reviews and feedback** — who leaves reviews, what characteristics they have.
34
-
35
- > For every persona statement specify the data source. Mark data older than 12 months with ⚠️.
36
-
37
- ### Link with Other Skills
38
- | Skill | What we extract | When to call |
39
- |------|-----------|----------------|
40
- | `competitive-analysis` | Who competitors are targeting, whitespace segments (step 2) | If there is no data on competitive targeting |
41
- | `rfm-analysis` | Champions profile as the ICP benchmark (step 2) | If there is CRM data and a data-driven ICP is needed |
42
- | `cohort-analysis` | Cohorts with the best retention — characteristics for ICP (step 2) | If there is cohort data |
43
- | `jtbd-analysis` | Jobs-to-be-done to enrich persona goals and pain points (step 3) | For a deep understanding of motivation |
44
- | `web-research` | Industry data on demographics, firmographics, salaries | If there is no primary data |
45
- | `customer-journey-mapping` | Persona validation through the real customer path | After persona creation — for verification |
46
-
47
- ## Protocol
48
-
49
- ### Step 0Context Gathering
50
- 1. Verify the presence of mandatory data.
51
- 2. Determine the focus:
52
-
53
- | Model | ICP | Personas | Structure |
54
- |--------|:---:|:--------:|-----------|
55
- | B2B | Firmographics | 1-3 by buying role | ICP (company) Personas (people in the company) |
56
- | B2C | Demographics + psychographics | 1-3 by segments | Personas = ICP (they overlap) |
57
- | B2B2C | Both layers | 1-2 B2B + 1-2 B2C | ICP (business partner) + Persona (end user) |
58
-
59
- 3. Determine data availability: data-driven (CRM, cohorts) or hypothesis-driven (interviews, benchmarks).
60
-
61
- ### Step 1 Business Context
62
- 1. Description of the product and key value proposition.
63
- 2. Definition of the business model and unit of sale.
64
- 3. Average check and sales cycle.
65
- 4. Current customer base: who is already buying, who is the best customer.
66
- 5. If there is CRM data call `$rfm-analysis` to define the Champions profile.
67
-
68
- ### Step 2 ICP (Ideal Customer Profile)
69
-
70
- **For B2B** firmographic profile of the ideal client company:
71
-
72
- | Criterion | Ideal | Acceptable | Exception | Source |
73
- |----------|-----------|------------|------------|----------|
74
- | Industry / vertical | [industries] | [industries] | [industries] | [Source] |
75
- | Size (employees) | [range] | [range] | [range] | [Source] |
76
- | ARR / Revenue | [range] | [range] | [range] | [Source] |
77
- | Geography | [regions] | [regions] | [regions] | [Source] |
78
- | Maturity | [stage] | [stage] | [stage] | [Source] |
79
- | Tech stack | [technologies] | [technologies] | [technologies] | [Source] |
80
- | Category budget | [range] | [range] | | [Source] |
81
- | Company pain points | [problems] | — | — | [Source] |
82
-
83
- **For B2C**demographic + psychographic profile:
84
-
85
- | Criterion | Ideal | Acceptable | Exception | Source |
86
- |----------|-----------|------------|------------|----------|
87
- | Age | [range] | [range] | [range] | [Source] |
88
- | Income | [range] | [range] | [range] | [Source] |
89
- | Geography | [regions] | [regions] | [regions] | [Source] |
90
- | Education / profession | [description] | [description] | — | [Source] |
91
- | Interests and values | [description] | | | [Source] |
92
-
93
- ### Step 3 Buyer Personas (1-3 personas)
94
- For each persona a detailed profile:
95
-
96
- | Attribute | Description |
97
- |---------|----------|
98
- | **Name and role** | Archetypal name + title / role |
99
- | **Demographics** | Age, gender, geo, income, education |
100
- | **Professional context** | Title, experience, reporting structure, KPI |
101
- | **Goals and motivations** | What they want to achieve (professionally and personally) |
102
- | **Pains and frustrations** | What hinders them, what they complain about |
103
- | **Behavior** | How they seek solutions, where they consume information |
104
- | **Tech literacy** | Low / Medium / High |
105
- | **Quote** | A phrase reflecting the persona's essence |
106
-
107
- > Every attribute with an indicated source: CRM, interview, benchmark, hypothesis.
108
-
109
- ### Step 4 — Negative Persona (Anti-persona)
110
- Identify 1-2 customer profiles that **should not** be attracted:
111
-
112
- | Attribute | Description |
113
- |---------|----------|
114
- | **Name and role** | Archetypal name |
115
- | **Why not our client** | Reason for exclusion |
116
- | **Typical signs** | How to recognize them early |
117
- | **Cost of a mistake** | What happens if we acquire them (high churn, low LTV, support load) |
118
-
119
- > Negative personas help sales and marketing **avoid wasting resources** on obviously unsuitable clients.
120
-
121
- ### Step 5 Decision-Making Process
122
- For each persona:
123
- - **Buying role** — initiator / influencer / decision maker / user / gatekeeper.
124
- - **Selection criteria**by which parameters they compare solutions.
125
- - **Objections** — typical doubts and barriers.
126
- - **Decision cycle**duration and stages.
127
- - **Environment influence** who else affects the decision.
128
-
129
- ### Step 6 Channels and Touchpoints
130
- For each persona:
131
-
132
- | Channel | Uses | Content format | Effectiveness |
133
- |-------|:----------:|-----------------|:-------------:|
134
- | Google Search | Yes / No | [Articles, reviews] | High / Medium / Low |
135
- | LinkedIn | Yes / No | [Posts, webinars] | ... |
136
- | Conferences | Yes / No | [Speeches, networking] | ... |
137
- | Peer review (colleagues) | Yes / No | [Recommendations] | ... |
138
- | [Others] | ... | ... | ... |
139
-
140
- ### Step 7Messaging per Persona
141
- For each persona:
142
- - **Key message** — one sentence conveying value.
143
- - **Arguments** — 3-5 supporting points.
144
- - **Tone** — formal / friendly / expert.
145
- - **Trigger words** — what attracts them.
146
- - **Stop words**what repels them.
147
-
148
- ### Step 8 — Prioritization
149
- Rank personas according to a scoring model:
150
-
151
- | Criterion | Weight | Scale | Description |
152
- |----------|:---:|:-----:|----------|
153
- | Segment size | 0.20 | 1-10 | How many potential customers |
154
- | LTV (potential) | 0.25 | 1-10 | Expected revenue per customer |
155
- | CAC (inverted) | 0.20 | 1-10 | 10 = cheap to acquire, 1 = expensive |
156
- | Product-market fit | 0.20 | 1-10 | How well the product solves the persona's pains |
157
- | Strategic importance | 0.15 | 1-10 | Brand effect, new market entry, referrals |
158
-
159
- `Priority Score = Σ(weight × score)`. **Priority persona: Score ≥ 7.0.**
160
-
161
- ### Step 9 Persona Validation
162
- Check internal consistency:
163
-
164
- | Check | Test | Result |
165
- |----------|------|:---------:|
166
- | ICP Personas | Personas work in companies fitting the ICP | Yes / No |
167
- | Personas ↔ Negative | Personas do not overlap with anti-personas | Yes / No |
168
- | Pains Product | The product actually solves stated pains | Yes / No |
169
- | Channels ↔ Messaging | The message tone fits the channel | Yes / No |
170
- | Data-backed | 70% of attributes are backed by data (not hypotheses) | Yes / ⚠️ |
171
-
172
- > If Data-backed < 70% mark the persona as **hypothesis-driven**, recommend validation via interviews / A/B testing.
173
-
174
- ## Example B2B SaaS: Recruitment Automation Platform
175
-
176
- **Context:** HR-tech platform, B2B SaaS, per-seat subscription, average check $500/mo, Russian market.
177
-
178
- ### ICP (Firmographics)
179
-
180
- | Criterion | Ideal | Acceptable | Exception | Source |
181
- |----------|-----------|------------|------------|----------|
182
- | Industry | IT, fintech, retail | Manufacturing, logistics | Public sector (long tenders) | CRM: 80% customers |
183
- | Size | 50-500 employees | 20-50 or 500-2000 | < 20 (no HR) | CRM: sweet spot |
184
- | Revenue | $5M-$50M | $1M-$5M | < $1M | Benchmark HH.ru |
185
- | Geography | Moscow, St. Petersburg | Millionaire cities (Russia) | CIS (for now) | CRM: 70% Moscow/SPB |
186
- | Open vacancies | 10+ simultaneously | 5-10 | < 5 (doesn't pay off) | CRM: correlation with LTV |
187
-
188
- ### Buyer Persona 1: "Marina" — HR Director (Priority)
189
-
190
- | Attribute | Description | Source |
191
- |---------|----------|----------|
192
- | **Demographics** | F, 32-42, Moscow/SPB, income 250-400K ₽/mo | LinkedIn, HH.ru |
193
- | **Title** | HR Director / Head of People, reports to CEO | CRM: 65% deals |
194
- | **KPI** | Time-to-hire < 30 days, cost-per-hire < $2K | Interviews (N=8) |
195
- | **Goals** | Close 15+ vacancies in parallel without team burnout | Interviews |
196
- | **Pains** | Manual work in Excel, losing candidates, CEO pressures for speed | Support tickets |
197
- | **Behavior** | Seeks solutions on Google + HR communities in Telegram | Survey (N=120) |
198
- | **Tech literacy** | Medium — confident SaaS user | CRM |
199
- | **Quote** | "I need to close vacancies, not fill out spreadsheets" | Interviews |
200
-
201
- **Decision process:** Decision Maker (budget up to $1K/mo), influencer for $1K+. Cycle: 14-30 days. Objections: "What if it doesn't integrate with HH.ru?", "The team won't use it". Criteria: integration with HH.ru, simplicity, price.
202
-
203
- **Channels:** Google (ATS reviews), HR Telegram (Recruiters chat), conferences (HR API, People Management).
204
-
205
- **Messaging:** "Close vacancies 2x faster — without Excel or manual routine". Tone: expert, hype-free. Triggers: "automation", "integration with HH.ru", "time saving". Stop words: "AI will replace recruiters", "revolution".
206
-
207
- ### Negative Persona: "Oleg" Micro-business CEO
208
-
209
- | Attribute | Description |
210
- |---------|----------|
211
- | **Profile** | CEO of a company < 15 people, hires on his own 1-2 times a year |
212
- | **Why not ours** | No HR dept, vacancies are too rare, subscription won't pay off |
213
- | **Signs** | Registers with personal email, 1 vacancy, asks about a free tier |
214
- | **Cost of mistake** | LTV < CAC ($45 vs $120), 80% churn in M1, support load |
215
-
216
- ### Prioritization
217
-
218
- | Persona | Size (0.20) | LTV (0.25) | Rev. CAC (0.20) | PMF (0.20) | Strateg. (0.15) | **Score** |
219
- |---------|:------------:|:----------:|:---------------:|:----------:|:---------------:|:---------:|
220
- | Marina (HR Dir.) | 7 | 8 | 7 | 9 | 6 | **7.6** |
221
- | Anton (CEO 50-200) | 5 | 9 | 4 | 6 | 8 | **6.4** |
222
-
223
- **Priority:** Marina (7.6) — maximum PMF, accessible via HR channels, solves a direct pain point.
224
-
225
- ## Validation (Quality Gate)
226
-
227
- - [ ] ICP is formulated with clear criteria (ideal / acceptable / exception) and sources
228
- - [ ] 1-3 buyer personas are defined with complete profiles
229
- - [ ] Personas are distinct from each other (no duplication)
230
- - [ ] At least 1 negative persona defined with identifiers and mistake cost
231
- - [ ] Decision-making process described for each persona
232
- - [ ] Channels and touchpoints defined with effectiveness evaluation
233
- - [ ] Messaging tied to specific personas (message, tone, triggers, stop words)
234
- - [ ] Prioritization conducted via a weighted scoring model
235
- - [ ] Consistency validation passed (ICP Personas Negative Product)
236
- - [ ] ≥ 70% of attributes are backed by data; if < 70% — persona is marked hypothesis-driven
237
- - [ ] Data sources are specified; data older than 12 months is marked ⚠️
238
-
239
- > If validation fails — iterate until it passes, do not hand off before that.
240
-
241
- ## Handoff
242
- The result of `$icp-buyer-persona` serves as input for:
243
- - **Strategist / Mediator** — target audience for strategic decisions.
244
- - **`customer-journey-mapping`** personas for journey mapping.
245
- - **`jtbd-analysis`** personas as context for task analysis.
246
- - **`competitive-analysis`** target segments for competitive benchmarking.
247
- - **`tam-sam-som`** SAM/SOM filters based on ICP.
248
- - **`rfm-analysis`** Champions profile to compare against the ICP.
249
-
250
- Delivery format: ICP table + buyer personas + negative persona + prioritization + messaging. Use `$handoff` during transfer.
251
-
252
- ## Anti-patterns
253
-
254
- | Mistake | Why it's bad | Correct approach |
255
- |--------|-------------|---------------|
256
- | ICP = everyone | No focus, dilutes resources | Clear inclusion / exclusion criteria |
257
- | Persona without data | Fantasy, not research | Every attribute has a source; < 70% data = hypothesis-driven |
258
- | Demographics only | People of the same age act differently | Incorporate behavior, motivation, decision process |
259
- | 5+ personas | Impossible to personalize for everyone | Maximum 3, prioritize via scoring |
260
- | ICP for B2C | B2C lacks firmographics, requires a different structure | Demographics + psychographics for B2C |
261
- | No messaging | Personas exist, but how to talk to them is unclear | Key message + tone + triggers + stop words |
262
- | No negative persona | Marketing spends budget on wrong fits | At least 1 anti-persona with identifiers and mistake cost |
263
- | Static profile | The market and customers change | Review every 6 months |
264
- | "Eyeballed" prioritization | Subjective choice, not reproducible | Scoring model with weights and a ≥ 7.0 threshold |
265
-
266
- ## Output Template
267
-
268
- ```
269
- ### ICP / Buyer Persona — [Product / Service]
270
-
271
- **Business Model:** [B2B / B2C / B2B2C]
272
- **Geography:** [markets]
273
- **Pricing Model:** [model]
274
- **Data Type:** Data-driven / Hypothesis-driven
275
- **Date of Analysis:** [date]
276
-
277
- ---
278
-
279
- #### ICP (Ideal Customer Profile)
280
-
281
- ##### B2B Firmographic Profile
282
-
283
- | Criterion | Ideal | Acceptable | Exception | Source |
284
- |----------|-----------|------------|------------|----------|
285
- | Industry | [industries] | [industries] | [industries] | [Source] |
286
- | Size (employees) | [range] | [range] | [range] | [Source] |
287
- | Revenue | [range] | [range] | [range] | [Source] |
288
- | Geography | [regions] | [regions] | [regions] | [Source] |
289
- | Maturity | [stage] | [stage] | [stage] | [Source] |
290
- | Category budget | [range] | [range] | — | [Source] |
291
-
292
- ##### B2C Demographic + Psychographic Profile
293
-
294
- | Criterion | Ideal | Acceptable | Exception | Source |
295
- |----------|-----------|------------|------------|----------|
296
- | Age | [range] | [range] | [range] | [Source] |
297
- | Income | [range] | [range] | [range] | [Source] |
298
- | Geography | [regions] | [regions] | [regions] | [Source] |
299
-
300
- ---
301
-
302
- #### Buyer Persona 1: [Name] [Role] (Priority)
303
-
304
- | Attribute | Description | Source |
305
- |---------|----------|----------|
306
- | **Demographics** | [age, gender, geo, income] | [Source] |
307
- | **Title** | [title, company, experience] | [Source] |
308
- | **KPI** | [success metrics at work] | [Source] |
309
- | **Goals** | [what they want to achieve] | [Source] |
310
- | **Pains** | [what hinders them] | [Source] |
311
- | **Behavior** | [how they seek solutions] | [Source] |
312
- | **Tech literacy**| [level] | [Source] |
313
- | **Quote** | «[phrase]» | [Source] |
314
-
315
- **Decision-Making Process:**
316
- - Buying role: [role]
317
- - Selection criteria: [criteria]
318
- - Objections: [typical doubts]
319
- - Decision cycle: [duration]
320
- - Influence: [who else is involved]
321
-
322
- **Channels:**
323
-
324
- | Channel | Format | Effectiveness |
325
- |-------|--------|:-------------:|
326
- | [Channel] | [Content format] | High / Medium / Low |
327
-
328
- **Messaging:**
329
- - Key message: "[one sentence]"
330
- - Arguments: [3-5 points]
331
- - Tone: [style]
332
- - Triggers: [words] | Stop words: [words]
333
-
334
- ---
335
-
336
- #### Buyer Persona 2: [Name] — [Role]
337
- [Similar structure]
338
-
339
- ---
340
-
341
- #### Negative Persona: [Name] [Role]
342
-
343
- | Attribute | Description |
344
- |---------|----------|
345
- | **Profile** | [Who it is] |
346
- | **Why not our client** | [Reason for exclusion] |
347
- | **Signs** | [How to recognize early] |
348
- | **Mistake cost** | [What is lost: LTV < CAC, churn, support load] |
349
-
350
- ---
351
-
352
- #### Prioritization (Scoring)
353
-
354
- | Persona | Size (0.20) | LTV (0.25) | CAC inv. (0.20) | PMF (0.20) | Strateg. (0.15) | **Score** | **Priority** |
355
- |---------|:------------:|:----------:|:---------------:|:----------:|:---------------:|:---------:|:------------:|
356
- | [Persona 1] | X | X | X | X | X | **X.X** | 1 |
357
- | [Persona 2] | X | X | X | X | X | **X.X** | 2 |
358
-
359
- **Priority Persona:** [Name] (Score X.X) — [justification]
360
-
361
- ---
362
-
363
- #### Consistency Validation
364
-
365
- | Check | Result |
366
- |----------|:---------:|
367
- | ICP ↔ Personas | Yes / No |
368
- | Personas ↔ Negative | Yes / No |
369
- | Pains ↔ Product | Yes / No |
370
- | Channels ↔ Messaging | Yes / No |
371
- | Data-backed 70% | Yes / ⚠️ |
372
-
373
- ---
374
-
375
- #### Sources & Assumptions
376
-
377
- | # | Fact / assumption | Source | Date | Reliability |
378
- |---|-------------------|----------|------|:-------------:|
379
- | 1 | [Fact] | [Source] | [Date] | ✅ / ⚠️ / 🔮 |
380
-
381
- Legend: ✅ Verified (CRM / interviews N≥5) | ⚠️ Estimated (benchmark / 1 source) | 🔮 Assumed (hypothesis)
382
-
383
- ---
384
-
385
- #### Recommendations
386
- - **→ Strategist:** [key takeaway]
387
- - **→ $customer-journey-mapping:** [persona for mapping]
388
- - **→ $competitive-analysis:** [target segments for benchmarking]
389
- - **Review:** in 6 months or upon product/market changes
390
- ```
1
+ ---
2
+ name: icp-buyer-persona
3
+ description: Ideal customer profile and buyer personas — firmographics, demographics, decision-making process
4
+ type: triggered
5
+ domain: analytics
6
+ owners:
7
+ - strategist
8
+ gates:
9
+ - STRATEGIST
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - "icp-buyer-persona"
14
+ - "ICP"
15
+ - "buyer persona"
16
+ - "идеальный клиент"
17
+ - "покупательская персона"
18
+ related: []
19
+ budget_lines: 407
20
+ schema_version: 1
21
+ ---
22
+ # ICP / Buyer Persona Ideal customer profile and buyer personas
23
+
24
+ ## When to Use
25
+ - When launching a new product or entering a new market — to define the target customer.
26
+ - When setting up marketing and salesfor targeting and communication personalization.
27
+ - When conversion is low — to rethink who the efforts are directed at.
28
+ - When scaling — to refine the ICP for new segments and geographies.
29
+
30
+ ## Input
31
+
32
+ | Field | Required | Description |
33
+ |------|:-----------:|----------|
34
+ | Product / service | ✅ | What we offer |
35
+ | Business model | | B2B / B2C / B2B2C / DTC |
36
+ | Target geography | ✅ | Markets and regions |
37
+ | Pricing model | ⬚ | Subscription / transaction / license |
38
+ | Current customers | | Description or data of the best current customers |
39
+ | CRM data | ⬚ | Deals, average check, sales cycle, reasons for loss |
40
+ | Competitors | | Who the customers consider as alternatives |
41
+ | Hypotheses | | Preliminary assumptions regarding the target audience |
42
+
43
+ > If mandatory fields are not provided **request them from the user** before starting the analysis. Do not make assumptions.
44
+
45
+ ## Data Sources
46
+ 1. **Web Search** — industry reports on demographics / firmographics of the target market.
47
+ 2. **CRM data** — profile of the best customers (if provided).
48
+ 3. **Competitive analysis** — who competitors are targeting (landing pages, case studies).
49
+ 4. **Social platforms**LinkedIn (for B2B), social networks, specialized communities.
50
+ 5. **Reviews and feedback** who leaves reviews, what characteristics they have.
51
+
52
+ > For every persona statement — specify the data source. Mark data older than 12 months with ⚠️.
53
+
54
+ ### Link with Other Skills
55
+ | Skill | What we extract | When to call |
56
+ |------|-----------|----------------|
57
+ | `competitive-analysis` | Who competitors are targeting, whitespace segments (step 2) | If there is no data on competitive targeting |
58
+ | `rfm-analysis` | Champions profile as the ICP benchmark (step 2) | If there is CRM data and a data-driven ICP is needed |
59
+ | `cohort-analysis` | Cohorts with the best retention — characteristics for ICP (step 2) | If there is cohort data |
60
+ | `jtbd-analysis` | Jobs-to-be-done to enrich persona goals and pain points (step 3) | For a deep understanding of motivation |
61
+ | `web-research` | Industry data on demographics, firmographics, salaries | If there is no primary data |
62
+ | `customer-journey-mapping` | Persona validation through the real customer path | After persona creation — for verification |
63
+
64
+ ## Protocol
65
+
66
+ ### Step 0Context Gathering
67
+ 1. Verify the presence of mandatory data.
68
+ 2. Determine the focus:
69
+
70
+ | Model | ICP | Personas | Structure |
71
+ |--------|:---:|:--------:|-----------|
72
+ | B2B | Firmographics | 1-3 by buying role | ICP (company) → Personas (people in the company) |
73
+ | B2C | Demographics + psychographics | 1-3 by segments | Personas = ICP (they overlap) |
74
+ | B2B2C | Both layers | 1-2 B2B + 1-2 B2C | ICP (business partner) + Persona (end user) |
75
+
76
+ 3. Determine data availability: data-driven (CRM, cohorts) or hypothesis-driven (interviews, benchmarks).
77
+
78
+ ### Step 1 Business Context
79
+ 1. Description of the product and key value proposition.
80
+ 2. Definition of the business model and unit of sale.
81
+ 3. Average check and sales cycle.
82
+ 4. Current customer base: who is already buying, who is the best customer.
83
+ 5. If there is CRM data call `$rfm-analysis` to define the Champions profile.
84
+
85
+ ### Step 2 ICP (Ideal Customer Profile)
86
+
87
+ **For B2B** firmographic profile of the ideal client company:
88
+
89
+ | Criterion | Ideal | Acceptable | Exception | Source |
90
+ |----------|-----------|------------|------------|----------|
91
+ | Industry / vertical | [industries] | [industries] | [industries] | [Source] |
92
+ | Size (employees) | [range] | [range] | [range] | [Source] |
93
+ | ARR / Revenue | [range] | [range] | [range] | [Source] |
94
+ | Geography | [regions] | [regions] | [regions] | [Source] |
95
+ | Maturity | [stage] | [stage] | [stage] | [Source] |
96
+ | Tech stack | [technologies] | [technologies] | [technologies] | [Source] |
97
+ | Category budget | [range] | [range] | — | [Source] |
98
+ | Company pain points | [problems] | | | [Source] |
99
+
100
+ **For B2C** demographic + psychographic profile:
101
+
102
+ | Criterion | Ideal | Acceptable | Exception | Source |
103
+ |----------|-----------|------------|------------|----------|
104
+ | Age | [range] | [range] | [range] | [Source] |
105
+ | Income | [range] | [range] | [range] | [Source] |
106
+ | Geography | [regions] | [regions] | [regions] | [Source] |
107
+ | Education / profession | [description] | [description] | | [Source] |
108
+ | Interests and values | [description] | — | — | [Source] |
109
+
110
+ ### Step 3 Buyer Personas (1-3 personas)
111
+ For each persona — a detailed profile:
112
+
113
+ | Attribute | Description |
114
+ |---------|----------|
115
+ | **Name and role** | Archetypal name + title / role |
116
+ | **Demographics** | Age, gender, geo, income, education |
117
+ | **Professional context** | Title, experience, reporting structure, KPI |
118
+ | **Goals and motivations** | What they want to achieve (professionally and personally) |
119
+ | **Pains and frustrations** | What hinders them, what they complain about |
120
+ | **Behavior** | How they seek solutions, where they consume information |
121
+ | **Tech literacy** | Low / Medium / High |
122
+ | **Quote** | A phrase reflecting the persona's essence |
123
+
124
+ > Every attributewith an indicated source: CRM, interview, benchmark, hypothesis.
125
+
126
+ ### Step 4Negative Persona (Anti-persona)
127
+ Identify 1-2 customer profiles that **should not** be attracted:
128
+
129
+ | Attribute | Description |
130
+ |---------|----------|
131
+ | **Name and role** | Archetypal name |
132
+ | **Why not our client** | Reason for exclusion |
133
+ | **Typical signs** | How to recognize them early |
134
+ | **Cost of a mistake** | What happens if we acquire them (high churn, low LTV, support load) |
135
+
136
+ > Negative personas help sales and marketing **avoid wasting resources** on obviously unsuitable clients.
137
+
138
+ ### Step 5 Decision-Making Process
139
+ For each persona:
140
+ - **Buying role**initiator / influencer / decision maker / user / gatekeeper.
141
+ - **Selection criteria** — by which parameters they compare solutions.
142
+ - **Objections** — typical doubts and barriers.
143
+ - **Decision cycle** — duration and stages.
144
+ - **Environment influence** — who else affects the decision.
145
+
146
+ ### Step 6Channels and Touchpoints
147
+ For each persona:
148
+
149
+ | Channel | Uses | Content format | Effectiveness |
150
+ |-------|:----------:|-----------------|:-------------:|
151
+ | Google Search | Yes / No | [Articles, reviews] | High / Medium / Low |
152
+ | LinkedIn | Yes / No | [Posts, webinars] | ... |
153
+ | Conferences | Yes / No | [Speeches, networking] | ... |
154
+ | Peer review (colleagues) | Yes / No | [Recommendations] | ... |
155
+ | [Others] | ... | ... | ... |
156
+
157
+ ### Step 7 Messaging per Persona
158
+ For each persona:
159
+ - **Key message** one sentence conveying value.
160
+ - **Arguments** — 3-5 supporting points.
161
+ - **Tone**formal / friendly / expert.
162
+ - **Trigger words** — what attracts them.
163
+ - **Stop words** — what repels them.
164
+
165
+ ### Step 8 — Prioritization
166
+ Rank personas according to a scoring model:
167
+
168
+ | Criterion | Weight | Scale | Description |
169
+ |----------|:---:|:-----:|----------|
170
+ | Segment size | 0.20 | 1-10 | How many potential customers |
171
+ | LTV (potential) | 0.25 | 1-10 | Expected revenue per customer |
172
+ | CAC (inverted) | 0.20 | 1-10 | 10 = cheap to acquire, 1 = expensive |
173
+ | Product-market fit | 0.20 | 1-10 | How well the product solves the persona's pains |
174
+ | Strategic importance | 0.15 | 1-10 | Brand effect, new market entry, referrals |
175
+
176
+ `Priority Score = Σ(weight × score)`. **Priority persona: Score 7.0.**
177
+
178
+ ### Step 9 — Persona Validation
179
+ Check internal consistency:
180
+
181
+ | Check | Test | Result |
182
+ |----------|------|:---------:|
183
+ | ICP Personas | Personas work in companies fitting the ICP | Yes / No |
184
+ | Personas Negative | Personas do not overlap with anti-personas | Yes / No |
185
+ | Pains Product | The product actually solves stated pains | Yes / No |
186
+ | Channels Messaging | The message tone fits the channel | Yes / No |
187
+ | Data-backed | ≥ 70% of attributes are backed by data (not hypotheses) | Yes / ⚠️ |
188
+
189
+ > If Data-backed < 70% — mark the persona as **hypothesis-driven**, recommend validation via interviews / A/B testing.
190
+
191
+ ## Example — B2B SaaS: Recruitment Automation Platform
192
+
193
+ **Context:** HR-tech platform, B2B SaaS, per-seat subscription, average check $500/mo, Russian market.
194
+
195
+ ### ICP (Firmographics)
196
+
197
+ | Criterion | Ideal | Acceptable | Exception | Source |
198
+ |----------|-----------|------------|------------|----------|
199
+ | Industry | IT, fintech, retail | Manufacturing, logistics | Public sector (long tenders) | CRM: 80% customers |
200
+ | Size | 50-500 employees | 20-50 or 500-2000 | < 20 (no HR) | CRM: sweet spot |
201
+ | Revenue | $5M-$50M | $1M-$5M | < $1M | Benchmark HH.ru |
202
+ | Geography | Moscow, St. Petersburg | Millionaire cities (Russia) | CIS (for now) | CRM: 70% Moscow/SPB |
203
+ | Open vacancies | 10+ simultaneously | 5-10 | < 5 (doesn't pay off) | CRM: correlation with LTV |
204
+
205
+ ### Buyer Persona 1: "Marina" HR Director (Priority)
206
+
207
+ | Attribute | Description | Source |
208
+ |---------|----------|----------|
209
+ | **Demographics** | F, 32-42, Moscow/SPB, income 250-400K ₽/mo | LinkedIn, HH.ru |
210
+ | **Title** | HR Director / Head of People, reports to CEO | CRM: 65% deals |
211
+ | **KPI** | Time-to-hire < 30 days, cost-per-hire < $2K | Interviews (N=8) |
212
+ | **Goals** | Close 15+ vacancies in parallel without team burnout | Interviews |
213
+ | **Pains** | Manual work in Excel, losing candidates, CEO pressures for speed | Support tickets |
214
+ | **Behavior** | Seeks solutions on Google + HR communities in Telegram | Survey (N=120) |
215
+ | **Tech literacy** | Medium — confident SaaS user | CRM |
216
+ | **Quote** | "I need to close vacancies, not fill out spreadsheets" | Interviews |
217
+
218
+ **Decision process:** Decision Maker (budget up to $1K/mo), influencer for $1K+. Cycle: 14-30 days. Objections: "What if it doesn't integrate with HH.ru?", "The team won't use it". Criteria: integration with HH.ru, simplicity, price.
219
+
220
+ **Channels:** Google (ATS reviews), HR Telegram (Recruiters chat), conferences (HR API, People Management).
221
+
222
+ **Messaging:** "Close vacancies 2x faster — without Excel or manual routine". Tone: expert, hype-free. Triggers: "automation", "integration with HH.ru", "time saving". Stop words: "AI will replace recruiters", "revolution".
223
+
224
+ ### Negative Persona: "Oleg" — Micro-business CEO
225
+
226
+ | Attribute | Description |
227
+ |---------|----------|
228
+ | **Profile** | CEO of a company < 15 people, hires on his own 1-2 times a year |
229
+ | **Why not ours** | No HR dept, vacancies are too rare, subscription won't pay off |
230
+ | **Signs** | Registers with personal email, 1 vacancy, asks about a free tier |
231
+ | **Cost of mistake** | LTV < CAC ($45 vs $120), 80% churn in M1, support load |
232
+
233
+ ### Prioritization
234
+
235
+ | Persona | Size (0.20) | LTV (0.25) | Rev. CAC (0.20) | PMF (0.20) | Strateg. (0.15) | **Score** |
236
+ |---------|:------------:|:----------:|:---------------:|:----------:|:---------------:|:---------:|
237
+ | Marina (HR Dir.) | 7 | 8 | 7 | 9 | 6 | **7.6** |
238
+ | Anton (CEO 50-200) | 5 | 9 | 4 | 6 | 8 | **6.4** |
239
+
240
+ **Priority:** Marina (7.6) — maximum PMF, accessible via HR channels, solves a direct pain point.
241
+
242
+ ## Validation (Quality Gate)
243
+
244
+ - [ ] ICP is formulated with clear criteria (ideal / acceptable / exception) and sources
245
+ - [ ] 1-3 buyer personas are defined with complete profiles
246
+ - [ ] Personas are distinct from each other (no duplication)
247
+ - [ ] At least 1 negative persona defined with identifiers and mistake cost
248
+ - [ ] Decision-making process described for each persona
249
+ - [ ] Channels and touchpoints defined with effectiveness evaluation
250
+ - [ ] Messaging tied to specific personas (message, tone, triggers, stop words)
251
+ - [ ] Prioritization conducted via a weighted scoring model
252
+ - [ ] Consistency validation passed (ICP ↔ Personas ↔ Negative ↔ Product)
253
+ - [ ] ≥ 70% of attributes are backed by data; if < 70% — persona is marked hypothesis-driven
254
+ - [ ] Data sources are specified; data older than 12 months is marked ⚠️
255
+
256
+ > If validation fails iterate until it passes, do not hand off before that.
257
+
258
+ ## Handoff
259
+ The result of `$icp-buyer-persona` serves as input for:
260
+ - **Strategist / Mediator** target audience for strategic decisions.
261
+ - **`customer-journey-mapping`** personas for journey mapping.
262
+ - **`jtbd-analysis`** personas as context for task analysis.
263
+ - **`competitive-analysis`** target segments for competitive benchmarking.
264
+ - **`tam-sam-som`** SAM/SOM filters based on ICP.
265
+ - **`rfm-analysis`** — Champions profile to compare against the ICP.
266
+
267
+ Delivery format: ICP table + buyer personas + negative persona + prioritization + messaging. Use `$handoff` during transfer.
268
+
269
+ ## Anti-patterns
270
+
271
+ | Mistake | Why it's bad | Correct approach |
272
+ |--------|-------------|---------------|
273
+ | ICP = everyone | No focus, dilutes resources | Clear inclusion / exclusion criteria |
274
+ | Persona without data | Fantasy, not research | Every attribute has a source; < 70% data = hypothesis-driven |
275
+ | Demographics only | People of the same age act differently | Incorporate behavior, motivation, decision process |
276
+ | 5+ personas | Impossible to personalize for everyone | Maximum 3, prioritize via scoring |
277
+ | ICP for B2C | B2C lacks firmographics, requires a different structure | Demographics + psychographics for B2C |
278
+ | No messaging | Personas exist, but how to talk to them is unclear | Key message + tone + triggers + stop words |
279
+ | No negative persona | Marketing spends budget on wrong fits | At least 1 anti-persona with identifiers and mistake cost |
280
+ | Static profile | The market and customers change | Review every 6 months |
281
+ | "Eyeballed" prioritization | Subjective choice, not reproducible | Scoring model with weights and a ≥ 7.0 threshold |
282
+
283
+ ## Output Template
284
+
285
+ ```
286
+ ### ICP / Buyer Persona [Product / Service]
287
+
288
+ **Business Model:** [B2B / B2C / B2B2C]
289
+ **Geography:** [markets]
290
+ **Pricing Model:** [model]
291
+ **Data Type:** Data-driven / Hypothesis-driven
292
+ **Date of Analysis:** [date]
293
+
294
+ ---
295
+
296
+ #### ICP (Ideal Customer Profile)
297
+
298
+ ##### B2B Firmographic Profile
299
+
300
+ | Criterion | Ideal | Acceptable | Exception | Source |
301
+ |----------|-----------|------------|------------|----------|
302
+ | Industry | [industries] | [industries] | [industries] | [Source] |
303
+ | Size (employees) | [range] | [range] | [range] | [Source] |
304
+ | Revenue | [range] | [range] | [range] | [Source] |
305
+ | Geography | [regions] | [regions] | [regions] | [Source] |
306
+ | Maturity | [stage] | [stage] | [stage] | [Source] |
307
+ | Category budget | [range] | [range] | — | [Source] |
308
+
309
+ ##### B2C Demographic + Psychographic Profile
310
+
311
+ | Criterion | Ideal | Acceptable | Exception | Source |
312
+ |----------|-----------|------------|------------|----------|
313
+ | Age | [range] | [range] | [range] | [Source] |
314
+ | Income | [range] | [range] | [range] | [Source] |
315
+ | Geography | [regions] | [regions] | [regions] | [Source] |
316
+
317
+ ---
318
+
319
+ #### Buyer Persona 1: [Name] — [Role] (Priority)
320
+
321
+ | Attribute | Description | Source |
322
+ |---------|----------|----------|
323
+ | **Demographics** | [age, gender, geo, income] | [Source] |
324
+ | **Title** | [title, company, experience] | [Source] |
325
+ | **KPI** | [success metrics at work] | [Source] |
326
+ | **Goals** | [what they want to achieve] | [Source] |
327
+ | **Pains** | [what hinders them] | [Source] |
328
+ | **Behavior** | [how they seek solutions] | [Source] |
329
+ | **Tech literacy**| [level] | [Source] |
330
+ | **Quote** | «[phrase]» | [Source] |
331
+
332
+ **Decision-Making Process:**
333
+ - Buying role: [role]
334
+ - Selection criteria: [criteria]
335
+ - Objections: [typical doubts]
336
+ - Decision cycle: [duration]
337
+ - Influence: [who else is involved]
338
+
339
+ **Channels:**
340
+
341
+ | Channel | Format | Effectiveness |
342
+ |-------|--------|:-------------:|
343
+ | [Channel] | [Content format] | High / Medium / Low |
344
+
345
+ **Messaging:**
346
+ - Key message: "[one sentence]"
347
+ - Arguments: [3-5 points]
348
+ - Tone: [style]
349
+ - Triggers: [words] | Stop words: [words]
350
+
351
+ ---
352
+
353
+ #### Buyer Persona 2: [Name] — [Role]
354
+ [Similar structure]
355
+
356
+ ---
357
+
358
+ #### Negative Persona: [Name] — [Role]
359
+
360
+ | Attribute | Description |
361
+ |---------|----------|
362
+ | **Profile** | [Who it is] |
363
+ | **Why not our client** | [Reason for exclusion] |
364
+ | **Signs** | [How to recognize early] |
365
+ | **Mistake cost** | [What is lost: LTV < CAC, churn, support load] |
366
+
367
+ ---
368
+
369
+ #### Prioritization (Scoring)
370
+
371
+ | Persona | Size (0.20) | LTV (0.25) | CAC inv. (0.20) | PMF (0.20) | Strateg. (0.15) | **Score** | **Priority** |
372
+ |---------|:------------:|:----------:|:---------------:|:----------:|:---------------:|:---------:|:------------:|
373
+ | [Persona 1] | X | X | X | X | X | **X.X** | 1 |
374
+ | [Persona 2] | X | X | X | X | X | **X.X** | 2 |
375
+
376
+ **Priority Persona:** [Name] (Score X.X) — [justification]
377
+
378
+ ---
379
+
380
+ #### Consistency Validation
381
+
382
+ | Check | Result |
383
+ |----------|:---------:|
384
+ | ICP ↔ Personas | Yes / No |
385
+ | Personas ↔ Negative | Yes / No |
386
+ | Pains Product | Yes / No |
387
+ | Channels Messaging | Yes / No |
388
+ | Data-backed 70% | Yes / ⚠️ |
389
+
390
+ ---
391
+
392
+ #### Sources & Assumptions
393
+
394
+ | # | Fact / assumption | Source | Date | Reliability |
395
+ |---|-------------------|----------|------|:-------------:|
396
+ | 1 | [Fact] | [Source] | [Date] | ✅ / ⚠️ / 🔮 |
397
+
398
+ Legend: ✅ Verified (CRM / interviews N≥5) | ⚠️ Estimated (benchmark / 1 source) | 🔮 Assumed (hypothesis)
399
+
400
+ ---
401
+
402
+ #### Recommendations
403
+ - **→ Strategist:** [key takeaway]
404
+ - **→ $customer-journey-mapping:** [persona for mapping]
405
+ - **→ $competitive-analysis:** [target segments for benchmarking]
406
+ - **Review:** in 6 months or upon product/market changes
407
+ ```