@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,93 @@
1
+ # Reuse shipped product foundations
2
+
3
+ Inspect the existing application and accepted behavior first. These optional
4
+ application and account/session foundations fit the bundled Next.js/Postgres
5
+ stack. The shared auth database assets also support custom Node/Postgres apps.
6
+ Another stack or working integration should keep its established implementation.
7
+ Installing code does not select an offer, account-entry method or commercial model.
8
+
9
+ The complete skill catalog includes a local helper at
10
+ `<skills-directory>/egbe-os-product-build/scripts/scaffold.py`. It locates sibling
11
+ bundles by their published names; no checkout, network call or credentials are
12
+ needed. Discover the choices and preview a compatible new application:
13
+
14
+ ```bash
15
+ python3 <skills-directory>/egbe-os-product-build/scripts/scaffold.py list
16
+ python3 <skills-directory>/egbe-os-product-build/scripts/scaffold.py plan --target <product-directory> --nextjs
17
+ ```
18
+
19
+ Select only the required pieces:
20
+
21
+ | Option | Installs | Still needs implementation/configuration |
22
+ | --- | --- | --- |
23
+ | `--nextjs` | Blank application from Design landing page | Product UI/behavior, real public observability bindings |
24
+ | `--auth-db` | Shared Node/Postgres auth schema, migration runner and private validation-session helper | Application's account-entry/session resolver, protected access, real attached database and controlled migration step; preserves framework/start command |
25
+ | `--accounts` | Product Auth's Postgres schema, migrations, server account/session helpers and validation-session helper | Selected account-entry/recovery UX, real attached database and protected product paths |
26
+ | `--subscriptions` | Payments' subscription foundation plus its required account foundation | Accepted plan catalog, real provider bindings, account-entry, product entitlements, navigation and verification |
27
+
28
+ For a compatible new app requiring subscriptions, preview with
29
+ `plan --target <product-directory> --nextjs --subscriptions`. For a compatible
30
+ existing Next.js app, omit `--nextjs` and select only the absent foundation.
31
+ The subscription foundation is **not** a one-time purchase engine: use Payments'
32
+ one-time-purchase workflow for that offer instead. A stateless product need not
33
+ add accounts or payments.
34
+
35
+ For a custom Node/Postgres app with a `package.json`, use
36
+ `plan --target <product-directory> --auth-db`. This reuses the existing raw-SQL
37
+ assets without installing Next.js modules or changing the app's start command.
38
+ It adds `pg`, `db:migrate` and `auth:validation-session`; it does not supply a
39
+ complete auth implementation. Preserve an established ORM/auth library's schema
40
+ and migration ledger instead of installing parallel raw-SQL tables. The full
41
+ `--accounts` and `--subscriptions` options include these same database assets.
42
+ Read the [shared auth database contract](../../egbe-os-product-auth/assets/db/README.md)
43
+ for the schema, session-token contract and private validation-session lifecycle.
44
+
45
+ Review the preview, then repeat the same arguments with `apply` instead of
46
+ `plan`. The helper merges required package entries, copies missing foundation
47
+ files and appends the installed foundation's marked ownership guidance to
48
+ `AGENTS.md`, preserving existing project guidance and credentials. The Next.js
49
+ starter appends its build/secret ignore rules to `.gitignore`, preserving existing
50
+ rules; review their order in the resulting file. Different
51
+ existing files, dependency versions, scripts or marked guidance stop the whole
52
+ plan before writes; resolve the integration deliberately rather than deleting
53
+ working code. Symlinks within the destination are rejected. Repeating the same
54
+ installation without intervening edits makes no changes. Edited foundations
55
+ remain a manual review, not an update/overwrite target.
56
+
57
+ ## Without a terminal
58
+
59
+ Through the Egbe connector, or wherever the local helper cannot run, Egbe runs
60
+ the same helper against a repository. Open a commit session on the product's
61
+ repository and branch as `egbe-os-git` describes ("Without a terminal"), then:
62
+
63
+ ```json
64
+ POST /git/commit-sessions/<session_id>/scaffold
65
+ {"foundations": ["nextjs", "subscriptions"], "directory": ""}
66
+ ```
67
+
68
+ `foundations` takes the options above without dashes in front (`nextjs`,
69
+ `auth-db`, `accounts`, `subscriptions`); `directory` is the product's folder in
70
+ the repository (empty for its root). The plan is made against the session's base
71
+ commit and anything already staged in the session, with the same merging and
72
+ refusals as the local helper; a refusal (409) stages nothing. The result lists
73
+ `changes` (`path`, `action`, `size`); review them, then repeat the same request
74
+ with `"apply": true` to stage those files and commit the session with a message.
75
+ Repeating an installation that is already staged or committed returns no changes.
76
+
77
+ `lockfile_current: true` means the resulting `package-lock.json` lists the
78
+ package's dependencies, so the starter Dockerfile's `npm ci` works. `false`
79
+ means it does not, because the app's dependencies or lockfile differ from the
80
+ shipped ones; regenerate the lockfile with `npm install --include=dev` where
81
+ npm can run before deploying, or report that dependency as remaining work.
82
+
83
+ ## After installation
84
+
85
+ Both paths keep an unedited shipped `package-lock.json` (the starter's or a
86
+ previous installation's) in step: when a foundation adds dependencies, they
87
+ install the matching prebuilt lockfile from Design landing page's
88
+ `assets/lockfiles/`. An edited lockfile is left as it is; then refresh it with
89
+ the project's package manager (`npm install --include=dev` for the bundled npm
90
+ starter), as after any other dependency change. The helper
91
+ does not install packages, migrate a database, create provider objects, deploy
92
+ or verify an integration. Read the selected Auth/Payments contract, implement
93
+ the accepted behavior and verify the resulting customer journey before publishing.
@@ -0,0 +1,32 @@
1
+ # Interface implementation and verification
2
+
3
+ Implement accepted content, behavior and visual direction within their stated scope.
4
+ Unspecified routine details can be completed coherently; an omitted choice is not
5
+ a prohibition or permission to alter a product promise. Metadata such as plan IDs
6
+ or destinations belongs in behavior, not visible copy.
7
+
8
+ Verify the rendered interface, not only CSS declarations or screenshots:
9
+
10
+ - Use semantic controls, labels and meaningful errors; keyboard navigation, visible
11
+ focus, dialog focus/return, Esc and accessible close controls must work. Touch
12
+ targets should be comfortably usable (44px is a useful target); never hide a
13
+ necessary control behind a hover-only interaction.
14
+ - Check text contrast: at least 4.5:1 for normal text, 3:1 for large text (24px,
15
+ or about 18.7px bold). Keep body text readable; 16px form text avoids iOS input
16
+ zoom. Verify the fonts actually loaded and that fallback layouts remain usable.
17
+ - Inspect narrow/mobile and desktop layouts, including tables, long content,
18
+ large numbers and dialogs. Avoid clipping and accidental horizontal page scroll;
19
+ use intentional accessible overflow where content genuinely needs it.
20
+ - Respect reduced motion; moving content must not make layout jump or remove the
21
+ usable state. Show progress for pending work and preserve input on recoverable
22
+ failures. Test empty, partial and error states that occur on this path.
23
+ - Exercise every distinct changed action and route, including selected-plan and
24
+ return context. A dead destination, fake submit or misleading disabled feature
25
+ is not completed implementation. Do not fabricate proof, screenshots or testimonials.
26
+
27
+ Use browser inspection and proportionate screenshots to verify the affected path
28
+ at realistic widths (for example 375 and 1440px, plus any failing breakpoint).
29
+ Computed styles and overflow checks complement visual inspection; neither replaces
30
+ the other. Check the project's lint/build and relevant tests. Preserve technical
31
+ evidence with the work, excluding credentials and private customer captures from
32
+ public output. No fixed palette, image count or report-per-section is required.
@@ -0,0 +1,86 @@
1
+ # Private review after handoff
2
+
3
+ Use this when the founder or another authorized reviewer needs to try the
4
+ customer journey or proposed paid result after implementation stops. Keep the
5
+ business, delivery format and implementation choices open. This workflow adds
6
+ no authority to spend, contact customers, accept agreements or expand access.
7
+
8
+ When the caller explicitly authorizes synthetic account testing, use that
9
+ permission within its named products and review window: generate fresh private
10
+ test credentials, create marked test accounts through normal signup, and
11
+ exercise the product's own non-binding test acknowledgments. Keep account and
12
+ terms-version observations in private test evidence and exclude synthetic
13
+ activity from real customer and revenue metrics. This does not authorize
14
+ changes to human accounts, third-party agreements or financial commitments.
15
+ Mandatory tool confirmations still govern credential operations and binding
16
+ agreements, even on an owner-controlled product. Do not relabel real terms or
17
+ switch tools to evade a required confirmation. A missing browser-policy
18
+ capability remains an explicit dependency, not permission supplied by this
19
+ workflow. Preserve actual Auth and consent proof as separate outcomes.
20
+
21
+ ## Establish usable access
22
+
23
+ Before choosing the review method, establish the reviewer's available devices,
24
+ browser sign-ins, supported interactions and essential file capabilities. Account
25
+ for any required human action for credentials, consent or email verification.
26
+ Connected-service read access does not establish a signed-in browser session.
27
+ Use these facts in the existing plan and handoff; no separate intake form is
28
+ needed. Resolve routine choices within existing delegation.
29
+
30
+ Use normal account entry for Auth proof. After that proof, dependent work may
31
+ reuse Auth's private validation identity through the normal session authority.
32
+ A session created for testing does not prove signup, login or consent. A raw
33
+ cookie file is not a usable handoff when the reviewer's tools cannot load it.
34
+ Never introduce a public test-login route, copy an owner's browser cookies or
35
+ weaken authentication to make a review possible.
36
+
37
+ Keep the minimum authorized review access usable for the agreed review window,
38
+ within the caller's time and resource limits. Record its expiry and cleanup
39
+ owner; preserve the founder's ordinary access. When the reviewer can read the
40
+ shared project folder, a private Git-ignored file there, such as one under
41
+ `.local/`, is a supported credential handoff; keep it out of commits, public
42
+ pages and reports. Prefer expiry the product enforces itself, such as review
43
+ accounts or sessions it rejects after the deadline, so cleanup does not depend
44
+ on a process running after you stop. If an essential human step or
45
+ capability remains unavailable, state the precise gap and continue independent
46
+ authorized preparation. Do not report the missing check as passed.
47
+
48
+ ## Leave a repeatable customer journey
49
+
50
+ Use the current serving product and the focused Auth, Payments and Analytics
51
+ workflows. Leave a supported way for the reviewer to repeat the relevant checks
52
+ with their actual access after the builder finishes. A written walkthrough,
53
+ local test output or old payment receipt alone does not provide that ability.
54
+
55
+ Payments owns validate-only requests and receipt verification. Repeat validation
56
+ to obtain fresh short-lived receipts when needed; do not extend receipt validity,
57
+ persist receipts as reusable credentials or create real charges as probes.
58
+ Keep no-charge checkout validation separate from signed lifecycle, durable
59
+ entitlement and delivery verification. Exercise those through supported isolated
60
+ synthetic checks; do not grant production paid access merely to claim a pass.
61
+
62
+ Trace the offer's complete applicable journey from entry and offer selection
63
+ through authenticated continuation, payment handling, access enforcement, the
64
+ actual promised result, saved-work recovery, support and measurement. Reuse
65
+ existing authoritative state rather than building parallel test logic. Check
66
+ account boundaries and duplicate processing where relevant. Label synthetic
67
+ identities and events and exclude them from customer and revenue claims.
68
+
69
+ For a file-based result, verify that the intended recipient can obtain, open,
70
+ use and recover the actual deliverable using the agreed tools. For a hosted
71
+ result, verify its corresponding return and recovery behavior. State narrower
72
+ coverage honestly; opening a preview is not proof of the full paid result.
73
+ Keep tests proportional to the actual offer rather than requiring every
74
+ possible account, payment or file feature.
75
+
76
+ ## Carry the resource basis and remaining gaps
77
+
78
+ Use the accepted delivery, support and recovery obligations and the task's resource
79
+ basis. Read Wallet for current balances/rates when a resource check is needed.
80
+ Return a missing commercial decision to its owner instead of adapting the offer
81
+ inside technical review. Keep resource limits separate from unfinished authorized work.
82
+
83
+ Return the product location, repeatable review steps, necessary private access,
84
+ access lifetime, remaining human actions and verified/unverified outcomes in the
85
+ existing handoff. Keep secrets out of public plans and evidence. Completion of
86
+ this preparation does not authorize launch or establish demand or revenue.
@@ -0,0 +1,296 @@
1
+ #!/usr/bin/env python3
2
+ """Preview or install shipped product foundations without network operations."""
3
+ import argparse
4
+ from dataclasses import dataclass
5
+ import json
6
+ from pathlib import Path
7
+ import sys
8
+
9
+
10
+ class Conflict(ValueError):
11
+ pass
12
+
13
+
14
+ @dataclass
15
+ class Edit:
16
+ path: Path
17
+ before: bytes | None
18
+ after: bytes
19
+
20
+
21
+ def skill(root: Path, name: str) -> Path:
22
+ """Work in both a source checkout and the complete installed catalog."""
23
+ for candidate in (root / ("egbe-os-" + name), root / name):
24
+ if (candidate / "SKILL.md").is_file():
25
+ return candidate
26
+ raise Conflict(f"Missing skill bundle: egbe-os-{name}; refresh the complete catalog")
27
+
28
+
29
+ def check_path(root: Path, path: Path):
30
+ for candidate in (path, *path.parents):
31
+ if candidate.is_symlink():
32
+ raise Conflict(f"Symlink destination: {candidate}")
33
+ if candidate == root:
34
+ break
35
+ if path.exists() and not path.is_file():
36
+ raise Conflict(f"Expected a regular file: {path}")
37
+ for parent in path.parents:
38
+ if parent == root.parent:
39
+ break
40
+ if parent.exists() and not parent.is_dir():
41
+ raise Conflict(f"Expected a directory: {parent}")
42
+
43
+
44
+ def tree(source: Path):
45
+ if not source.is_dir():
46
+ raise Conflict(f"Missing shipped foundation: {source}")
47
+ for path in sorted(source.rglob("*")):
48
+ relative = path.relative_to(source)
49
+ if any(part in {"node_modules", ".next", "__pycache__"} for part in relative.parts):
50
+ continue
51
+ if path.is_symlink():
52
+ raise Conflict(f"Symlink in foundation: {path}")
53
+ if path.is_file() and path.name not in {"package.fragment.json", "AGENTS.append.md"}:
54
+ yield relative, path.read_bytes()
55
+
56
+
57
+ def append_marked(existing: str, marker: str, text: str, *, ignore_file=False) -> str:
58
+ start, end = (f"# {marker}", f"# /{marker}") if ignore_file else (f"<!-- {marker} -->", f"<!-- /{marker} -->")
59
+ block = start + "\n" + text.rstrip() + "\n" + end
60
+ if start in existing or end in existing:
61
+ if existing.count(start) != 1 or existing.count(end) != 1 or block not in existing:
62
+ raise Conflict(f"Existing foundation guidance differs: {marker}; review it manually")
63
+ return existing
64
+ return existing.rstrip() + ("\n\n" if existing.strip() else "") + block + "\n"
65
+
66
+
67
+ # The command-line options by name, for callers that select foundations without flags.
68
+ FOUNDATIONS = {"nextjs": "base", "auth-db": "auth_db", "accounts": "accounts", "subscriptions": "subscriptions"}
69
+ MERGED = {Path("package.json"), Path("AGENTS.md"), Path(".gitignore")}
70
+
71
+
72
+ LOCKFILE = Path("package-lock.json")
73
+ LOCKED_SECTIONS = ("dependencies", "devDependencies")
74
+
75
+
76
+ def shipped_lockfiles(skills):
77
+ """The starter's lockfile and the prebuilt ones for its foundation combinations."""
78
+ assets = skill(skills, "design-landing-page") / "assets"
79
+ paths = [assets / "scaffold/package-lock.json", *sorted((assets / "lockfiles").glob("*/package-lock.json"))]
80
+ return [path.read_bytes() for path in paths if path.is_file()]
81
+
82
+
83
+ def lock_lists(lock: bytes, package: dict) -> bool:
84
+ """Whether a lockfile's root lists exactly the package's dependencies, as `npm ci` requires."""
85
+ try:
86
+ root = json.loads(lock).get("packages", {}).get("", {})
87
+ except (ValueError, AttributeError):
88
+ return False
89
+ return all((package.get(section) or {}) == (root.get(section) or {}) for section in LOCKED_SECTIONS)
90
+
91
+
92
+ def _lock_shape(lock: bytes):
93
+ """A lockfile without the root package's own name and version."""
94
+ try:
95
+ data = json.loads(lock)
96
+ root = dict(data.get("packages", {}).get("", {}))
97
+ except (ValueError, AttributeError):
98
+ return None
99
+ for field in ("name", "version"):
100
+ data.pop(field, None)
101
+ root.pop(field, None)
102
+ return {**data, "packages": {**data.get("packages", {}), "": root}}
103
+
104
+
105
+ def is_shipped_lockfile(lock: bytes, skills) -> bool:
106
+ """An unedited shipped lockfile, whatever the root package's name and version."""
107
+ return _lock_shape(lock) in [_lock_shape(shipped) for shipped in shipped_lockfiles(skills)]
108
+
109
+
110
+ def prebuilt_lockfile(package: dict, skills):
111
+ """The shipped lockfile listing the package's dependencies, carrying its name and version."""
112
+ shipped = shipped_lockfiles(skills)
113
+ for lock in shipped:
114
+ if lock_lists(lock, package):
115
+ data = json.loads(lock)
116
+ if all(data.get(field) == package.get(field) for field in ("name", "version")):
117
+ return lock
118
+ for record in (data, data["packages"][""]):
119
+ for field in ("name", "version"):
120
+ if field in package:
121
+ record[field] = package[field]
122
+ else:
123
+ record.pop(field, None)
124
+ return (json.dumps(data, indent=2) + "\n").encode()
125
+ return None
126
+
127
+
128
+ def compose(read, *, base=False, auth_db=False, accounts=False, subscriptions=False, skills=None):
129
+ """Plan the selected foundations against any destination.
130
+
131
+ `read(relative)` returns the destination's bytes at a relative path, or None
132
+ when absent, and raises Conflict for a path that cannot hold a file. Returns
133
+ `(relative, before, after)` for every file the installation changes.
134
+ """
135
+ skills = skills or Path(__file__).resolve().parents[2]
136
+ if not (base or auth_db or accounts or subscriptions):
137
+ raise Conflict("Select --nextjs, --auth-db, --accounts or --subscriptions explicitly")
138
+ files = {}
139
+
140
+ def add(source, prefix=Path()):
141
+ for relative, content in tree(source):
142
+ relative = prefix / relative
143
+ if relative in files and files[relative] != content:
144
+ raise Conflict(f"Overlapping foundation files: {relative}")
145
+ files[relative] = content
146
+
147
+ if base:
148
+ add(skill(skills, "design-landing-page") / "assets/scaffold")
149
+ existing_package = read(Path("package.json"))
150
+ package_bytes = existing_package if existing_package is not None else files.get(Path("package.json"))
151
+ if package_bytes is None:
152
+ raise Conflict("A product package.json is required; use --nextjs only for a new app")
153
+ package = json.loads(package_bytes)
154
+ if not isinstance(package, dict):
155
+ raise Conflict("package.json must contain an object")
156
+ agents = (read(Path("AGENTS.md")) or b"").decode()
157
+ if base:
158
+ starter_guidance = files[Path("AGENTS.md")].decode()
159
+ agents = append_marked(agents, "EGBE:APPLICATION-SCAFFOLD", starter_guidance)
160
+ existing_ignores = (read(Path(".gitignore")) or b"").decode()
161
+ files[Path(".gitignore")] = append_marked(
162
+ existing_ignores, "EGBE:APPLICATION-SCAFFOLD", files[Path(".gitignore")].decode(), ignore_file=True,
163
+ ).encode()
164
+
165
+ foundations = []
166
+ if auth_db or accounts or subscriptions:
167
+ auth = skill(skills, "product-auth")
168
+ add(auth / "assets/db", Path("db"))
169
+ foundations.append(auth / "assets/scaffolds/product-auth-database")
170
+ if accounts or subscriptions:
171
+ foundations.append(auth / "assets/scaffolds/product-nextjs-postgres")
172
+ if subscriptions:
173
+ foundations.append(skill(skills, "payments") / "assets/scaffolds/billing-nextjs-subscription")
174
+ original_package = json.loads(package_bytes)
175
+ for foundation in foundations:
176
+ fragment = json.loads((foundation / "package.fragment.json").read_text())
177
+ scripts = package.setdefault("scripts", {})
178
+ if not isinstance(scripts, dict):
179
+ raise Conflict("package.json scripts must contain an object")
180
+ for name, expected in fragment.get("expectedScripts", {}).items():
181
+ if scripts.get(name) not in (expected, fragment.get("scripts", {}).get(name, expected)):
182
+ raise Conflict(f"Incompatible script: {name}; expected {expected!r}")
183
+ for section in ("dependencies", "devDependencies", "scripts"):
184
+ current = package.setdefault(section, {})
185
+ if not isinstance(current, dict):
186
+ raise Conflict(f"package.json {section} must contain an object")
187
+ for name, value in fragment.get(section, {}).items():
188
+ if name in current and current[name] != value:
189
+ expected = fragment.get("expectedScripts", {}).get(name)
190
+ if section != "scripts" or current[name] != expected:
191
+ raise Conflict(f"Conflicting {section} entry: {name}")
192
+ current[name] = value
193
+ add(foundation)
194
+ agents = append_marked(agents, fragment["agentsMarker"], (foundation / "AGENTS.append.md").read_text())
195
+ if base and existing_package is not None:
196
+ # Do not transplant a starter package into an existing application.
197
+ # Repeated installation is allowed only when its merged package agrees.
198
+ starter = json.loads(files[Path("package.json")])
199
+ if any(package.get(key) != value for key, value in starter.items() if key not in {"scripts", "dependencies", "devDependencies"}):
200
+ raise Conflict("Existing app package differs; omit --nextjs and integrate only the selected foundation")
201
+ for section in ("scripts", "dependencies", "devDependencies"):
202
+ for name, value in starter.get(section, {}).items():
203
+ allowed = {value}
204
+ for foundation in foundations:
205
+ fragment = json.loads((foundation / "package.fragment.json").read_text())
206
+ if name in fragment.get(section, {}):
207
+ allowed.add(fragment[section][name])
208
+ if package.get(section, {}).get(name) not in allowed:
209
+ raise Conflict(f"Existing app differs from starter: {section}.{name}")
210
+ if package == original_package:
211
+ files[Path("package.json")] = package_bytes
212
+ else:
213
+ files[Path("package.json")] = (json.dumps(package, indent=2) + "\n").encode()
214
+ if base or foundations:
215
+ files[Path("AGENTS.md")] = agents.encode()
216
+ # Keep `npm ci` working: an unedited shipped lockfile that no longer lists the
217
+ # package's dependencies is replaced by the prebuilt one for this combination.
218
+ replaceable = set(MERGED)
219
+ lock = files.get(LOCKFILE)
220
+ lock = lock if lock is not None else read(LOCKFILE)
221
+ final_package = json.loads(files[Path("package.json")])
222
+ if lock is not None and not lock_lists(lock, final_package):
223
+ existing_lock = read(LOCKFILE)
224
+ prebuilt = prebuilt_lockfile(final_package, skills) if is_shipped_lockfile(lock, skills) else None
225
+ if prebuilt is not None and (existing_lock is None or is_shipped_lockfile(existing_lock, skills)):
226
+ files[LOCKFILE] = prebuilt
227
+ replaceable.add(LOCKFILE)
228
+ changes = []
229
+ for relative, after in sorted(files.items()):
230
+ before = read(relative)
231
+ if before == after:
232
+ continue
233
+ if before is not None and relative not in replaceable:
234
+ raise Conflict(f"Existing file differs: {relative}; no files were written")
235
+ changes.append((relative, before, after))
236
+ return changes
237
+
238
+
239
+ def plan(target: Path, *, base=False, auth_db=False, accounts=False, subscriptions=False, skills=None):
240
+ if target.is_symlink():
241
+ raise Conflict(f"Symlink destination: {target}")
242
+ root = target.resolve()
243
+ if root.exists() and not root.is_dir():
244
+ raise Conflict(f"Expected a product directory: {root}")
245
+
246
+ def read(relative):
247
+ path = root / relative
248
+ check_path(root, path)
249
+ return path.read_bytes() if path.exists() else None
250
+
251
+ changes = compose(read, base=base, auth_db=auth_db, accounts=accounts, subscriptions=subscriptions,
252
+ skills=skills)
253
+ return root, [Edit(root / relative, before, after) for relative, before, after in changes]
254
+
255
+
256
+ def apply(root, edits):
257
+ # Recheck every planned write before changing anything.
258
+ for edit in edits:
259
+ check_path(root, edit.path)
260
+ before = edit.path.read_bytes() if edit.path.exists() else None
261
+ if before != edit.before:
262
+ raise Conflict(f"Destination changed since planning: {edit.path}")
263
+ # Ownership guidance describes code already copied, so write it last.
264
+ for edit in sorted(edits, key=lambda item: item.path.name == "AGENTS.md"):
265
+ edit.path.parent.mkdir(parents=True, exist_ok=True)
266
+ edit.path.write_bytes(edit.after)
267
+
268
+
269
+ def main():
270
+ parser = argparse.ArgumentParser(description=__doc__)
271
+ parser.add_argument("command", choices=("list", "plan", "apply"))
272
+ parser.add_argument("--target", type=Path, default=Path.cwd())
273
+ parser.add_argument("--nextjs", action="store_true", help="Copy the blank Next.js starter; for new applications only")
274
+ parser.add_argument("--auth-db", action="store_true", help="Add shared Node/Postgres auth database assets without Next.js server helpers")
275
+ parser.add_argument("--accounts", action="store_true", help="Add the Postgres account/session foundation")
276
+ parser.add_argument("--subscriptions", action="store_true", help="Add subscription billing and its required account foundation; not one-time purchases")
277
+ args = parser.parse_args()
278
+ if args.command == "list":
279
+ print("--nextjs: blank Next.js application; use only when this stack fits")
280
+ print("--auth-db: shared Node/Postgres auth schema, migrations and private validation-session helper; preserves framework/start command")
281
+ print("--accounts: Postgres users, identities, sessions and migrations; account-entry UI still needs implementation")
282
+ print("--subscriptions: subscription lifecycle, checkout, billing UI and account foundation; not a one-time purchase engine")
283
+ return
284
+ try:
285
+ root, edits = plan(args.target, base=args.nextjs, auth_db=args.auth_db, accounts=args.accounts, subscriptions=args.subscriptions)
286
+ if args.command == "apply":
287
+ apply(root, edits)
288
+ print(json.dumps({"target": str(root), "applied": args.command == "apply", "changes": [str(e.path.relative_to(root)) for e in edits]}, indent=2))
289
+ if edits:
290
+ print("Next: install dependencies with your package manager (refresh the lockfile only if it was edited or npm ci fails), implement accepted behavior, configure real bindings and verify before publishing.", file=sys.stderr)
291
+ except (Conflict, OSError, ValueError) as exc:
292
+ parser.exit(1, f"Scaffold installation stopped: {exc}\n")
293
+
294
+
295
+ if __name__ == "__main__":
296
+ main()
@@ -0,0 +1,118 @@
1
+ ---
2
+ name: egbe-os-product-demo-video
3
+ description: Record a real product walkthrough and produce a video and poster.
4
+ metadata:
5
+ egbe-when: "Offer when a homepage or pitch would benefit from showing the product in action."
6
+ egbe-visible: "true"
7
+ egbe-title: "Product demo video"
8
+ egbe-description: "Show your product in action with a clear walkthrough video and a preview image."
9
+ egbe-category: "Product & design"
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
+ # Record a product demo
57
+
58
+ Keep the recording context, source captures, final media and checks together in
59
+ `egbe-docs/marketing/packs/<video-id>/`; version source captures in `work/` and use
60
+ the existing plan or asset notes rather than creating a separate document per step.
61
+ Keep credential-bearing captures out of Git and public exports.
62
+
63
+ Show the real path from customer intent to a useful result. Deliver a playable
64
+ video and poster; embedding or publishing them is a separate action unless
65
+ included in the request.
66
+
67
+ ## Through the Egbe connector
68
+
69
+ Egbe does not record video. Through the connector you can plan the walkthrough,
70
+ confirm the serving revision with `egbe-os-deploy` and keep the notes in Egbe's
71
+ artifact store. Recording needs browser and recording tools in your own
72
+ environment, or a set-up project workspace (in a persistent project workspace
73
+ not set up yet, call `egbe_local_setup`). Without either, tell the founder;
74
+ screenshots or a description are not a recording.
75
+
76
+ ## Prepare the walkthrough
77
+
78
+ Read the requested or already agreed audience, destination and behavior, then
79
+ inspect the actual product. Resolve consequential gaps without reopening accepted
80
+ choices. Capture the shortest coherent journey that demonstrates the requested
81
+ result. Use a local or staging app when appropriate; for an existing
82
+ deployment, confirm its serving revision through `egbe-os-deploy` rather than guessing
83
+ a hostname.
84
+
85
+ Use synthetic, non-sensitive content and a test identity only if the journey
86
+ needs authentication. Reuse an authorized identity when possible. A public
87
+ tool needs neither signup nor a mailbox. Do not generate paid transactions,
88
+ send outreach or alter real customer records just to make a demo. Prepare any
89
+ necessary test state within the approved task scope.
90
+
91
+ ## Capture real behavior
92
+
93
+ Use the harness's available browser/recording tools. If they cannot record,
94
+ follow [Recording options](references/recording.md). Identify the precise
95
+ missing dependency or permission if recording remains unavailable; screenshots
96
+ or AI-generated footage are not a completed recording.
97
+
98
+ Start from a ready page, perform meaningful actions and wait for visible
99
+ outcomes instead of relying only on fixed sleeps. Keep text legible at the
100
+ target size and let viewers see the result. If the app fails, record the defect
101
+ as a blocker; do not conceal it with a mock success screen. Cut idle/setup time,
102
+ not steps essential to understanding what the product really does.
103
+
104
+ ## Verify and deliver
105
+
106
+ Inspect playback from start to finish and the poster at the intended display
107
+ size: content is readable, the promised result is visible, no private data is
108
+ exposed, and no black/error frames or accidental dialogs remain. Confirm file
109
+ duration, codec and dimensions, not just existence. Keep source revision/URL
110
+ and walkthrough steps with the project's existing asset records so another
111
+ session can reproduce the capture.
112
+
113
+ Store the video and poster in the requested destination; for embedding, use
114
+ the product's existing public asset convention. Check the actual browser
115
+ player, fallback poster and mobile layout. Provide controls or a pause option
116
+ for looping content; respect reduced motion and add captions when speech
117
+ carries meaning. Report local file paths, verified outcome and any limitations.
118
+ Publish only when authorized, using `egbe-os-git` and `egbe-os-deploy` for an Egbe-hosted app.
@@ -0,0 +1,32 @@
1
+ # Recording options
2
+
3
+ Prefer a recording feature already available in the browser tool. Otherwise,
4
+ use an existing project-local Playwright installation or an approved isolated
5
+ tool environment. Do not change the product's dependencies or global browser
6
+ configuration just to capture a video.
7
+
8
+ With Playwright, create an isolated browser context with matching `viewport`
9
+ and `recordVideo.size` dimensions; the default recording may shrink the page
10
+ and make text unreadable. Inspect the live page and use its actual roles/selectors for
11
+ the planned actions. Save the `page.video()` handle, then **close the context**
12
+ before calling `video.saveAs(...)`: closing finalizes the WebM. Keep auth state
13
+ and credentials out of the saved assets. If browser binaries or recording
14
+ support are missing, report the dependency and use the harness's normal
15
+ installation/approval flow.
16
+
17
+ When FFmpeg is available, convert and create a poster from a useful frame:
18
+
19
+ ```bash
20
+ ffmpeg -n -i capture.webm -c:v libx264 -pix_fmt yuv420p \
21
+ -movflags +faststart -an demo.mp4
22
+ ffmpeg -n -ss 2 -i demo.mp4 -frames:v 1 demo-poster.jpg
23
+ ffprobe -v error -show_entries format=duration,size:stream=codec_name,width,height \
24
+ -of json demo.mp4
25
+ ```
26
+
27
+ Choose the poster timestamp from the actual recording; the example's two
28
+ seconds is not a product requirement. Preserve audio when it is part of the
29
+ requested story (remove `-an` and encode compatible audio). Use unique output
30
+ paths or explicitly approve replacing old assets; `-n` avoids overwriting them.
31
+ Compression, cropping and speed changes must preserve readable content and
32
+ must not misrepresent actual product latency. Validate playback after editing.