code-ai-installer 4.0.0 → 4.0.1-b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (471) hide show
  1. package/README.md +83 -67
  2. package/dist/index.js +2 -0
  3. package/dist/mcp/audit_ledger.d.ts +12 -0
  4. package/dist/mcp/audit_ledger.js +82 -0
  5. package/dist/mcp/cli.js +7 -1
  6. package/dist/mcp/config.d.ts +23 -0
  7. package/dist/mcp/config.js +44 -6
  8. package/dist/mcp/index.d.ts +1 -2
  9. package/dist/mcp/index.js +1 -2
  10. package/dist/mcp/paths.d.ts +20 -2
  11. package/dist/mcp/paths.js +29 -5
  12. package/dist/mcp/proposal_dedup.d.ts +32 -0
  13. package/dist/mcp/proposal_dedup.js +102 -0
  14. package/dist/mcp/proposal_store.d.ts +18 -0
  15. package/dist/mcp/proposal_store.js +74 -0
  16. package/dist/mcp/scorecard.d.ts +140 -0
  17. package/dist/mcp/scorecard.js +103 -0
  18. package/dist/mcp/skill_invocations.d.ts +15 -0
  19. package/dist/mcp/skill_invocations.js +28 -0
  20. package/dist/mcp/task_state.d.ts +77 -2
  21. package/dist/mcp/tools/_subprocess.d.ts +16 -0
  22. package/dist/mcp/tools/_subprocess.js +56 -0
  23. package/dist/mcp/tools/advance_gate.js +2 -2
  24. package/dist/mcp/tools/aggregate_run_metrics.d.ts +19 -0
  25. package/dist/mcp/tools/aggregate_run_metrics.js +139 -0
  26. package/dist/mcp/tools/apply_diff.d.ts +2 -0
  27. package/dist/mcp/tools/apply_diff.js +29 -0
  28. package/dist/mcp/tools/audit_bilocale_parity.d.ts +2 -0
  29. package/dist/mcp/tools/audit_bilocale_parity.js +146 -0
  30. package/dist/mcp/tools/audit_budget_compliance.d.ts +35 -0
  31. package/dist/mcp/tools/audit_budget_compliance.js +172 -0
  32. package/dist/mcp/tools/build.d.ts +2 -0
  33. package/dist/mcp/tools/build.js +47 -0
  34. package/dist/mcp/tools/check_lint.d.ts +2 -0
  35. package/dist/mcp/tools/check_lint.js +23 -0
  36. package/dist/mcp/tools/classify_gate.js +2 -2
  37. package/dist/mcp/tools/current_gate.js +2 -2
  38. package/dist/mcp/tools/dependency_supply_chain.d.ts +2 -0
  39. package/dist/mcp/tools/dependency_supply_chain.js +59 -0
  40. package/dist/mcp/tools/docker_compose.d.ts +2 -0
  41. package/dist/mcp/tools/docker_compose.js +24 -0
  42. package/dist/mcp/tools/e2e_playwright.d.ts +2 -0
  43. package/dist/mcp/tools/e2e_playwright.js +88 -0
  44. package/dist/mcp/tools/get_skill.js +17 -0
  45. package/dist/mcp/tools/git_commit.d.ts +2 -0
  46. package/dist/mcp/tools/git_commit.js +30 -0
  47. package/dist/mcp/tools/list_proposals.d.ts +6 -0
  48. package/dist/mcp/tools/list_proposals.js +16 -0
  49. package/dist/mcp/tools/list_skills.js +9 -1
  50. package/dist/mcp/tools/load_role.d.ts +3 -4
  51. package/dist/mcp/tools/load_role.js +11 -13
  52. package/dist/mcp/tools/propose_change.d.ts +8 -0
  53. package/dist/mcp/tools/propose_change.js +36 -0
  54. package/dist/mcp/tools/record_decision.js +25 -25
  55. package/dist/mcp/tools/review_proposal.d.ts +17 -0
  56. package/dist/mcp/tools/review_proposal.js +99 -0
  57. package/dist/mcp/tools/run_drift_audit.d.ts +11 -0
  58. package/dist/mcp/tools/run_drift_audit.js +79 -0
  59. package/dist/mcp/tools/run_tests.d.ts +2 -0
  60. package/dist/mcp/tools/run_tests.js +92 -0
  61. package/dist/mcp/tools/sign_off.js +14 -2
  62. package/dist/mcp/tools/stubs.js +30 -9
  63. package/dist/mcp/tools/verify_claim.js +33 -6
  64. package/dist/mcp_setup.d.ts +14 -3
  65. package/dist/mcp_setup.js +15 -6
  66. package/dist/shared/frontmatter.d.ts +44 -2
  67. package/dist/shared/frontmatter.js +54 -6
  68. package/dist/shared/index.d.ts +0 -5
  69. package/dist/shared/index.js +0 -5
  70. package/dist/shared/persona.d.ts +2 -2
  71. package/dist/shared/persona.js +1 -1
  72. package/dist/shared/pipeline.d.ts +46 -1
  73. package/dist/shared/tools.d.ts +1382 -16
  74. package/dist/shared/tools.js +229 -0
  75. package/dist/shared/vocabulary.d.ts +99 -4
  76. package/dist/shared/vocabulary.js +94 -5
  77. package/domains/analytics/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  78. package/domains/analytics/.agents/skills/bcg-matrix/SKILL.md +345 -329
  79. package/domains/analytics/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  80. package/domains/analytics/.agents/skills/board/SKILL.md +22 -0
  81. package/domains/analytics/.agents/skills/cohort-analysis/SKILL.md +338 -322
  82. package/domains/analytics/.agents/skills/competitive-analysis/SKILL.md +413 -395
  83. package/domains/analytics/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  84. package/domains/analytics/.agents/skills/gates/SKILL.md +388 -366
  85. package/domains/analytics/.agents/skills/handoff/SKILL.md +402 -380
  86. package/domains/analytics/.agents/skills/html-pdf-report/SKILL.md +21 -289
  87. package/domains/analytics/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  88. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  89. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  90. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  91. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  92. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  93. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  94. package/domains/analytics/.agents/skills/html-pdf-report-reference/agents/skill.yaml +23 -0
  95. package/domains/analytics/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  96. package/domains/analytics/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  97. package/domains/analytics/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  98. package/domains/analytics/.agents/skills/pest-analysis/SKILL.md +324 -305
  99. package/domains/analytics/.agents/skills/porters-five-forces/SKILL.md +377 -361
  100. package/domains/analytics/.agents/skills/report-design/SKILL.md +416 -398
  101. package/domains/analytics/.agents/skills/rfm-analysis/SKILL.md +330 -314
  102. package/domains/analytics/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  103. package/domains/analytics/.agents/skills/swot-analysis/SKILL.md +340 -324
  104. package/domains/analytics/.agents/skills/tam-sam-som/SKILL.md +329 -312
  105. package/domains/analytics/.agents/skills/trend-analysis/SKILL.md +347 -331
  106. package/domains/analytics/.agents/skills/unit-economics/SKILL.md +430 -413
  107. package/domains/analytics/.agents/skills/value-chain-analysis/SKILL.md +346 -330
  108. package/domains/analytics/.agents/skills/web-research/SKILL.md +323 -308
  109. package/domains/analytics/AGENTS.md +1 -0
  110. package/domains/analytics/agents/auditor.md +76 -0
  111. package/domains/analytics/agents/conductor.md +11 -0
  112. package/domains/analytics/agents/data_analyst.md +11 -0
  113. package/domains/analytics/agents/designer.md +11 -0
  114. package/domains/analytics/agents/interviewer.md +11 -0
  115. package/domains/analytics/agents/layouter.md +11 -0
  116. package/domains/analytics/agents/mediator.md +11 -0
  117. package/domains/analytics/agents/researcher.md +11 -0
  118. package/domains/analytics/agents/strategist.md +11 -0
  119. package/domains/analytics/locales/en/.agents/skills/ansoff-matrix/SKILL.md +316 -300
  120. package/domains/analytics/locales/en/.agents/skills/bcg-matrix/SKILL.md +345 -329
  121. package/domains/analytics/locales/en/.agents/skills/blue-ocean-strategy/SKILL.md +432 -416
  122. package/domains/analytics/locales/en/.agents/skills/board/SKILL.md +22 -0
  123. package/domains/analytics/locales/en/.agents/skills/cohort-analysis/SKILL.md +338 -322
  124. package/domains/analytics/locales/en/.agents/skills/competitive-analysis/SKILL.md +413 -395
  125. package/domains/analytics/locales/en/.agents/skills/customer-journey-mapping/SKILL.md +347 -331
  126. package/domains/analytics/locales/en/.agents/skills/gates/SKILL.md +388 -366
  127. package/domains/analytics/locales/en/.agents/skills/handoff/SKILL.md +402 -380
  128. package/domains/analytics/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -289
  129. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +325 -0
  130. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  131. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  132. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  133. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  134. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  135. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  136. package/domains/analytics/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +29 -0
  137. package/domains/analytics/locales/en/.agents/skills/icp-buyer-persona/SKILL.md +407 -390
  138. package/domains/analytics/locales/en/.agents/skills/jtbd-analysis/SKILL.md +357 -341
  139. package/domains/analytics/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +32 -0
  140. package/domains/analytics/locales/en/.agents/skills/pest-analysis/SKILL.md +324 -305
  141. package/domains/analytics/locales/en/.agents/skills/porters-five-forces/SKILL.md +377 -361
  142. package/domains/analytics/locales/en/.agents/skills/report-design/SKILL.md +416 -398
  143. package/domains/analytics/locales/en/.agents/skills/rfm-analysis/SKILL.md +330 -314
  144. package/domains/analytics/locales/en/.agents/skills/session-prompt-generator/SKILL.md +400 -378
  145. package/domains/analytics/locales/en/.agents/skills/swot-analysis/SKILL.md +340 -324
  146. package/domains/analytics/locales/en/.agents/skills/tam-sam-som/SKILL.md +329 -312
  147. package/domains/analytics/locales/en/.agents/skills/trend-analysis/SKILL.md +347 -331
  148. package/domains/analytics/locales/en/.agents/skills/unit-economics/SKILL.md +430 -413
  149. package/domains/analytics/locales/en/.agents/skills/value-chain-analysis/SKILL.md +366 -350
  150. package/domains/analytics/locales/en/.agents/skills/web-research/SKILL.md +324 -309
  151. package/domains/analytics/locales/en/AGENTS.md +1 -0
  152. package/domains/analytics/locales/en/agents/auditor.md +76 -0
  153. package/domains/analytics/locales/en/agents/conductor.md +27 -0
  154. package/domains/analytics/locales/en/agents/data_analyst.md +29 -0
  155. package/domains/analytics/locales/en/agents/designer.md +27 -0
  156. package/domains/analytics/locales/en/agents/interviewer.md +11 -0
  157. package/domains/analytics/locales/en/agents/layouter.md +11 -0
  158. package/domains/analytics/locales/en/agents/mediator.md +11 -0
  159. package/domains/analytics/locales/en/agents/researcher.md +11 -0
  160. package/domains/analytics/locales/en/agents/strategist.md +11 -0
  161. package/domains/analytics/persona/persona-base.md +94 -0
  162. package/domains/analytics/pipeline.yaml +102 -0
  163. package/domains/content/.agents/skills/audience-analysis/SKILL.md +15 -0
  164. package/domains/content/.agents/skills/board/SKILL.md +20 -0
  165. package/domains/content/.agents/skills/brand-compliance/SKILL.md +15 -0
  166. package/domains/content/.agents/skills/brand-guidelines/SKILL.md +17 -0
  167. package/domains/content/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  168. package/domains/content/.agents/skills/content-brief/SKILL.md +15 -0
  169. package/domains/content/.agents/skills/content-calendar/SKILL.md +15 -0
  170. package/domains/content/.agents/skills/content-release-gate/SKILL.md +15 -0
  171. package/domains/content/.agents/skills/content-review-checklist/SKILL.md +15 -0
  172. package/domains/content/.agents/skills/cta-optimization/SKILL.md +15 -0
  173. package/domains/content/.agents/skills/data-storytelling/SKILL.md +15 -0
  174. package/domains/content/.agents/skills/email-copywriting/SKILL.md +15 -0
  175. package/domains/content/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  176. package/domains/content/.agents/skills/fact-checking/SKILL.md +15 -0
  177. package/domains/content/.agents/skills/gates/SKILL.md +20 -0
  178. package/domains/content/.agents/skills/google-stitch-content/SKILL.md +15 -0
  179. package/domains/content/.agents/skills/handoff/SKILL.md +24 -0
  180. package/domains/content/.agents/skills/headline-formulas/SKILL.md +15 -0
  181. package/domains/content/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  182. package/domains/content/.agents/skills/karpathy-guidelines/SKILL.md +28 -0
  183. package/domains/content/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  184. package/domains/content/.agents/skills/marketing-psychology/SKILL.md +15 -0
  185. package/domains/content/.agents/skills/moodboard/SKILL.md +15 -0
  186. package/domains/content/.agents/skills/platform-compliance/SKILL.md +15 -0
  187. package/domains/content/.agents/skills/platform-strategy/SKILL.md +15 -0
  188. package/domains/content/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  189. package/domains/content/.agents/skills/readability-scoring/SKILL.md +15 -0
  190. package/domains/content/.agents/skills/seo-copywriting/SKILL.md +15 -0
  191. package/domains/content/.agents/skills/social-media-formats/SKILL.md +15 -0
  192. package/domains/content/.agents/skills/source-verification/SKILL.md +15 -0
  193. package/domains/content/.agents/skills/storytelling-framework/SKILL.md +15 -0
  194. package/domains/content/.agents/skills/tone-of-voice/SKILL.md +15 -0
  195. package/domains/content/.agents/skills/topic-research/SKILL.md +15 -0
  196. package/domains/content/.agents/skills/trend-research/SKILL.md +15 -0
  197. package/domains/content/.agents/skills/visual-brief/SKILL.md +15 -0
  198. package/domains/content/AGENTS.md +4 -0
  199. package/domains/content/agents/auditor.md +76 -0
  200. package/domains/content/agents/conductor.md +11 -0
  201. package/domains/content/agents/copywriter.md +11 -0
  202. package/domains/content/agents/researcher.md +11 -0
  203. package/domains/content/agents/reviewer.md +11 -0
  204. package/domains/content/agents/strategist.md +11 -0
  205. package/domains/content/agents/visual_concept.md +11 -0
  206. package/domains/content/locales/en/.agents/skills/audience-analysis/SKILL.md +15 -0
  207. package/domains/content/locales/en/.agents/skills/board/SKILL.md +20 -0
  208. package/domains/content/locales/en/.agents/skills/brand-compliance/SKILL.md +15 -0
  209. package/domains/content/locales/en/.agents/skills/brand-guidelines/SKILL.md +17 -0
  210. package/domains/content/locales/en/.agents/skills/competitor-content-analysis/SKILL.md +15 -0
  211. package/domains/content/locales/en/.agents/skills/content-brief/SKILL.md +15 -0
  212. package/domains/content/locales/en/.agents/skills/content-calendar/SKILL.md +15 -0
  213. package/domains/content/locales/en/.agents/skills/content-release-gate/SKILL.md +15 -0
  214. package/domains/content/locales/en/.agents/skills/content-review-checklist/SKILL.md +15 -0
  215. package/domains/content/locales/en/.agents/skills/cta-optimization/SKILL.md +15 -0
  216. package/domains/content/locales/en/.agents/skills/data-storytelling/SKILL.md +15 -0
  217. package/domains/content/locales/en/.agents/skills/email-copywriting/SKILL.md +15 -0
  218. package/domains/content/locales/en/.agents/skills/email-engagement-tiers/SKILL.md +15 -0
  219. package/domains/content/locales/en/.agents/skills/fact-checking/SKILL.md +15 -0
  220. package/domains/content/locales/en/.agents/skills/gates/SKILL.md +20 -0
  221. package/domains/content/locales/en/.agents/skills/google-stitch-content/SKILL.md +15 -0
  222. package/domains/content/locales/en/.agents/skills/handoff/SKILL.md +24 -0
  223. package/domains/content/locales/en/.agents/skills/headline-formulas/SKILL.md +15 -0
  224. package/domains/content/locales/en/.agents/skills/image-prompt-engineering/SKILL.md +15 -0
  225. package/domains/content/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +30 -1
  226. package/domains/content/locales/en/.agents/skills/mailerlite-email-ops/SKILL.md +15 -0
  227. package/domains/content/locales/en/.agents/skills/marketing-psychology/SKILL.md +15 -0
  228. package/domains/content/locales/en/.agents/skills/moodboard/SKILL.md +15 -0
  229. package/domains/content/locales/en/.agents/skills/platform-compliance/SKILL.md +15 -0
  230. package/domains/content/locales/en/.agents/skills/platform-strategy/SKILL.md +15 -0
  231. package/domains/content/locales/en/.agents/skills/platform-visual-specs/SKILL.md +15 -0
  232. package/domains/content/locales/en/.agents/skills/readability-scoring/SKILL.md +15 -0
  233. package/domains/content/locales/en/.agents/skills/seo-copywriting/SKILL.md +15 -0
  234. package/domains/content/locales/en/.agents/skills/social-media-formats/SKILL.md +15 -0
  235. package/domains/content/locales/en/.agents/skills/source-verification/SKILL.md +15 -0
  236. package/domains/content/locales/en/.agents/skills/storytelling-framework/SKILL.md +15 -0
  237. package/domains/content/locales/en/.agents/skills/tone-of-voice/SKILL.md +15 -0
  238. package/domains/content/locales/en/.agents/skills/topic-research/SKILL.md +15 -0
  239. package/domains/content/locales/en/.agents/skills/trend-research/SKILL.md +15 -0
  240. package/domains/content/locales/en/.agents/skills/visual-brief/SKILL.md +15 -0
  241. package/domains/content/locales/en/AGENTS.md +4 -0
  242. package/domains/content/locales/en/agents/auditor.md +76 -0
  243. package/domains/content/locales/en/agents/conductor.md +12 -0
  244. package/domains/content/locales/en/agents/copywriter.md +12 -0
  245. package/domains/content/locales/en/agents/researcher.md +12 -0
  246. package/domains/content/locales/en/agents/reviewer.md +12 -0
  247. package/domains/content/locales/en/agents/strategist.md +12 -0
  248. package/domains/content/locales/en/agents/visual_concept.md +12 -0
  249. package/domains/content/persona/persona-base.md +94 -0
  250. package/domains/content/pipeline.yaml +96 -0
  251. package/domains/development/.agents/skills/adr-log/SKILL.md +1 -0
  252. package/domains/development/.agents/skills/design-intake/SKILL.md +0 -4
  253. package/domains/development/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  254. package/domains/development/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  255. package/domains/development/.agents/skills/mcp-integration/SKILL.md +211 -0
  256. package/domains/development/.agents/skills/mcp-integration/agents/claude.json +22 -0
  257. package/domains/development/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  258. package/domains/development/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  259. package/domains/development/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  260. package/domains/development/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  261. package/domains/development/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  262. package/domains/development/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  263. package/domains/development/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  264. package/domains/development/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  265. package/domains/development/AGENTS.md +1 -0
  266. package/domains/development/AGENTS.yaml +1 -0
  267. package/domains/development/agents/architect.md +13 -1
  268. package/domains/development/agents/auditor.md +74 -0
  269. package/domains/development/agents/conductor.md +14 -3
  270. package/domains/development/agents/devops.md +8 -9
  271. package/domains/development/agents/reviewer.md +12 -0
  272. package/domains/development/agents/senior_full_stack.md +12 -0
  273. package/domains/development/agents/tester.md +10 -16
  274. package/domains/development/locales/en/.agents/skills/adr-log/SKILL.md +1 -0
  275. package/domains/development/locales/en/.agents/skills/current-state-analysis/SKILL.md +256 -172
  276. package/domains/development/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +2 -1
  277. package/domains/development/locales/en/.agents/skills/lava-flow-legacy-detection/SKILL.md +15 -1
  278. package/domains/development/locales/en/.agents/skills/mcp-integration/SKILL.md +211 -0
  279. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/claude.json +22 -0
  280. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/copilot.json +22 -0
  281. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/gemini.json +22 -0
  282. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/kimi.yaml +18 -0
  283. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/openai.yaml +8 -0
  284. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/qwen.json +22 -0
  285. package/domains/development/locales/en/.agents/skills/mcp-integration/agents/skill.yaml +26 -0
  286. package/domains/development/locales/en/.agents/skills/qa-ui-a11y-smoke/SKILL.md +1 -1
  287. package/domains/development/locales/en/.agents/skills/ui-a11y-smoke-review/SKILL.md +1 -1
  288. package/domains/development/locales/en/AGENTS.md +5 -0
  289. package/domains/development/locales/en/AGENTS.yaml +1 -0
  290. package/domains/development/locales/en/agents/architect.md +13 -1
  291. package/domains/development/locales/en/agents/auditor.md +74 -0
  292. package/domains/development/locales/en/agents/conductor.md +14 -3
  293. package/domains/development/locales/en/agents/devops.md +8 -9
  294. package/domains/development/locales/en/agents/reviewer.md +12 -0
  295. package/domains/development/locales/en/agents/senior_full_stack.md +12 -0
  296. package/domains/development/locales/en/agents/tester.md +10 -16
  297. package/domains/development/persona/persona-base.md +94 -0
  298. package/domains/product/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  299. package/domains/product/.agents/skills/ab-test-design/SKILL.md +428 -412
  300. package/domains/product/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  301. package/domains/product/.agents/skills/assumption-mapping/SKILL.md +323 -307
  302. package/domains/product/.agents/skills/board/SKILL.md +24 -0
  303. package/domains/product/.agents/skills/design-brief/SKILL.md +433 -418
  304. package/domains/product/.agents/skills/epic-breakdown/SKILL.md +435 -420
  305. package/domains/product/.agents/skills/gates/SKILL.md +470 -446
  306. package/domains/product/.agents/skills/gtm-brief/SKILL.md +18 -321
  307. package/domains/product/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  308. package/domains/product/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  309. package/domains/product/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  310. package/domains/product/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  311. package/domains/product/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  312. package/domains/product/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  313. package/domains/product/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  314. package/domains/product/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  315. package/domains/product/.agents/skills/handoff/SKILL.md +463 -439
  316. package/domains/product/.agents/skills/html-pdf-report/SKILL.md +21 -663
  317. package/domains/product/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  318. package/domains/product/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  319. package/domains/product/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  320. package/domains/product/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  321. package/domains/product/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  322. package/domains/product/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  323. package/domains/product/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  324. package/domains/product/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  325. package/domains/product/.agents/skills/hypothesis-template/SKILL.md +484 -469
  326. package/domains/product/.agents/skills/jtbd-canvas/SKILL.md +274 -258
  327. package/domains/product/.agents/skills/kano-model/SKILL.md +370 -355
  328. package/domains/product/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  329. package/domains/product/.agents/skills/launch-checklist/SKILL.md +434 -419
  330. package/domains/product/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  331. package/domains/product/.agents/skills/north-star-metric/SKILL.md +317 -301
  332. package/domains/product/.agents/skills/okr-framework/SKILL.md +299 -284
  333. package/domains/product/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  334. package/domains/product/.agents/skills/prd-template/SKILL.md +18 -258
  335. package/domains/product/.agents/skills/prd-template-reference/SKILL.md +285 -0
  336. package/domains/product/.agents/skills/prd-template-reference/agents/claude.json +17 -0
  337. package/domains/product/.agents/skills/prd-template-reference/agents/copilot.json +17 -0
  338. package/domains/product/.agents/skills/prd-template-reference/agents/gemini.json +17 -0
  339. package/domains/product/.agents/skills/prd-template-reference/agents/kimi.yaml +16 -0
  340. package/domains/product/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  341. package/domains/product/.agents/skills/prd-template-reference/agents/qwen.json +17 -0
  342. package/domains/product/.agents/skills/prd-template-reference/agents/skill.yaml +23 -0
  343. package/domains/product/.agents/skills/problem-statement/SKILL.md +327 -312
  344. package/domains/product/.agents/skills/product-roadmap/SKILL.md +320 -304
  345. package/domains/product/.agents/skills/product-vision/SKILL.md +409 -394
  346. package/domains/product/.agents/skills/release-notes/SKILL.md +18 -258
  347. package/domains/product/.agents/skills/release-notes-reference/SKILL.md +285 -0
  348. package/domains/product/.agents/skills/release-notes-reference/agents/claude.json +17 -0
  349. package/domains/product/.agents/skills/release-notes-reference/agents/copilot.json +17 -0
  350. package/domains/product/.agents/skills/release-notes-reference/agents/gemini.json +17 -0
  351. package/domains/product/.agents/skills/release-notes-reference/agents/kimi.yaml +15 -0
  352. package/domains/product/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  353. package/domains/product/.agents/skills/release-notes-reference/agents/qwen.json +17 -0
  354. package/domains/product/.agents/skills/release-notes-reference/agents/skill.yaml +22 -0
  355. package/domains/product/.agents/skills/report-design/SKILL.md +17 -307
  356. package/domains/product/.agents/skills/report-design-reference/SKILL.md +331 -0
  357. package/domains/product/.agents/skills/report-design-reference/agents/claude.json +17 -0
  358. package/domains/product/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  359. package/domains/product/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  360. package/domains/product/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  361. package/domains/product/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  362. package/domains/product/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  363. package/domains/product/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  364. package/domains/product/.agents/skills/rice-scoring/SKILL.md +266 -251
  365. package/domains/product/.agents/skills/saas-metrics/SKILL.md +422 -404
  366. package/domains/product/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  367. package/domains/product/.agents/skills/user-flow/SKILL.md +491 -476
  368. package/domains/product/.agents/skills/user-interview-script/SKILL.md +315 -298
  369. package/domains/product/.agents/skills/user-story/SKILL.md +401 -385
  370. package/domains/product/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  371. package/domains/product/AGENTS.md +5 -0
  372. package/domains/product/AGENTS.yaml +1 -0
  373. package/domains/product/agents/auditor.md +76 -0
  374. package/domains/product/agents/conductor.md +11 -0
  375. package/domains/product/agents/data_analyst.md +11 -0
  376. package/domains/product/agents/designer.md +11 -0
  377. package/domains/product/agents/discovery.md +11 -0
  378. package/domains/product/agents/layouter.md +11 -0
  379. package/domains/product/agents/mediator.md +11 -0
  380. package/domains/product/agents/pm.md +11 -0
  381. package/domains/product/agents/product_strategist.md +11 -0
  382. package/domains/product/agents/tech_lead.md +11 -0
  383. package/domains/product/agents/ux_designer.md +11 -0
  384. package/domains/product/locales/en/.agents/skills/aarrr-metrics/SKILL.md +451 -433
  385. package/domains/product/locales/en/.agents/skills/ab-test-design/SKILL.md +428 -412
  386. package/domains/product/locales/en/.agents/skills/acceptance-criteria/SKILL.md +422 -406
  387. package/domains/product/locales/en/.agents/skills/assumption-mapping/SKILL.md +323 -307
  388. package/domains/product/locales/en/.agents/skills/board/SKILL.md +24 -0
  389. package/domains/product/locales/en/.agents/skills/design-brief/SKILL.md +433 -418
  390. package/domains/product/locales/en/.agents/skills/epic-breakdown/SKILL.md +435 -420
  391. package/domains/product/locales/en/.agents/skills/gates/SKILL.md +470 -446
  392. package/domains/product/locales/en/.agents/skills/gtm-brief/SKILL.md +18 -321
  393. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/SKILL.md +348 -0
  394. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/claude.json +17 -0
  395. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/copilot.json +17 -0
  396. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/gemini.json +17 -0
  397. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/kimi.yaml +15 -0
  398. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/openai.yaml +10 -0
  399. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/qwen.json +17 -0
  400. package/domains/product/locales/en/.agents/skills/gtm-brief-reference/agents/skill.yaml +22 -0
  401. package/domains/product/locales/en/.agents/skills/handoff/SKILL.md +463 -439
  402. package/domains/product/locales/en/.agents/skills/html-pdf-report/SKILL.md +21 -663
  403. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/SKILL.md +699 -0
  404. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/claude.json +17 -0
  405. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/copilot.json +17 -0
  406. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/gemini.json +17 -0
  407. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/kimi.yaml +15 -0
  408. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/openai.yaml +10 -0
  409. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/qwen.json +17 -0
  410. package/domains/product/locales/en/.agents/skills/html-pdf-report-reference/agents/skill.yaml +22 -0
  411. package/domains/product/locales/en/.agents/skills/hypothesis-template/SKILL.md +484 -469
  412. package/domains/product/locales/en/.agents/skills/jtbd-canvas/SKILL.md +273 -257
  413. package/domains/product/locales/en/.agents/skills/kano-model/SKILL.md +370 -355
  414. package/domains/product/locales/en/.agents/skills/karpathy-guidelines/SKILL.md +36 -0
  415. package/domains/product/locales/en/.agents/skills/launch-checklist/SKILL.md +434 -419
  416. package/domains/product/locales/en/.agents/skills/moscow-prioritization/SKILL.md +407 -392
  417. package/domains/product/locales/en/.agents/skills/north-star-metric/SKILL.md +317 -301
  418. package/domains/product/locales/en/.agents/skills/okr-framework/SKILL.md +299 -284
  419. package/domains/product/locales/en/.agents/skills/opportunity-solution-tree/SKILL.md +472 -456
  420. package/domains/product/locales/en/.agents/skills/prd-template/SKILL.md +18 -258
  421. package/domains/product/locales/en/.agents/skills/prd-template-reference/SKILL.md +285 -0
  422. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/claude.json +16 -0
  423. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/copilot.json +16 -0
  424. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/gemini.json +16 -0
  425. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/kimi.yaml +15 -0
  426. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/openai.yaml +10 -0
  427. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/qwen.json +16 -0
  428. package/domains/product/locales/en/.agents/skills/prd-template-reference/agents/skill.yaml +22 -0
  429. package/domains/product/locales/en/.agents/skills/problem-statement/SKILL.md +327 -312
  430. package/domains/product/locales/en/.agents/skills/product-roadmap/SKILL.md +321 -305
  431. package/domains/product/locales/en/.agents/skills/product-vision/SKILL.md +410 -395
  432. package/domains/product/locales/en/.agents/skills/release-notes/SKILL.md +18 -258
  433. package/domains/product/locales/en/.agents/skills/release-notes-reference/SKILL.md +285 -0
  434. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/claude.json +16 -0
  435. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/copilot.json +16 -0
  436. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/gemini.json +16 -0
  437. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/kimi.yaml +14 -0
  438. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/openai.yaml +10 -0
  439. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/qwen.json +16 -0
  440. package/domains/product/locales/en/.agents/skills/release-notes-reference/agents/skill.yaml +21 -0
  441. package/domains/product/locales/en/.agents/skills/report-design/SKILL.md +17 -307
  442. package/domains/product/locales/en/.agents/skills/report-design-reference/SKILL.md +331 -0
  443. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/claude.json +17 -0
  444. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/copilot.json +17 -0
  445. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/gemini.json +17 -0
  446. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/kimi.yaml +15 -0
  447. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/openai.yaml +10 -0
  448. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/qwen.json +17 -0
  449. package/domains/product/locales/en/.agents/skills/report-design-reference/agents/skill.yaml +22 -0
  450. package/domains/product/locales/en/.agents/skills/rice-scoring/SKILL.md +266 -251
  451. package/domains/product/locales/en/.agents/skills/saas-metrics/SKILL.md +422 -404
  452. package/domains/product/locales/en/.agents/skills/session-prompt-generator/SKILL.md +474 -450
  453. package/domains/product/locales/en/.agents/skills/user-flow/SKILL.md +491 -476
  454. package/domains/product/locales/en/.agents/skills/user-interview-script/SKILL.md +314 -297
  455. package/domains/product/locales/en/.agents/skills/user-story/SKILL.md +401 -385
  456. package/domains/product/locales/en/.agents/skills/wsjf-scoring/SKILL.md +333 -315
  457. package/domains/product/locales/en/AGENTS.md +5 -0
  458. package/domains/product/locales/en/agents/auditor.md +76 -0
  459. package/domains/product/locales/en/agents/conductor.md +11 -0
  460. package/domains/product/locales/en/agents/data_analyst.md +11 -0
  461. package/domains/product/locales/en/agents/designer.md +11 -0
  462. package/domains/product/locales/en/agents/discovery.md +11 -0
  463. package/domains/product/locales/en/agents/layouter.md +11 -0
  464. package/domains/product/locales/en/agents/mediator.md +11 -0
  465. package/domains/product/locales/en/agents/pm.md +11 -0
  466. package/domains/product/locales/en/agents/product_strategist.md +11 -0
  467. package/domains/product/locales/en/agents/tech_lead.md +11 -0
  468. package/domains/product/locales/en/agents/ux_designer.md +11 -0
  469. package/domains/product/persona/persona-base.md +94 -0
  470. package/domains/product/pipeline.yaml +115 -0
  471. package/package.json +72 -70
