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,305 +1,324 @@
1
- ---
2
- name: pest-analysis
3
- description: Macro-environment analysis — political, economic, social, technological, environmental, and legal factors
4
- ---
5
- # PEST/PESTEL Analysis — Macro-environment Analysis
6
-
7
- ## When to Use
8
- - When assessing the **macro-environment** before entering a new market or launching a new product.
9
- - During **strategic planning** — to understand external factors affecting the business.
10
- - When analyzing **regulatory and political risks** in specific regions or industries.
11
- - When preparing **investment decisions** — assessing country and industry risks.
12
-
13
- ## Input
14
-
15
- | Field | Required | Description |
16
- |-------|:--------:|-------------|
17
- | Subject of analysis | ✅ | Company, industry, market, or region |
18
- | Geographic focus | ✅ | Country / region / global reach |
19
- | Analysis horizon | ⬚ | Forecast period (default is 3-5 years) |
20
- | Mode | ⬚ | PEST (4 factors) or PESTEL (6 factors, default) |
21
- | Industry | ⬚ | Specific industry to narrow down factors |
22
- | Strategic goals | ⬚ | Context for evaluating factor impact |
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. National statistical agencies macroeconomic indicators, demographics.
28
- 2. Central banks and regulators interest rates, regulatory initiatives.
29
- 3. Industry associations industry reports, forecasts.
30
- 4. International organizationsWorld Bank, IMF, WTO, OECD.
31
- 5. Tech insights — Gartner, Forrester, McKinsey, BCG.
32
- 6. Environmental and legal databases — ESG ratings, legislative registries.
33
-
34
- > Each fact must be cited with a source and date. Data older than 12 months must be marked with ⚠️ and verified via `web-research`.
35
-
36
- ### Integration with Other Skills
37
- | Skill | What We Take | When to Trigger |
38
- |-------|--------------|-----------------|
39
- | `swot-analysis` | External Opportunities / Threats are formed from PESTEL factors (step 8) | PESTEL O/T block in SWOT |
40
- | `tam-sam-som` | Macro constraints on market size: regulatory, economic (steps 1-2, 6) | If PESTEL reveals constraints on SAM/SOM |
41
- | `competitive-analysis` | Regulatory barriers to entry for competitors (step 6) | If legal factors affect the competitive landscape |
42
- | `ansoff-matrix` | Macro risks for growth strategies: new markets, diversification (step 8) | To assess expansion risks |
43
- | `web-research` | Macro data verification, recent reports | If data is missing or outdated (>12 months) |
44
- | `trend-analysis` | Trends to substantiate factor dynamics (↑/↓/→) | If deep trend elaboration is needed |
45
-
46
- ## Protocol
47
-
48
- ### Step 0Context Preparation
49
- 1. Define the subject of analysis and geographic focus.
50
- 2. Clarify the mode: PEST (4 factors) or PESTEL (6 factors).
51
- 3. Set the analysis horizon and strategic context.
52
- 4. Identify key questions the analysis should answer.
53
- 5. Gather available data from sources.
54
-
55
- ### Step 1 Political Factors
56
- 1. Assess political stability and form of government.
57
- 2. Analyze current and planned government policies affecting the industry.
58
- 3. Assess trade policy: tariffs, sanctions, trade agreements.
59
- 4. Analyze tax policy and government incentives.
60
- 5. Assess corruption risks and institutional quality.
61
- 6. For each factor, fill out a card:
62
-
63
- | Field | Value |
64
- |-------|-------|
65
- | Factor | [Description] |
66
- | Impact (1-5) | [How strongly it affects the business] |
67
- | Probability (1-5) | [Likelihood of realization / intensification] |
68
- | Trend | strengthening / weakening / → stable |
69
- | Nature | 🟢 Opportunity / 🔴 Risk / 🟡 Dual |
70
- | Horizon | Short-term (<1y) / Medium-term (1-3y) / Long-term (3-5y) |
71
- | Source | [URL / Title, Date] |
72
-
73
- **Nature is determined by the following rule:**
74
- - 🟢 **Opportunity**the factor creates a competitive advantage, lowers barriers, opens the market.
75
- - 🔴 **Risk** the factor restricts, increases costs, creates a threat.
76
- - 🟡 **Dual** depends on strategy: can be both a risk and an opportunity.
77
-
78
- ### Step 2 Economic Factors
79
- 1. Analyze macroeconomic indicators: GDP, inflation, unemployment.
80
- 2. Assess currency risks and exchange rate dynamics.
81
- 3. Analyze interest rates and capital availability.
82
- 4. Assess purchasing power and consumption structure.
83
- 5. Analyze economic cycles and the phase of the business cycle.
84
- 6. For each factor — fill out a card (same as step 1).
85
-
86
- ### Step 3 Social Factors
87
- 1. Analyze demographic trends: age structure, urbanization, migration.
88
- 2. Assess cultural norms and values affecting consumption.
89
- 3. Analyze education levels and workforce qualifications.
90
- 4. Assess changes in lifestyle and consumer preferences.
91
- 5. Analyze social inequality and its impact on markets.
92
- 6. For each factor fill out a card (same as step 1).
93
-
94
- ### Step 4Technological Factors
95
- 1. Assess the level of technological development in the region / industry.
96
- 2. Analyze the pace of technological change and disruption.
97
- 3. Assess R&D investments public and private.
98
- 4. Analyze the level of digitalization and internet penetration.
99
- 5. Assess the impact of automation and AI on the industry.
100
- 6. For each factor fill out a card (same as step 1).
101
-
102
- ### Step 5 Environmental Factors (PESTEL)
103
- 1. Analyze environmental legislation and regulatory requirements.
104
- 2. Assess climate risks and their impact on the business.
105
- 3. Analyze ESG trends and stakeholder pressure.
106
- 4. Assess the availability and cost of resources (energy, raw materials, water).
107
- 5. Analyze carbon footprints and sustainability requirements.
108
- 6. For each factor fill out a card (same as step 1).
109
-
110
- ### Step 6 Legal Factors (PESTEL)
111
- 1. Analyze the regulatory context: licensing, certification, compliance.
112
- 2. Assess intellectual property protection and patent law.
113
- 3. Analyze labor legislation and its impact on HR strategy.
114
- 4. Assess data protection and privacy (GDPR, local equivalents).
115
- 5. Analyze antitrust regulation and its impact on the market.
116
- 6. For each factorfill out a card (same as step 1).
117
-
118
- ### Step 7 Scoring and Prioritization
119
- 1. Calculate the final score for each factor: `Score = Impact × Probability`.
120
- 2. Determine top factors by category (Score ≥ 12).
121
- 3. Build a heatmap:
122
-
123
- | | Probability 1 | 2 | 3 | 4 | 5 |
124
- |--|:---:|:---:|:---:|:---:|:---:|
125
- | **Impact 5** | 5 | 10 | 15 🟡 | 20 🔴 | 25 🔴 |
126
- | **4** | 4 | 8 | 12 🟡 | 16 🔴 | 20 🔴 |
127
- | **3** | 3 | 6 | 9 | 12 🟡 | 15 🟡 |
128
- | **2** | 2 | 4 | 6 | 8 | 10 |
129
- | **1** | 1 | 2 | 3 | 4 | 5 |
130
-
131
- 🔴 Score 16: critical immediate response required.
132
- 🟡 Score 12-15: significant monitoring and action plan needed.
133
- No marker < 12: background monitor the trend.
134
-
135
- 4. Highlight critical factors requiring an immediate response.
136
-
137
- ### Step 8Scenario Analysis
138
- 1. Define 2-3 key uncertainties (factors with high Scores and ambiguous trends).
139
- 2. Build 3 scenarios:
140
-
141
- | Scenario | Key Assumptions | Business Impact | Probability | Strategic Response |
142
- |----------|-----------------|-----------------|:-----------:|--------------------|
143
- | Optimistic | [Which factors improve] | [What it yields] | XX% | [What to do] |
144
- | Base | [Current trends continue] | [What to expect] | XX% | [What to do] |
145
- | Pessimistic | [Which factors worsen] | [What the threat is] | XX% | [What to do] |
146
-
147
- 3. For the pessimistic scenario define trigger points: under what conditions to activate the contingency plan.
148
-
149
- ### Step 9 — Synthesis and Recommendations
150
- 1. Formulate the overall macro-environment profile (favorable / neutral / hostile).
151
- 2. Identify key change drivers over the analysis horizon.
152
- 3. Formulate strategic recommendations:
153
-
154
- | # | Factor | Type | Recommendation | Priority | Timeframe |
155
- |---|--------|:----:|----------------|:--------:|-----------|
156
- | 1 | [Factor] | 🔴 Risk | [What to do for mitigation] | P1 | [When] |
157
- | 2 | [Factor] | 🟢 Opp. | [How to leverage] | P2 | [When] |
158
-
159
- 4. Determine review frequency (quarterly for volatile markets, annually for stable ones).
160
-
161
- ## Example — EdTech platform, Russian market, 3-year horizon
162
-
163
- **Context:** Online corporate learning platform, B2B SaaS, Russia, horizon 2026-2029.
164
-
165
- ### Factor Summary Table (TOP)
166
-
167
- | # | Cat. | Factor | Impact | Prob. | Score | Trend | Nature | Horizon |
168
- |---|------|--------|:------:|:-----:|:-----:|:-----:|:------:|---------|
169
- | P1 | Political | Gov program "Personnel" subsidies for corp training | 4 | 4 | **16** | ↑ | 🟢 | Mid-term |
170
- | P2 | Political | Restrictions on foreign LMS (import substitution) | 4 | 3 | **12** | ↑ | 🟡 | Short-term |
171
- | E1 | Economic | Inflation 8-10% — pressure on HR budgets | 4 | 5 | **20** | → | 🔴 | Short-term |
172
- | E2 | Economic | Talent shortage → growing upskilling investments | 5 | 4 | **20** | ↑ | 🟢 | Mid-term |
173
- | S1 | Social | Gen Z entering workforce — digital-first learning expected | 4 | 5 | **20** | ↑ | 🟢 | Long-term |
174
- | T1 | Technological | AI personalization in learning — new standard | 5 | 4 | **20** | ↑ | 🟢 | Mid-term |
175
- | T2 | Technological | LLM content generation — reducing course costs | 4 | 4 | **16** | | 🟡 | Short-term |
176
- | L1 | Legal | Personal Data Law — local data storage required | 5 | 5 | **25** | | 🔴 | Short-term |
177
-
178
- ### Macro-Environment Profile
179
-
180
- | Category | Avg. Score | Trend | Evaluation |
181
- |----------|:----------:|:-----:|------------|
182
- | Political | 14.0 | | 🟡 Dual — subsidies + restrictions |
183
- | Economic | 20.0 | ↑ | 🟢 Favorable — talent shortage = high demand |
184
- | Social | 20.0 | ↑ | 🟢 Favorable — digital-first trend |
185
- | Technological | 18.0 | ↑ | 🟢 Favorable — AI drives differentiation |
186
- | Legal | 25.0 | | 🔴 Hostile high compliance requirements |
187
-
188
- **Overall profile:** Favorable macro-environment for EdTech with significant legal constraints.
189
-
190
- ### Scenario Analysis
191
-
192
- | Scenario | Assumptions | Impact | Prob. | Response |
193
- |----------|-------------|--------|:-----:|----------|
194
- | Optimistic | Subsidies +50%, AI lowers cost-per-learner | TAM ×1.5, margin +10pp | 25% | Aggressive growth, AI investments |
195
- | Base | Trends continue, inflation 8% | TAM +15% YoY, margin stable | 50% | Focus on PMF and retention |
196
- | Pessimistic | HR budgets cut, regulatory barriers rise | TAM flat, churn +5pp | 25% | Focus on compliance, lower CAC |
197
-
198
- **Trigger point (Pessimistic):** if HR budgets in >30% of client companies are cut by >20% — activate contingency.
199
-
200
- ### Strategic Recommendations
201
-
202
- | # | Factor | Type | Recommendation | Priority |
203
- |---|--------|:----:|----------------|:--------:|
204
- | 1 | L1: Personal Data Law | 🔴 | Migrate to local servers by Q3 | P1 |
205
- | 2 | T1: AI personalization | 🟢 | Invest in AI module as a differentiator | P1 |
206
- | 3 | E2: Talent shortage | 🟢 | Position as "ROI on learning" | P2 |
207
- | 4 | P2: Import substitution | 🟡 | Prepare for inclusion in local software registry | P2 |
208
-
209
- ## Validation (Quality Gate)
210
-
211
- - [ ] All categories (P/E/S/T or P/E/S/T/E/L) are covered with at least 3 factors each
212
- - [ ] For each factor: impact (1-5), probability (1-5), trend (↑/↓/→), nature (🟢/🔴/🟡), horizon
213
- - [ ] Nature justified: opportunity / risk / dual per the protocol rule
214
- - [ ] Scoring correct: Score = Impact × Probability, top factors (≥12) highlighted
215
- - [ ] Trends justified with causes and sources
216
- - [ ] No overlaps between categories
217
- - [ ] Scenario analysis: 3 scenarios with assumptions, impact, probability, and response
218
- - [ ] Trigger points defined for the pessimistic scenario
219
- - [ ] Recommendations are specific, prioritized (P1/P2/P3), and tied to factors
220
- - [ ] Analysis reflects the specified horizon and geographic focus
221
- - [ ] Data sources cited; data older than 12 months marked with ⚠️
222
-
223
- ## Handoff
224
- The output of `$pest-analysis` serves as input for:
225
- - **Strategist / Mediator** macro-environment for strategic decisions and risk assessment.
226
- - **`swot-analysis`** external Opportunities and Threats derived from PESTEL factors.
227
- - **`tam-sam-som`** — macro constraints on market size (regulatory, economic).
228
- - **`ansoff-matrix`** macro risks for growth strategies in new markets.
229
- - **`competitive-analysis`** — regulatory barriers to entry for competitors.
230
-
231
- Handoff format: factor summary table + macro-environment profile + scenario analysis + recommendations. Use `$handoff` to transfer context.
232
-
233
- ## Anti-patterns
234
-
235
- | Error | Why it's bad | Correct Approach |
236
- |-------|--------------|------------------|
237
- | Listing factors without scoring | An unprioritized list is useless | Each factor gets Score = Impact × Probability |
238
- | Ignoring trends | A static snapshot ignores dynamics | Provide Trend ↑/↓/→ + horizon + cause |
239
- | Confusing categories | Putting a legal factor under "Political" muddles the analysis| Strictly separate by PESTEL categories |
240
- | Focusing solely on negative factors | Opportunities get lost | Nature: 🟢 opportunity / 🔴 risk / 🟡 dual |
241
- | Lack of geographic focus | Factors vary by country | Always specify region / country |
242
- | Identical scores for all factors | No differentiation, no priorities | Use the full 1-5 scale, justify each score |
243
- | Scenarios without trigger points | Unclear when to activate contingency | Trigger: specific condition → specific action |
244
- | Factors without sources | Cannot be verified, subjective opinions | Each fact must have source and date; >12mo = ⚠️ |
245
-
246
- ## Output Template
247
-
248
- ```markdown
249
- ## PEST/PESTEL Analysis: [Subject of Analysis]
250
- **Region:** [Geography] | **Horizon:** [Period] | **Mode:** PEST / PESTEL | **Date:** [Date]
251
-
252
- ### Factor Summary Table
253
-
254
- | # | Cat. | Factor | Impact (1-5) | Prob. (1-5) | Score | Trend | Nature | Horizon | Source |
255
- |---|------|--------|:------------:|:-----------:|:-----:|:-----:|:------:|---------|--------|
256
- | 1 | P | [Factor] | X | X | XX | ↑/↓/→ | 🟢/🔴/🟡 | Short/Mid/Long | [Source] |
257
-
258
- ### Heatmap (TOP Factors)
259
-
260
- | Factor | Score | Trend | Cat. | Nature | Recommendation |
261
- |--------|:-----:|:-----:|------|:------:|----------------|
262
- | [Factor] | XX 🔴 | | [X] | Risk | [Action] |
263
-
264
- Thresholds: 🔴 ≥ 16 critical | 🟡 12-15 significant | < 12 background
265
-
266
- ### Macro-Environment Profile
267
-
268
- | Category | Avg. Score | Trend | Evaluation |
269
- |----------|:----------:|:-----:|------------|
270
- | Political | X.X | ↑/↓/→ | 🟢 Favorable / 🟡 Neutral / 🔴 Hostile |
271
- | Economic | X.X | ↑/↓/→ | ... |
272
- | Social | X.X | ↑/↓/→ | ... |
273
- | Technological | X.X | ↑/↓/→ | ... |
274
- | Environmental | X.X | ↑/↓/→ | ... |
275
- | Legal | X.X | ↑/↓/→ | ... |
276
-
277
- **Overall profile:** [1-2 sentences]
278
-
279
- ### Scenario Analysis
280
-
281
- | Scenario | Key Assumptions | Business Impact | Probability | Strategic Response |
282
- |----------|-----------------|-----------------|:-----------:|--------------------|
283
- | Optimistic | [Which factors improve] | [What it yields] | XX% | [What to do] |
284
- | Base | [Current trends continue] | [What to expect] | XX% | [What to do] |
285
- | Pessimistic | [Which factors worsen] | [What the threat is] | XX% | [What to do] |
286
-
287
- **Trigger points (pessimistic):** [Under what condition what action]
288
-
289
- ### Strategic Recommendations
290
-
291
- | # | Factor | Type | Recommendation | Priority | Timeframe |
292
- |---|--------|:----:|----------------|:--------:|-----------|
293
- | 1 | [Factor] | 🔴 | [Mitigation] | P1 | [When] |
294
- | 2 | [Factor] | 🟢 | [How to leverage] | P2 | [When] |
295
-
296
- **Review Frequency:** [quarterly / annually]
297
-
298
- ### Sources and Assumptions
299
-
300
- | # | Fact / Assumption | Source | Date | Reliability |
301
- |---|-------------------|--------|------|:-----------:|
302
- | 1 | [Fact] | [Source] | [Date] | / ⚠️ / 🔮 |
303
-
304
- Legend: Verified (2+ sources) | ⚠️ Estimated (1 source) | 🔮 Assumed (expert assessment)
305
- ```
1
+ ---
2
+ name: pest-analysis
3
+ description: Macro-environment analysis — political, economic, social, technological, environmental, and legal factors
4
+ type: triggered
5
+ domain: analytics
6
+ owners:
7
+ - strategist
8
+ - mediator
9
+ gates:
10
+ - STRATEGIST
11
+ - MEDIATOR
12
+ tech: []
13
+ topic: []
14
+ triggers:
15
+ - pest-analysis
16
+ - PEST
17
+ - PESTEL
18
+ - ПЕСТ
19
+ - макроанализ
20
+ related: []
21
+ budget_lines: 324
22
+ schema_version: 1
23
+ ---
24
+ # PEST/PESTEL AnalysisMacro-environment Analysis
25
+
26
+ ## When to Use
27
+ - When assessing the **macro-environment** before entering a new market or launching a new product.
28
+ - During **strategic planning**to understand external factors affecting the business.
29
+ - When analyzing **regulatory and political risks** in specific regions or industries.
30
+ - When preparing **investment decisions** assessing country and industry risks.
31
+
32
+ ## Input
33
+
34
+ | Field | Required | Description |
35
+ |-------|:--------:|-------------|
36
+ | Subject of analysis | ✅ | Company, industry, market, or region |
37
+ | Geographic focus | | Country / region / global reach |
38
+ | Analysis horizon | ⬚ | Forecast period (default is 3-5 years) |
39
+ | Mode | | PEST (4 factors) or PESTEL (6 factors, default) |
40
+ | Industry | | Specific industry to narrow down factors |
41
+ | Strategic goals | | Context for evaluating factor impact |
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. National statistical agencies — macroeconomic indicators, demographics.
47
+ 2. Central banks and regulators — interest rates, regulatory initiatives.
48
+ 3. Industry associationsindustry reports, forecasts.
49
+ 4. International organizations World Bank, IMF, WTO, OECD.
50
+ 5. Tech insights Gartner, Forrester, McKinsey, BCG.
51
+ 6. Environmental and legal databases ESG ratings, legislative registries.
52
+
53
+ > Each fact must be cited with a source and date. Data older than 12 months must be marked with ⚠️ and verified via `web-research`.
54
+
55
+ ### Integration with Other Skills
56
+ | Skill | What We Take | When to Trigger |
57
+ |-------|--------------|-----------------|
58
+ | `swot-analysis` | External Opportunities / Threats are formed from PESTEL factors (step 8) | PESTEL → O/T block in SWOT |
59
+ | `tam-sam-som` | Macro constraints on market size: regulatory, economic (steps 1-2, 6) | If PESTEL reveals constraints on SAM/SOM |
60
+ | `competitive-analysis` | Regulatory barriers to entry for competitors (step 6) | If legal factors affect the competitive landscape |
61
+ | `ansoff-matrix` | Macro risks for growth strategies: new markets, diversification (step 8) | To assess expansion risks |
62
+ | `web-research` | Macro data verification, recent reports | If data is missing or outdated (>12 months) |
63
+ | `trend-analysis` | Trends to substantiate factor dynamics (↑/↓/→) | If deep trend elaboration is needed |
64
+
65
+ ## Protocol
66
+
67
+ ### Step 0 Context Preparation
68
+ 1. Define the subject of analysis and geographic focus.
69
+ 2. Clarify the mode: PEST (4 factors) or PESTEL (6 factors).
70
+ 3. Set the analysis horizon and strategic context.
71
+ 4. Identify key questions the analysis should answer.
72
+ 5. Gather available data from sources.
73
+
74
+ ### Step 1Political Factors
75
+ 1. Assess political stability and form of government.
76
+ 2. Analyze current and planned government policies affecting the industry.
77
+ 3. Assess trade policy: tariffs, sanctions, trade agreements.
78
+ 4. Analyze tax policy and government incentives.
79
+ 5. Assess corruption risks and institutional quality.
80
+ 6. For each factor, fill out a card:
81
+
82
+ | Field | Value |
83
+ |-------|-------|
84
+ | Factor | [Description] |
85
+ | Impact (1-5) | [How strongly it affects the business] |
86
+ | Probability (1-5) | [Likelihood of realization / intensification] |
87
+ | Trend | strengthening / weakening / → stable |
88
+ | Nature | 🟢 Opportunity / 🔴 Risk / 🟡 Dual |
89
+ | Horizon | Short-term (<1y) / Medium-term (1-3y) / Long-term (3-5y) |
90
+ | Source | [URL / Title, Date] |
91
+
92
+ **Nature is determined by the following rule:**
93
+ - 🟢 **Opportunity** — the factor creates a competitive advantage, lowers barriers, opens the market.
94
+ - 🔴 **Risk**the factor restricts, increases costs, creates a threat.
95
+ - 🟡 **Dual** depends on strategy: can be both a risk and an opportunity.
96
+
97
+ ### Step 2Economic Factors
98
+ 1. Analyze macroeconomic indicators: GDP, inflation, unemployment.
99
+ 2. Assess currency risks and exchange rate dynamics.
100
+ 3. Analyze interest rates and capital availability.
101
+ 4. Assess purchasing power and consumption structure.
102
+ 5. Analyze economic cycles and the phase of the business cycle.
103
+ 6. For each factor fill out a card (same as step 1).
104
+
105
+ ### Step 3 Social Factors
106
+ 1. Analyze demographic trends: age structure, urbanization, migration.
107
+ 2. Assess cultural norms and values affecting consumption.
108
+ 3. Analyze education levels and workforce qualifications.
109
+ 4. Assess changes in lifestyle and consumer preferences.
110
+ 5. Analyze social inequality and its impact on markets.
111
+ 6. For each factor fill out a card (same as step 1).
112
+
113
+ ### Step 4 Technological Factors
114
+ 1. Assess the level of technological development in the region / industry.
115
+ 2. Analyze the pace of technological change and disruption.
116
+ 3. Assess R&D investmentspublic and private.
117
+ 4. Analyze the level of digitalization and internet penetration.
118
+ 5. Assess the impact of automation and AI on the industry.
119
+ 6. For each factor fill out a card (same as step 1).
120
+
121
+ ### Step 5 — Environmental Factors (PESTEL)
122
+ 1. Analyze environmental legislation and regulatory requirements.
123
+ 2. Assess climate risks and their impact on the business.
124
+ 3. Analyze ESG trends and stakeholder pressure.
125
+ 4. Assess the availability and cost of resources (energy, raw materials, water).
126
+ 5. Analyze carbon footprints and sustainability requirements.
127
+ 6. For each factor fill out a card (same as step 1).
128
+
129
+ ### Step 6 Legal Factors (PESTEL)
130
+ 1. Analyze the regulatory context: licensing, certification, compliance.
131
+ 2. Assess intellectual property protection and patent law.
132
+ 3. Analyze labor legislation and its impact on HR strategy.
133
+ 4. Assess data protection and privacy (GDPR, local equivalents).
134
+ 5. Analyze antitrust regulation and its impact on the market.
135
+ 6. For each factor fill out a card (same as step 1).
136
+
137
+ ### Step 7Scoring and Prioritization
138
+ 1. Calculate the final score for each factor: `Score = Impact × Probability`.
139
+ 2. Determine top factors by category (Score ≥ 12).
140
+ 3. Build a heatmap:
141
+
142
+ | | Probability 1 | 2 | 3 | 4 | 5 |
143
+ |--|:---:|:---:|:---:|:---:|:---:|
144
+ | **Impact 5** | 5 | 10 | 15 🟡 | 20 🔴 | 25 🔴 |
145
+ | **4** | 4 | 8 | 12 🟡 | 16 🔴 | 20 🔴 |
146
+ | **3** | 3 | 6 | 9 | 12 🟡 | 15 🟡 |
147
+ | **2** | 2 | 4 | 6 | 8 | 10 |
148
+ | **1** | 1 | 2 | 3 | 4 | 5 |
149
+
150
+ 🔴 Score 16: critical immediate response required.
151
+ 🟡 Score 12-15: significant monitoring and action plan needed.
152
+ No marker < 12: background — monitor the trend.
153
+
154
+ 4. Highlight critical factors requiring an immediate response.
155
+
156
+ ### Step 8 Scenario Analysis
157
+ 1. Define 2-3 key uncertainties (factors with high Scores and ambiguous trends).
158
+ 2. Build 3 scenarios:
159
+
160
+ | Scenario | Key Assumptions | Business Impact | Probability | Strategic Response |
161
+ |----------|-----------------|-----------------|:-----------:|--------------------|
162
+ | Optimistic | [Which factors improve] | [What it yields] | XX% | [What to do] |
163
+ | Base | [Current trends continue] | [What to expect] | XX% | [What to do] |
164
+ | Pessimistic | [Which factors worsen] | [What the threat is] | XX% | [What to do] |
165
+
166
+ 3. For the pessimistic scenario — define trigger points: under what conditions to activate the contingency plan.
167
+
168
+ ### Step 9 — Synthesis and Recommendations
169
+ 1. Formulate the overall macro-environment profile (favorable / neutral / hostile).
170
+ 2. Identify key change drivers over the analysis horizon.
171
+ 3. Formulate strategic recommendations:
172
+
173
+ | # | Factor | Type | Recommendation | Priority | Timeframe |
174
+ |---|--------|:----:|----------------|:--------:|-----------|
175
+ | 1 | [Factor] | 🔴 Risk | [What to do for mitigation] | P1 | [When] |
176
+ | 2 | [Factor] | 🟢 Opp. | [How to leverage] | P2 | [When] |
177
+
178
+ 4. Determine review frequency (quarterly for volatile markets, annually for stable ones).
179
+
180
+ ## Example EdTech platform, Russian market, 3-year horizon
181
+
182
+ **Context:** Online corporate learning platform, B2B SaaS, Russia, horizon 2026-2029.
183
+
184
+ ### Factor Summary Table (TOP)
185
+
186
+ | # | Cat. | Factor | Impact | Prob. | Score | Trend | Nature | Horizon |
187
+ |---|------|--------|:------:|:-----:|:-----:|:-----:|:------:|---------|
188
+ | P1 | Political | Gov program "Personnel" — subsidies for corp training | 4 | 4 | **16** | ↑ | 🟢 | Mid-term |
189
+ | P2 | Political | Restrictions on foreign LMS (import substitution) | 4 | 3 | **12** | ↑ | 🟡 | Short-term |
190
+ | E1 | Economic | Inflation 8-10% — pressure on HR budgets | 4 | 5 | **20** | → | 🔴 | Short-term |
191
+ | E2 | Economic | Talent shortage → growing upskilling investments | 5 | 4 | **20** | ↑ | 🟢 | Mid-term |
192
+ | S1 | Social | Gen Z entering workforce — digital-first learning expected | 4 | 5 | **20** | ↑ | 🟢 | Long-term |
193
+ | T1 | Technological | AI personalization in learning — new standard | 5 | 4 | **20** | ↑ | 🟢 | Mid-term |
194
+ | T2 | Technological | LLM content generation reducing course costs | 4 | 4 | **16** | | 🟡 | Short-term |
195
+ | L1 | Legal | Personal Data Law local data storage required | 5 | 5 | **25** | | 🔴 | Short-term |
196
+
197
+ ### Macro-Environment Profile
198
+
199
+ | Category | Avg. Score | Trend | Evaluation |
200
+ |----------|:----------:|:-----:|------------|
201
+ | Political | 14.0 | ↑ | 🟡 Dual — subsidies + restrictions |
202
+ | Economic | 20.0 | | 🟢 Favorable talent shortage = high demand |
203
+ | Social | 20.0 | ↑ | 🟢 Favorable — digital-first trend |
204
+ | Technological | 18.0 | | 🟢 Favorable AI drives differentiation |
205
+ | Legal | 25.0 | | 🔴 Hostile high compliance requirements |
206
+
207
+ **Overall profile:** Favorable macro-environment for EdTech with significant legal constraints.
208
+
209
+ ### Scenario Analysis
210
+
211
+ | Scenario | Assumptions | Impact | Prob. | Response |
212
+ |----------|-------------|--------|:-----:|----------|
213
+ | Optimistic | Subsidies +50%, AI lowers cost-per-learner | TAM ×1.5, margin +10pp | 25% | Aggressive growth, AI investments |
214
+ | Base | Trends continue, inflation 8% | TAM +15% YoY, margin stable | 50% | Focus on PMF and retention |
215
+ | Pessimistic | HR budgets cut, regulatory barriers rise | TAM flat, churn +5pp | 25% | Focus on compliance, lower CAC |
216
+
217
+ **Trigger point (Pessimistic):** if HR budgets in >30% of client companies are cut by >20% — activate contingency.
218
+
219
+ ### Strategic Recommendations
220
+
221
+ | # | Factor | Type | Recommendation | Priority |
222
+ |---|--------|:----:|----------------|:--------:|
223
+ | 1 | L1: Personal Data Law | 🔴 | Migrate to local servers by Q3 | P1 |
224
+ | 2 | T1: AI personalization | 🟢 | Invest in AI module as a differentiator | P1 |
225
+ | 3 | E2: Talent shortage | 🟢 | Position as "ROI on learning" | P2 |
226
+ | 4 | P2: Import substitution | 🟡 | Prepare for inclusion in local software registry | P2 |
227
+
228
+ ## Validation (Quality Gate)
229
+
230
+ - [ ] All categories (P/E/S/T or P/E/S/T/E/L) are covered with at least 3 factors each
231
+ - [ ] For each factor: impact (1-5), probability (1-5), trend (↑/↓/→), nature (🟢/🔴/🟡), horizon
232
+ - [ ] Nature justified: opportunity / risk / dual — per the protocol rule
233
+ - [ ] Scoring correct: Score = Impact × Probability, top factors (≥12) highlighted
234
+ - [ ] Trends justified with causes and sources
235
+ - [ ] No overlaps between categories
236
+ - [ ] Scenario analysis: 3 scenarios with assumptions, impact, probability, and response
237
+ - [ ] Trigger points defined for the pessimistic scenario
238
+ - [ ] Recommendations are specific, prioritized (P1/P2/P3), and tied to factors
239
+ - [ ] Analysis reflects the specified horizon and geographic focus
240
+ - [ ] Data sources cited; data older than 12 months marked with ⚠️
241
+
242
+ ## Handoff
243
+ The output of `$pest-analysis` serves as input for:
244
+ - **Strategist / Mediator** macro-environment for strategic decisions and risk assessment.
245
+ - **`swot-analysis`** — external Opportunities and Threats derived from PESTEL factors.
246
+ - **`tam-sam-som`** — macro constraints on market size (regulatory, economic).
247
+ - **`ansoff-matrix`** — macro risks for growth strategies in new markets.
248
+ - **`competitive-analysis`** — regulatory barriers to entry for competitors.
249
+
250
+ Handoff format: factor summary table + macro-environment profile + scenario analysis + recommendations. Use `$handoff` to transfer context.
251
+
252
+ ## Anti-patterns
253
+
254
+ | Error | Why it's bad | Correct Approach |
255
+ |-------|--------------|------------------|
256
+ | Listing factors without scoring | An unprioritized list is useless | Each factor gets Score = Impact × Probability |
257
+ | Ignoring trends | A static snapshot ignores dynamics | Provide Trend ↑/↓/→ + horizon + cause |
258
+ | Confusing categories | Putting a legal factor under "Political" muddles the analysis| Strictly separate by PESTEL categories |
259
+ | Focusing solely on negative factors | Opportunities get lost | Nature: 🟢 opportunity / 🔴 risk / 🟡 dual |
260
+ | Lack of geographic focus | Factors vary by country | Always specify region / country |
261
+ | Identical scores for all factors | No differentiation, no priorities | Use the full 1-5 scale, justify each score |
262
+ | Scenarios without trigger points | Unclear when to activate contingency | Trigger: specific condition → specific action |
263
+ | Factors without sources | Cannot be verified, subjective opinions | Each fact must have source and date; >12mo = ⚠️ |
264
+
265
+ ## Output Template
266
+
267
+ ```markdown
268
+ ## PEST/PESTEL Analysis: [Subject of Analysis]
269
+ **Region:** [Geography] | **Horizon:** [Period] | **Mode:** PEST / PESTEL | **Date:** [Date]
270
+
271
+ ### Factor Summary Table
272
+
273
+ | # | Cat. | Factor | Impact (1-5) | Prob. (1-5) | Score | Trend | Nature | Horizon | Source |
274
+ |---|------|--------|:------------:|:-----------:|:-----:|:-----:|:------:|---------|--------|
275
+ | 1 | P | [Factor] | X | X | XX | ↑/↓/→ | 🟢/🔴/🟡 | Short/Mid/Long | [Source] |
276
+
277
+ ### Heatmap (TOP Factors)
278
+
279
+ | Factor | Score | Trend | Cat. | Nature | Recommendation |
280
+ |--------|:-----:|:-----:|------|:------:|----------------|
281
+ | [Factor] | XX 🔴 | | [X] | Risk | [Action] |
282
+
283
+ Thresholds: 🔴 16 critical | 🟡 12-15 significant | < 12 background
284
+
285
+ ### Macro-Environment Profile
286
+
287
+ | Category | Avg. Score | Trend | Evaluation |
288
+ |----------|:----------:|:-----:|------------|
289
+ | Political | X.X | ↑/↓/→ | 🟢 Favorable / 🟡 Neutral / 🔴 Hostile |
290
+ | Economic | X.X | ↑/↓/→ | ... |
291
+ | Social | X.X | ↑/↓/→ | ... |
292
+ | Technological | X.X | ↑/↓/→ | ... |
293
+ | Environmental | X.X | ↑/↓/→ | ... |
294
+ | Legal | X.X | ↑/↓/→ | ... |
295
+
296
+ **Overall profile:** [1-2 sentences]
297
+
298
+ ### Scenario Analysis
299
+
300
+ | Scenario | Key Assumptions | Business Impact | Probability | Strategic Response |
301
+ |----------|-----------------|-----------------|:-----------:|--------------------|
302
+ | Optimistic | [Which factors improve] | [What it yields] | XX% | [What to do] |
303
+ | Base | [Current trends continue] | [What to expect] | XX% | [What to do] |
304
+ | Pessimistic | [Which factors worsen] | [What the threat is] | XX% | [What to do] |
305
+
306
+ **Trigger points (pessimistic):** [Under what condition → what action]
307
+
308
+ ### Strategic Recommendations
309
+
310
+ | # | Factor | Type | Recommendation | Priority | Timeframe |
311
+ |---|--------|:----:|----------------|:--------:|-----------|
312
+ | 1 | [Factor] | 🔴 | [Mitigation] | P1 | [When] |
313
+ | 2 | [Factor] | 🟢 | [How to leverage] | P2 | [When] |
314
+
315
+ **Review Frequency:** [quarterly / annually]
316
+
317
+ ### Sources and Assumptions
318
+
319
+ | # | Fact / Assumption | Source | Date | Reliability |
320
+ |---|-------------------|--------|------|:-----------:|
321
+ | 1 | [Fact] | [Source] | [Date] | ✅ / ⚠️ / 🔮 |
322
+
323
+ Legend: ✅ Verified (2+ sources) | ⚠️ Estimated (1 source) | 🔮 Assumed (expert assessment)
324
+ ```