@egbe-ai/opencode 0.0.0-stage → 0.1.8

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 (479) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +124 -2
  3. package/index.js +5 -0
  4. package/package.json +55 -4
  5. package/plugin.js +230 -0
  6. package/session-log.js +315 -0
  7. package/skills/.egbe-catalog/manifest.json +1 -0
  8. package/skills/egbe-os-analytics/SKILL.md +499 -0
  9. package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
  10. package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
  11. package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
  12. package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
  13. package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
  14. package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
  15. package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
  16. package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
  17. package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
  18. package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
  19. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
  20. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
  21. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
  22. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
  23. package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
  24. package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
  25. package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
  26. package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
  27. package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
  28. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
  29. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
  30. package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
  31. package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
  32. package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
  33. package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
  34. package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
  35. package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
  36. package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
  37. package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
  38. package/skills/egbe-os-db/SKILL.md +174 -0
  39. package/skills/egbe-os-deploy/SKILL.md +412 -0
  40. package/skills/egbe-os-design/SKILL.md +182 -0
  41. package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
  42. package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
  43. package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
  44. package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
  45. package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
  46. package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
  47. package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
  48. package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
  49. package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
  50. package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
  51. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
  52. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
  53. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
  54. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
  55. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
  56. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
  57. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
  58. package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
  59. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
  60. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
  61. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
  62. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
  63. package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
  64. package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
  65. package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
  66. package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
  67. package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
  68. package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
  69. package/skills/egbe-os-destination-readiness/references/report.md +116 -0
  70. package/skills/egbe-os-domains/SKILL.md +189 -0
  71. package/skills/egbe-os-errors/SKILL.md +259 -0
  72. package/skills/egbe-os-git/SKILL.md +275 -0
  73. package/skills/egbe-os-git/references/issues.md +33 -0
  74. package/skills/egbe-os-google-ads/SKILL.md +163 -0
  75. package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
  76. package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
  77. package/skills/egbe-os-google-ads/references/conversions.md +153 -0
  78. package/skills/egbe-os-google-ads/references/delivery.md +128 -0
  79. package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
  80. package/skills/egbe-os-google-ads/references/reporting.md +105 -0
  81. package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
  82. package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
  83. package/skills/egbe-os-google-auth/SKILL.md +285 -0
  84. package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
  85. package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
  86. package/skills/egbe-os-images/SKILL.md +163 -0
  87. package/skills/egbe-os-images/references/stock-images.md +21 -0
  88. package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
  89. package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
  90. package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
  91. package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
  92. package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
  93. package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
  94. package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
  95. package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
  96. package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
  97. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
  98. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
  99. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
  100. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
  101. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
  102. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
  103. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
  104. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
  105. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
  106. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
  107. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
  108. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
  109. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
  110. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
  111. package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
  112. package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
  113. package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
  114. package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
  115. package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
  116. package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
  117. package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
  118. package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
  119. package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
  120. package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
  121. package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
  122. package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
  123. package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
  124. package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
  125. package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
  126. package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
  127. package/skills/egbe-os-llm/SKILL.md +160 -0
  128. package/skills/egbe-os-mail/SKILL.md +180 -0
  129. package/skills/egbe-os-me/SKILL.md +119 -0
  130. package/skills/egbe-os-meta-ads/SKILL.md +114 -0
  131. package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
  132. package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
  133. package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
  134. package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
  135. package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
  136. package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
  137. package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
  138. package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
  139. package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
  140. package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
  141. package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
  142. package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
  143. package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
  144. package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
  145. package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
  146. package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
  147. package/skills/egbe-os-notifications/SKILL.md +78 -0
  148. package/skills/egbe-os-openai-ads/SKILL.md +149 -0
  149. package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
  150. package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
  151. package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
  152. package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
  153. package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
  154. package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
  155. package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
  156. package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
  157. package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
  158. package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
  159. package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
  160. package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
  161. package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
  162. package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
  163. package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
  164. package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
  165. package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
  166. package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
  167. package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
  168. package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
  169. package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
  170. package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
  171. package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
  172. package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
  173. package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
  174. package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
  175. package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
  176. package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
  177. package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
  178. package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
  179. package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
  180. package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
  181. package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
  182. package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
  183. package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
  184. package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
  185. package/skills/egbe-os-payments/SKILL.md +215 -0
  186. package/skills/egbe-os-payments/agents/openai.yaml +4 -0
  187. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
  188. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
  189. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
  190. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
  191. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
  192. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
  193. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
  194. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
  195. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
  196. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
  197. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
  198. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
  199. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
  200. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
  201. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
  202. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
  203. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
  204. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
  205. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
  206. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
  207. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
  208. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
  209. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
  210. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
  211. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
  212. package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
  213. package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
  214. package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
  215. package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
  216. package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
  217. package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
  218. package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
  219. package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
  220. package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
  221. package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
  222. package/skills/egbe-os-playbook/SKILL.md +79 -0
  223. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
  224. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
  225. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
  226. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
  227. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
  228. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
  229. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
  230. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
  231. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
  232. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
  233. package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
  234. package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
  235. package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
  236. package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
  237. package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
  238. package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
  239. package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
  240. package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
  241. package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
  242. package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
  243. package/skills/egbe-os-playbook/playbooks/product.md +67 -0
  244. package/skills/egbe-os-playbook/references/catalog.md +127 -0
  245. package/skills/egbe-os-playbook/references/changes.md +167 -0
  246. package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
  247. package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
  248. package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
  249. package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
  250. package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
  251. package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
  252. package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
  253. package/skills/egbe-os-product-auth/SKILL.md +151 -0
  254. package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
  255. package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
  256. package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
  257. package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
  258. package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
  259. package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
  260. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
  261. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
  262. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
  263. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
  264. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
  265. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
  266. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
  267. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
  268. package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
  269. package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
  270. package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
  271. package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
  272. package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
  273. package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
  274. package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
  275. package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
  276. package/skills/egbe-os-product-build/SKILL.md +111 -0
  277. package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
  278. package/skills/egbe-os-product-build/references/capabilities.md +25 -0
  279. package/skills/egbe-os-product-build/references/engineering.md +72 -0
  280. package/skills/egbe-os-product-build/references/execution.md +55 -0
  281. package/skills/egbe-os-product-build/references/foundations.md +93 -0
  282. package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
  283. package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
  284. package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
  285. package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
  286. package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
  287. package/skills/egbe-os-product-market-research/SKILL.md +159 -0
  288. package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
  289. package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
  290. package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
  291. package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
  292. package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
  293. package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
  294. package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
  295. package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
  296. package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
  297. package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
  298. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
  299. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
  300. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
  301. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
  302. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
  303. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
  304. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
  305. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
  306. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
  307. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
  308. package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
  309. package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
  310. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
  311. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
  312. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
  313. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
  314. package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
  315. package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
  316. package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
  317. package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
  318. package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
  319. package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
  320. package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
  321. package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
  322. package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
  323. package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
  324. package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
  325. package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
  326. package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
  327. package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
  328. package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
  329. package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
  330. package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
  331. package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
  332. package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
  333. package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
  334. package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
  335. package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
  336. package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
  337. package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
  338. package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
  339. package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
  340. package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
  341. package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
  342. package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
  343. package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
  344. package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
  345. package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
  346. package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
  347. package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
  348. package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
  349. package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
  350. package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
  351. package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
  352. package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
  353. package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
  354. package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
  355. package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
  356. package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
  357. package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
  358. package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
  359. package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
  360. package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
  361. package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
  362. package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
  363. package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
  364. package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
  365. package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
  366. package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
  367. package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
  368. package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
  369. package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
  370. package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
  371. package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
  372. package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
  373. package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
  374. package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
  375. package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
  376. package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
  377. package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
  378. package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
  379. package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
  380. package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
  381. package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
  382. package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
  383. package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
  384. package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
  385. package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
  386. package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
  387. package/skills/egbe-os-product-report/SKILL.md +150 -0
  388. package/skills/egbe-os-product-report/references/artifacts.md +84 -0
  389. package/skills/egbe-os-product-report/references/brief.md +34 -0
  390. package/skills/egbe-os-product-report/references/daily.md +76 -0
  391. package/skills/egbe-os-product-report/references/sources.md +68 -0
  392. package/skills/egbe-os-product-routines/SKILL.md +166 -0
  393. package/skills/egbe-os-product-routines/references/catalog.md +22 -0
  394. package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
  395. package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
  396. package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
  397. package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
  398. package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
  399. package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
  400. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
  401. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
  402. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
  403. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
  404. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
  405. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
  406. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
  407. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
  408. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
  409. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
  410. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
  411. package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
  412. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
  413. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
  414. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
  415. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
  416. package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
  417. package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
  418. package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
  419. package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
  420. package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
  421. package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
  422. package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
  423. package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
  424. package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
  425. package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
  426. package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
  427. package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
  428. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
  429. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
  430. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
  431. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
  432. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
  433. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
  434. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
  435. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
  436. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
  437. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
  438. package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
  439. package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
  440. package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
  441. package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
  442. package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
  443. package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
  444. package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
  445. package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
  446. package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
  447. package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
  448. package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
  449. package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
  450. package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
  451. package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
  452. package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
  453. package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
  454. package/skills/egbe-os-report-ui/SKILL.md +133 -0
  455. package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
  456. package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
  457. package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
  458. package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
  459. package/skills/egbe-os-report-ui/references/components.md +209 -0
  460. package/skills/egbe-os-research/SKILL.md +125 -0
  461. package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
  462. package/skills/egbe-os-scrape/SKILL.md +160 -0
  463. package/skills/egbe-os-search/SKILL.md +182 -0
  464. package/skills/egbe-os-search/references/google-places.md +81 -0
  465. package/skills/egbe-os-support/SKILL.md +149 -0
  466. package/skills/egbe-os-telemetry/SKILL.md +344 -0
  467. package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
  468. package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
  469. package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
  470. package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
  471. package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
  472. package/skills/egbe-os-tools/SKILL.md +180 -0
  473. package/skills/egbe-os-tools/references/theona.md +26 -0
  474. package/skills/egbe-os-wallet/SKILL.md +181 -0
  475. package/skills/egbe-setup/EGBE.md +484 -0
  476. package/skills/egbe-setup/SKILL.md +116 -0
  477. package/skills/egbe-setup/references/project.md +80 -0
  478. package/state.js +37 -0
  479. package/update.js +361 -0