@@ -1,308 +1,323 @@
1
- ---
2
- name: web-research
3
- description: Обязательный веб-поиск и верификация данных — протокол поиска, перекрёстная проверка, аудит источников
4
- ---
5
- # Web Research — Обязательный веб-поиск и верификация данных
6
-
7
- ## Когда использовать
8
- - **Обязателен** для всех Researcher-гейтов (RES-xx) — без исключений.
9
- - При **любом утверждении**, основанном на внешних данных (рыночная статистика, регуляторные нормы, конкурентные данные).
10
- - При **верификации** данных, предоставленных пользователем — даже если пользователь уверен в их точности.
11
- - При **обнаружении устаревших данных** — обновление и актуализация.
12
-
13
- > **Абсолютное правило:** Researcher НЕ МОЖЕТ завершить гейт без выполнения `$web-research`. Отсутствие веб-поиска — автоматический **Blocker** при проверке `$gates`.
14
-
15
- ## Вход
16
-
17
- | Поле | Обязательно | Описание |
18
- |------|:-----------:|----------|
19
- | Research brief | ✅ | Вопросы для исследования (из Interviewer) |
20
- | Тема исследования | | Основная тема / отрасль / компания |
21
- | Данные пользователя | ⬚ | Данные, предоставленные пользователем для верификации |
22
- | Ограничения поиска | ⬚ | География, язык, период, исключения |
23
- | Минимум источников | | Минимальное количество источников на тезис (по умолчанию 3) |
24
-
25
- ### Связь с другими скилами
26
- | Скил | Взаимодействие | Когда |
27
- |------|----------------|-------|
28
- | `$gates` (RES-xx) | Отсутствие web-research = автоматический Blocker | При gate check каждого RES-гейта |
29
- | `$handoff` | Результаты web-research передаются Data Analyst через handoff | После завершения исследования |
30
- | `tam-sam-som` | Рыночные данные: TAM, CAGR, доли рынка | Когда Data Analyst применяет TAM/SAM/SOM |
31
- | `competitive-analysis` | Данные о конкурентах: фичи, цены, доли | Когда Data Analyst применяет конкурентный анализ |
32
- | `pest-analysis` | Макроданные: регуляция, экономика, демография | Когда Data Analyst применяет PEST/PESTEL |
33
- | `trend-analysis` | Тренды: adoption rates, инвестиции, прогнозы | Когда Data Analyst применяет анализ трендов |
34
- | `cohort-analysis` | Отраслевые бенчмарки retention | Если нет реальных данных по когортам |
35
- | `unit-economics` | Бенчмарки CAC, LTV, churn по отрасли | Если нет реальных unit economics |
36
- | Все фреймворк-скилы | Любые внешние данные, требуемые фреймворком | Всегда, когда фреймворк ссылается на `$web-research` |
37
-
38
- > `$web-research` **сервисный скил**: он обслуживает все аналитические скилы, поставляя верифицированные данные.
39
-
40
- ## Тирование источников
41
-
42
- | Tier | Тип источника | Примеры | Надёжность | Использование |
43
- |:----:|---------------|---------|:----------:|---------------|
44
- | **T1** | Официальные отчёты, госстатистика, рецензируемые | Statista, Gartner, McKinsey, World Bank, Росстат, SEC filings | Высокая | Основа для Verified. 1 источник T1 = достаточно для Estimated |
45
- | **T2** | Отраслевые медиа, аналитика, корпоративные блоги | TechCrunch, CB Insights, HH.ru Research, блоги компаний | Средняя | Подтверждение T1 или основа для Estimated. 2× T2 = Verified |
46
- | **T3** | Форумы, соцсети, личные мнения, агрегаторы | Reddit, HN, Quora, блоги экспертов, Telegram-каналы | Низкая | Только для сигналов и гипотез. Не может быть Verified. Максимум Assumed |
47
-
48
- **Правила:**
49
- - Verified = T1 + T1/T2, или T2 с совпадением данных.
50
- - Estimated = T1, или T2.
51
- - Assumed = T3, или косвенный расчёт, или экстраполяция.
52
- - **T3 никогда не считается за Verified или Estimated.**
53
-
54
- ## Уровни достоверности данных
55
-
56
- | Уровень | Маркер | Определение | Требования | В отчёте |
57
- |---------|:------:|-------------|------------|----------|
58
- | **Verified** | ✅ | Подтверждено 2+ независимыми источниками (T1/T2) | URL обоих, даты, совпадение | Можно утверждать |
59
- | **Estimated** | ⚠️ | Один T1/T2 источник или расчёт | URL, методология, оговорка | «По оценкам...» |
60
- | **Assumed** | 🔮 | Предположение, косвенные данные, T3 | Обоснование, косвенные источники | «Предположительно...» |
61
-
62
- ## Требования к актуальности данных
63
-
64
- | Тип данных | Максимальный возраст | Действие при устаревании |
65
- |-----------|:--------------------:|--------------------------|
66
- | Рыночная статистика | 12 месяцев | Искать свежие или помечать ⚠️ Estimated |
67
- | Регуляторные / правовые | Текущая версия | Обязательно проверить актуальность |
68
- | Финансовые показатели компаний | Последний отчётный период | Указать период отчёта |
69
- | Технологические тренды | 6 месяцев | Искать самые свежие |
70
- | Демографические данные | 24 месяца | Допустимо, если нет свежих |
71
-
72
- ## Протокол
73
-
74
- ### Шаг 0 Планирование поиска
75
- 1. Изучить research brief выделить ключевые вопросы.
76
- 2. Для каждого вопроса определить минимум 3 поисковых запроса.
77
- 3. Включить год в запросы для обеспечения актуальности.
78
- 4. Запланировать запросы на контр-доказательства (counter-evidence).
79
- 5. Определить приоритет источников: T1 T2 T3.
80
-
81
- ### Шаг 1 Выполнение поиска
82
- 1. Выполнить поисковые запросы через WebSearch.
83
- 2. Для каждого результата: извлечь данные через WebFetch.
84
- 3. Зафиксировать: URL, дату публикации, автора / организацию, **Tier источника**.
85
- 4. Минимум 3 запроса на каждую точку данных.
86
-
87
- ### Шаг 2 — Извлечение и структурирование данных
88
- 1. Из каждого источника извлечь конкретные данные (числа, факты, цитаты).
89
- 2. Привязать данные к вопросам из research brief.
90
- 3. Присвоить уровень достоверности (Verified / Estimated / Assumed) по правилам тирования.
91
- 4. Проставить дату-штамп для каждой точки данных.
92
-
93
- ### Шаг 3 Перекрёстная проверка
94
- 1. Для каждой ключевой точки данных найти подтверждение в 2+ источниках.
95
- 2. При расхождении данных: зафиксировать оба значения, указать источники, пометить как конфликт.
96
- 3. При конфликтепопытаться найти третий источник для разрешения.
97
- 4. Если конфликт не разрешён — передать обе версии с пометкой «Конфликт: [значение A] vs [значение B]».
98
-
99
- ### Шаг 4 Поиск контр-доказательств
100
- 1. Для каждого ключевого тезиса целенаправленно искать опровержения.
101
- 2. Сформулировать запросы вида: «[тезис] criticism», «[тезис] disadvantages», «[тезис] risks».
102
- 3. Зафиксировать найденные контр-аргументы.
103
- 4. Если контр-доказательств не найдено зафиксировать как «контр-позиция не обнаружена».
104
-
105
- ### Шаг 5 Формирование аудит-трейла
106
- 1. Записать все использованные поисковые запросы.
107
- 2. Записать все посещённые URL (даже если данные не использованы).
108
- 3. Записать причины отклонения источников (устарел, T3, нерелевантен, конфликтует).
109
- 4. Сформировать итоговую таблицу источников.
110
-
111
- ### Шаг 6Оценка качества исследования
112
- Рассчитать метрики качества:
113
-
114
- | Метрика | Формула | Значение | Порог |
115
- |---------|---------|:--------:|:-----:|
116
- | **Verified %** | Verified / Total × 100 | XX% | ≥ 50% — хорошо |
117
- | **Coverage** | Вопросов покрыто / Всего вопросов × 100 | XX% | 100% — обязательно |
118
- | **Source diversity** | Уникальных источников / Точек данных | X.X | ≥ 1.5 — хорошо |
119
- | **Counter-evidence rate** | Тезисов с контр-поиском / Всего тезисов × 100 | XX% | 100% — обязательно |
120
- | **Conflict rate** | Неразрешённых конфликтов / Всего точек × 100 | XX% | ≤ 10% допустимо |
121
-
122
- **Качество исследования:**
123
-
124
- | Verified % | Оценка | Действие |
125
- |:----------:|--------|----------|
126
- | 70% | 🟢 Высокое | Можно передавать Data Analyst |
127
- | 50-69% | 🟡 Среднее | Передавать с оговоркой, рекомендовать дополнительный поиск |
128
- | < 50% | 🔴 Низкое | Доработать: найти больше T1/T2 источников |
129
-
130
- ### Шаг 7 — Компиляция результатов
131
- 1. Структурировать данные по вопросам research brief.
132
- 2. Для каждого вопроса: факты источники Tier) уровень достоверности контр-позиция.
133
- 3. Выделить конфликты и неразрешённые вопросы.
134
- 4. Приложить метрики качества.
135
- 5. Сформировать выводы для передачи Data Analyst.
136
-
137
- ## Паттерны поисковых запросов
138
-
139
- ### Обязательные паттерны
140
- | Паттерн | Пример | Цель |
141
- |---------|--------|------|
142
- | `[тема] [год]` | «SaaS market size 2025» | Актуальные данные |
143
- | `[тема] statistics report` | «e-commerce Russia statistics report» | Официальные отчёты (T1) |
144
- | `[тема] criticism risks` | «remote work criticism risks» | Контр-доказательства |
145
- | `[компания] revenue financial results` | «Skillbox revenue 2025» | Финансовые данные |
146
- | `[тема] vs [альтернатива]` | «Bitrix24 vs amoCRM 2025» | Сравнительные данные |
147
- | `site:statista.com [тема]` | `site:statista.com cloud computing` | T1 источники |
148
- | `[тема] research [отрасль]` | «retention benchmarks SaaS B2B» | Отраслевые бенчмарки |
149
-
150
- ### Запрещённые паттерны
151
- | Паттерн | Почему | Альтернатива |
152
- |---------|--------|-------------|
153
- | Один общий запрос на всю тему | Поверхностные данные | Минимум 3 запроса на точку данных |
154
- | Запрос без года | Устаревшие результаты | Всегда включать год |
155
- | Только подтверждающие запросы | Confirmation bias | Обязательно искать контр-доказательства |
156
- | Копирование данных без проверки | Недостоверные данные | Перекрёстная проверка 2+ источников |
157
- | Только T3 источники | Низкая надёжность | Приоритет: T1 T2 → T3 как дополнение |
158
-
159
- ## Пример Web Research для «Рынок EdTech РФ, корпоративное обучение»
160
-
161
- **Research brief (из INT-01):** 4 из 12 вопросов (фрагмент).
162
-
163
- ### Вопрос 1: Каков размер рынка EdTech РФ (TAM)?
164
-
165
- | # | Факт | Источник | Tier | URL | Дата | Достоверность |
166
- |---|------|----------|:----:|-----|------|:-------------:|
167
- | 1 | EdTech РФ = $4.2B (2026) | Smart Ranking | T1 | smart-ranking.ru/... | 2026-01 | ✅ Verified |
168
- | 2 | EdTech РФ = $3.9-4.5B (2026) | ВШЭ, ИСИЭЗ | T1 | hse.ru/... | 2025-11 | ✅ Verified |
169
- | 3 | Корп. обучение = 43% от EdTech | ВШЭ | T1 | hse.ru/... | 2025-11 | ⚠️ Estimated |
170
-
171
- **Контр-позиция:** Smart Ranking отмечает, что 30% рынка теневой сектор (частные репетиторы), что может завышать TAM. Источник: smart-ranking.ru/methodology.
172
- **Конфликты:** Нет (разброс $3.9-4.5B = нормальный для разных методологий).
173
-
174
- ### Вопрос 3: Какие технологические тренды меняют рынок?
175
-
176
- | # | Факт | Источник | Tier | URL | Дата | Достоверность |
177
- |---|------|----------|:----:|-----|------|:-------------:|
178
- | 1 | AI-персонализация: adoption 12% в EdTech | Gartner | T1 | gartner.com/... | 2025-09 | ✅ Verified |
179
- | 2 | AI-персонализация: Duolingo +40% retention | TechCrunch | T2 | techcrunch.com/... | 2025-07 | ✅ Verified (с #1) |
180
- | 3 | LLM снижает стоимость курса ×5 | a16z | T2 | a16z.com/... | 2026-02 | ⚠️ Estimated |
181
- | 4 | «AI в обучении переоценён для корп. сектора» | HBR | T1 | hbr.org/... | 2025-10 | ✅ Контр-позиция |
182
-
183
- **Контр-позиция:** HBR аргументирует, что корп. обучение требует human-in-the-loop и AI-only решения не работают для soft skills.
184
-
185
- ### Метрики качества
186
-
187
- | Метрика | Значение | Порог | Оценка |
188
- |---------|:--------:|:-----:|:------:|
189
- | Verified % | 62% (18/29) | ≥ 50% | 🟡 Среднее |
190
- | Coverage | 100% (12/12 вопросов) | 100% | 🟢 |
191
- | Source diversity | 1.7 (48 источников / 29 точек) | 1.5 | 🟢 |
192
- | Counter-evidence rate | 100% (12/12 тезисов) | 100% | 🟢 |
193
- | Conflict rate | 7% (2/29) | 10% | 🟢 |
194
-
195
- **Качество: 🟡 Среднее** (Verified 62% передавать с оговоркой, рекомендовать дополнительный T1 поиск для ⚠️ данных).
196
-
197
- ### Аудит-трейл (фрагмент)
198
-
199
- | # | Запрос | Результатов | Использовано | Отклонено |
200
- |---|--------|:-----------:|:------------:|:---------:|
201
- | 1 | «EdTech market Russia 2025 2026» | 23 | 4 | 19 (устарели: 8, нерелевантны: 11) |
202
- | 2 | «корпоративное обучение рынок РФ отчёт» | 15 | 3 | 12 (T3: 5, дубли: 4, устарели: 3) |
203
- | 3 | «EdTech Russia criticism risks 2025» | 9 | 2 | 7 (нерелевантны) |
204
-
205
- **Всего:** 38 запросов, 112 результатов, 48 источников использовано, 64 отклонено.
206
-
207
- ## Валидация (Quality Gate)
208
-
209
- Веб-исследование считается завершённым если:
210
-
211
- - [ ] Все вопросы research brief покрыты данными (Coverage = 100%)
212
- - [ ] WebSearch / WebFetch использованы (не «по памяти»)
213
- - [ ] Каждая точка данных: URL, дата, Tier источника, уровень достоверности
214
- - [ ] Перекрёстная проверка выполнена (2+ источника на ключевые данные)
215
- - [ ] Контр-доказательства искались целенаправленно для каждого тезиса (Counter-evidence = 100%)
216
- - [ ] Данные актуальны по таблице требований
217
- - [ ] Аудит-трейл заполнен (все запросы, URL, причины отклонения)
218
- - [ ] Конфликтующие данные помечены и объяснены (Conflict rate 10%)
219
- - [ ] Минимум источников достигнут (по умолчанию ≥ 3 на тезис)
220
- - [ ] Verified % 50% (если < 50% — доработать или передать с оговоркой 🔴)
221
- - [ ] T3 источники не использованы как Verified или Estimated
222
-
223
- ## Handoff
224
- Результат `$web-research` является входными данными для:
225
- - **Data Analyst (AN-xx)** — верифицированные данные для применения фреймворков.
226
- - **Все фреймворк-скилы** через Data Analyst: данные поступают в TAM/SAM/SOM, Competitive Analysis, PEST, SWOT и т.д.
227
- - **`$gates` (RES-xx)** gate check проверяет наличие и качество web-research.
228
-
229
- Формат передачи: структурированный отчёт (по вопросам research brief) + таблица источников Tier и достоверностью) + метрики качества + аудит-трейл. При передаче — использовать `$handoff`.
230
-
231
- ## Anti-patterns
232
-
233
- | Ошибка | Почему плохо | Как правильно |
234
- |--------|-------------|---------------|
235
- | Данные «по памяти» без поиска | Могут быть устаревшими или неточными | Всегда выполнять WebSearch |
236
- | Один источник = «факт» | Нет перекрёстной проверки | 2+ источника (T1/T2) на ключевые данные |
237
- | Нет контр-доказательств | Confirmation bias, однобокий анализ | Целенаправленно искать опровержения (100%) |
238
- | URL без даты и Tier | Невозможно оценить актуальность и надёжность | Всегда: URL + дата + Tier (T1/T2/T3) |
239
- | Все данные Verified | Нереалистично, скрывает неопределённость | Честно: Verified / Estimated / Assumed |
240
- | Запросы без года | Устаревшие результаты | Включать текущий год в запрос |
241
- | Пропуск аудит-трейла | Невозможно проверить качество исследования | Записывать все запросы, URL, причины отклонения |
242
- | Только T3 источники | Низкая надёжность, не может быть Verified | Приоритет T1 → T2; T3 только как сигнал |
243
- | Verified < 50% без доработки | Большинство данных ненадёжно | Доработать: найти T1/T2 или передать с оговоркой 🔴 |
244
-
245
- ## Шаблон вывода
246
-
247
- ```
248
- ### Web Research Report [Тема]
249
-
250
- **Researcher:** [RES-xx]
251
- **Дата:** [YYYY-MM-DD]
252
- **Research brief:** [N вопросов из INT-01]
253
-
254
- ---
255
-
256
- #### Метрики качества
257
-
258
- | Метрика | Значение | Порог | Оценка |
259
- |---------|:--------:|:-----:|:------:|
260
- | Verified % | XX% | ≥ 50% | 🟢/🟡/🔴 |
261
- | Coverage | XX% | 100% | 🟢/🔴 |
262
- | Source diversity | X.X | ≥ 1.5 | 🟢/🟡 |
263
- | Counter-evidence rate | XX% | 100% | 🟢/🔴 |
264
- | Conflict rate | XX% | ≤ 10% | 🟢/🟡 |
265
-
266
- **Качество исследования:** 🟢 Высокое / 🟡 Среднее / 🔴 Низкое
267
-
268
- ---
269
-
270
- #### Результаты по вопросам
271
-
272
- ##### Вопрос 1: [Формулировка из research brief]
273
-
274
- | # | Факт / Данные | Источник | Tier | URL | Дата | Достоверность |
275
- |---|--------------|----------|:----:|-----|------|:-------------:|
276
- | 1 | [Значение] | [Название] | T1/T2/T3 | [URL] | [YYYY-MM] | ✅ / ⚠️ / 🔮 |
277
-
278
- **Контр-позиция:** [Найденные контр-аргументы или «Не обнаружена»]
279
- **Конфликты:** [Расхождения или «Нет»]
280
-
281
- ##### Вопрос 2: [Формулировка]
282
- [аналогично]
283
-
284
- ---
285
-
286
- #### Сводка достоверности
287
-
288
- | Уровень | Кол-во | Доля |
289
- |---------|:------:|:----:|
290
- | ✅ Verified | [N] | XX% |
291
- | ⚠️ Estimated | [N] | XX% |
292
- | 🔮 Assumed | [N] | XX% |
293
-
294
- #### Нерешённые конфликты
295
-
296
- | # | Данные A | Источник A (Tier) | Данные B | Источник B (Tier) | Комментарий |
297
- |---|---------|:-----------------:|---------|:-----------------:|-------------|
298
-
299
- ---
300
-
301
- #### Аудит-трейл
302
-
303
- | # | Запрос | Результатов | Использовано | Отклонено (причина) |
304
- |---|--------|:-----------:|:------------:|---------------------|
305
- | 1 | [запрос] | [N] | [N] | [N] ([причины]) |
306
-
307
- **Всего:** [N] запросов, [N] результатов, [N] использовано, [N] отклонено
308
- ```
1
+ ---
2
+ name: web-research
3
+ description: Обязательный веб-поиск и верификация данных — протокол поиска, перекрёстная проверка, аудит источников
4
+ type: mandatory
5
+ domain: analytics
6
+ owners:
7
+ - researcher
8
+ gates:
9
+ - RESEARCHER
10
+ tech: []
11
+ topic: []
12
+ triggers:
13
+ - "web-research"
14
+ - "Веб-поиск и верификация данных"
15
+ - "Обязательный веб-поиск и верификация данных — протокол поиска, перекрёстная проверка, аудит источников"
16
+ related: []
17
+ budget_lines: 323
18
+ schema_version: 1
19
+ ---
20
+ # Web Research Обязательный веб-поиск и верификация данных
21
+
22
+ ## Когда использовать
23
+ - **Обязателен** для всех Researcher-гейтов (RES-xx) без исключений.
24
+ - При **любом утверждении**, основанном на внешних данных (рыночная статистика, регуляторные нормы, конкурентные данные).
25
+ - При **верификации** данных, предоставленных пользователем — даже если пользователь уверен в их точности.
26
+ - При **обнаружении устаревших данных** обновление и актуализация.
27
+
28
+ > **Абсолютное правило:** Researcher НЕ МОЖЕТ завершить гейт без выполнения `$web-research`. Отсутствие веб-поиска — автоматический **Blocker** при проверке `$gates`.
29
+
30
+ ## Вход
31
+
32
+ | Поле | Обязательно | Описание |
33
+ |------|:-----------:|----------|
34
+ | Research brief | | Вопросы для исследования (из Interviewer) |
35
+ | Тема исследования | | Основная тема / отрасль / компания |
36
+ | Данные пользователя | | Данные, предоставленные пользователем для верификации |
37
+ | Ограничения поиска | ⬚ | География, язык, период, исключения |
38
+ | Минимум источников | | Минимальное количество источников на тезис (по умолчанию 3) |
39
+
40
+ ### Связь с другими скилами
41
+ | Скил | Взаимодействие | Когда |
42
+ |------|----------------|-------|
43
+ | `$gates` (RES-xx) | Отсутствие web-research = автоматический Blocker | При gate check каждого RES-гейта |
44
+ | `$handoff` | Результаты web-research передаются Data Analyst через handoff | После завершения исследования |
45
+ | `tam-sam-som` | Рыночные данные: TAM, CAGR, доли рынка | Когда Data Analyst применяет TAM/SAM/SOM |
46
+ | `competitive-analysis` | Данные о конкурентах: фичи, цены, доли | Когда Data Analyst применяет конкурентный анализ |
47
+ | `pest-analysis` | Макроданные: регуляция, экономика, демография | Когда Data Analyst применяет PEST/PESTEL |
48
+ | `trend-analysis` | Тренды: adoption rates, инвестиции, прогнозы | Когда Data Analyst применяет анализ трендов |
49
+ | `cohort-analysis` | Отраслевые бенчмарки retention | Если нет реальных данных по когортам |
50
+ | `unit-economics` | Бенчмарки CAC, LTV, churn по отрасли | Если нет реальных unit economics |
51
+ | Все фреймворк-скилы | Любые внешние данные, требуемые фреймворком | Всегда, когда фреймворк ссылается на `$web-research` |
52
+
53
+ > `$web-research` — **сервисный скил**: он обслуживает все аналитические скилы, поставляя верифицированные данные.
54
+
55
+ ## Тирование источников
56
+
57
+ | Tier | Тип источника | Примеры | Надёжность | Использование |
58
+ |:----:|---------------|---------|:----------:|---------------|
59
+ | **T1** | Официальные отчёты, госстатистика, рецензируемые | Statista, Gartner, McKinsey, World Bank, Росстат, SEC filings | Высокая | Основа для Verified. 1 источник T1 = достаточно для Estimated |
60
+ | **T2** | Отраслевые медиа, аналитика, корпоративные блоги | TechCrunch, CB Insights, HH.ru Research, блоги компаний | Средняя | Подтверждение T1 или основа для Estimated. 2× T2 = Verified |
61
+ | **T3** | Форумы, соцсети, личные мнения, агрегаторы | Reddit, HN, Quora, блоги экспертов, Telegram-каналы | Низкая | Только для сигналов и гипотез. Не может быть Verified. Максимум Assumed |
62
+
63
+ **Правила:**
64
+ - Verified = T1 + T1/T2, или T2 с совпадением данных.
65
+ - Estimated = 1× T1, или 2× T2.
66
+ - Assumed = T3, или косвенный расчёт, или экстраполяция.
67
+ - **T3 никогда не считается за Verified или Estimated.**
68
+
69
+ ## Уровни достоверности данных
70
+
71
+ | Уровень | Маркер | Определение | Требования | В отчёте |
72
+ |---------|:------:|-------------|------------|----------|
73
+ | **Verified** | ✅ | Подтверждено 2+ независимыми источниками (T1/T2) | URL обоих, даты, совпадение | Можно утверждать |
74
+ | **Estimated** | ⚠️ | Один T1/T2 источник или расчёт | URL, методология, оговорка | «По оценкам...» |
75
+ | **Assumed** | 🔮 | Предположение, косвенные данные, T3 | Обоснование, косвенные источники | «Предположительно...» |
76
+
77
+ ## Требования к актуальности данных
78
+
79
+ | Тип данных | Максимальный возраст | Действие при устаревании |
80
+ |-----------|:--------------------:|--------------------------|
81
+ | Рыночная статистика | 12 месяцев | Искать свежие или помечать ⚠️ Estimated |
82
+ | Регуляторные / правовые | Текущая версия | Обязательно проверить актуальность |
83
+ | Финансовые показатели компаний | Последний отчётный период | Указать период отчёта |
84
+ | Технологические тренды | 6 месяцев | Искать самые свежие |
85
+ | Демографические данные | 24 месяца | Допустимо, если нет свежих |
86
+
87
+ ## Протокол
88
+
89
+ ### Шаг 0 Планирование поиска
90
+ 1. Изучить research brief выделить ключевые вопросы.
91
+ 2. Для каждого вопроса определить минимум 3 поисковых запроса.
92
+ 3. Включить год в запросы для обеспечения актуальности.
93
+ 4. Запланировать запросы на контр-доказательства (counter-evidence).
94
+ 5. Определить приоритет источников: T1 T2 T3.
95
+
96
+ ### Шаг 1Выполнение поиска
97
+ 1. Выполнить поисковые запросы через WebSearch.
98
+ 2. Для каждого результата: извлечь данные через WebFetch.
99
+ 3. Зафиксировать: URL, дату публикации, автора / организацию, **Tier источника**.
100
+ 4. Минимум 3 запроса на каждую точку данных.
101
+
102
+ ### Шаг 2 — Извлечение и структурирование данных
103
+ 1. Из каждого источника извлечь конкретные данные (числа, факты, цитаты).
104
+ 2. Привязать данные к вопросам из research brief.
105
+ 3. Присвоить уровень достоверности (Verified / Estimated / Assumed) по правилам тирования.
106
+ 4. Проставить дату-штамп для каждой точки данных.
107
+
108
+ ### Шаг 3 Перекрёстная проверка
109
+ 1. Для каждой ключевой точки данных — найти подтверждение в 2+ источниках.
110
+ 2. При расхождении данных: зафиксировать оба значения, указать источники, пометить как конфликт.
111
+ 3. При конфликтепопытаться найти третий источник для разрешения.
112
+ 4. Если конфликт не разрешён — передать обе версии с пометкой «Конфликт: [значение A] vs [значение B]».
113
+
114
+ ### Шаг 4 Поиск контр-доказательств
115
+ 1. Для каждого ключевого тезиса — целенаправленно искать опровержения.
116
+ 2. Сформулировать запросы вида: «[тезис] criticism», «[тезис] disadvantages», «[тезис] risks».
117
+ 3. Зафиксировать найденные контр-аргументы.
118
+ 4. Если контр-доказательств не найдено зафиксировать как «контр-позиция не обнаружена».
119
+
120
+ ### Шаг 5Формирование аудит-трейла
121
+ 1. Записать все использованные поисковые запросы.
122
+ 2. Записать все посещённые URL (даже если данные не использованы).
123
+ 3. Записать причины отклонения источников (устарел, T3, нерелевантен, конфликтует).
124
+ 4. Сформировать итоговую таблицу источников.
125
+
126
+ ### Шаг 6 Оценка качества исследования
127
+ Рассчитать метрики качества:
128
+
129
+ | Метрика | Формула | Значение | Порог |
130
+ |---------|---------|:--------:|:-----:|
131
+ | **Verified %** | Verified / Total × 100 | XX% | ≥ 50% — хорошо |
132
+ | **Coverage** | Вопросов покрыто / Всего вопросов × 100 | XX% | 100% — обязательно |
133
+ | **Source diversity** | Уникальных источников / Точек данных | X.X | 1.5 хорошо |
134
+ | **Counter-evidence rate** | Тезисов с контр-поиском / Всего тезисов × 100 | XX% | 100% — обязательно |
135
+ | **Conflict rate** | Неразрешённых конфликтов / Всего точек × 100 | XX% | ≤ 10% — допустимо |
136
+
137
+ **Качество исследования:**
138
+
139
+ | Verified % | Оценка | Действие |
140
+ |:----------:|--------|----------|
141
+ | ≥ 70% | 🟢 Высокое | Можно передавать Data Analyst |
142
+ | 50-69% | 🟡 Среднее | Передавать с оговоркой, рекомендовать дополнительный поиск |
143
+ | < 50% | 🔴 Низкое | Доработать: найти больше T1/T2 источников |
144
+
145
+ ### Шаг 7 Компиляция результатов
146
+ 1. Структурировать данные по вопросам research brief.
147
+ 2. Для каждого вопроса: факты источники Tier) → уровень достоверности → контр-позиция.
148
+ 3. Выделить конфликты и неразрешённые вопросы.
149
+ 4. Приложить метрики качества.
150
+ 5. Сформировать выводы для передачи Data Analyst.
151
+
152
+ ## Паттерны поисковых запросов
153
+
154
+ ### Обязательные паттерны
155
+ | Паттерн | Пример | Цель |
156
+ |---------|--------|------|
157
+ | `[тема] [год]` | «SaaS market size 2025» | Актуальные данные |
158
+ | `[тема] statistics report` | «e-commerce Russia statistics report» | Официальные отчёты (T1) |
159
+ | `[тема] criticism risks` | «remote work criticism risks» | Контр-доказательства |
160
+ | `[компания] revenue financial results` | «Skillbox revenue 2025» | Финансовые данные |
161
+ | `[тема] vs [альтернатива]` | «Bitrix24 vs amoCRM 2025» | Сравнительные данные |
162
+ | `site:statista.com [тема]` | `site:statista.com cloud computing` | T1 источники |
163
+ | `[тема] research [отрасль]` | «retention benchmarks SaaS B2B» | Отраслевые бенчмарки |
164
+
165
+ ### Запрещённые паттерны
166
+ | Паттерн | Почему | Альтернатива |
167
+ |---------|--------|-------------|
168
+ | Один общий запрос на всю тему | Поверхностные данные | Минимум 3 запроса на точку данных |
169
+ | Запрос без года | Устаревшие результаты | Всегда включать год |
170
+ | Только подтверждающие запросы | Confirmation bias | Обязательно искать контр-доказательства |
171
+ | Копирование данных без проверки | Недостоверные данные | Перекрёстная проверка 2+ источников |
172
+ | Только T3 источники | Низкая надёжность | Приоритет: T1 → T2 → T3 как дополнение |
173
+
174
+ ## Пример Web Research для «Рынок EdTech РФ, корпоративное обучение»
175
+
176
+ **Research brief (из INT-01):** 4 из 12 вопросов (фрагмент).
177
+
178
+ ### Вопрос 1: Каков размер рынка EdTech РФ (TAM)?
179
+
180
+ | # | Факт | Источник | Tier | URL | Дата | Достоверность |
181
+ |---|------|----------|:----:|-----|------|:-------------:|
182
+ | 1 | EdTech РФ = $4.2B (2026) | Smart Ranking | T1 | smart-ranking.ru/... | 2026-01 | ✅ Verified |
183
+ | 2 | EdTech РФ = $3.9-4.5B (2026) | ВШЭ, ИСИЭЗ | T1 | hse.ru/... | 2025-11 | ✅ Verified |
184
+ | 3 | Корп. обучение = 43% от EdTech | ВШЭ | T1 | hse.ru/... | 2025-11 | ⚠️ Estimated |
185
+
186
+ **Контр-позиция:** Smart Ranking отмечает, что 30% рынка — теневой сектор (частные репетиторы), что может завышать TAM. Источник: smart-ranking.ru/methodology.
187
+ **Конфликты:** Нет (разброс $3.9-4.5B = нормальный для разных методологий).
188
+
189
+ ### Вопрос 3: Какие технологические тренды меняют рынок?
190
+
191
+ | # | Факт | Источник | Tier | URL | Дата | Достоверность |
192
+ |---|------|----------|:----:|-----|------|:-------------:|
193
+ | 1 | AI-персонализация: adoption 12% в EdTech | Gartner | T1 | gartner.com/... | 2025-09 | ✅ Verified |
194
+ | 2 | AI-персонализация: Duolingo +40% retention | TechCrunch | T2 | techcrunch.com/... | 2025-07 | ✅ Verified (с #1) |
195
+ | 3 | LLM снижает стоимость курса ×5 | a16z | T2 | a16z.com/... | 2026-02 | ⚠️ Estimated |
196
+ | 4 | «AI в обучении переоценён для корп. сектора» | HBR | T1 | hbr.org/... | 2025-10 | ✅ Контр-позиция |
197
+
198
+ **Контр-позиция:** HBR аргументирует, что корп. обучение требует human-in-the-loop и AI-only решения не работают для soft skills.
199
+
200
+ ### Метрики качества
201
+
202
+ | Метрика | Значение | Порог | Оценка |
203
+ |---------|:--------:|:-----:|:------:|
204
+ | Verified % | 62% (18/29) | ≥ 50% | 🟡 Среднее |
205
+ | Coverage | 100% (12/12 вопросов) | 100% | 🟢 |
206
+ | Source diversity | 1.7 (48 источников / 29 точек) | ≥ 1.5 | 🟢 |
207
+ | Counter-evidence rate | 100% (12/12 тезисов) | 100% | 🟢 |
208
+ | Conflict rate | 7% (2/29) | ≤ 10% | 🟢 |
209
+
210
+ **Качество: 🟡 Среднее** (Verified 62% — передавать с оговоркой, рекомендовать дополнительный T1 поиск для ⚠️ данных).
211
+
212
+ ### Аудит-трейл (фрагмент)
213
+
214
+ | # | Запрос | Результатов | Использовано | Отклонено |
215
+ |---|--------|:-----------:|:------------:|:---------:|
216
+ | 1 | «EdTech market Russia 2025 2026» | 23 | 4 | 19 (устарели: 8, нерелевантны: 11) |
217
+ | 2 | «корпоративное обучение рынок РФ отчёт» | 15 | 3 | 12 (T3: 5, дубли: 4, устарели: 3) |
218
+ | 3 | «EdTech Russia criticism risks 2025» | 9 | 2 | 7 (нерелевантны) |
219
+
220
+ **Всего:** 38 запросов, 112 результатов, 48 источников использовано, 64 отклонено.
221
+
222
+ ## Валидация (Quality Gate)
223
+
224
+ Веб-исследование считается завершённым если:
225
+
226
+ - [ ] Все вопросы research brief покрыты данными (Coverage = 100%)
227
+ - [ ] WebSearch / WebFetch использованы (не «по памяти»)
228
+ - [ ] Каждая точка данных: URL, дата, Tier источника, уровень достоверности
229
+ - [ ] Перекрёстная проверка выполнена (2+ источника на ключевые данные)
230
+ - [ ] Контр-доказательства искались целенаправленно для каждого тезиса (Counter-evidence = 100%)
231
+ - [ ] Данные актуальны по таблице требований
232
+ - [ ] Аудит-трейл заполнен (все запросы, URL, причины отклонения)
233
+ - [ ] Конфликтующие данные помечены и объяснены (Conflict rate ≤ 10%)
234
+ - [ ] Минимум источников достигнут (по умолчанию ≥ 3 на тезис)
235
+ - [ ] Verified % 50% (если < 50% доработать или передать с оговоркой 🔴)
236
+ - [ ] T3 источники не использованы как Verified или Estimated
237
+
238
+ ## Handoff
239
+ Результат `$web-research` является входными данными для:
240
+ - **Data Analyst (AN-xx)** верифицированные данные для применения фреймворков.
241
+ - **Все фреймворк-скилы** через Data Analyst: данные поступают в TAM/SAM/SOM, Competitive Analysis, PEST, SWOT и т.д.
242
+ - **`$gates` (RES-xx)** gate check проверяет наличие и качество web-research.
243
+
244
+ Формат передачи: структурированный отчёт (по вопросам research brief) + таблица источников (с Tier и достоверностью) + метрики качества + аудит-трейл. При передаче — использовать `$handoff`.
245
+
246
+ ## Anti-patterns
247
+
248
+ | Ошибка | Почему плохо | Как правильно |
249
+ |--------|-------------|---------------|
250
+ | Данные «по памяти» без поиска | Могут быть устаревшими или неточными | Всегда выполнять WebSearch |
251
+ | Один источник = «факт» | Нет перекрёстной проверки | 2+ источника (T1/T2) на ключевые данные |
252
+ | Нет контр-доказательств | Confirmation bias, однобокий анализ | Целенаправленно искать опровержения (100%) |
253
+ | URL без даты и Tier | Невозможно оценить актуальность и надёжность | Всегда: URL + дата + Tier (T1/T2/T3) |
254
+ | Все данные Verified | Нереалистично, скрывает неопределённость | Честно: Verified / Estimated / Assumed |
255
+ | Запросы без года | Устаревшие результаты | Включать текущий год в запрос |
256
+ | Пропуск аудит-трейла | Невозможно проверить качество исследования | Записывать все запросы, URL, причины отклонения |
257
+ | Только T3 источники | Низкая надёжность, не может быть Verified | Приоритет T1 → T2; T3 только как сигнал |
258
+ | Verified < 50% без доработки | Большинство данных ненадёжно | Доработать: найти T1/T2 или передать с оговоркой 🔴 |
259
+
260
+ ## Шаблон вывода
261
+
262
+ ```
263
+ ### Web Research Report [Тема]
264
+
265
+ **Researcher:** [RES-xx]
266
+ **Дата:** [YYYY-MM-DD]
267
+ **Research brief:** [N вопросов из INT-01]
268
+
269
+ ---
270
+
271
+ #### Метрики качества
272
+
273
+ | Метрика | Значение | Порог | Оценка |
274
+ |---------|:--------:|:-----:|:------:|
275
+ | Verified % | XX% | ≥ 50% | 🟢/🟡/🔴 |
276
+ | Coverage | XX% | 100% | 🟢/🔴 |
277
+ | Source diversity | X.X | ≥ 1.5 | 🟢/🟡 |
278
+ | Counter-evidence rate | XX% | 100% | 🟢/🔴 |
279
+ | Conflict rate | XX% | ≤ 10% | 🟢/🟡 |
280
+
281
+ **Качество исследования:** 🟢 Высокое / 🟡 Среднее / 🔴 Низкое
282
+
283
+ ---
284
+
285
+ #### Результаты по вопросам
286
+
287
+ ##### Вопрос 1: [Формулировка из research brief]
288
+
289
+ | # | Факт / Данные | Источник | Tier | URL | Дата | Достоверность |
290
+ |---|--------------|----------|:----:|-----|------|:-------------:|
291
+ | 1 | [Значение] | [Название] | T1/T2/T3 | [URL] | [YYYY-MM] | ✅ / ⚠️ / 🔮 |
292
+
293
+ **Контр-позиция:** [Найденные контр-аргументы или «Не обнаружена»]
294
+ **Конфликты:** [Расхождения или «Нет»]
295
+
296
+ ##### Вопрос 2: [Формулировка]
297
+ [аналогично]
298
+
299
+ ---
300
+
301
+ #### Сводка достоверности
302
+
303
+ | Уровень | Кол-во | Доля |
304
+ |---------|:------:|:----:|
305
+ | Verified | [N] | XX% |
306
+ | ⚠️ Estimated | [N] | XX% |
307
+ | 🔮 Assumed | [N] | XX% |
308
+
309
+ #### Нерешённые конфликты
310
+
311
+ | # | Данные A | Источник A (Tier) | Данные B | Источник B (Tier) | Комментарий |
312
+ |---|---------|:-----------------:|---------|:-----------------:|-------------|
313
+
314
+ ---
315
+
316
+ #### Аудит-трейл
317
+
318
+ | # | Запрос | Результатов | Использовано | Отклонено (причина) |
319
+ |---|--------|:-----------:|:------------:|---------------------|
320
+ | 1 | [запрос] | [N] | [N] | [N] ([причины]) |
321
+
322
+ **Всего:** [N] запросов, [N] результатов, [N] использовано, [N] отклонено
323
+ ```