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,341 +1,357 @@
1
- ---
2
- name: jtbd-analysis
3
- description: Analysis of customer jobs — functional, emotional, social jobs, and opportunity score
4
- ---
5
- # Jobs To Be Done — Customer Jobs Analysis
6
-
7
- ## When to Use
8
- - During new product development — to identify the real jobs the customer is trying to get done.
9
- - When prioritizing features — to determine which jobs are underserved and represent the greatest opportunity.
10
- - When evaluating a value proposition — to understand what the customer is actually willing to pay for.
11
- - When churn is high — to find out which jobs the product fails to solve or solves poorly.
12
-
13
- ## Input
14
-
15
- | Field | Required | Description |
16
- |-------|:--------:|-------------|
17
- | Product / service | ✅ | What is being analyzed |
18
- | Target audience | ✅ | Who the customer is (from `$icp-buyer-persona` or description) |
19
- | Usage context | ✅ | In what situation the customer uses the product |
20
- | Existing data | ⬚ | Interviews, surveys, reviews, support tickets |
21
- | Competitors | | Alternatives the customer currently uses |
22
- | Job hypotheses | ⬚ | Preliminary assumptions from the team |
23
-
24
- > If mandatory fields are not provided **request them from the user** before starting the analysis. Do not make assumptions.
25
-
26
- ## Data Sources
27
- 1. **Web Search**customer reviews, forum discussions, video reviews.
28
- 2. **Reviews** — App Store, Google Play, G2, Capterra, Trustpilot, Amazon Reviews.
29
- 3. **Forums & Communities** — Reddit, Quora, Stack Overflow, thematic groups.
30
- 4. **Competitive Analysis** — how competitors position their solutions (what Jobs they address).
31
- 5. **Customer Data** interviews, surveys, CRM data, support tickets.
32
-
33
- > For each Job at least 1 source confirming its existence. Mark data older than 12 months with ⚠️.
34
-
35
- ### Integration with Other Skills
36
- | Skill | What We Take | When to Trigger |
37
- |-------|--------------|-----------------|
38
- | `icp-buyer-persona` | Personas, goals, pains, context (steps 0-1) | If the target audience is undefined |
39
- | `competitive-analysis` | How competitors address Jobs, white spaces (step 7) | To identify competing solutions |
40
- | `customer-journey-mapping` | Points where Jobs arise in the customer journey (step 1) | To link Jobs to journey stages |
41
- | `web-research` | Reviews, discussions, customer pain points | If primary data (interviews/surveys) is lacking |
42
- | `blue-ocean-strategy` | ERRC factors to create new value | If underserved Jobs require a radically new solution |
43
- | `cohort-analysis` | Correlation between Jobs and retention (step 8) | If needed to understand which Jobs impact retention |
44
-
45
- ## Protocol
46
-
47
- ### Step 0Context Gathering
48
- 1. Verify the availability of required input data.
49
- 2. Determine the level of analysis: the entire product or a specific feature / scenario.
50
- 3. Determine data type: primary (interviews, surveys) or secondary (reviews, forums, benchmarks).
51
- 4. If the persona is undefined — trigger `$icp-buyer-persona`.
52
-
53
- ### Step 1 — Defining Context (When / Where / Why)
54
- - **When:** in what situation the need arises (trigger).
55
- - **Where:** physical and digital context of use.
56
- - **Why:** what progress the customer wants to achieve.
57
- - Formulate a context statement: "When [situation], I want to [progress], so I can [result]."
58
-
59
- ### Step 2 Functional Jobs
60
- Determine the practical tasks the customer is trying to accomplish:
61
- - **Main Job** — the primary goal (one).
62
- - **Related Jobs** — what else needs to be done in that context (2-5).
63
- - **Consumption Chain Jobs** purchasing, setting up, learning, maintaining (2-4).
64
- - Formulation: **verb + object + context** (without tying it to a specific solution).
65
-
66
- > Correctness test: if the wording contains a product name, brand, or technology it is a Feature, not a Job. Reformulate.
67
-
68
- ### Step 3 — Emotional Jobs
69
- Determine how the customer wants to feel:
70
- - Confidence, control, peace of mind.
71
- - Satisfaction, pride, achievement.
72
- - Relief from anxiety, stress, uncertainty.
73
- - Formulation: "Feel [emotion] when [context]."
74
-
75
- ### Step 4Social Jobs
76
- Determine how the customer wants to be perceived by others:
77
- - Professionalism, expertise, competence.
78
- - Innovation, progressiveness.
79
- - Reliability, responsibility.
80
- - Formulation: "Be perceived as [quality] by [audience]."
81
-
82
- ### Step 5Job Map (Main Job Steps)
83
- Break down the Main Job using the Universal Job Map:
84
-
85
- | Step | Description | Analysis Question |
86
- |------|-------------|-------------------|
87
- | 1. **Define** | Determine what needs to be done | How does the customer formulate the goal? What objectives are set? |
88
- | 2. **Locate** | Find resources and inputs | What needs to be found/gathered before execution? |
89
- | 3. **Prepare** | Get ready to execute | How does the customer prepare the environment, tools, data? |
90
- | 4. **Confirm** | Verify readiness | How do they check that everything is in place? |
91
- | 5. **Execute** | Perform the task | What exactly are they doing? What are the steps? |
92
- | 6. **Monitor** | Track progress | How do they know things are on track? |
93
- | 7. **Modify** | Correct issues if they arise | What do they do if something goes wrong? |
94
- | 8. **Conclude** | Finish the task | How is the result finalized? What happens next? |
95
-
96
- For each step: what the customer does now, where the friction is, what can be improved.
97
-
98
- ### Step 6Prioritization (Importance vs Satisfaction)
99
- Score each Job on two scales (1-10):
100
- - **Importance** — how important this job is to the customer.
101
- - **Satisfaction** how well current solutions get the job done.
102
-
103
- | Zone | Condition | Interpretation |
104
- |------|-----------|----------------|
105
- | **Underserved** | High Importance + Low Satisfaction | Core opportunity customer wants it but isn't getting it |
106
- | **Served** | Importance Satisfaction | Current level is sufficient |
107
- | **Overserved** | Low Importance + High Satisfaction | Over-invested could be simplified |
108
-
109
- ### Step 7 Outcome Expectations
110
- Define expected outcomes for each priority Job:
111
-
112
- | Job | Outcome | Metric | Minimum | Ideal | Current Level | Gap |
113
- |-----|---------|--------|:-------:|:-----:|:-------------:|:---:|
114
- | [F1] | [Result] | [How to measure] | [Value] | [Value] | [Value] | [Δ] |
115
-
116
- - Metrics: speed, quality, cost, convenience, reliability.
117
- - Gap = Ideal Current Level. The larger the Gap, the larger the opportunity.
118
-
119
- ### Step 8 Competing Solutions
120
- For each Job:
121
-
122
- | Job | Direct Competitor | Indirect | DIY | "Do nothing" |
123
- |-----|-------------------|----------|-----|--------------|
124
- | [F1] | [Product A] | [Category B] | [Excel, manual process] | [Consequences: loses X] |
125
-
126
- - **Switching triggers:** what will cause the customer to switch from their current solution.
127
- - **Barriers:** what keeps them on the current solution (habit, switching costs, fear).
128
-
129
- ### Step 9 — Opportunity Score
130
- Calculate the Opportunity Score for each Job:
131
-
132
- **Formula:** `Opportunity = Importance + max(Importance - Satisfaction, 0)`
133
-
134
- | Threshold | Status | Recommendation |
135
- |:---------:|--------|----------------|
136
- | > 15 | 🔴 Underserved | Priority — high potential for the product |
137
- | 10-15 | 🟡 Served | Maintain, seek targeted improvements |
138
- | < 10 | 🟢 Overserved | Do not invest, consider simplifying |
139
-
140
- Rank all Jobs by Opportunity Score.
141
-
142
- ### Step 10 Jobs Product Opportunities
143
- Translate underserved Jobs into specific product opportunities:
144
-
145
- | # | Underserved Job | Opportunity Score | Job Map Friction | Product Opportunity | Type |
146
- |---|-----------------|:-----------------:|------------------|---------------------|:----:|
147
- | 1 | [F1] | XX | [Job Map step with friction] | [What the product can do] | Feature / Improvement / New Product |
148
-
149
- - **Feature** — add functionality addressing a specific Job Map step.
150
- - **Improvement** improve an existing feature (reduce friction).
151
- - **New Product** — if the Job requires a fundamentally new solution → trigger `$blue-ocean-strategy`.
152
-
153
- ## Example SaaS: Recruiting Automation Platform
154
-
155
- **Context:** HR platform, persona "Marina" (HR Director, 50-200 employees, 15+ open roles).
156
-
157
- ### Context Statement
158
- > When a company has 15+ open roles simultaneously, the HR Director wants to quickly close positions with suitable candidates so that the business does not lose money due to unfilled roles.
159
-
160
- ### Functional Jobs
161
-
162
- | # | Job | Imp. | Sat. | Opp. | Status |
163
- |---|-----|:----:|:----:|:----:|:------:|
164
- | F1 | Filter suitable candidates from a resume stream (15+ roles) | 9 | 4 | **14** | 🔴 Underserved |
165
- | F2 | Approve a candidate with the hiring manager in 1-2 days | 8 | 3 | **13** | 🔴 Underserved |
166
- | F3 | Track the status of all current open roles in one place | 7 | 5 | **9** | 🟢 Overserved |
167
- | F4 | Import roles and resumes from external sources (e.g. Indeed) | 8 | 2 | **14** | 🔴 Underserved |
168
- | F5 | Prepare a hiring efficiency report for the CEO | 6 | 4 | **8** | 🟢 Overserved |
169
-
170
- ### Emotional Jobs
171
-
172
- | # | Job | Imp. | Sat. | Opp. |
173
- |---|-----|:----:|:----:|:----:|
174
- | E1 | Feel in control when managing 15+ roles simultaneously | 9 | 3 | **15** 🔴 |
175
- | E2 | Relieve anxiety about a candidate getting "lost" in the process | 8 | 4 | **12** 🟡 |
176
-
177
- ### Social Jobs
178
-
179
- | # | Job | Imp. | Sat. | Opp. |
180
- |---|-----|:----:|:----:|:----:|
181
- | S1 | Be perceived as an effective HR leader by the CEO | 8 | 5 | **11** 🟡 |
182
- | S2 | Demonstrate a tech-savvy approach in front of the team | 6 | 6 | **6** 🟢 |
183
-
184
- ### Job Map Main Job (F1: Filter candidates)
185
-
186
- | Step | Current Behavior | Friction | Opportunity |
187
- |------|------------------|----------|-------------|
188
- | Define | Formulates requirements mentally | No standardized template → vague criteria | Requirements template with must/nice-to-have |
189
- | Locate | Searches for resumes manually | Manual search for 15 roles = 3h/day | Auto-import via API |
190
- | Prepare | Copies resumes into Excel | Formatting breaks, no unified view | Auto-parsing of resumes |
191
- | Confirm | Visually checks for fit | Highly subjective, misses candidates | AI-scoring based on criteria |
192
- | Execute | Emails the manager | Manager forgets, no SLAs | In-app approvals with deadlines |
193
- | Monitor | Asks the manager via chat | Zero visibility into status | Dashboard with a pipeline |
194
-
195
- ### Jobs Product Opportunities
196
-
197
- | # | Job | Opp. | Friction | Opportunity | Type |
198
- |---|-----|:----:|----------|-------------|:----:|
199
- | 1 | F4: Import from external sources | 14 | Locate: manual search 3h/day | API integration | Feature |
200
- | 2 | F1: Filter candidates | 14 | Confirm: subjective scoring | AI-scoring by must/nice-to-have | Feature |
201
- | 3 | F2: Approve with manager | 13 | Execute: email without SLA | In-app approvals with deadlines | Improvement |
202
-
203
- ## Validation (Quality Gate)
204
-
205
- - [ ] Identified at least 5 functional jobs formulated as "verb + object + context"
206
- - [ ] Identified at least 3 emotional jobs
207
- - [ ] Identified at least 2 social jobs
208
- - [ ] All jobs formulated without tying them to a specific solution (test: no product names)
209
- - [ ] Job Map built for the Main Job (8 steps of the Universal Job Map)
210
- - [ ] For each Job Map step: current behavior, friction, and opportunity defined
211
- - [ ] Prioritization via Importance × Satisfaction is completed
212
- - [ ] Opportunity Score calculated, Jobs ranked
213
- - [ ] Competing solutions (4 levels) and switching triggers defined for each priority Job
214
- - [ ] Outcome Expectations defined with metrics, minimum, ideal, and gap
215
- - [ ] Underserved Jobs translated into product opportunities
216
- - [ ] Data sources cited; data older than 12 months marked with ⚠️
217
-
218
- > If validation fails — revise and refine until it passes, rather than proceeding to the next step.
219
-
220
- ## Handoff
221
- The output of `$jtbd-analysis` serves as input for:
222
- - **Strategist / Product Manager** priority Jobs for product strategy.
223
- - **`icp-buyer-persona`** enriching personas with jobs and expectations.
224
- - **`competitive-analysis`** competing solutions for benchmarking.
225
- - **`customer-journey-mapping`** jobs at each stage of the customer journey.
226
- - **`unit-economics`** willingness to pay based on the value of jobs to be done.
227
- - **`blue-ocean-strategy`** if underserved Jobs require a radically new solution.
228
-
229
- Handoff format: ranked list of Jobs with Opportunity Scores + Job Map + product opportunities. Use `$handoff` to transfer context.
230
-
231
- ## Anti-patterns
232
-
233
- | Error | Why it's bad | Correct Approach |
234
- |-------|--------------|------------------|
235
- | Job is tied to a solution | "Wants to use our API" is a Feature, not a Job | Frame via progress: "verb + object + context" |
236
- | Only functional Jobs | Emotional and social context are ignored | Always analyze all three types |
237
- | Without prioritization | All Jobs appear equally important | Importance × Satisfaction → Opportunity Score |
238
- | Free of competing solutions | Unclear what we are competing against | For each Job: direct, indirect, DIY, "do nothing" |
239
- | Excessively abstract Jobs | "Wants to be successful" is not actionable | Specific context: "close 15 roles in 30 days" |
240
- | Confusing Job and Feature | Job = customer's task, Feature = provider's solution | Separate layers, translate via Job Map |
241
- | Without Outcome Expectations | Unclear how to measure success | Metric + minimum + ideal + current level + gap |
242
- | Missing Job Map | Unclear where the exact friction points lie | Universal Job Map: 8 steps for the Main Job |
243
- | Opportunity Score without actions | We know it's underserved, but don't know what to do | Jobs Product Opportunities with type: feature / improvement / new product |
244
-
245
- ## Output Template
246
-
247
- ```markdown
248
- ### Jobs To Be Done — [Product / Service]
249
-
250
- **Target Audience:** [who]
251
- **Context:** [situation]
252
- **Data Type:** Primary (interviews N=X) / Secondary (reviews, forums)
253
- **Date of Analysis:** [date]
254
-
255
- ---
256
-
257
- #### Context Statement
258
- > When [situation], [persona] wants to [progress], so they can [result].
259
-
260
- ---
261
-
262
- #### Job Hierarchy
263
-
264
- ##### Functional Jobs
265
-
266
- | # | Job | Imp. (1-10) | Sat. (1-10) | Opp. Score | Status | Source |
267
- |---|-----|:-----------:|:-----------:|:----------:|:------:|--------|
268
- | F1 | [Main Job: verb + object + context] | X | X | XX | 🔴/🟡/🟢 | [Source] |
269
- | F2 | [Related Job] | X | X | XX | 🔴/🟡/🟢 | [Source] |
270
-
271
- ##### Emotional Jobs
272
-
273
- | # | Job | Imp. | Sat. | Opp. | Source |
274
- |---|-----|:----:|:----:|:----:|--------|
275
- | E1 | Feel [emotion] when [context] | X | X | XX | [Source] |
276
-
277
- ##### Social Jobs
278
-
279
- | # | Job | Imp. | Sat. | Opp. | Source |
280
- |---|-----|:----:|:----:|:----:|--------|
281
- | S1 | Be perceived as [quality] by [audience] | X | X | XX | [Source] |
282
-
283
- ---
284
-
285
- #### Job Map Main Job ([F1])
286
-
287
- | Step | Current Behavior | Friction | Opportunity |
288
- |------|------------------|----------|-------------|
289
- | Define | [Description] | [Problem] | [Solution] |
290
- | Locate | [Description] | [Problem] | [Solution] |
291
- | Prepare | [Description] | [Problem] | [Solution] |
292
- | Confirm | [Description] | [Problem] | [Solution] |
293
- | Execute | [Description] | [Problem] | [Solution] |
294
- | Monitor | [Description] | [Problem] | [Solution] |
295
- | Modify | [Description] | [Problem] | [Solution] |
296
- | Conclude | [Description] | [Problem] | [Solution] |
297
-
298
- ---
299
-
300
- #### Opportunity Score Matrix
301
-
302
- | Zone | Jobs | Opp. Score | Recommendation |
303
- |------|------|:----------:|----------------|
304
- | 🔴 Underserved (>15) | [F1, E1, ...] | XX-XX | Priority for development |
305
- | 🟡 Served (10-15) | [F2, S1, ...] | XX-XX | Maintain, targeted improvements |
306
- | 🟢 Overserved (<10) | [F3, ...] | XX-XX | Do not invest, consider simplifying |
307
-
308
- ---
309
-
310
- #### Competing Solutions
311
-
312
- | Job | Direct | Indirect | DIY | "Nothing" | Switching Trigger |
313
- |-----|--------|----------|-----|-----------|-------------------|
314
- | [F1] | [Product] | [Category] | [Method] | [Consequences] | [What will cause a switch] |
315
-
316
- ---
317
-
318
- #### Outcome Expectations (Top 3 Jobs)
319
-
320
- | Job | Outcome | Metric | Minimum | Ideal | Current | Gap |
321
- |-----|---------|--------|:-------:|:-----:|:-------:|:---:|
322
- | [F1] | [Result] | [Metric] | [Value] | [Value] | [Value] | [Δ] |
323
-
324
- ---
325
-
326
- #### Jobs → Product Opportunities
327
-
328
- | # | Underserved Job | Opp. | Job Map Friction | Opportunity | Type |
329
- |---|-----------------|:----:|------------------|-------------|:----:|
330
- | 1 | [F1] | XX | [Step: problem] | [What to do] | Feature / Improvement / New Product |
331
-
332
- ---
333
-
334
- #### Sources and Assumptions
335
-
336
- | # | Fact / Assumption | Source | Date | Reliability |
337
- |---|-------------------|--------|------|:-----------:|
338
- | 1 | [Fact] | [Source] | [Date] | / ⚠️ / 🔮 |
339
-
340
- Legend: ✅ Verified (interviews N≥5 / product data) | ⚠️ Estimated (reviews / 1 source) | 🔮 Assumed (hypothesis)
341
- ```
1
+ ---
2
+ name: jtbd-analysis
3
+ description: Analysis of customer jobs — functional, emotional, social jobs, and opportunity score
4
+ type: triggered
5
+ domain: analytics
6
+ owners:
7
+ - strategist
8
+ gates:
9
+ - STRATEGIST
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - "jtbd-analysis"
14
+ - "JTBD"
15
+ - "Jobs To Be Done"
16
+ - "задачи клиента"
17
+ related: []
18
+ budget_lines: 357
19
+ schema_version: 1
20
+ ---
21
+ # Jobs To Be Done Customer Jobs Analysis
22
+
23
+ ## When to Use
24
+ - During new product developmentto identify the real jobs the customer is trying to get done.
25
+ - When prioritizing features — to determine which jobs are underserved and represent the greatest opportunity.
26
+ - When evaluating a value proposition — to understand what the customer is actually willing to pay for.
27
+ - When churn is high to find out which jobs the product fails to solve or solves poorly.
28
+
29
+ ## Input
30
+
31
+ | Field | Required | Description |
32
+ |-------|:--------:|-------------|
33
+ | Product / service | | What is being analyzed |
34
+ | Target audience | ✅ | Who the customer is (from `$icp-buyer-persona` or description) |
35
+ | Usage context | ✅ | In what situation the customer uses the product |
36
+ | Existing data | | Interviews, surveys, reviews, support tickets |
37
+ | Competitors | ⬚ | Alternatives the customer currently uses |
38
+ | Job hypotheses | | Preliminary assumptions from the team |
39
+
40
+ > If mandatory fields are not provided **request them from the user** before starting the analysis. Do not make assumptions.
41
+
42
+ ## Data Sources
43
+ 1. **Web Search** customer reviews, forum discussions, video reviews.
44
+ 2. **Reviews** — App Store, Google Play, G2, Capterra, Trustpilot, Amazon Reviews.
45
+ 3. **Forums & Communities** — Reddit, Quora, Stack Overflow, thematic groups.
46
+ 4. **Competitive Analysis** — how competitors position their solutions (what Jobs they address).
47
+ 5. **Customer Data**interviews, surveys, CRM data, support tickets.
48
+
49
+ > For each Job at least 1 source confirming its existence. Mark data older than 12 months with ⚠️.
50
+
51
+ ### Integration with Other Skills
52
+ | Skill | What We Take | When to Trigger |
53
+ |-------|--------------|-----------------|
54
+ | `icp-buyer-persona` | Personas, goals, pains, context (steps 0-1) | If the target audience is undefined |
55
+ | `competitive-analysis` | How competitors address Jobs, white spaces (step 7) | To identify competing solutions |
56
+ | `customer-journey-mapping` | Points where Jobs arise in the customer journey (step 1) | To link Jobs to journey stages |
57
+ | `web-research` | Reviews, discussions, customer pain points | If primary data (interviews/surveys) is lacking |
58
+ | `blue-ocean-strategy` | ERRC factors to create new value | If underserved Jobs require a radically new solution |
59
+ | `cohort-analysis` | Correlation between Jobs and retention (step 8) | If needed to understand which Jobs impact retention |
60
+
61
+ ## Protocol
62
+
63
+ ### Step 0Context Gathering
64
+ 1. Verify the availability of required input data.
65
+ 2. Determine the level of analysis: the entire product or a specific feature / scenario.
66
+ 3. Determine data type: primary (interviews, surveys) or secondary (reviews, forums, benchmarks).
67
+ 4. If the persona is undefined — trigger `$icp-buyer-persona`.
68
+
69
+ ### Step 1 Defining Context (When / Where / Why)
70
+ - **When:** in what situation the need arises (trigger).
71
+ - **Where:** physical and digital context of use.
72
+ - **Why:** what progress the customer wants to achieve.
73
+ - Formulate a context statement: "When [situation], I want to [progress], so I can [result]."
74
+
75
+ ### Step 2Functional Jobs
76
+ Determine the practical tasks the customer is trying to accomplish:
77
+ - **Main Job** — the primary goal (one).
78
+ - **Related Jobs** — what else needs to be done in that context (2-5).
79
+ - **Consumption Chain Jobs** — purchasing, setting up, learning, maintaining (2-4).
80
+ - Formulation: **verb + object + context** (without tying it to a specific solution).
81
+
82
+ > Correctness test: if the wording contains a product name, brand, or technology it is a Feature, not a Job. Reformulate.
83
+
84
+ ### Step 3 — Emotional Jobs
85
+ Determine how the customer wants to feel:
86
+ - Confidence, control, peace of mind.
87
+ - Satisfaction, pride, achievement.
88
+ - Relief from anxiety, stress, uncertainty.
89
+ - Formulation: "Feel [emotion] when [context]."
90
+
91
+ ### Step 4 Social Jobs
92
+ Determine how the customer wants to be perceived by others:
93
+ - Professionalism, expertise, competence.
94
+ - Innovation, progressiveness.
95
+ - Reliability, responsibility.
96
+ - Formulation: "Be perceived as [quality] by [audience]."
97
+
98
+ ### Step 5Job Map (Main Job Steps)
99
+ Break down the Main Job using the Universal Job Map:
100
+
101
+ | Step | Description | Analysis Question |
102
+ |------|-------------|-------------------|
103
+ | 1. **Define** | Determine what needs to be done | How does the customer formulate the goal? What objectives are set? |
104
+ | 2. **Locate** | Find resources and inputs | What needs to be found/gathered before execution? |
105
+ | 3. **Prepare** | Get ready to execute | How does the customer prepare the environment, tools, data? |
106
+ | 4. **Confirm** | Verify readiness | How do they check that everything is in place? |
107
+ | 5. **Execute** | Perform the task | What exactly are they doing? What are the steps? |
108
+ | 6. **Monitor** | Track progress | How do they know things are on track? |
109
+ | 7. **Modify** | Correct issues if they arise | What do they do if something goes wrong? |
110
+ | 8. **Conclude** | Finish the task | How is the result finalized? What happens next? |
111
+
112
+ For each step: what the customer does now, where the friction is, what can be improved.
113
+
114
+ ### Step 6 Prioritization (Importance vs Satisfaction)
115
+ Score each Job on two scales (1-10):
116
+ - **Importance** how important this job is to the customer.
117
+ - **Satisfaction** how well current solutions get the job done.
118
+
119
+ | Zone | Condition | Interpretation |
120
+ |------|-----------|----------------|
121
+ | **Underserved** | High Importance + Low Satisfaction | Core opportunity — customer wants it but isn't getting it |
122
+ | **Served** | Importance Satisfaction | Current level is sufficient |
123
+ | **Overserved** | Low Importance + High Satisfaction | Over-invested — could be simplified |
124
+
125
+ ### Step 7 — Outcome Expectations
126
+ Define expected outcomes for each priority Job:
127
+
128
+ | Job | Outcome | Metric | Minimum | Ideal | Current Level | Gap |
129
+ |-----|---------|--------|:-------:|:-----:|:-------------:|:---:|
130
+ | [F1] | [Result] | [How to measure] | [Value] | [Value] | [Value] | [Δ] |
131
+
132
+ - Metrics: speed, quality, cost, convenience, reliability.
133
+ - Gap = Ideal − Current Level. The larger the Gap, the larger the opportunity.
134
+
135
+ ### Step 8 — Competing Solutions
136
+ For each Job:
137
+
138
+ | Job | Direct Competitor | Indirect | DIY | "Do nothing" |
139
+ |-----|-------------------|----------|-----|--------------|
140
+ | [F1] | [Product A] | [Category B] | [Excel, manual process] | [Consequences: loses X] |
141
+
142
+ - **Switching triggers:** what will cause the customer to switch from their current solution.
143
+ - **Barriers:** what keeps them on the current solution (habit, switching costs, fear).
144
+
145
+ ### Step 9 Opportunity Score
146
+ Calculate the Opportunity Score for each Job:
147
+
148
+ **Formula:** `Opportunity = Importance + max(Importance - Satisfaction, 0)`
149
+
150
+ | Threshold | Status | Recommendation |
151
+ |:---------:|--------|----------------|
152
+ | > 15 | 🔴 Underserved | Priority — high potential for the product |
153
+ | 10-15 | 🟡 Served | Maintain, seek targeted improvements |
154
+ | < 10 | 🟢 Overserved | Do not invest, consider simplifying |
155
+
156
+ Rank all Jobs by Opportunity Score.
157
+
158
+ ### Step 10 Jobs Product Opportunities
159
+ Translate underserved Jobs into specific product opportunities:
160
+
161
+ | # | Underserved Job | Opportunity Score | Job Map Friction | Product Opportunity | Type |
162
+ |---|-----------------|:-----------------:|------------------|---------------------|:----:|
163
+ | 1 | [F1] | XX | [Job Map step with friction] | [What the product can do] | Feature / Improvement / New Product |
164
+
165
+ - **Feature** add functionality addressing a specific Job Map step.
166
+ - **Improvement** improve an existing feature (reduce friction).
167
+ - **New Product** if the Job requires a fundamentally new solution trigger `$blue-ocean-strategy`.
168
+
169
+ ## Example — SaaS: Recruiting Automation Platform
170
+
171
+ **Context:** HR platform, persona "Marina" (HR Director, 50-200 employees, 15+ open roles).
172
+
173
+ ### Context Statement
174
+ > When a company has 15+ open roles simultaneously, the HR Director wants to quickly close positions with suitable candidates so that the business does not lose money due to unfilled roles.
175
+
176
+ ### Functional Jobs
177
+
178
+ | # | Job | Imp. | Sat. | Opp. | Status |
179
+ |---|-----|:----:|:----:|:----:|:------:|
180
+ | F1 | Filter suitable candidates from a resume stream (15+ roles) | 9 | 4 | **14** | 🔴 Underserved |
181
+ | F2 | Approve a candidate with the hiring manager in 1-2 days | 8 | 3 | **13** | 🔴 Underserved |
182
+ | F3 | Track the status of all current open roles in one place | 7 | 5 | **9** | 🟢 Overserved |
183
+ | F4 | Import roles and resumes from external sources (e.g. Indeed) | 8 | 2 | **14** | 🔴 Underserved |
184
+ | F5 | Prepare a hiring efficiency report for the CEO | 6 | 4 | **8** | 🟢 Overserved |
185
+
186
+ ### Emotional Jobs
187
+
188
+ | # | Job | Imp. | Sat. | Opp. |
189
+ |---|-----|:----:|:----:|:----:|
190
+ | E1 | Feel in control when managing 15+ roles simultaneously | 9 | 3 | **15** 🔴 |
191
+ | E2 | Relieve anxiety about a candidate getting "lost" in the process | 8 | 4 | **12** 🟡 |
192
+
193
+ ### Social Jobs
194
+
195
+ | # | Job | Imp. | Sat. | Opp. |
196
+ |---|-----|:----:|:----:|:----:|
197
+ | S1 | Be perceived as an effective HR leader by the CEO | 8 | 5 | **11** 🟡 |
198
+ | S2 | Demonstrate a tech-savvy approach in front of the team | 6 | 6 | **6** 🟢 |
199
+
200
+ ### Job Map — Main Job (F1: Filter candidates)
201
+
202
+ | Step | Current Behavior | Friction | Opportunity |
203
+ |------|------------------|----------|-------------|
204
+ | Define | Formulates requirements mentally | No standardized template → vague criteria | Requirements template with must/nice-to-have |
205
+ | Locate | Searches for resumes manually | Manual search for 15 roles = 3h/day | Auto-import via API |
206
+ | Prepare | Copies resumes into Excel | Formatting breaks, no unified view | Auto-parsing of resumes |
207
+ | Confirm | Visually checks for fit | Highly subjective, misses candidates | AI-scoring based on criteria |
208
+ | Execute | Emails the manager | Manager forgets, no SLAs | In-app approvals with deadlines |
209
+ | Monitor | Asks the manager via chat | Zero visibility into status | Dashboard with a pipeline |
210
+
211
+ ### Jobs Product Opportunities
212
+
213
+ | # | Job | Opp. | Friction | Opportunity | Type |
214
+ |---|-----|:----:|----------|-------------|:----:|
215
+ | 1 | F4: Import from external sources | 14 | Locate: manual search 3h/day | API integration | Feature |
216
+ | 2 | F1: Filter candidates | 14 | Confirm: subjective scoring | AI-scoring by must/nice-to-have | Feature |
217
+ | 3 | F2: Approve with manager | 13 | Execute: email without SLA | In-app approvals with deadlines | Improvement |
218
+
219
+ ## Validation (Quality Gate)
220
+
221
+ - [ ] Identified at least 5 functional jobs formulated as "verb + object + context"
222
+ - [ ] Identified at least 3 emotional jobs
223
+ - [ ] Identified at least 2 social jobs
224
+ - [ ] All jobs formulated without tying them to a specific solution (test: no product names)
225
+ - [ ] Job Map built for the Main Job (8 steps of the Universal Job Map)
226
+ - [ ] For each Job Map step: current behavior, friction, and opportunity defined
227
+ - [ ] Prioritization via Importance × Satisfaction is completed
228
+ - [ ] Opportunity Score calculated, Jobs ranked
229
+ - [ ] Competing solutions (4 levels) and switching triggers defined for each priority Job
230
+ - [ ] Outcome Expectations defined with metrics, minimum, ideal, and gap
231
+ - [ ] Underserved Jobs translated into product opportunities
232
+ - [ ] Data sources cited; data older than 12 months marked with ⚠️
233
+
234
+ > If validation fails — revise and refine until it passes, rather than proceeding to the next step.
235
+
236
+ ## Handoff
237
+ The output of `$jtbd-analysis` serves as input for:
238
+ - **Strategist / Product Manager** priority Jobs for product strategy.
239
+ - **`icp-buyer-persona`** enriching personas with jobs and expectations.
240
+ - **`competitive-analysis`** competing solutions for benchmarking.
241
+ - **`customer-journey-mapping`** jobs at each stage of the customer journey.
242
+ - **`unit-economics`** willingness to pay based on the value of jobs to be done.
243
+ - **`blue-ocean-strategy`** if underserved Jobs require a radically new solution.
244
+
245
+ Handoff format: ranked list of Jobs with Opportunity Scores + Job Map + product opportunities. Use `$handoff` to transfer context.
246
+
247
+ ## Anti-patterns
248
+
249
+ | Error | Why it's bad | Correct Approach |
250
+ |-------|--------------|------------------|
251
+ | Job is tied to a solution | "Wants to use our API" is a Feature, not a Job | Frame via progress: "verb + object + context" |
252
+ | Only functional Jobs | Emotional and social context are ignored | Always analyze all three types |
253
+ | Without prioritization | All Jobs appear equally important | Importance × Satisfaction → Opportunity Score |
254
+ | Free of competing solutions | Unclear what we are competing against | For each Job: direct, indirect, DIY, "do nothing" |
255
+ | Excessively abstract Jobs | "Wants to be successful" is not actionable | Specific context: "close 15 roles in 30 days" |
256
+ | Confusing Job and Feature | Job = customer's task, Feature = provider's solution | Separate layers, translate via Job Map |
257
+ | Without Outcome Expectations | Unclear how to measure success | Metric + minimum + ideal + current level + gap |
258
+ | Missing Job Map | Unclear where the exact friction points lie | Universal Job Map: 8 steps for the Main Job |
259
+ | Opportunity Score without actions | We know it's underserved, but don't know what to do | Jobs → Product Opportunities with type: feature / improvement / new product |
260
+
261
+ ## Output Template
262
+
263
+ ```markdown
264
+ ### Jobs To Be Done — [Product / Service]
265
+
266
+ **Target Audience:** [who]
267
+ **Context:** [situation]
268
+ **Data Type:** Primary (interviews N=X) / Secondary (reviews, forums)
269
+ **Date of Analysis:** [date]
270
+
271
+ ---
272
+
273
+ #### Context Statement
274
+ > When [situation], [persona] wants to [progress], so they can [result].
275
+
276
+ ---
277
+
278
+ #### Job Hierarchy
279
+
280
+ ##### Functional Jobs
281
+
282
+ | # | Job | Imp. (1-10) | Sat. (1-10) | Opp. Score | Status | Source |
283
+ |---|-----|:-----------:|:-----------:|:----------:|:------:|--------|
284
+ | F1 | [Main Job: verb + object + context] | X | X | XX | 🔴/🟡/🟢 | [Source] |
285
+ | F2 | [Related Job] | X | X | XX | 🔴/🟡/🟢 | [Source] |
286
+
287
+ ##### Emotional Jobs
288
+
289
+ | # | Job | Imp. | Sat. | Opp. | Source |
290
+ |---|-----|:----:|:----:|:----:|--------|
291
+ | E1 | Feel [emotion] when [context] | X | X | XX | [Source] |
292
+
293
+ ##### Social Jobs
294
+
295
+ | # | Job | Imp. | Sat. | Opp. | Source |
296
+ |---|-----|:----:|:----:|:----:|--------|
297
+ | S1 | Be perceived as [quality] by [audience] | X | X | XX | [Source] |
298
+
299
+ ---
300
+
301
+ #### Job Map — Main Job ([F1])
302
+
303
+ | Step | Current Behavior | Friction | Opportunity |
304
+ |------|------------------|----------|-------------|
305
+ | Define | [Description] | [Problem] | [Solution] |
306
+ | Locate | [Description] | [Problem] | [Solution] |
307
+ | Prepare | [Description] | [Problem] | [Solution] |
308
+ | Confirm | [Description] | [Problem] | [Solution] |
309
+ | Execute | [Description] | [Problem] | [Solution] |
310
+ | Monitor | [Description] | [Problem] | [Solution] |
311
+ | Modify | [Description] | [Problem] | [Solution] |
312
+ | Conclude | [Description] | [Problem] | [Solution] |
313
+
314
+ ---
315
+
316
+ #### Opportunity Score Matrix
317
+
318
+ | Zone | Jobs | Opp. Score | Recommendation |
319
+ |------|------|:----------:|----------------|
320
+ | 🔴 Underserved (>15) | [F1, E1, ...] | XX-XX | Priority for development |
321
+ | 🟡 Served (10-15) | [F2, S1, ...] | XX-XX | Maintain, targeted improvements |
322
+ | 🟢 Overserved (<10) | [F3, ...] | XX-XX | Do not invest, consider simplifying |
323
+
324
+ ---
325
+
326
+ #### Competing Solutions
327
+
328
+ | Job | Direct | Indirect | DIY | "Nothing" | Switching Trigger |
329
+ |-----|--------|----------|-----|-----------|-------------------|
330
+ | [F1] | [Product] | [Category] | [Method] | [Consequences] | [What will cause a switch] |
331
+
332
+ ---
333
+
334
+ #### Outcome Expectations (Top 3 Jobs)
335
+
336
+ | Job | Outcome | Metric | Minimum | Ideal | Current | Gap |
337
+ |-----|---------|--------|:-------:|:-----:|:-------:|:---:|
338
+ | [F1] | [Result] | [Metric] | [Value] | [Value] | [Value] | [Δ] |
339
+
340
+ ---
341
+
342
+ #### Jobs → Product Opportunities
343
+
344
+ | # | Underserved Job | Opp. | Job Map Friction | Opportunity | Type |
345
+ |---|-----------------|:----:|------------------|-------------|:----:|
346
+ | 1 | [F1] | XX | [Step: problem] | [What to do] | Feature / Improvement / New Product |
347
+
348
+ ---
349
+
350
+ #### Sources and Assumptions
351
+
352
+ | # | Fact / Assumption | Source | Date | Reliability |
353
+ |---|-------------------|--------|------|:-----------:|
354
+ | 1 | [Fact] | [Source] | [Date] | ✅ / ⚠️ / 🔮 |
355
+
356
+ Legend: ✅ Verified (interviews N≥5 / product data) | ⚠️ Estimated (reviews / 1 source) | 🔮 Assumed (hypothesis)
357
+ ```