@@ -0,0 +1,55 @@
1
+ # Standalone local research
2
+
3
+ Use the full bundle in an ordinary product repository with a prepared research
4
+ assignment and OS credentials. Scripts publish files and receipts in the workspace;
5
+ the caller owns Git. No hosted runtime, instance ID or separate docs repository
6
+ is required. Choose one stable research ID for the work and retain it on resume.
7
+
8
+ For a requested multi-section preview, record the task's selected
9
+ scope once (the user need not name internal workflow IDs):
10
+
11
+ ```bash
12
+ export EGBE_RESEARCH_ID="${EGBE_RESEARCH_ID:-market}"
13
+ python <skill-root>/scripts/build-preview-context.py --workspace . \
14
+ --sections keyword_economics,acquisition_channels
15
+ ```
16
+
17
+ Run only the operations needed by that scope. Respect actual receipt-backed
18
+ input dependencies; there is no mandatory catalog sequence. For narrative
19
+ research, pass the bounded question with `--assignment` or `--assignment-file`.
20
+ An optional `--context-file` provides only the relevant provider-safe background
21
+ chosen for that question. Measured operations can use their explicit CLI inputs
22
+ without a context file; the shared snapshot records the context actually used.
23
+ Read each selected workflow and the artifact contract; metered calls stay within
24
+ the caller's authorized budget. For US and UK, run
25
+ the same keyword runner separately with `--location-code 2840` and `2826`.
26
+ Repeating US preserves UK and reuses the request cache.
27
+
28
+ After each workflow (and the required AI completion review), refresh outcomes:
29
+
30
+ ```bash
31
+ python <skill-root>/scripts/build-preview-context.py --workspace .
32
+ ```
33
+
34
+ Absent work stays pending. To close genuinely failed or intentionally skipped
35
+ work, pass `--failed <section-id>`; use `--retry <section-id>` to reopen it.
36
+ Only that explicit closure stays fixed. Receipt-derived outcomes, including
37
+ `partial`, `no_data` and validation failures, are checked again on refresh.
38
+ Do not mark success manually. Refresh checks input/file hashes and the
39
+ materialized report. Changed scope or selected context needs a new research ID
40
+ for new collection so existing research remains available. Source drift does
41
+ not erase saved observations or itself authorize another paid run.
42
+
43
+ If a preview is requested, once no selected section is pending, follow `preview.md` to write the synthesis
44
+ and render it from the workspace root:
45
+
46
+ ```bash
47
+ python <skill-root>/scripts/write-preview.py --local-report-link full-report.md
48
+ ```
49
+
50
+ This creates local documents, not hosted links. No instance registration, fake
51
+ public ID, provider call or manual `preview-context.json` construction is needed.
52
+
53
+ For product definition or another decision, link the relevant existing findings
54
+ and their evidence boundary into the caller's requirements or plan. No separate
55
+ PRD-context adapter, rendered preview or receipt-binding step is required.
@@ -0,0 +1,27 @@
1
+ # Market size and dynamics
2
+
3
+ Read `../contracts/research-artifacts.md` and `../prompts/market-size-and-dynamics.md`
4
+ for evidence checks and output mechanics. The current assignment, not the
5
+ bundled topic brief, defines the question and depth.
6
+
7
+ ```bash
8
+ python <skill-root>/scripts/run-market-size-and-dynamics.py --workspace . \
9
+ --assignment "The bounded question, scope and comparison criteria from the current task"
10
+ ```
11
+
12
+ Use `--assignment-file` for existing task text when convenient; no new format
13
+ is required. The runner keeps provider-safe product context and includes only
14
+ valid completed supporting results/measurements. Missing optional inputs are
15
+ limitations, not reasons to collect unrequested sections. A selected unfinished
16
+ measurement used by this section must finish or be closed before it can be cited.
17
+
18
+ The actual assignment, query, system prompt, job state and result live under
19
+ `egbe-docs/research/<id>/work/market_size_dynamics/`. The result materializes under
20
+ `## Market size and dynamics` in the existing incremental report. Retrying unchanged inputs
21
+ resumes/reuses the job before publication; changed inputs preserve that work
22
+ and require a separate research ID, not a silent new provider call.
23
+
24
+ After success, complete the shared Research Completion Review for
25
+ `market_size_dynamics`. Preserve failed/uncertain state; do not replace a provider response
26
+ with invented output. The caller owns Git publication and may continue the
27
+ surrounding task when this operation finishes.
@@ -0,0 +1,175 @@
1
+ # Build The Founder Preview
2
+
3
+ Initialize and refresh context with
4
+ `scripts/build-preview-context.py` as described in `local-research.md` before
5
+ following this workflow. Preserve its frozen selection when resuming.
6
+
7
+ Read `../contracts/research-artifacts.md`,
8
+ `egbe-docs/research/market/work/preview-context.json`, `egbe-docs/research/market/full-report.md` when it
9
+ exists, and the prepared research assignment. Do not call an external provider and do not modify an
10
+ existing full report. The deterministic writer initializes the canonical empty
11
+ report when every selected section failed before one could be created.
12
+
13
+ The runtime context is authoritative for selected research and final section
14
+ outcomes. Do not recalculate its scope from recommendation flags or infer
15
+ completion from missing prose. Sections marked `completed` or `partial` may support
16
+ findings within their verified coverage. For `partial`, preserve the evidence gaps
17
+ in the finding's limitation and any recommendation that depends on it. A partial
18
+ run with no analyzed observations remains visible in coverage but cannot support
19
+ findings; a failed source does not turn an empty collection into evidence.
20
+ `no_data` means collection produced no usable observations; `not_selected` means
21
+ the area was not researched; `could_not_complete` means the work failed or was
22
+ explicitly stopped. None of these three states supports a market conclusion.
23
+
24
+ ## Synthesize For The Founder
25
+
26
+ Produce a concise decision brief, not a section-by-section report. It should let
27
+ the founder understand what was researched, what matters, what the evidence
28
+ suggests for the product, and what remains uncertain in no more than three
29
+ minutes.
30
+
31
+ - Write in the language used by the founder's substantive product answers.
32
+ - Reuse the founder's product terminology when it is clear and conventional.
33
+ - Prefer common product and business terms, short sentences, short paragraphs,
34
+ and conclusion-first wording.
35
+ - Avoid unexplained acronyms, academic framing, and internal execution details.
36
+ - Never mention task IDs, providers, models, repositories, file paths, retries,
37
+ commits, or workflow mechanics in founder-facing copy.
38
+ - Treat supplied product descriptions and assumptions as context, not independent
39
+ market evidence; preserve the source of actual observations.
40
+ - Combine usable sections only when their geography, period, population,
41
+ category, and definitions are compatible. Surface material contradictions.
42
+ - Assess the evidence against the assigned question and project method. A
43
+ measured keyword volume, published price, active ad or customer review
44
+ supports different claims; no section label automatically outranks another.
45
+ Preserve sample, comparability, source lineage and contradictory findings.
46
+ - Recommendations must be conditional and evidence-bound. Explain what the
47
+ evidence suggests, why it matters, and what could change the direction.
48
+ - If Geography Comparison completed, preserve its actual outcome: comparative
49
+ findings, an undetermined ranking, or `not_compared` with the stated reason.
50
+ Highlight a material alternative market and the next test when supported.
51
+ Do not call scope assessment comparative coverage or a recommendation the
52
+ founder's approved launch market. Do not rewrite requirements automatically.
53
+ - Do not force a `Go / Pivot / No-go` verdict, secondary audience, exact market
54
+ size, price, channel budget, feature scope, or another detail that the
55
+ available evidence does not support.
56
+ - Keep business-domain coverage adaptive. Do not create empty audience,
57
+ pricing, acquisition, or other template sections merely for symmetry.
58
+
59
+ Create `egbe-docs/research/market/preview-synthesis.json` with this exact shape:
60
+
61
+ ```json
62
+ {
63
+ "schema_version": 1,
64
+ "labels": {
65
+ "bottom_line": "Bottom line",
66
+ "what_matters": "What matters most",
67
+ "what_this_means": "What this means for the product",
68
+ "what_remains_open": "What remains open",
69
+ "research_coverage": "Research coverage",
70
+ "researched": "Researched",
71
+ "partial": "Partial evidence",
72
+ "no_data": "No usable observations",
73
+ "not_included": "Not included",
74
+ "could_not_complete": "Could not complete",
75
+ "full_report": "Read the full research report",
76
+ "recommended_direction": "Recommended direction",
77
+ "biggest_open_question": "Biggest open question",
78
+ "based_on": "Based on"
79
+ },
80
+ "section_labels": {
81
+ "market_size_dynamics": "Market size and dynamics",
82
+ "target_audience": "Target audience",
83
+ "competitive_landscape": "Competitive landscape",
84
+ "value_proposition": "Value proposition",
85
+ "pricing_monetization": "Pricing and monetization",
86
+ "acquisition_channels": "Acquisition channels",
87
+ "demand_validation": "Demand validation",
88
+ "unit_economics": "Unit economics",
89
+ "organic_trend_watch": "TikTok and Reels market trends"
90
+ },
91
+ "bottom_line": {
92
+ "summary": "One short conclusion-first sentence.",
93
+ "detail": "Two to four short sentences with the main direction and material uncertainty.",
94
+ "source_section_ids": ["target_audience"],
95
+ "confidence_note": "Confidence is moderate because direct buyer interviews are still missing."
96
+ },
97
+ "findings": [
98
+ {
99
+ "title": "A short founder-facing finding title",
100
+ "finding": "What the available evidence supports.",
101
+ "why_it_matters": "Why this changes a product or business decision.",
102
+ "source_section_ids": ["target_audience"],
103
+ "limitation": "The consequential limitation in plain language."
104
+ }
105
+ ],
106
+ "product_implications": [
107
+ {
108
+ "title": "A short priority title",
109
+ "direction": "The recommended product direction in one short sentence.",
110
+ "rationale": "Why this follows from the available evidence.",
111
+ "source_section_ids": ["target_audience"],
112
+ "reconsider_if": "Reconsider this if the named assumption or evidence changes."
113
+ }
114
+ ],
115
+ "open_questions": [
116
+ {
117
+ "question": "The most important unresolved question?",
118
+ "why_it_matters": "How its answer could change the direction."
119
+ }
120
+ ]
121
+ }
122
+ ```
123
+
124
+ Localize every `labels` value, every `section_labels` value, and all
125
+ founder-facing content to the founder's language. `section_labels` must contain
126
+ every section ID from the runtime context exactly once, including any future
127
+ section not shown in this current example. Keep `source_section_ids` and JSON
128
+ keys exactly as specified. Use only plain single-paragraph strings inside JSON;
129
+ the writer owns all Markdown structure.
130
+ The `partial` and `no_data` labels are required when those statuses occur in the
131
+ context; otherwise they may be omitted. Coverage is rendered separately from
132
+ completed research, without upgrading a limited result to full coverage.
133
+
134
+ Use up to five findings, up to four product implications, and one to four open
135
+ questions. Order all lists by decision importance. The first open question is
136
+ the biggest one. The first one or two product implications become the compact
137
+ chat recommendation.
138
+
139
+ Every finding and product implication requires at least one supporting section
140
+ ID marked `completed` or a `partial` section with analyzed observations in the
141
+ runtime context. The rendered document shows those localized supporting section
142
+ names. The bottom line also cites usable
143
+ sections when any exist. If no selected section has usable evidence, leave
144
+ `findings` and `product_implications` empty, cite no bottom-line sources, state
145
+ that no evidence-backed direction is available, and use the open questions to
146
+ explain what must be resolved.
147
+
148
+ ## Render The Artifacts
149
+
150
+ From the workspace root run:
151
+
152
+ ```bash
153
+ python <skill-root>/scripts/write-preview.py
154
+ ```
155
+
156
+ The full-report link defaults to `full-report.md` beside the preview. Use
157
+ `--local-report-link` only for a different safe relative link or explicit HTTP(S)
158
+ URL. No instance/public ID is needed; Git commit/push belongs to the caller.
159
+
160
+ The writer validates the context and synthesis, creates
161
+ `egbe-docs/research/market/preview.md`, derives the short founder chat summary at
162
+ `egbe-docs/research/market/summary.md`, and records deterministic
163
+ render hashes at `egbe-docs/research/market/preview-render.json`. Do not hand-write or
164
+ post-edit any rendered artifact.
165
+
166
+ The Preview targets 450–650 words and may not exceed 750 words. The chat
167
+ summary contains at most three blocks: one bottom-line sentence, one or two
168
+ recommended-direction bullets when supported, and the biggest open question.
169
+ It may not exceed 600 visible characters. The notification owns its headline
170
+ and link, so the generated summary must not repeat either one.
171
+
172
+ Hand off the synthesis, render receipt, Preview, and summary together for the
173
+ project's normal Git workflow. If the writer initialized an otherwise missing
174
+ full report for an all-failed run, include that canonical H1-only file. Do not otherwise
175
+ modify the full report, and do not create a PRD.
@@ -0,0 +1,27 @@
1
+ # Pricing and monetization
2
+
3
+ Read `../contracts/research-artifacts.md` and `../prompts/pricing-and-monetization.md`
4
+ for evidence checks and output mechanics. The current assignment, not the
5
+ bundled topic brief, defines the question and depth.
6
+
7
+ ```bash
8
+ python <skill-root>/scripts/run-pricing-and-monetization.py --workspace . \
9
+ --assignment "The bounded question, scope and comparison criteria from the current task"
10
+ ```
11
+
12
+ Use `--assignment-file` for existing task text when convenient; no new format
13
+ is required. The runner keeps provider-safe product context and includes only
14
+ valid completed supporting results/measurements. Missing optional inputs are
15
+ limitations, not reasons to collect unrequested sections. A selected unfinished
16
+ measurement used by this section must finish or be closed before it can be cited.
17
+
18
+ The actual assignment, query, system prompt, job state and result live under
19
+ `egbe-docs/research/<id>/work/pricing_monetization/`. The result materializes under
20
+ `## Pricing and monetization` in the existing incremental report. Retrying unchanged inputs
21
+ resumes/reuses the job before publication; changed inputs preserve that work
22
+ and require a separate research ID, not a silent new provider call.
23
+
24
+ After success, complete the shared Research Completion Review for
25
+ `pricing_monetization`. Preserve failed/uncertain state; do not replace a provider response
26
+ with invented output. The caller owns Git publication and may continue the
27
+ surrounding task when this operation finishes.
@@ -0,0 +1,35 @@
1
+ # Serialize research recommendations
2
+
3
+ This optional writer serves the existing recommendation UI. It does not select
4
+ research or run providers. Derive any proposed scope from the current task and
5
+ project market-and-acquisition method, reusing existing material. No research
6
+ may be the right recommendation; an empty recommendations object is valid.
7
+
8
+ Read the catalog for supported IDs and the artifact contract for publication.
9
+ The UI omits catalog entries marked internal; that presentation filter does not
10
+ forbid the agent from using their research operations for a bounded assignment.
11
+ Explicit competitor domains can supply Ads/Reviews directly; Keyword Economics
12
+ is not an automatic prerequisite.
13
+
14
+ Supply temporary JSON:
15
+
16
+ ```json
17
+ {
18
+ "recommendations": {"target_audience": "Question this work would answer."},
19
+ "explanation": "Why this scope is useful for the current decision, or why no new research is needed."
20
+ }
21
+ ```
22
+
23
+ Reasons are nonempty plain-text single lines of at most 180 characters. The
24
+ explanation is one plain-text paragraph of at most 400 characters. These are
25
+ existing UI limits, not a research-depth or evidence requirement. Name the
26
+ uncertainty without presenting intended findings as established facts or
27
+ including unrelated founder personal information.
28
+
29
+ ```bash
30
+ python <skill-root>/scripts/write-recommendations.py --input <temporary-json-path>
31
+ ```
32
+
33
+ The writer validates IDs, fills the selectable option list, and atomically
34
+ serializes `egbe-docs/research/<id>/pre-prd-recommendations.md`. It does not
35
+ expand the selection. The caller owns Git and the next action.
@@ -0,0 +1,76 @@
1
+ # Competitor Reviews
2
+
3
+ Read `../contracts/research-artifacts.md`. This section uses NO OS Research
4
+ job and no free-form web research: the bundled deterministic runner collects
5
+ customer reviews of the market's competitors from G2 and Trustpilot and
6
+ renders the section body plus a machine-readable evidence file itself. Do
7
+ not write or edit section prose, tables, or the evidence file by hand.
8
+
9
+ ## 1. Inputs
10
+
11
+ Competitor domains come from completed sections automatically (their
12
+ receipt-validated evidence files), exactly like Competitor Ads: first the
13
+ tiered Competitor Set in stable inspection order, then the Keyword Economics demand
14
+ surface. When neither section has run or they missed a competitor the
15
+ founder named, pass domains explicitly:
16
+
17
+ - `--domains "competitor.com, other.io"` — merged ahead of discovered ones;
18
+ a domain the Competitor Set recorded as excluded is never refilled from
19
+ Keyword Economics automatically; naming it here is the founder's override;
20
+ - at most 3 competitors per run (`--max-competitors`; each one costs four
21
+ actor runs — two platforms × lowest-rated + top-rated pulls — and the list
22
+ is trimmed to fit `--max-actor-runs`);
23
+ - `--g2-slugs "competitor.com=their-g2-slug"` — only when a competitor's G2
24
+ slug differs from its brand token (the runner guesses `clickup` from
25
+ `clickup.com` by default and EXCLUDES the platform when the slug resolves
26
+ to a different product).
27
+
28
+ ## 2. Run the deterministic runner
29
+
30
+ From the workspace root, resolve `<skill-root>` to the extracted directory
31
+ containing this skill's `SKILL.md`, then run:
32
+
33
+ ```bash
34
+ python3 <skill-root>/scripts/run-review-mining.py --workspace .
35
+ ```
36
+
37
+ The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment.
38
+ Per competitor it pulls the lowest-rated reviews (paying customers with
39
+ unmet needs — offer wedges) and the top-rated reviews (the language of
40
+ value) from each platform, keeps the platform-recorded analysis fields (G2
41
+ company-segment/industry codes, hate/love themes, switched-from and reason;
42
+ Trustpilot verification, country, company replies), counts billing/pricing
43
+ complaints deterministically, and:
44
+
45
+ - writes review rows to `egbe-docs/research/market/evidence/review-mining.json`;
46
+ - materializes the exact section under `## Competitor reviews` in
47
+ `egbe-docs/research/market/full-report.md`;
48
+ - verifies the report and evidence together; Git remains caller-owned;
49
+ - records the completed state receipt under
50
+ `egbe-docs/research/market/work/review_mining/`.
51
+
52
+ Every provider response is cached in the runtime directory, so re-running
53
+ the same command replays cached data instead of spending actor runs again.
54
+
55
+ ## 3. Known limits and failure handling
56
+
57
+ G2 is slug-keyed: when the guessed slug resolves to a different product, the
58
+ platform is excluded from analysis and listed in the section — supply the
59
+ correct slug via `--g2-slugs` and re-run rather than hand-patching data.
60
+ Trustpilot is domain-keyed. Review volumes are biased toward products that
61
+ actively solicit reviews; an empty platform for a small competitor is weak
62
+ evidence, not proof of absence. Synthesis into wedge hypotheses is a
63
+ downstream concern — this section reports only platform-recorded data.
64
+
65
+ If the runner reports no competitor domains: pass `--domains` with
66
+ competitors supplied for the assignment when they exist; when the workspace has
67
+ neither a completed Keyword Economics run nor any named competitor, record
68
+ the section as could-not-complete with that reason instead of retrying (the
69
+ recommendations writer prevents this case for recommended scopes by
70
+ co-recommending Keyword Economics automatically). For any other failure,
71
+ preserve the runtime state and stop; a later attempt resumes from cache. Do
72
+ not substitute Brave search, generic OS Research, direct provider access, or
73
+ an agent-written result, and do not edit `egbe-docs/research/market/full-report.md` or
74
+ the evidence file manually. Completion is validated deterministically from
75
+ the runtime receipt; this section has no LLM-based Research Completion
76
+ Review step.
@@ -0,0 +1,27 @@
1
+ # Target audience
2
+
3
+ Read `../contracts/research-artifacts.md` and `../prompts/target-audience.md`
4
+ for evidence checks and output mechanics. The current assignment, not the
5
+ bundled topic brief, defines the question and depth.
6
+
7
+ ```bash
8
+ python <skill-root>/scripts/run-target-audience.py --workspace . \
9
+ --assignment "The bounded question, scope and comparison criteria from the current task"
10
+ ```
11
+
12
+ Use `--assignment-file` for existing task text when convenient; no new format
13
+ is required. The runner keeps provider-safe product context and includes only
14
+ valid completed supporting results/measurements. Missing optional inputs are
15
+ limitations, not reasons to collect unrequested sections. A selected unfinished
16
+ measurement used by this section must finish or be closed before it can be cited.
17
+
18
+ The actual assignment, query, system prompt, job state and result live under
19
+ `egbe-docs/research/<id>/work/target_audience/`. The result materializes under
20
+ `## Target audience` in the existing incremental report. Retrying unchanged inputs
21
+ resumes/reuses the job before publication; changed inputs preserve that work
22
+ and require a separate research ID, not a silent new provider call.
23
+
24
+ After success, complete the shared Research Completion Review for
25
+ `target_audience`. Preserve failed/uncertain state; do not replace a provider response
26
+ with invented output. The caller owns Git publication and may continue the
27
+ surrounding task when this operation finishes.
@@ -0,0 +1,46 @@
1
+ # TikTok/Reels Market Trend Research
2
+
3
+ Read `../contracts/research-artifacts.md`. Resolve `<pmr-skill-root>` to the
4
+ installed directory containing this workflow and the Product Market Research
5
+ `SKILL.md`.
6
+
7
+ 1. State the scoped research question from this study. Build provider-safe context
8
+ from it, explicitly selected context (optional `--context-file`) and any
9
+ validated supporting sections:
10
+
11
+ ```bash
12
+ python3 <pmr-skill-root>/scripts/build-organic-trend-context.py --workspace . \
13
+ --assignment "The specific question this study should answer"
14
+ ```
15
+
16
+ 2. Use the installed Egbe OS `egbe-os-organic-trend-watch` skill. Read its `SKILL.md`
17
+ and the collection/analysis workflow it names. The skill also supports direct
18
+ use; PMR sections are optional evidence, not prerequisites.
19
+ 3. Execute only that workflow against
20
+ `egbe-docs/research/market/work/organic_trend_watch/context.json`. The dedicated skill
21
+ owns provider selection, collection, resumability, analysis, `result.md`,
22
+ and its completion receipt. Do not replace its workflow with manual web
23
+ research or author its runtime result outside its contracts.
24
+ 4. After it seals a complete, partial or no-data result, delegate validation to the
25
+ same installed skill and materialize its result through Product Market
26
+ Research:
27
+
28
+ ```bash
29
+ python3 <pmr-skill-root>/scripts/finalize-organic-trend-watch.py \
30
+ --workspace . \
31
+ --organic-skill-root <organic-skill-root>
32
+ ```
33
+
34
+ The finalizer invokes the dedicated skill's authoritative runtime validator
35
+ before it reads the result. It then upserts only
36
+ `## TikTok/Reels market trend research for this product` into the canonical
37
+ full report and persists that report through the product repository
38
+ boundary. It writes the PMR-owned `integration-receipt.json` after successful
39
+ materialization and persistence, preserving coverage rather than upgrading
40
+ partial evidence to completed research. Publication is local and requires no Git
41
+ commit proof; the caller owns normal project synchronization. Stop after the
42
+ finalizer succeeds; never create or edit that integration receipt manually.
43
+
44
+ The PMR Preview preserves `partial` and `no_data` with their coverage. Use verified
45
+ partial findings with their limitations; no-data results cannot support findings.
46
+ Follow `preview.md` for the shared synthesis and display contract.
@@ -0,0 +1,27 @@
1
+ # Unit economics
2
+
3
+ Read `../contracts/research-artifacts.md` and `../prompts/unit-economics.md`
4
+ for evidence checks and output mechanics. The current assignment, not the
5
+ bundled topic brief, defines the question and depth.
6
+
7
+ ```bash
8
+ python <skill-root>/scripts/run-unit-economics.py --workspace . \
9
+ --assignment "The bounded question, scope and comparison criteria from the current task"
10
+ ```
11
+
12
+ Use `--assignment-file` for existing task text when convenient; no new format
13
+ is required. The runner keeps provider-safe product context and includes only
14
+ valid completed supporting results/measurements. Missing optional inputs are
15
+ limitations, not reasons to collect unrequested sections. A selected unfinished
16
+ measurement used by this section must finish or be closed before it can be cited.
17
+
18
+ The actual assignment, query, system prompt, job state and result live under
19
+ `egbe-docs/research/<id>/work/unit_economics/`. The result materializes under
20
+ `## Unit economics` in the existing incremental report. Retrying unchanged inputs
21
+ resumes/reuses the job before publication; changed inputs preserve that work
22
+ and require a separate research ID, not a silent new provider call.
23
+
24
+ After success, complete the shared Research Completion Review for
25
+ `unit_economics`. Preserve failed/uncertain state; do not replace a provider response
26
+ with invented output. The caller owns Git publication and may continue the
27
+ surrounding task when this operation finishes.
@@ -0,0 +1,27 @@
1
+ # Value proposition
2
+
3
+ Read `../contracts/research-artifacts.md` and `../prompts/value-proposition.md`
4
+ for evidence checks and output mechanics. The current assignment, not the
5
+ bundled topic brief, defines the question and depth.
6
+
7
+ ```bash
8
+ python <skill-root>/scripts/run-value-proposition.py --workspace . \
9
+ --assignment "The bounded question, scope and comparison criteria from the current task"
10
+ ```
11
+
12
+ Use `--assignment-file` for existing task text when convenient; no new format
13
+ is required. The runner keeps provider-safe product context and includes only
14
+ valid completed supporting results/measurements. Missing optional inputs are
15
+ limitations, not reasons to collect unrequested sections. A selected unfinished
16
+ measurement used by this section must finish or be closed before it can be cited.
17
+
18
+ The actual assignment, query, system prompt, job state and result live under
19
+ `egbe-docs/research/<id>/work/value_proposition/`. The result materializes under
20
+ `## Value proposition` in the existing incremental report. Retrying unchanged inputs
21
+ resumes/reuses the job before publication; changed inputs preserve that work
22
+ and require a separate research ID, not a silent new provider call.
23
+
24
+ After success, complete the shared Research Completion Review for
25
+ `value_proposition`. Preserve failed/uncertain state; do not replace a provider response
26
+ with invented output. The caller owns Git publication and may continue the
27
+ surrounding task when this operation finishes.