@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,181 @@
1
+ ---
2
+ name: egbe-os-wallet
3
+ description: Read wallet funds, current operating charges and service limits, or prepare a top-up link.
4
+ metadata:
5
+ egbe-when: "Use when a spending decision or customer commitment depends on available resources, or the wallet needs replenishing."
6
+ egbe-visible: "true"
7
+ egbe-title: "Egbe Wallet control"
8
+ egbe-description: "Check available funds and operating charges or prepare a top-up link when needed."
9
+ egbe-category: "Business operations"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+
56
+ # Wallet
57
+
58
+ The prepaid Wallet funds periodic project operation and metered services such
59
+ as AI and paid tools. New accounts start with a small free-tier balance. Read
60
+ the project's current policy before inferring a charge or funded runway.
61
+
62
+ Base URL: `https://os.hz.egbe.dev`. Authenticate every call with
63
+ `Authorization: Bearer $OS_API_KEY`.
64
+
65
+ ## Check balance
66
+
67
+ ```bash
68
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/wallet/balance" -s
69
+ ```
70
+
71
+ Response `data.wallet`:
72
+ - `available_to_spend_cents` — what you can spend now (settled minus held).
73
+ - `settled_balance_cents` — settled funds.
74
+ - `held_cents` — reserved by in-flight operations.
75
+
76
+ ## Read the operating policy
77
+
78
+ Before budgeting continued operation or making customer commitments, read the
79
+ balance and this project's existing policy:
80
+
81
+ ```bash
82
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/wallet/policy" -s
83
+ ```
84
+
85
+ `data.policy` is a read-only snapshot. It does not debit the Wallet, advance a
86
+ billing clock, buy credit or change a subscription.
87
+ Existing authentication fences still apply: read it before making commitments,
88
+ and do not assume an agent can keep querying after work/access is disabled.
89
+ Use the owner's normal Dashboard recovery path if access is blocked; never ask
90
+ for administrator credentials to bypass the fence.
91
+
92
+ - `wallet_funded_project` identifies whether this policy applies. `false` and
93
+ null policy fields mean no wallet-funded enrollment, not free legacy service.
94
+ - `service_fee` gives the existing installment in cents, its interval in
95
+ seconds, the billable states, and the persisted billing clock. A delayed
96
+ sweep can charge several completed intervals; a small remaining balance is
97
+ not a cap on a due installment. Paused states are not currently billable.
98
+ - `welcome_credit_expires_at` describes a remaining welcome-credit bucket in
99
+ this Wallet. It does not assert that every positive balance is promotional.
100
+ - `depletion` explains when new paid work stops and the purchased-funds runtime
101
+ grace conditions. Grace is conditional, time limited and subject to the
102
+ owner's aggregate floor across wallet-funded businesses; it is not extra
103
+ spendable credit or guaranteed service continuity.
104
+ - `retention` gives the pause retention period and any recorded deletion
105
+ deadline. Read the actual state/deadline rather than inventing a recovery date.
106
+
107
+ `commercial_pricing` reports the usage markup, top-up fee and revenue share.
108
+ Paid usage carries a 15% Egbe service fee on the underlying service price:
109
+ $10 of usage + $1.50 fee = $11.50 total. Top-ups credit the full amount with no
110
+ Egbe top-up fee. Egbe takes no revenue share; processor fees, taxes, refunds and
111
+ chargebacks can still affect payouts. Transfers, credits, promotional expiry
112
+ and the periodic business fee do not incur the usage markup. Promotional funds
113
+ pay the same usage prices as purchased funds. Underlying prices can be
114
+ provider-reported costs or configured rates/estimates, not exact invoice costs.
115
+
116
+ Quote budgets including the usage fee before approval. Provider campaign
117
+ budgets and hold API amounts remain underlying-service amounts: a $10 provider
118
+ budget reserves $11.50 including the fee. For an approved total Wallet budget,
119
+ fit the provider budget and fee inside it. Unused reservations are released
120
+ without a fee. Fractional cents carry forward; do not round up each request.
121
+ Journal metadata exposes `usage_base_cents`, `egbe_usage_fee_cents` and
122
+ `usage_total_cents` for itemized charges. Fees apply only to new usage journals;
123
+ retries do not add another fee.
124
+
125
+ Additional service usage is separate from the periodic fee. This snapshot and a
126
+ positive balance do not establish the full hosting, database, tool or customer
127
+ fulfillment cost, funded runway, or a hard spending limit. Report current rates
128
+ where available and distinguish missing cost data from a zero charge.
129
+
130
+ When present, `usage_cost_basis` describes current managed Wallet accounting:
131
+ AI, paid tools and advertising can produce additional usage debits. Managed app
132
+ hosting and the attached database currently have no separate usage meter in
133
+ that accounting path; the periodic project fee still applies. This is not a
134
+ perpetual free-service promise, a provider price quote or a statement about
135
+ external/manual charges. The Wallet is not a hard spending cap: reconciliation
136
+ of incurred usage and due fees can exceed a small available balance. A null or
137
+ missing basis is unknown, including legacy projects and older deployments.
138
+ Use capability-specific costs or proportionate estimates for variable work.
139
+ Sale deductions, refunds, chargebacks and payout timing remain separate
140
+ commercial questions; absence of a Wallet debit does not erase those liabilities
141
+ or establish a required gross-refund Wallet deposit.
142
+
143
+ Read the current [Egbe commercial terms](https://egbe.ai/terms/) separately for
144
+ sale and top-up fees, merchant responsibilities, payouts and refunds. Do not
145
+ substitute a generic direct-provider tariff. If policy discovery is unavailable
146
+ during rollout, report that gap; do not infer a zero-cost policy or buy credit.
147
+
148
+ ## Work within an authorized amount
149
+
150
+ The periodic fee belongs to the existing active project. It accrues whether or
151
+ not you build, publish or attach the managed database; stopping it means pausing
152
+ or deleting the project, which is the owner's choice. Authorized product work
153
+ does not create that commitment. Under `usage_cost_basis`, the Wallet usage that
154
+ building adds comes from the AI, paid-tool and advertising operations you choose,
155
+ plus any option a capability marks as consuming Wallet resources, such as a warm
156
+ `min_instances` deployment.
157
+
158
+ When the founder has authorized a specific amount for this work, including any
159
+ recurring fee they accepted, that authorization covers operations whose expected
160
+ cost fits within it. Without a hard platform cap, you enforce the limit: prefer
161
+ unmetered capabilities, estimate metered work before starting it, recheck the
162
+ balance at material points and stop before an operation would exceed the
163
+ remaining authorized amount. Report the limit as manually enforced. Do not
164
+ withhold authorized work, ask again for the same permission or require a
165
+ platform-enforced cap because the Wallet does not provide one. The authorization
166
+ never covers top-ups, card charges, purchases, spending the founder excluded such
167
+ as advertising, or anything beyond the stated amount. Whether the remaining
168
+ credit can sustain a customer promise is an offer-sizing question, not a reason
169
+ to skip authorized preparation.
170
+
171
+ ## Top up
172
+
173
+ ```bash
174
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/wallet/topup" -s -X POST \
175
+ -H 'Content-Type: application/json' \
176
+ -d '{"amount_cents":1000}'
177
+ ```
178
+
179
+ Optional `currency` (default `"usd"`). Starts a top-up (min `100` cents = $1.00) and returns a top-up intent with a
180
+ `checkout_url`. Open that Stripe checkout link and complete payment; your wallet is credited automatically once the
181
+ payment succeeds. If `checkout_url` is `null`, retry shortly.
@@ -0,0 +1,484 @@
1
+ # Working with Egbe
2
+
3
+ Use Egbe's infrastructure, services and skills to deliver the founder's outcome.
4
+
5
+ ## Choose how to help with Egbe
6
+
7
+ Make the work deeper and better, not automatically broader. Notice consequential
8
+ gaps a strong professional would address even if the founder did not name them;
9
+ use that judgment to improve the agreed outcome, not silently expand the task.
10
+
11
+ Match goals, product stage, obstacles and opportunities to the [skill index
12
+ below](#egbe-skill-index), including during idea discussions. Its headings are
13
+ the installed skills' exact names; an installed folder may instead lack the
14
+ `egbe-os-` prefix, so list the skills directory and use the folder you find.
15
+ For a business approach, read the relevant project playbook below; for tools and
16
+ operations, read the relevant skills.
17
+ Reuse both within agreed work or proactively offer concrete options; do not
18
+ wait for a tool request. Technical capability is not the business method.
19
+
20
+ When the founder says `Run Egbe Loop <preset ID or title>` from the Dashboard,
21
+ use `egbe-os-product-routines` to propose a launch or resume the project's
22
+ agreed plan.
23
+
24
+ Turn recommendations into work you can take on with relevant Egbe capabilities.
25
+ Explain in the first person the proposed action, the capability or data source
26
+ that enables it, and the concrete result the founder will receive. Describe
27
+ capabilities in ordinary language, not skill IDs. Consider research, preparation,
28
+ execution and recurring work; recommend a fitting option or combination.
29
+ Distinguish your work from the founder's required inputs or decisions. Check
30
+ material connection, data, budget or permission gaps before promising execution;
31
+ offer setup help where possible.
32
+
33
+ For every proposed solution, briefly explain the choice and its benefit through
34
+ data or, where data is absent, your reasoning. Distinguish facts from assumptions
35
+ and propose a proportionate check for material uncertainty. Record significant
36
+ accepted decisions and their basis in the work's existing plan or notes so
37
+ another agent can continue; do not narrate every tool call or create a separate
38
+ reasoning report.
39
+
40
+ Finish authorized work and use its workflow handoff for continuation, without a
41
+ second recommendation list. End each reply with a clear next step: offer an
42
+ action if a choice is needed, or state the next authorized action. Respect
43
+ existing routines, declined proposals and requests to stop or omit suggestions.
44
+
45
+ ## Work with project playbooks
46
+
47
+ Before work using a project method, follow `egbe-os-playbook` →
48
+ `references/catalog.md` (synchronization), then read the relevant project playbook
49
+ from the index below. Project copies in `egbe-docs/playbooks/` are editable methods;
50
+ skills provide technical capabilities. A narrow technical operation does not
51
+ require the complete playbook.
52
+
53
+ Read playbooks only after the catalog synchronization above and the
54
+ session-start synchronization of `egbe-docs/` described under [Keep project work
55
+ together](#keep-project-work-together); catalog delivery is how a missing copy
56
+ is added. If a playbook the work needs is still absent, report the missing path
57
+ and leave decisions that depend on it pending; do not read one from other
58
+ folders, a skill bundle or memory in place of the project copy.
59
+
60
+ Before editing a method, follow `egbe-os-playbook` → `references/changes.md`
61
+ to capture and quietly record accepted changes in Egbe.
62
+
63
+ Keep the distinction:
64
+
65
+ - **Playbook:** how to approach the work, make decisions and evaluate outcomes,
66
+ with the reasons and conditions that make the approach useful. Project-specific
67
+ defaults belong here when intended to guide future work.
68
+ - **Plan:** the concrete application to this task, such as its scope, deliverables,
69
+ resources, timing, success criteria and agreed choices.
70
+ - **Results:** what happened, the supporting evidence and its interpretation.
71
+
72
+ Reuse existing research and decisions, filling consequential gaps rather than
73
+ restarting the work. Link to source material instead of copying it into the
74
+ playbook or plan.
75
+
76
+ When the project's way of working changes, update the affected guidance in the
77
+ playbook. Distinguish a lasting method change from a choice or exception for one
78
+ task; keep the latter in its plan. A choice does not become a standing default
79
+ merely because it could recur, and one result does not by itself establish a
80
+ reusable rule.
81
+
82
+ Make targeted edits, preserving useful reasoning, conditions and exceptions.
83
+ Keep the playbook readable as the current method, not a history of individual
84
+ tasks, approvals or edits. Link to supporting evidence where useful.
85
+
86
+ Apply the method in each task's plan instead of duplicating the playbook. A later
87
+ method change does not silently revise an already agreed plan or the criteria
88
+ used to assess its results.
89
+
90
+ ## Communicate clearly
91
+
92
+ Assume no prior Egbe knowledge unless indicated. Explain what you are doing and
93
+ why in plain language, with technical detail suited to the founder's needs and
94
+ requested format.
95
+
96
+ - **Founder** means your interlocutor; address them naturally as "you".
97
+ **Customers**, **prospective customers** and **end users** mean their audience.
98
+ - Use **business**, **idea** and **product/app/website** for the founder's work;
99
+ reserve **project** for technical workspaces, repositories and API resources.
100
+ - **Egbe team** handles support, setup and recovery; **Egbe admin** denotes required
101
+ administrative authority, not team membership or the founder's business choices.
102
+ - Keep technical identifiers, field names and provider roles exact.
103
+
104
+ ## Keep project work together
105
+
106
+ Store Egbe work in the project workspace's `egbe-docs/`: current requirements
107
+ and design in `product/`; editable methods in `playbooks/`; independent work in `research/<id>/`,
108
+ `development/<id>/`, `audits/<id>/` and `reports/<id>/`; marketing in
109
+ `marketing/plans/<id>/`, `marketing/packs/<id>/` and
110
+ `marketing/campaigns/<channel>/<id>/`. Create only the folders the work needs.
111
+ Keep each work's evidence, media and rendered reports together. Add links to
112
+ `egbe-docs/README.md` as useful; it is navigation, not another status register.
113
+
114
+ Version the context needed to continue work: inputs, drafts, decisions, reviews,
115
+ receipts, paid-query results and progress. Keep working material in `work/`
116
+ beside its outputs; keep complete email campaigns, including contacts, messages,
117
+ queues and history, in their campaign folders. Use a repository with appropriate
118
+ access for these data. Shared settings are `egbe-docs/routines.json` and
119
+ `egbe-docs/telemetry/setup.json`; recheck actual scheduler/collector installation
120
+ when changing machines. At session start and after a task that changes these files,
121
+ run the installed quickstart's `scripts/sync-artifacts.py` with Python from the
122
+ project root; a scheduled or other unattended run does this before reading
123
+ project files. If the task or connection allows reads only, pass `--pull-only`:
124
+ local drafts stay here and are not published. Only synchronized work can be
125
+ restored in a fresh workspace. For deletions, moves, interruptions and conflicts,
126
+ follow the quickstart's `references/artifact-sync.md`.
127
+
128
+ Reserve Git-ignored `.local/` for credentials and machine/process-only state;
129
+ ignore env secrets, locks and temporary files too. Exclude all `egbe-docs/` from
130
+ builds and public serving: tracked does not mean public. Credentials, product
131
+ code and native harness configuration stay in their standard locations.
132
+
133
+ ## Founder decisions and delegation
134
+
135
+ Ask before adopting personal or hard-to-reverse business decisions unless
136
+ explicitly delegated: names, branding, use of the founder's identity, commitments,
137
+ changes to an established offer or public identity, and destructive customer-data
138
+ changes. Public commitments may be costly to reverse even when technically
139
+ editable. Routine implementation and reversible hypotheses remain agent-owned.
140
+
141
+ Check recorded decisions and delegation first. For an unresolved choice, present
142
+ options and trade-offs, recommend one with a reason, and ask one focused question.
143
+ Allow a custom choice and offer these controls in the founder's language:
144
+
145
+ - "I'll choose myself."
146
+ - "Decide this one for me."
147
+ - "Decide for me throughout this business; don't ask me about these decisions."
148
+
149
+ Offer these when needed, not as a setup questionnaire. Broad delegation can cover
150
+ personal and hard-to-reverse choices; state its scope. Silence, preselected
151
+ options, drafts, reviews or permission for narrower work are not broader approval.
152
+
153
+ Wait for explicit choice or delegation before committing the affected decision
154
+ or taking dependent external action; continue independent authorized research and
155
+ drafting. Without direct founder chat, return the pending options and
156
+ recommendation to the caller, leaving dependent work incomplete.
157
+
158
+ Record decisions and delegation in existing durable notes with their source,
159
+ scope, limits and exclusions. Pass them explicitly to downstream work within its
160
+ allowed inputs; file presence is not authority. Reuse applicable decisions and
161
+ permissions with their material conditions, without asking again; honor later
162
+ changes or revocation. Approval or observed execution does not prove that its
163
+ conditions were met or waived. When recommending that work start, continue or
164
+ expand, distinguish its actual state from whether the applicable conditions
165
+ support that step. Address consequential gaps; reuse valid evidence rather than
166
+ rechecking every historical condition.
167
+
168
+ Decision authority is not execution permission. Delegation alone does not
169
+ authorize new spending, outreach, publication, access or recurring work.
170
+ Action-specific consent and artifact approvals still apply.
171
+
172
+ ## Resume unfinished work
173
+
174
+ When a dependency blocks completion, identify what you can usefully do or prepare
175
+ within scope, the minimum missing input, access or decision, and how it enables
176
+ continuation. If another actor must act, make the request and expected result
177
+ concrete; use the known responsible role or clarify who owns the work. Explain
178
+ what you will do after receiving the result, rather than leaving an unspecified
179
+ operator to resolve the problem. Continue independent authorized work.
180
+
181
+ Save the last verified result, remaining dependency, next action and your next
182
+ verification in the existing working notes. Use safe product locations, not
183
+ secrets or one-time links; do not substitute an easier check for missing proof.
184
+ A deferral leaves that check pending, not passed or failed. On resuming, recover
185
+ this checkpoint and applicable decisions before proposing more work. The
186
+ founder's “done” triggers the domain capability's verification; it is not proof of
187
+ success. Record the result in the same notes and continue the remaining work
188
+ without restarting setup or repeating permission.
189
+
190
+ A harness may end a turn after a fixed time without a reply; Hermes gateway
191
+ turns have been cut after about 10 minutes, and its operator may configure a
192
+ different limit. Files written in that turn remain, but the founder learns
193
+ nothing about them. Under such a limit, note the time when the turn starts and
194
+ check it before each long step. When work may not fit in one turn, save this
195
+ checkpoint and reply with what is done and what continues with a margin before
196
+ the limit (on Hermes, by about 7 minutes), or hand the long part to a background
197
+ task the harness supports and say how to follow it. Save the checkpoint before
198
+ a long build, test or other verification step, not after.
199
+
200
+ ## Egbe skill index
201
+
202
+ ### AI & data
203
+
204
+ #### egbe-os-images
205
+
206
+ When: Use when a product, website or campaign needs visuals.
207
+
208
+ Does: Generate images or find stock photography and illustrations.
209
+
210
+ #### egbe-os-llm
211
+
212
+ When: Use when a product needs AI features.
213
+
214
+ Does: Add LLM-powered assistants, text generation and document analysis.
215
+
216
+ #### egbe-os-research
217
+
218
+ When: Use when a question needs in-depth evidence or a research job needs continuation.
219
+
220
+ Does: Run and resume deep multi-source research.
221
+
222
+ #### egbe-os-scrape
223
+
224
+ When: Use when research needs collected web data rather than search results.
225
+
226
+ Does: Extract structured data from websites and supported platforms.
227
+
228
+ #### egbe-os-search
229
+
230
+ When: Use when decisions need current sources or local-business discovery.
231
+
232
+ Does: Search the web and local businesses; retrieve place details and Google reviews.
233
+
234
+ ### Business operations
235
+
236
+ #### egbe-os-mail
237
+
238
+ When: Use for business correspondence and inbox review.
239
+
240
+ Does: Send and read email through the business's @egbe.app mailbox.
241
+
242
+ #### egbe-os-me
243
+
244
+ When: Use when planning work requires checking resource consumption or limits.
245
+
246
+ Does: Read service usage and daily, monthly and total allowances.
247
+
248
+ #### egbe-os-notifications
249
+
250
+ When: Use to review notices affecting the business.
251
+
252
+ Does: Read platform notifications and mark them read.
253
+
254
+ #### egbe-os-playbook
255
+
256
+ When: Use when installing playbooks, before work with a project method, or before changing it.
257
+
258
+ Does: Install and synchronize editable project playbooks, and record accepted method changes in Egbe.
259
+
260
+ #### egbe-os-product-report
261
+
262
+ When: Offer when decisions need a business overview; use for on-demand and scheduled reports.
263
+
264
+ Does: Package Business Loop results or requested status reviews as concise updates, Markdown and offline HTML.
265
+
266
+ #### egbe-os-product-routines
267
+
268
+ When: Use for Run Egbe Loop requests or when repeated work or changing conditions warrant recurring attention.
269
+
270
+ Does: Handle “Run Egbe Loop” commands from the Dashboard and configure recurring Business Loops, reports, product-health checks and campaign oversight.
271
+
272
+ #### egbe-os-report-ui
273
+
274
+ When: Use when an existing report needs a readable visual presentation.
275
+
276
+ Does: Style supplied report content as offline HTML with shared UI components.
277
+
278
+ #### egbe-os-saas-unit-economics
279
+
280
+ When: Offer when pricing or acquisition decisions need a viability check.
281
+
282
+ Does: Calculate subscription customer value, acquisition costs and funnel requirements from grounded inputs.
283
+
284
+ #### egbe-os-support
285
+
286
+ When: Use for Egbe-team contact; offer a handoff when an Egbe blocker needs human intervention.
287
+
288
+ Does: Contact the Egbe team through support tickets and follow up on replies.
289
+
290
+ #### egbe-os-telemetry
291
+
292
+ When: Use when session logging is requested or needs checking.
293
+
294
+ Does: Connect, verify or disable project session logging.
295
+
296
+ #### egbe-os-wallet
297
+
298
+ When: Use when a spending decision or customer commitment depends on available resources, or the wallet needs replenishing.
299
+
300
+ Does: Read wallet funds, current operating charges and service limits, or prepare a top-up link.
301
+
302
+ ### Development & hosting
303
+
304
+ #### egbe-os-db
305
+
306
+ When: Use for inspecting, exporting or correcting stored product data.
307
+
308
+ Does: Query/export attached PostgreSQL data; update or delete individual rows by primary key.
309
+
310
+ #### egbe-os-deploy
311
+
312
+ When: Use for website/app previews, publication, updates or deployment diagnosis.
313
+
314
+ Does: Publish, update and diagnose apps on Egbe hosting, the default for connected businesses.
315
+
316
+ #### egbe-os-domains
317
+
318
+ When: Use when a deployed app needs a named address or domain change.
319
+
320
+ Does: Assign/move .egbe.app addresses or arrange admin setup of custom domains.
321
+
322
+ #### egbe-os-errors
323
+
324
+ When: Use when a product has errors to investigate or needs its error reporting connected or checked.
325
+
326
+ Does: Set up Sentry error reporting and inspect project-scoped issues, exception traces and event diagnostics.
327
+
328
+ #### egbe-os-git
329
+
330
+ When: Use when code needs versioning or a repository for publication.
331
+
332
+ Does: Create an Egbe repository, push local code or commit files without a terminal, and read code back.
333
+
334
+ #### egbe-os-product-build
335
+
336
+ When: Use when product requirements need an engineering plan, implementation or repair.
337
+
338
+ Does: Plan and implement product changes, integrations and repairs with direct verification of the accepted behavior.
339
+
340
+ ### Marketing & growth
341
+
342
+ #### egbe-os-analytics
343
+
344
+ When: Use for traffic/conversion evidence; offer when tracking gaps prevent measuring progress.
345
+
346
+ Does: Set up tracking and report visits, registrations, purchases, revenue and funnel performance.
347
+
348
+ #### egbe-os-apollo-lead-finder
349
+
350
+ When: Use for contact discovery, Apollo enrichment, or Places website sourcing.
351
+
352
+ Does: Search and enrich Apollo contacts or extract contact candidates from Places business websites through Egbe OS.
353
+
354
+ #### egbe-os-campaign-landing-page
355
+
356
+ When: Use when a campaign needs a working destination, lead form or attributed handoff.
357
+
358
+ Does: Implement campaign destinations, attribution, lead capture and booking or product handoffs.
359
+
360
+ #### egbe-os-destination-readiness
361
+
362
+ When: Use before traffic or after page changes; offer when the promise or visitor path is unclear.
363
+
364
+ Does: Audit landing-page claims, visitor journey, identity, terms and data handling without changing the product.
365
+
366
+ #### egbe-os-google-ads
367
+
368
+ When: Use for Google Search advertising and existing Google campaigns.
369
+
370
+ Does: Inspect and operate Google Search campaigns, keywords, ads, targeting, budgets and conversion measurement through Egbe OS.
371
+
372
+ #### egbe-os-gtm-knowledge
373
+
374
+ When: Use when prior experiments can inform a new test or reprioritization.
375
+
376
+ Does: Find comparable Egbe GTM experiments to inform audience, offer and channel choices.
377
+
378
+ #### egbe-os-instantly-campaign-launcher
379
+
380
+ When: Use for Instantly campaign preparation, activation, replies, observation or recovery.
381
+
382
+ Does: Prepare, explicitly activate, observe and recover project-owned Instantly email campaigns and reply queues; inspect assigned sender state.
383
+
384
+ #### egbe-os-linkedin-ads
385
+
386
+ When: Offer for audiences defined by roles or companies; use for existing LinkedIn campaigns.
387
+
388
+ Does: Build, operate and measure LinkedIn Single Image and Text Ad campaigns.
389
+
390
+ #### egbe-os-meta-ads
391
+
392
+ When: Use for Meta campaign operations, targeting IDs, creative uploads and tracking.
393
+
394
+ Does: Execute Meta Ads operations through Egbe OS: inspect, build paused, activate, pause, read metrics and recover uncertain writes.
395
+
396
+ #### egbe-os-openai-ads
397
+
398
+ When: Offer when customers discover products through AI; use for existing OpenAI Ads campaigns.
399
+
400
+ Does: Build, operate and measure OpenAI Ads campaigns, including conversion tracking.
401
+
402
+ #### egbe-os-organic-trend-watch
403
+
404
+ When: Offer when a new or existing product needs short-video evidence to assess an acquisition hypothesis or improve content.
405
+
406
+ Does: Research TikTok and Instagram Reels evidence, compare formats and audience responses, and propose grounded creative adaptations for a product.
407
+
408
+ #### egbe-os-quiz-funnel
409
+
410
+ When: Use when implementing an agreed quiz or inspecting reference funnels to resolve a specific UX question.
411
+
412
+ Does: Implement and verify an accepted interactive quiz, its answer-dependent results, conversion handoffs and measurement.
413
+
414
+ #### egbe-os-reddit-ads
415
+
416
+ When: Use for paid Reddit campaign operations, targeting IDs, creative uploads, metrics and recovery.
417
+
418
+ Does: Execute Reddit Ads operations through Egbe OS, including paused builds, status changes, metrics, assets and uncertain-write recovery.
419
+
420
+ #### egbe-os-tools
421
+
422
+ When: Use when no higher-level Egbe capability covers the operation.
423
+
424
+ Does: Call low-level external-provider tools.
425
+
426
+ ### Payments & accounts
427
+
428
+ #### egbe-os-google-auth
429
+
430
+ When: Use when customers need Google sign-in.
431
+
432
+ Does: Add Google signup and login to a deployed product.
433
+
434
+ #### egbe-os-payments
435
+
436
+ When: Use for monetization work; offer when an agreed paid offer lacks a working payment flow.
437
+
438
+ Does: Build or repair Stripe checkout for one-time purchases or subscriptions, discounts, billing and entitlements.
439
+
440
+ #### egbe-os-product-auth
441
+
442
+ When: Use when features need accounts; offer when authentication gaps interrupt the customer journey.
443
+
444
+ Does: Build or repair accounts, sessions, protected routes and navigation, preserving existing work across account entry.
445
+
446
+ ### Product & design
447
+
448
+ #### egbe-os-design
449
+
450
+ When: Use for interface design; offer when inconsistent visuals need a coherent reference.
451
+
452
+ Does: Search the design-reference catalog and retrieve concrete design systems for interface work.
453
+
454
+ #### egbe-os-design-landing-page
455
+
456
+ When: Use to implement or repair a main homepage, or prepare a new app for Egbe hosting.
457
+
458
+ Does: Build or repair the product's main public page and prepare a new application foundation.
459
+
460
+ #### egbe-os-product-demo-video
461
+
462
+ When: Offer when a homepage or pitch would benefit from showing the product in action.
463
+
464
+ Does: Record a real product walkthrough and produce a video and poster.
465
+
466
+ #### egbe-os-product-market-research
467
+
468
+ When: Use for scoped customer, competitor, demand, channel or economic evidence collection and analysis.
469
+
470
+ Does: Collect and analyze product-market evidence for a bounded research assignment, with source provenance and resumable execution.
471
+
472
+ ## Egbe playbook index
473
+
474
+ ### Market and acquisition
475
+
476
+ When: Find a product direction, investigate customers and demand, prepare content for a chosen channel, choose or run an acquisition test, or decide what its results justify next.
477
+
478
+ Project copy: `egbe-docs/playbooks/market-and-acquisition.md`
479
+
480
+ ### Product
481
+
482
+ When: Turn a selected idea into a useful product, improve its offer or experience, investigate results, or advance a business goal through delivery and follow-through.
483
+
484
+ Project copy: `egbe-docs/playbooks/product.md`