@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,355 @@
1
+ # Product Checkout Workflow
2
+
3
+ Use this workflow to implement an accepted offer's catalog, pricing handoff and
4
+ Checkout Session creation. `one_time` uses `mode: "payment"`; `subscription`
5
+ uses `mode: "subscription"` with a recurring price. Do not choose a commercial
6
+ model as an implementation shortcut.
7
+
8
+ ## References
9
+
10
+ Read before implementation:
11
+
12
+ 1. [../contracts/plan-catalog.md](../contracts/plan-catalog.md)
13
+ 2. [../security/server-integration.md](../security/server-integration.md)
14
+ 3. [discounts-and-promotion-codes.md](discounts-and-promotion-codes.md)
15
+ 4. [Webhook security](../security/webhook-and-entitlements.md) for signature
16
+ verification and the gateway preflight that runs during checkout validation.
17
+ Subscription transition details apply only to subscriptions.
18
+
19
+ ## Workflow
20
+
21
+ 1. Inspect accepted requirements, pricing surface, auth continuation, account model,
22
+ deployment env, and any payment code. Continue the same product.
23
+ 2. Build one plan catalog and make landing pricing render from it.
24
+ 3. Create or reuse owned Stripe products and prices through OS. Send stable
25
+ `Idempotency-Key` headers and include `plan_key`,
26
+ `payment_gateway_app_slug`, and `payment_gateway_webhook_path` in provider
27
+ metadata so later lifecycle checks can resolve the product target directly
28
+ from scoped readback. Confirm ids and metadata with
29
+ `GET /payments/evidence`.
30
+ 4. Use the server-only `OS_URL` and `OS_API_KEY` injected by Site Gateway, plus
31
+ the product webhook secret deployed exactly as described in the server
32
+ integration contract. Never mint or deploy a payments-specific OS key.
33
+ 5. Route a paid CTA to `/checkout?plan=<plan-key>` or an equivalent stable
34
+ product route. A free plan may continue directly to signup.
35
+ 6. When the accepted flow requires an account, preserve the validated same-origin
36
+ checkout continuation through signup/login. After auth, resume the same plan.
37
+ For an accepted guest purchase, use the server-owned order/session binding
38
+ in [one-time-purchase.md](one-time-purchase.md); do not add signup by default.
39
+ 7. In a protected server checkout route, resolve `plan_key`, the buyer/order binding,
40
+ any existing owned customer, and allowed return URLs. For an account purchase
41
+ without an owned customer, use the authenticated account's server-read
42
+ verified email as `customer_email`; never accept that email from the browser.
43
+ Create or load a durable logical
44
+ checkout-attempt record before any provider create. Store its idempotency
45
+ key and the bounded buyer/order, plan, return-path, and attribution snapshot.
46
+ When the signed lifecycle event supplies a customer id, preserve its
47
+ buyer/order binding; attach it to an account only through verified ownership.
48
+ A guest purchase requires neither an account nor a provider customer id.
49
+ Keep this work in
50
+ a repository/data-access module when that matches the product architecture;
51
+ checkout routes do not need inline SQL.
52
+ If the product issues customer-restricted promotion codes, do not wait for a
53
+ first lifecycle event: explicitly create and persist the account's owned
54
+ Customer before opening Checkout, then send that exact `customer` in both
55
+ validation and creation. A `customer_email`-only session cannot redeem a
56
+ code restricted to a Stripe Customer, even when the emails match.
57
+ 8. For subscriptions, if the account already has an active, trialing, past-due, paused, or otherwise
58
+ managed subscription, open Customer Portal instead of creating another
59
+ subscription.
60
+ 9. Build one server-owned checkout payload from the durable attempt. Validate
61
+ it with `POST /payments/checkout-sessions/validate`; this must not create a
62
+ session. New implementations enable customer-entered promotion codes by
63
+ default. Leave automatic discounts absent unless product billing
64
+ configuration selects one through the discounts workflow.
65
+ 10. Only after validation succeeds (`data.valid` is true), create the real
66
+ session through `POST /payments/checkout-sessions`. In this ordinary
67
+ customer flow the validation response carries no `validation_receipt`, so
68
+ never require one before creating the session; see
69
+ [Validate-only contract](#validate-only-contract). Reuse the same validated price, mode,
70
+ owned `customer` or server-bound `customer_email`, stable account
71
+ or order `client_reference_id`, app slug, webhook
72
+ path, same-origin return URLs, first-touch attribution, and the persisted
73
+ idempotency key for that logical checkout attempt.
74
+ 11. Return the real Stripe URL to the browser. Complete the browser payment
75
+ handoff through the Egbe OS analytics workflow, then navigate.
76
+
77
+ ## Stable logical-attempt identity
78
+
79
+ Use one non-empty idempotency identity for the complete logical checkout
80
+ attempt. Persist it before validation or provider creation. Concurrent requests
81
+ for the same pending attempt must converge on one stored record, using a
82
+ transaction, unique constraint plus upsert, or an equivalent atomic
83
+ get-or-create operation. If an insert loses a race, reload the winning record.
84
+
85
+ Treat the persistence row and the checkout-attempt domain value as different
86
+ types. Map field names explicitly at the repository boundary, especially when
87
+ the database returns snake_case fields and application code uses camelCase.
88
+ Validate the mapped identity before returning it:
89
+
90
+ ```ts
91
+ type CheckoutAttemptRow = {
92
+ id: string;
93
+ idempotency_key: string | null;
94
+ };
95
+
96
+ type CheckoutAttempt = {
97
+ id: string;
98
+ idempotencyKey: string;
99
+ };
100
+
101
+ function toCheckoutAttempt(row: CheckoutAttemptRow): CheckoutAttempt {
102
+ const idempotencyKey = row.idempotency_key?.trim();
103
+ if (!idempotencyKey) {
104
+ throw new Error("Checkout attempt has no idempotency identity");
105
+ }
106
+ return { id: row.id, idempotencyKey };
107
+ }
108
+ ```
109
+
110
+ An ORM or another language may provide equivalent mapping, but do not cast a
111
+ raw persistence row to a differently named application type. Do not recover a
112
+ missing stored identity with the probe id, request time, or a request-local
113
+ random value. A missing identity is invalid attempt state and fails closed.
114
+
115
+ Generate a new opaque provider idempotency key once when a new logical attempt
116
+ row is created, and persist it as part of that atomic creation. A UUID or an
117
+ equivalent random value is appropriate at this boundary. For a subscription,
118
+ an active-attempt uniqueness rule may use account and plan. For a one-time
119
+ purchase, scope it to the specific order and plan: two orders for the same
120
+ buyer and price must not share a pending attempt. Preserve that order and attempt
121
+ across guest-to-account entry. Neither account/plan nor order/plan is a permanent
122
+ provider idempotency key. After an attempt reaches a terminal state, a deliberate new
123
+ attempt gets a new row and a new provider idempotency key. Current time or a
124
+ fresh random value is unsafe only when it is recomputed for each retry or used
125
+ as a fallback for a missing stored identity.
126
+
127
+ ## Validate-only contract
128
+
129
+ The protected checkout entry point must support a non-mutating validation mode
130
+ without creating a second checkout implementation. When the incoming product
131
+ request contains both:
132
+
133
+ ```text
134
+ X-Egbe-Payment-Probe: validate-only
135
+ X-Egbe-Payment-Probe-ID: <opaque caller id>
136
+ ```
137
+
138
+ run the same authentication or protected guest-order lookup, plan and customer binding, return URL,
139
+ webhook, attribution, and durable logical-attempt lookup as the normal flow.
140
+ Then:
141
+
142
+ 1. forward both headers to `POST /payments/checkout-sessions/validate`;
143
+ 2. include the logical attempt's stable idempotency key as
144
+ `idempotency_key` in the validation body;
145
+ 3. do not call customer, Checkout Session, Payment Link, entitlement, or
146
+ analytics mutation routes;
147
+ 4. unwrap the standard Egbe OS response envelope and return bounded JSON
148
+ containing `validation_only: true`, `operation: "checkout"`, `valid: true`,
149
+ and the real opaque `data.validation_receipt`;
150
+ 5. do not redirect to Stripe in this mode and do not persist the receipt.
151
+
152
+ Egbe OS responses use the same envelope:
153
+
154
+ ```json
155
+ {
156
+ "code": 200,
157
+ "message": "Checkout configuration is valid; no session was created.",
158
+ "data": {
159
+ "valid": true,
160
+ "validation_receipt": "<opaque signed receipt>"
161
+ }
162
+ }
163
+ ```
164
+
165
+ Egbe OS issues `validation_receipt` only when the request carries both probe
166
+ headers. A normal customer request sends neither header, and its validation
167
+ response is `data.valid: true` with no receipt. Apply the receipt check below
168
+ only inside the validate-only branch; requiring a receipt in the ordinary flow
169
+ makes every real purchase fail with a validation error before Stripe is reached,
170
+ while validate-only probes still pass.
171
+
172
+ Read provider fields from the decoded envelope's `data`, not from the top-level
173
+ envelope. If the HTTP client itself wraps the decoded body in `response.data`,
174
+ the receipt is therefore `response.data.data.validation_receipt`, not
175
+ `response.data.validation_receipt`.
176
+ Never substitute a placeholder or fallback receipt when
177
+ `data.validation_receipt` is absent. Treat that as a failed validation response
178
+ and return an error without creating a Checkout Session. A value such as
179
+ `probe-accepted`, an empty string, or a locally generated token is not a
180
+ validation receipt.
181
+
182
+ For example, when the product OS client returns the decoded envelope:
183
+
184
+ ```ts
185
+ const envelope = await validateCheckoutSession(validationPayload);
186
+ const receipt = envelope.data?.validation_receipt;
187
+ if (!envelope.data?.valid || !receipt) {
188
+ throw new Error("OS checkout validation returned no validation receipt");
189
+ }
190
+ return Response.json({
191
+ validation_only: true,
192
+ operation: "checkout",
193
+ valid: true,
194
+ validation_receipt: receipt,
195
+ });
196
+ ```
197
+
198
+ A paid landing CTA may be an ordinary same-origin link to
199
+ `/checkout?plan=<plan-key>` or an equivalent stable route. Do not add
200
+ probe-specific DOM topology to the landing page. On the reached paid checkout
201
+ surface, keep `data-plan-key` on the selected plan container and use
202
+ `data-checkout-action` on a same-origin form or a control associated with that
203
+ form. The form action is the protected checkout endpoint and carries the
204
+ selected plan as form data. This is a runtime contract, not a layout
205
+ requirement: intermediate pages, router transitions, button text, and component
206
+ topology remain product-owned.
207
+
208
+ Two retries of the same logical attempt must reuse the same persisted
209
+ idempotency key. Unknown or malformed probe headers fail closed; they never fall
210
+ through to provider create.
211
+
212
+ Never create Checkout Sessions as schema probes. Treat existing working
213
+ authentication as product infrastructure and preserve it while adding checkout.
214
+ Do not redesign login UI, redirects, client hydration, or session behavior as
215
+ part of this workflow.
216
+
217
+ For authenticated implementation and verification, reuse the private
218
+ validation identity prepared by Auth and the normal product session resolver.
219
+ Do not create another account, replay password or email-link entry, or add a
220
+ public test-login path merely to reach Checkout.
221
+
222
+ For an authorized after-turn review, leave a supported way to repeat this
223
+ validate-only flow with the reviewer's available tools and normal authentication.
224
+ Generate and verify fresh receipts during that review; an expired builder
225
+ receipt is not a reusable handoff. Preserve the existing non-mutating contract
226
+ and receipt lifetime. A successful checkout validation does not by itself prove
227
+ signed lifecycle processing, durable paid access or delivery.
228
+
229
+ ## OS Calls
230
+
231
+ Use snake_case payloads:
232
+
233
+ ```text
234
+ POST /payments/products
235
+ POST /payments/prices
236
+ POST /payments/customers
237
+ POST /payments/checkout-sessions/validate
238
+ POST /payments/checkout-sessions
239
+ GET /payments/evidence
240
+ ```
241
+
242
+ Every create call must use `Idempotency-Key`. Keep provider ids in the server
243
+ catalog/database and return only the checkout destination needed by the browser.
244
+ Persist a checkout-attempt record bound to the buyer/order and selected plan before the
245
+ provider call. Retries of that attempt reload its stored payload identity and
246
+ idempotency key; a deliberate new attempt gets a new record and a new key. Do
247
+ not derive one permanent provider key from account plus plan. Do not recompute
248
+ retry identity from current time or a fresh UUID inside each request.
249
+ Do not rebuild a materially different payload between validation and creation.
250
+
251
+ The checkout webhook path is a future delivery address, not proof that its
252
+ handler is ready. Never add a placeholder handler that returns a successful
253
+ response before verifying and durably recording the signed event; that would
254
+ discard a real payment event and suppress provider retries. When signed
255
+ lifecycle processing is unfinished, keep checkout unavailable for real purchases
256
+ until it can safely accept delivery; do not acknowledge unverified events.
257
+
258
+ The canonical checkout payload uses one provider `price`, not Stripe SDK
259
+ `line_items`. Build it once on the server and reuse it for validation and
260
+ creation. The two OS operations carry the same persisted identity through
261
+ different transport contracts: validation requires body field
262
+ `idempotency_key`; creation requires HTTP header `Idempotency-Key`. Keep those
263
+ transport details explicit in typed client methods instead of spreading an
264
+ ambiguous camelCase field into both payloads:
265
+
266
+ `checkoutBinding` below is the server-validated snapshot stored with the attempt.
267
+ Its `purchaseReference` identifies the order for a one-time purchase or the account
268
+ for a subscription. `customerFields` contains either an owned `customer`, a
269
+ server-bound `customer_email`, or neither when Checkout collects the guest's contact;
270
+ that contact alone never establishes ownership. Return URLs are validated for the
271
+ accepted product flow, not forced to an account billing page.
272
+
273
+ ```ts
274
+ const checkoutPayload = {
275
+ price: plan.priceId,
276
+ mode: plan.kind === "subscription" ? "subscription" : "payment",
277
+ ...checkoutBinding.customerFields,
278
+ client_reference_id: checkoutBinding.purchaseReference,
279
+ success_url: checkoutBinding.successUrl,
280
+ cancel_url: checkoutBinding.cancelUrl,
281
+ app_slug: deployedAppSlug,
282
+ webhook_path: "/api/payments/webhook",
283
+ metadata: { plan_key: plan.planKey, attribution: firstTouchAttribution },
284
+ };
285
+ const idempotencyKey = attempt.idempotencyKey.trim();
286
+ if (!idempotencyKey) {
287
+ throw new Error("Checkout attempt has no idempotency identity");
288
+ }
289
+
290
+ await validateCheckoutSession({
291
+ ...checkoutPayload,
292
+ idempotency_key: idempotencyKey,
293
+ });
294
+ return createCheckoutSession(checkoutPayload, {
295
+ headers: { "Idempotency-Key": idempotencyKey },
296
+ });
297
+ ```
298
+
299
+ After verifying both validation receipts, interpret idempotency evidence before
300
+ deploying. An absent idempotency fingerprint means the persisted identity did
301
+ not reach the validation body. Different fingerprints mean repeated requests
302
+ did not reload the same logical attempt. Fix the repository/client boundary;
303
+ never manufacture a probe-only fallback identity.
304
+
305
+ ## Preflight Before Deploy
306
+
307
+ Check the implementation once against this list before deploying:
308
+
309
+ 1. Checkout creation requires the normal server-side buyer/order authorization;
310
+ any account-entry continuation preserves `plan_key`.
311
+ 2. A repository or database adapter atomically reads or creates the logical
312
+ checkout attempt before validation or provider creation and explicitly maps
313
+ persistence field names into the application type.
314
+ 3. The mapped attempt supplies one non-empty stable idempotency key; request
315
+ time, probe ids, and request-local random values do not define retry
316
+ identity.
317
+ 4. Validation and creation share the same server-owned price, mode, customer,
318
+ buyer/order reference, customer/customer-email choice, return URLs, app slug,
319
+ webhook path, and attribution.
320
+ 5. Starting from the deployed landing page, each paid CTA reaches its selected
321
+ same-origin checkout route without relying on a particular card or component
322
+ structure.
323
+ 6. On that route, the selected plan container, same-origin form action, and plan
324
+ form value expose one coherent endpoint contract.
325
+ 7. With the normal authenticated test account or authorized guest-order session,
326
+ submit the live form twice over HTTP to
327
+ the product checkout endpoint using the validate-only headers. Both responses
328
+ must return the real
329
+ `data.validation_receipt`; verify both receipts through
330
+ `POST /payments/validation-receipts/verify`.
331
+ 8. Verified claims bind the expected app, plan, owned product/price, current
332
+ buyer/order reference, and one stable idempotency fingerprint. Scoped provider readback is
333
+ unchanged before and after both requests.
334
+ 9. The validate-only request body contains `idempotency_key`; the provider
335
+ create request sends the same value in the `Idempotency-Key` header.
336
+ 10. Product build/type checks pass and the paid CTA preserves the plan through
337
+ any required authentication to the checkout endpoint. An authorized real
338
+ checkout handoff is a separate check, not a schema probe or mandatory charge.
339
+
340
+ Do not implement billing analytics in this workflow. Do not apply subscription
341
+ entitlements from checkout return URLs; provider lifecycle events own that
342
+ state in the payment lifecycle workflow.
343
+
344
+ ## Completion
345
+
346
+ Each displayed paid plan preserves its identity through the accepted buyer flow
347
+ to the validated checkout endpoint. A ready or done report names the outcome
348
+ of both receipts verified through `POST /payments/validation-receipts/verify`
349
+ (Preflight items 7-8) and the `GET /payments/evidence` readback taken before and after
350
+ those requests. A build or type check alone does not make checkout ready;
351
+ without both verified receipts and both readbacks, report checkout readiness as
352
+ unconfirmed and name the missing check. State separately whether the real
353
+ Stripe handoff has been observed. Unknown plans, foreign
354
+ provider ids, duplicate subscriptions, unsafe return URLs, and provider errors
355
+ fail without changing entitlement state.
@@ -0,0 +1,55 @@
1
+ # Subscription Lifecycle Workflow
2
+
3
+ Use this workflow to turn signed Stripe events into durable product access.
4
+
5
+ ## References
6
+
7
+ Read [../security/webhook-and-entitlements.md](../security/webhook-and-entitlements.md)
8
+ before changing the webhook or access checks. Read the Egbe OS analytics payment
9
+ workflow when adding lifecycle events; analytics is not defined here.
10
+
11
+ ## Workflow
12
+
13
+ 1. Add durable account billing, subscription, processed-event, and entitlement
14
+ storage using the product's existing database and migration conventions.
15
+ 2. Implement the configured POST webhook route with raw-body signature
16
+ verification and duplicate-safe transactions. Signature verification must
17
+ complete before JSON event dispatch.
18
+ 3. Map checkout completion using `client_reference_id` plus the stored owned
19
+ customer mapping. Persist customer, subscription, plan, period, and provider
20
+ event ids.
21
+ 4. Apply live lifecycle events:
22
+ - paid checkout confirms the initial purchase;
23
+ - subscription create/update/delete/pause/resume synchronizes status;
24
+ - paid renewal invoice extends the paid period;
25
+ - failed payment moves to the product's warning/grace behavior;
26
+ - successful refund records the adjustment and updates access according to
27
+ the product policy.
28
+ 5. Make server-side feature access read entitlements from this durable state.
29
+ 6. Keep lifecycle decisions in one pure transition reducer shared by simulated
30
+ and live events. Exercise it through `POST /payments/webhooks/test` for paid
31
+ checkout, renewal, failed payment, cancellation, and refund. After signature
32
+ verification, return the bounded test contract from
33
+ [../security/webhook-and-entitlements.md](../security/webhook-and-entitlements.md)
34
+ before calling any persistence, entitlement, revenue, or analytics helper.
35
+ The no-side-effect boundary applies to imported helpers as well as
36
+ route-local code. Invalid signatures, and signatures timestamped more than
37
+ 60 seconds in the future or older than five minutes, must return 4xx;
38
+ replaying one simulated event id must be reported as a duplicate and remain
39
+ side-effect free. No particular internal action name is required.
40
+ 7. Prove durable application and actual Product enforcement separately from
41
+ the side-effect-free simulation. Follow
42
+ [../security/durable-verification.md](../security/durable-verification.md)
43
+ using the product's isolated integration-test mechanism. Do not require a
44
+ real charge or make a test event mutate production to obtain this proof.
45
+ 8. Use `GET /payments/evidence` to confirm provider-side customer,
46
+ subscription, checkout, and event ownership when real evidence exists.
47
+
48
+ Do not infer purchase from a success URL, client state, email address, or an
49
+ unsigned payload. Do not require a real charge merely to prove readiness.
50
+
51
+ ## Completion
52
+
53
+ Invalid and stale signatures fail, duplicate events are harmless, simulated
54
+ events cannot grant access, real subscription transitions are explainable in
55
+ the local database, and protected product behavior uses those entitlements.
@@ -0,0 +1,79 @@
1
+ ---
2
+ name: egbe-os-playbook
3
+ description: Install and synchronize editable project playbooks, and record accepted method changes in Egbe.
4
+ metadata:
5
+ egbe-when: "Use when installing playbooks, before work with a project method, or before changing it."
6
+ egbe-visible: "false"
7
+ egbe-title: "Project playbooks"
8
+ egbe-description: "Install and update project working methods, and record accepted adaptations for the Egbe team."
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
+ Run a script bundled with this skill from the root of a project folder set up
56
+ for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
57
+ A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
58
+ ID from `.env.local` through Egbe's request helper, which comes with the plugin at
59
+ `../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
60
+ skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
61
+ through the helper, which loads `.env.local` without executing it:
62
+ `python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
63
+ this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
64
+ holds this skill's folder.
65
+
66
+
67
+ # Project playbooks
68
+
69
+ Project playbooks in `egbe-docs/playbooks/` own the method. This skill handles
70
+ their delivery, synchronization and change records, not the business decision.
71
+
72
+ - For setup, follow [initial installation](references/catalog.md#initial-installation).
73
+ - Before work with a project method, follow
74
+ [synchronization](references/catalog.md#synchronize-before-method-work).
75
+ - Before editing one, read [Changes](references/changes.md) to capture and quietly
76
+ record accepted method changes; also use it to resume unfinished delivery.
77
+ - Without the installed helper, such as through the Egbe connector alone, follow
78
+ [Changes](references/changes.md#through-the-egbe-connector) to build and send
79
+ the record yourself.
@@ -0,0 +1,91 @@
1
+ # Email outreach
2
+
3
+ Use this for a targeted email acquisition test, whether recipients already exist
4
+ or need to be sourced. It supplements the shared market and acquisition method:
5
+ keep concrete choices and results in the existing test plan, not in this playbook.
6
+
7
+ ## Recipient and source coverage
8
+
9
+ Identify whose role, situation and ability to act make the message relevant to
10
+ the test. Reuse research and an existing suitable list. With
11
+ `egbe-os-apollo-lead-finder`, choose Apollo, Places or another available source
12
+ for its actual coverage; a local business audience may be poorly represented in
13
+ a B2B people database. Inspect a small sample for relevance before paying to
14
+ enrich a larger selection.
15
+
16
+ Distinguish a suitable organisation, a likely contact and a usable email address.
17
+ Missing or partial source results do not show that the market is absent. Explain
18
+ coverage gaps and propose another source or a reasoned audience change; do not
19
+ silently broaden the audience to fill a quota. Names and personalisation must
20
+ come from evidence, not guesses from an email address or invented familiarity.
21
+
22
+ ## Message and sequence
23
+
24
+ Make the first contact easy to understand: why this recipient, the useful offer
25
+ and a feasible next step. Prefer concise copy, a modest initial request and simple
26
+ formatting without unnecessary links. These are starting choices, not bans:
27
+ include a relevant resource or meeting invitation when it serves the recipient
28
+ and the test. Personal relevance does not require a name token or a fixed script.
29
+
30
+ Give each follow-up a purpose: useful context, clarification, a reminder or closing
31
+ the conversation. Choose a finite sequence and spacing for the buying context;
32
+ not every follow-up needs new material. Make declining straightforward. Use the
33
+ actual product's capabilities and proof, and do not ask for credentials or
34
+ sensitive customer files in a cold reply; use an appropriate protected route if
35
+ the product needs them.
36
+
37
+ Prepare the actual recipients, messages and intended responses for the agreed
38
+ material review. `egbe-os-instantly-campaign-launcher` translates that plan into
39
+ campaigns and replies; API acceptance does not establish copy quality.
40
+
41
+ ## Readiness, pilot and pace
42
+
43
+ Usually start with part of a finite audience so an untested approach does not
44
+ consume the whole list. Size the pilot and subsequent batches using available
45
+ recipients, contact costs, sending capacity and the ability to handle replies.
46
+ Expand only as delivery and responses justify it, rather than meeting a universal
47
+ contact target or daily minimum. A sourced email is not yet a campaign-ready
48
+ recipient: check suitability, prior contact, refusals and address verification.
49
+
50
+ Use the Instantly skill for technical readiness and delivery protection. In the
51
+ plan, explain the chosen volume, schedule, operational stop conditions and who
52
+ will handle replies. Distinguish new recipients from all sent messages, including
53
+ follow-ups. State whether a limit applies to one campaign, each sender or the
54
+ project as a whole; account for other campaigns sharing those senders or limits.
55
+ A per-campaign cap is not a project-wide safeguard. Check delivery problems early;
56
+ judge the offer later when the relevant recipients have had time to receive and
57
+ respond. One fixed review
58
+ hour or contact count cannot serve both purposes. Arrange real observation using
59
+ the shared [test workflow](../run-test.md), without assuming every optional job
60
+ or daily document is needed.
61
+
62
+ ## Continue the conversation
63
+
64
+ Read the actual reply and thread. Distinguish interest, a question, an objection,
65
+ a refusal, an automatic response and a different contact. Continue from what the
66
+ person said and what the product can deliver, not from a keyword category.
67
+ Keep promises consistent with the offer and carry relevant context into a handoff.
68
+ When a founder decision is needed, provide the reply, a proposed response and why.
69
+
70
+ Use the Instantly reply tools to preserve the thread and sender, record confirmed
71
+ refusals and check that sending has stopped. An automatic reply is not a person
72
+ declining, and marking a queue item handled is not proof of a provider-side stop.
73
+
74
+ ## Interpret the test
75
+
76
+ Separate delivery, substantive replies, qualified interest and the intended
77
+ product action. Show the counts behind rates and distinguish people from messages;
78
+ automatic replies, refusals and follow-ups do not all represent new interest.
79
+ Use product analytics for the corresponding action when available. Opens are at
80
+ most a noisy diagnostic, not proof of attention, demand or a winning message;
81
+ disabled tracking yields no open-rate evidence.
82
+
83
+ Compare recipients with comparable time to receive the sequence and respond.
84
+ Recently added batches are not mature just because the campaign is old. Identify
85
+ whether the observed problem is source relevance, delivery, the offer/message,
86
+ conversation handling or the subsequent product path. Aggregate campaign counts
87
+ cannot attribute success to the last follow-up or rank unmeasured message variants.
88
+
89
+ Use [evaluation](../evaluate.md) for the supported next decision. Do not convert
90
+ a universal reply-rate band into an automatic scale/pivot verdict; retain useful
91
+ reply evidence and the interpretation in the existing results.
@@ -0,0 +1,40 @@
1
+ # Google Search
2
+
3
+ Use this when assessing or running a Search test that reaches people through
4
+ expressed search intent. It supplements the shared market and acquisition method; use
5
+ `egbe-os-google-ads` for API operations, platform constraints and campaign records.
6
+
7
+ ## Demand and targeting
8
+
9
+ Use Google keyword ideas to investigate relevant demand. Compare query intent
10
+ with the actual offer, not just volume or a cheap click. Choose geography,
11
+ language, grouping and match types for the audience being tested, without a
12
+ fixed number of keywords, groups or variants.
13
+
14
+ For ambiguous shortlisted queries, reuse search-result evidence or check the
15
+ intended market's results when evidence is insufficient; do not research every
16
+ keyword separately. Keep material reasons for rejecting otherwise attractive
17
+ candidates in the existing plan.
18
+
19
+ Derive negative keywords from unwanted intent, not cost alone. Check their scope
20
+ and match types against wanted queries so they do not exclude the intended
21
+ audience. Explain the starting maximum CPC using available evidence and the
22
+ agreed spending limits; keep it distinct from expected average click cost.
23
+
24
+ ## Ads and measurement
25
+
26
+ Prepare the full keyword selection, exclusions, groups, headlines, descriptions
27
+ and destinations. Check continuity from query intent to ad promise, landing
28
+ page and intended action.
29
+
30
+ Choose Google conversion actions that represent the intended outcome. Explain
31
+ separately whether they are for observation or bidding optimization: collecting
32
+ an action is not by itself a reason to let bidding optimize toward it.
33
+
34
+ ## Interpreting a Search test
35
+
36
+ Where available, inspect actual search terms and their relevance, not only the
37
+ planned keyword list. Relate impressions and clicks to intent, spend and the
38
+ destination's outcomes. Check whether a mismatch comes from the searched intent,
39
+ match behavior, ad promise or landing experience before proposing a specific
40
+ keyword, exclusion, creative or destination change.
@@ -0,0 +1,24 @@
1
+ # LinkedIn
2
+
3
+ Use this for audiences whose professional context matters to the offer. Combine
4
+ it with the shared method; use `egbe-os-linkedin-ads` for supported targeting,
5
+ formats, account access and operations.
6
+
7
+ ## Reach the relevant buying situation
8
+
9
+ Connect professional role, organization and problem to the offer. Distinguish
10
+ the person responding from the buyer or decision-maker. Treat audience estimates
11
+ as estimates; if targeting is too narrow, explain the trade-off before broadening
12
+ it rather than silently sacrificing relevance for reach.
13
+
14
+ Design the message for the chosen format: a single-image ad can carry a clear
15
+ visual focal claim, while a small text-ad thumbnail cannot carry dense text.
16
+ Put the essential offer early enough to survive feed text truncation, and make
17
+ the next action fit the professional buying situation.
18
+
19
+ ## Interpret the buying cycle
20
+
21
+ Evaluate lead quality and progression over the relevant buying window, not only
22
+ CTR or low-cost clicks. A useful qualified conversation may precede a purchase;
23
+ check whether it advances the intended organization's buying process, not merely
24
+ whether a professional profile submitted a form.