@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,212 @@
1
+ # Build Core Product Authentication
2
+
3
+ ## 1. Inspect Before Editing
4
+
5
+ Work in the existing product repository. Identify:
6
+
7
+ - deployed slug and live host;
8
+ - accepted access requirements and any applicable PRD, design or page material;
9
+ - framework, server runtime, data access, migrations, and shared layouts;
10
+ - the approved value path, its access prerequisites and any public preview;
11
+ - existing signup/login/session code;
12
+ - the first useful protected route that exists now.
13
+
14
+ Reuse established libraries and component patterns when they meet the contracts.
15
+ Do not create a second app, auth store, header, or routing system.
16
+
17
+ The accepted value path and public-preview presentation are inputs to Auth,
18
+ not decisions to reinvent here. Preserve
19
+ existing work and its continuation across account entry; do not invent a preview.
20
+ Limit changes to authentication and its minimal protected continuation; do not
21
+ implement monitoring, analytics, or Billing behavior.
22
+
23
+ ## 2. Confirm the selected account-entry paths and scope
24
+
25
+ Use the methods selected in the requirements or current task, preserving suitable
26
+ working authentication. A repair stays within the affected method and its shared
27
+ dependencies; it does not require a second login method. If a material choice is
28
+ missing, propose an option with its reason and resolve it before dependent work.
29
+
30
+ For Google, follow `references/workflows/google.md`: the product backend uses
31
+ the live Egbe OS auth capability and normal product-scoped OS credential, never
32
+ its own Google credentials. For email sign-in links, follow
33
+ `references/workflows/passwordless-email.md`. For email/password, use the shared
34
+ credential contract and the same opaque server-side sessions. Do not substitute
35
+ waitlist capture, localStorage, hardcoded users or an in-memory demo session for
36
+ authentication, or implement an unselected login method for verification.
37
+
38
+ For a new full implementation, resolve how the user returns to the account and
39
+ recovers access within the selected authorization and requirements. A missing
40
+ safe return/recovery path is an unresolved gap, not a reason to silently add
41
+ email/password or email reset. Use `account-recovery.md` only when password
42
+ recovery or separate email verification is part of that solution.
43
+
44
+ ## 3. Prepare Durable State
45
+
46
+ Read the live Egbe OS `egbe-os-deploy` skill. Provision or reuse attached Postgres and
47
+ use the injected `DATABASE_URL`.
48
+
49
+ For a compatible Next.js/custom-Postgres application without an established auth
50
+ implementation, [Product Build's foundations](../../../egbe-os-product-build/references/foundations.md) expose the shipped
51
+ account/session server helpers and canonical migrations through the optional
52
+ local scaffold helper's `--accounts` selection. Preview before applying. It does
53
+ not choose or implement account-entry methods; continue with this workflow.
54
+
55
+ **Start from the canonical auth schema — do not re-derive users, sessions, or
56
+ provider bindings by hand.** This skill bundle ships it at `assets/db/`
57
+ (`migrations/0001_auth.sql`, `migrations/0002_auth_identities.sql`, and
58
+ `migrate.mjs`; see `assets/db/README.md`). It provides the universal user and
59
+ session state plus the `(provider, subject)` external-identity authority. Apply
60
+ it as the starting point:
61
+
62
+ - **Default custom Node/Postgres path** (the common case — this product talks to
63
+ Postgres with `pg` and raw SQL): the same optional helper's `--auth-db`
64
+ selection previews/installs these database assets and their package commands,
65
+ preserving the framework and start command. For manual integration, copy
66
+ `assets/db/` into the product repo as `db/` and add
67
+ `"db:migrate": "node db/migrate.mjs"` to `package.json`. Run it against
68
+ `DATABASE_URL` during a controlled build/deploy step. Then add only the
69
+ product-specific extras below as a *new* migration after `0002`; never edit
70
+ the canonical migrations. Use the baseline's SHA-256 token hash in the
71
+ product's normal request-time session resolver. A
72
+ new product defaults to the `egbe_session` cookie. When an existing working
73
+ resolver uses the same authoritative session state and hash contract under
74
+ another valid cookie name, preserve it and pass that name to the bundled
75
+ private validation helper with `--cookie-name`; never rename a working
76
+ session solely to fit the fixture default.
77
+ - **ORM / auth-library path** (Prisma, Drizzle, a batteries-included auth lib
78
+ with its own migration ledger): do **not** apply the raw SQL — it would drift
79
+ against the ORM's migration table. Instead reproduce the same users,
80
+ sessions, and unique provider-subject binding from `assets/db/README.md`
81
+ using that library's migration mechanism, then add only the extras below.
82
+
83
+ In both cases, add only any minimal product-owned link needed to preserve a
84
+ pre-signup result. Reuse the canonical external identity contract rather than
85
+ creating another provider-binding table.
86
+
87
+ For email/password, store a maintained password hash. For passwordless email,
88
+ leave `password_hash` null and add the minimal hashed one-time-token state as a
89
+ later migration. Never generate a fake password or placeholder hash merely to
90
+ fill the nullable column.
91
+
92
+ Use the product's existing migration/data layer. Run migrations at a controlled
93
+ build/deploy step, never a public initialization route, and do not commit
94
+ connection strings.
95
+
96
+ ## 4. Implement The Server Contract
97
+
98
+ Implement account entry, session lookup, logout, and protected-route checks as
99
+ one coherent server-side system. Follow
100
+ [../security/session-and-credentials.md](../security/session-and-credentials.md).
101
+
102
+ Each account-entry path must converge on the same durable user and session
103
+ authority. When Google is selected, it creates a fresh product session only
104
+ after the one-time Egbe identity exchange and transactional provider link succeed.
105
+ Logout must revoke the server session and clear the browser cookie. Protected
106
+ routes must authorize from server state on every request.
107
+
108
+ Choose the server transport before building the forms and keep it consistent.
109
+ For a JavaScript-enhanced UI, expose the actual same-origin signup, login, and
110
+ logout endpoints through the live auth interface attributes. This is a stable
111
+ machine interface to the production auth path, not a second implementation.
112
+
113
+ Keep any selected email entry deliberately narrow: email plus password for
114
+ the password profile, or email alone for passwordless email. Google may supply
115
+ verified name/picture but must not force new signup fields. Do not collect
116
+ company, username, password confirmation, or other profile data in this
117
+ workflow. Hidden CSRF, attribution, and safe continuation fields are allowed.
118
+
119
+ Keep return destinations same-origin and relative. Preserve a valid intended
120
+ destination through signup/login without putting identity or credentials in the
121
+ URL.
122
+
123
+ ## 5. Build The Product Experience
124
+
125
+ Follow [../ux/auth-experience.md](../ux/auth-experience.md) and
126
+ [../contracts/live-auth-interface.md](../contracts/live-auth-interface.md).
127
+
128
+ Provide canonical `/signup` and `/login` entry routes for new products. Add one
129
+ real protected continuation route. Preserve an existing useful route when one
130
+ already exists. If the real destination is not implemented yet, a minimal
131
+ protected verification surface can prove the auth mechanism, but is not a
132
+ completed product journey. Do not introduce a dashboard or placeholder feature
133
+ controls merely to satisfy a stage; connect the accepted destination when ready.
134
+
135
+ Make the shared landing navigation auth-aware. Signed-out users see login and
136
+ the normal product CTA. Signed-in users see identity, a valid continue action,
137
+ and logout in a user menu. Preserve the existing visual system and mobile nav.
138
+
139
+ If the current product already lets a visitor reach first value before signup,
140
+ associate that exact result with the account and continue it after signup. Do
141
+ not erase or regenerate it, and do not create the first-value flow in this
142
+ workflow.
143
+
144
+ When the real pre-signup result exists, verify that exact result survives
145
+ account entry. Otherwise verify the safe continuation mechanism and record
146
+ the missing integration check. Exercise the real producer and Auth together
147
+ once both exist; a placeholder result cannot prove this boundary.
148
+
149
+ ## 6. Deploy And Verify
150
+
151
+ When release is authorized, follow Egbe Git and Deploy for the committed
152
+ revision and verify on the returned live host. For local-only work, run the
153
+ applicable local checks and leave live account-entry proof explicitly pending.
154
+ For a full implementation, verify every selected method; for a bounded repair,
155
+ verify the affected method and shared dependencies touched by the change:
156
+
157
+ 1. signed-out entry exposes the selected account-entry controls;
158
+ 2. fresh account entry and protected continuation;
159
+ 3. session persistence after reload and signed-in navigation;
160
+ 4. logout and denial of the protected route;
161
+ 5. repeat login to the same local account and applicable identity linking;
162
+ 6. durable return access, the selected recovery behavior and safe continuation
163
+ restoration, including the exact Product result only when it already exists
164
+ within the implementation being verified.
165
+
166
+ When Google is in scope, its workflow includes verified-email linking to existing
167
+ accounts, including imported accounts without another login method. Email-link
168
+ verification includes receiving and using the actual live message.
169
+
170
+ Before deploying, confirm that each JavaScript-only auth control identifies its
171
+ real action and encoding as defined by the live auth interface contract. Native
172
+ POST forms need no extra action metadata.
173
+
174
+ Exercise rendered protected mutations through the browser with the deployed
175
+ headers and session cookies, including logout and applicable closed or invalid
176
+ states. Keep financial and communication checks non-charging and non-sending.
177
+ Endpoint probes with manually supplied headers can support security checks but
178
+ do not prove that the rendered form or control works. Preserve server-side
179
+ request protection when correcting a browser failure.
180
+
181
+ Use one private verification identity for this sequence and reuse it when a
182
+ check is repeated. Do not manufacture another account for every retry, and do
183
+ not write its password, access link, or token to the product repository or
184
+ shared reports. Reusing an identity means exercising current account-entry,
185
+ session, protected-route, and logout behavior; a saved prior success is not
186
+ current evidence. If a failed first entry is proven to have created the account
187
+ before failing later in the flow, a verifier may rotate to one strictly bounded
188
+ recovery identity instead of creating a new account on every retry.
189
+
190
+ Treat a redirect without authenticated state as failure. An unavailable agreed
191
+ method leaves a full implementation incomplete even when another method works;
192
+ do not silently remove it from the agreed scope.
193
+
194
+ Only after this real Auth proof succeeds, prepare one reusable private
195
+ validation identity when later Product or Billing work needs it. On the default
196
+ custom Node/Postgres path, run the bundled
197
+ `db/create-validation-session.mjs` as documented in `assets/db/README.md` and
198
+ load its cookie into an isolated browser session. On an ORM or maintained auth
199
+ library path, use its equivalent server-side user/session creation primitive
200
+ with the same properties: a unique validation user, short-lived revocable
201
+ session, raw credential kept only in private mode-`0600` state, and no public
202
+ route or bypass. This setup lets dependent sections exercise authenticated
203
+ behavior without replaying account entry. It never replaces the Auth proof
204
+ above.
205
+
206
+ When an authorized reviewer will continue after this section finishes, preserve
207
+ the minimum private validation access through the agreed review window and
208
+ record expiry/cleanup in the existing handoff. Confirm that the recipient's
209
+ supported tools can actually use the access; a private token file alone is not
210
+ interactive browser access. Keep ordinary account-entry proof and any pending
211
+ credential or consent action explicit. Do not broaden access or prolong a
212
+ session beyond the caller's authorized window.
@@ -0,0 +1,34 @@
1
+ # Google account entry
2
+
3
+ Use this workflow when Google is a selected account-entry method or its existing
4
+ implementation needs repair. Egbe OS owns OAuth; this product owns the local
5
+ account and session.
6
+
7
+ First discover and read the live capability contract:
8
+
9
+ ```bash
10
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/auth/google/skill" -s
11
+ ```
12
+
13
+ Implement the server-side intent and exchange flow exactly from that contract.
14
+ Do not copy provider endpoints into browser code, invent another OAuth client,
15
+ or put `OS_API_KEY` in a client bundle. Use the real deployed slug and a safe
16
+ relative product callback/continuation.
17
+
18
+ Use a durable external-identity mapping whose authority is `(provider,
19
+ subject)`. `email` is verified linking information, not the provider key. When
20
+ the verified Google email already belongs to a local user, link that existing
21
+ account transactionally and preserve its password or passwordless state. When
22
+ it does not, create the user and link once. Create the ordinary product session
23
+ only after the one-time Egbe exchange succeeds.
24
+
25
+ Expose Google on the agreed account-entry surfaces with the selected hierarchy.
26
+ It may be the only method; do not add email login to implement or verify it.
27
+
28
+ Completion requires a live Google signup, repeat Google login to the same local
29
+ account, verified-email linking to an existing local account, session persistence,
30
+ continuation, logout, and protected denial after logout. Check linking with an
31
+ existing or controlled imported account even in a Google-only product, preserving
32
+ its credentials and ownership; this does not require exposing another login
33
+ method. For a bounded repair, exercise the affected Google behavior and shared
34
+ dependencies rather than expanding the implementation.
@@ -0,0 +1,65 @@
1
+ # Passwordless Email Authentication
2
+
3
+ Use this profile only when authoritative product requirements select email
4
+ sign-in links. It extends the common account, session, protected-route,
5
+ navigation, and continuation workflow in `build-auth.md`; it does not add a
6
+ second auth system.
7
+
8
+ ## Account Entry
9
+
10
+ - Use the account-entry routes from the
11
+ [live auth interface](../contracts/live-auth-interface.md), with a single
12
+ visible email field. Signup and login may share one server implementation
13
+ while preserving the appropriate product copy and continuation.
14
+ - Normalize email consistently, apply bounded rate limiting by identity and
15
+ request source, and return responses that do not reveal account existence.
16
+ - A mail-provider failure must not be presented as a sent message. Keep the
17
+ response account-neutral while giving an honest retry state.
18
+ - Create the authenticated session only after the emailed credential succeeds,
19
+ never when the link is merely requested or accepted by the mail provider.
20
+
21
+ ## One-Time Credential
22
+
23
+ - Generate a cryptographically random, purpose-bound, short-lived credential;
24
+ store only its hash with user, expiry, and consumption state.
25
+ - Put the raw credential only in the intended HTTPS email link. Never log it,
26
+ persist it in browser storage, expose it to analytics, or retain it in the
27
+ browser URL after exchange. Send a no-referrer policy on the exchange response.
28
+ - Consume it atomically: exactly one request may transition an unexpired,
29
+ unused credential to used and receive the associated account. A separate
30
+ read followed by an unconditional update is not single-use enforcement.
31
+ - Choose one resend policy and make it truthful. Either keep a bounded set of
32
+ unexpired links usable or invalidate older links and clearly tell the user
33
+ that only the newest message works. Never leave an apparently current email
34
+ failing without an explanation and a new-link path.
35
+ - On successful exchange, create a fresh server-side session and redirect to a
36
+ validated relative continuation. Do not revoke unrelated active sessions
37
+ unless the product has an explicit security reason to do so.
38
+
39
+ ## Mail Delivery
40
+
41
+ Read the live Egbe OS `egbe-os-mail` skill and use its supported send path. Distinguish:
42
+
43
+ 1. the product accepted the request;
44
+ 2. the mail service accepted the message;
45
+ 3. the message reached the verification inbox;
46
+ 4. the live link established the intended authenticated session.
47
+
48
+ Only the fourth result completes this profile. A successful request endpoint or
49
+ mail API response alone is insufficient. Preserve a clear retry path for
50
+ immediate provider failure, delayed or missing delivery, expired links, used
51
+ links, and an invalid link.
52
+
53
+ ## Live Verification
54
+
55
+ Use one private verification inbox and the deployed HTTPS product:
56
+
57
+ 1. request a link and confirm the truthful pending state;
58
+ 2. receive the actual newest message and open its live link;
59
+ 3. confirm the protected continuation, server-verified navigation, and session
60
+ persistence after refresh;
61
+ 4. confirm reuse and expiry fail safely with a new-link path;
62
+ 5. request another link according to the stated resend policy and use it;
63
+ 6. sign out, confirm protected-route denial, and sign in again through email.
64
+
65
+ Do not claim success if inbox access or live-link verification is unavailable.
@@ -0,0 +1,111 @@
1
+ ---
2
+ name: egbe-os-product-build
3
+ description: Plan and implement product changes, integrations and repairs with direct verification of the accepted behavior.
4
+ metadata:
5
+ egbe-when: "Use when product requirements need an engineering plan, implementation or repair."
6
+ egbe-visible: "true"
7
+ egbe-title: "Product development"
8
+ egbe-description: "Build and improve your product using Egbe infrastructure, with working integrations and verified customer journeys."
9
+ egbe-category: "Development & hosting"
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
+ # Product build
68
+
69
+ Implement the requested behavior in the product's repository. Read the accepted
70
+ requirements or bounded task, relevant design, existing code and prior evidence.
71
+ Preserve recorded choices and the assigned scope; a missing product decision is
72
+ not permission to invent one. A narrow repair needs no complete PRD or new app.
73
+
74
+ ## Plan, implement and verify
75
+
76
+ - Read [engineering planning](references/engineering.md) before choosing the
77
+ implementation. It covers requirements, state, dependencies and failure boundaries.
78
+ - Follow [execution and verification](references/execution.md) for implementation,
79
+ regression checks, saved work, release and resumable progress.
80
+ - For platform integrations, read [capability discovery](references/capabilities.md)
81
+ and the relevant current domain contract before selecting an approach.
82
+ - For a compatible application foundation, read [shipped foundations](references/foundations.md).
83
+ The optional local helper previews and installs the existing Next.js, account/session
84
+ and subscription pieces without choosing the stack or commercial model for you.
85
+ Without a terminal, Egbe runs the same installation into a Git commit session.
86
+ - For a user-facing interface, use [interface quality](references/interface-quality.md).
87
+ - For review that must remain usable after handoff, use
88
+ [private review](references/workflows/private-review-handoff.md).
89
+
90
+ Use an existing work plan or `egbe-docs/development/<work-id>/` for the concrete
91
+ plan, TODOs and evidence. Keep accepted requirements in their existing product
92
+ documents; do not create a second definition or mandatory structured plan.
93
+ Update progress as work is proved and preserve open decisions/checks for resumption.
94
+
95
+ ## Domain capabilities
96
+
97
+ Use only what the accepted behavior requires; these are not sequential stages.
98
+
99
+ | Work | Capability |
100
+ | --- | --- |
101
+ | New application foundation or main page | `egbe-os-design-landing-page`: its application-preparation reference; preserve an existing application |
102
+ | Accounts, sessions, protected access | `egbe-os-product-auth` |
103
+ | Purchases, subscriptions, payment state | `egbe-os-payments`: select the workflow matching the accepted model |
104
+ | Outcome and payment measurement | `egbe-os-analytics`: activation-tracking or payment-lifecycle-tracking as applicable |
105
+ | Storage, generated output and other integrations | Discover DB, LLM, images or other capabilities through OS |
106
+ | Source control and serving release | `egbe-os-git`, `egbe-os-deploy` within the authorized publication scope |
107
+
108
+ Read accepted product decisions by meaning, not a prescribed PRD heading. Account
109
+ entry, a public preview and payment are independent choices, not universal gates.
110
+ Do not recreate missing planning artifacts merely to satisfy a capability's example.
111
+ Keep the real producer, consumer and integration proof connected across domain work.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Product Build"
3
+ short_description: "Implement and verify a complete product change"
4
+ default_prompt: "Use $egbe-os-product-build to implement and verify the agreed product outcome in the existing repository."
@@ -0,0 +1,25 @@
1
+ # Platform capabilities and credentials
2
+
3
+ Before choosing an integration, find the capability in public `GET /` and read
4
+ its `instruction_url` (or the corresponding installed skill):
5
+
6
+ ```bash
7
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/" -fsS
8
+ curl -fsS "${OS_URL}<instruction_url-from-catalog>"
9
+ ```
10
+
11
+ Use the configured OS_URL, normally https://os.hz.egbe.dev. Do not substitute a
12
+ guessed endpoint, provider host, copied stale schema or canned local result for
13
+ an unclear capability. Establish a credible implementation or report the exact
14
+ missing contract.
15
+
16
+ The local agent's OS_API_KEY is for discovery and authorized control-plane actions.
17
+ Never copy it into product code, APP_ENV_JSON, plans or client bundles. Product
18
+ server code uses OS_URL and OS_API_KEY supplied by the Site Gateway's product-runtime
19
+ identity. Do not mint, rename or deploy an agent key or invent per-capability keys.
20
+ Missing runtime identity is a platform deployment fault, not a reason to bypass it.
21
+
22
+ Keep the repository, deployment slug, database and other existing bindings unless
23
+ the task requires a deliberate change. Use the current Deploy contract for build,
24
+ runtime environment and release verification; use domain skills for their schemas,
25
+ authorization, errors and recovery instead of duplicating them here.
@@ -0,0 +1,72 @@
1
+ # Engineering planning
2
+
3
+ Inspect the repository, framework, dependencies, deployed identity, storage and
4
+ affected callers before writing the plan. Reuse established libraries and sound
5
+ existing patterns; do not copy a weak local precedent when a relevant, safer
6
+ implementation already exists elsewhere in the product. Keep unrelated work intact.
7
+
8
+ ## Close the real behavior
9
+
10
+ Map each accepted requirement to implementation and proof, or an explicitly deferred
11
+ scope. Include nonvisual obligations without inventing screens. Shared mechanisms
12
+ need one owner; consumers name the actual output they depend on. Order work by those
13
+ dependencies, not by a universal Auth/Product/Billing sequence. Split independently
14
+ deliverable and recoverable outcomes when one large task would hide their gaps.
15
+
16
+ Trace the initiating action, real producer, authoritative state, consumer/application,
17
+ visible result and recovery. A readable status, table or interface is not a completed
18
+ behavior. State must survive its promised boundary: request, redirect, retry, login,
19
+ later session or deployment. Identify the smallest production-capable missing
20
+ foundation; absence in the repository is work to implement, not permission to fake
21
+ the result or defer it silently.
22
+
23
+ Read the planned steps literally: could every one be finished while a necessary
24
+ producer, transformation, delivery or consumer is still missing? Correct that gap.
25
+ Keep producer proof with its producer and combined behavior with the first consumer
26
+ where the required real outputs exist. A stub for a later component does not prove
27
+ that component or the integrated journey.
28
+
29
+ ## State and access boundaries
30
+
31
+ For a result coupled to a state change or consumption of a right, use a stable
32
+ logical operation identity. Delivery, failure, duplicates, retries, concurrency
33
+ and partial failures must converge without double delivery, double spending or
34
+ contradictory authority. Choose transactions, idempotency, durable retry or
35
+ compensation from the real boundaries; do not assume one transaction spans external
36
+ providers. Add consumption bookkeeping only to rights that actually deplete.
37
+
38
+ Across guest/account or other identity transitions, preserve the actual work,
39
+ purchase, prior decisions and consumed capacity without granting them to another
40
+ person. A typed email or client-side ID is not proof of ownership. Use the Auth
41
+ contract and verified server-side linkage; avoid independent authorities or a reset
42
+ at registration. Keep product credentials separate from agent/control-plane credentials.
43
+
44
+ Authorize private results at every access path: page, API, storage/download and
45
+ email link. Apply the accepted roles/sharing policy. A hard-to-guess object ID is
46
+ not authorization; an explicitly intended bearer access link requires its own
47
+ secure, scoped lifecycle. Never expose secrets, customer data or a test-login bypass
48
+ to make verification easier.
49
+
50
+ ## Implementable design and code quality
51
+
52
+ Choose modules, interfaces, schema changes and tests after inspecting the system.
53
+ Record consequential choices and alternatives in the current work plan, not a second
54
+ architecture ledger. Changes to accepted behavior or cross-boundary contracts need
55
+ that decision resolved; internal implementation choices need not reopen the product.
56
+
57
+ - Group cohesive features into directories with clear responsibilities. Separate
58
+ orchestration, UI, domain behavior and external effects where they vary independently;
59
+ do not accumulate an entire feature in a flat module or giant view by convenience.
60
+ - Reuse shared logic when it represents the same responsibility; avoid both copied
61
+ behavior and speculative abstractions. Preserve the product's performance,
62
+ availability, accessibility and security requirements in the plan and checks.
63
+ - Add fallback/legacy paths only for an evidenced supported caller or operational
64
+ need, with an explicit authority, observable failure behavior and removal condition.
65
+ Do not silently return canned success or preserve obsolete branches without a consumer.
66
+ - Plan migrations and recovery for existing customer data. Do not replace durable
67
+ storage with memory or rebuild the app merely to simplify a local change.
68
+
69
+ Before editing, keep a proportional checklist of implementation and direct proof in
70
+ the existing work record. Group cases that prove the same boundary, not one document
71
+ or TODO for every negative case. Missing inputs block only dependent work; keep the
72
+ specific gap and continuation explicit.
@@ -0,0 +1,55 @@
1
+ # Execute and verify the implementation
2
+
3
+ Build the smallest real vertical path first, then supporting work. Use actual
4
+ domain contracts and follow the plan's scope; code, types and tests around an
5
+ absent central result do not complete it. Inspect existing completion claims as
6
+ leads, not proof. A time limit leaves work resumable, not permission to narrow
7
+ the promise or substitute a demo.
8
+
9
+ ## Direct verification
10
+
11
+ Match evidence to the claim. Source/local/contract tests can prove their boundary;
12
+ a serving journey needs evidence from the serving revision. Build, lint, HTTP 200,
13
+ data shape and a successful checkout redirect are supporting checks, not proof
14
+ of the customer's result. Inspect generated/transformed content for the accepted
15
+ quality on meaningful inputs, not just schema validity.
16
+
17
+ - Exercise relevant intermediate, partial, failure and recovery states as well
18
+ as success. Check authoritative state and rendered guidance/actions together;
19
+ a later successful action does not prove the earlier guidance was correct.
20
+ - For coupled delivery/state changes, test the actual joining boundary under
21
+ duplicates, retries, concurrency and relevant partial failures. An isolated
22
+ reducer or sequential simulation cannot establish the whole operation.
23
+ - Verify the accepted access policy on the real result, including direct API,
24
+ file and link access; prove guest-to-account continuity without cross-account
25
+ takeover. Use Auth's normal authority and preserve its separate account-entry proof.
26
+ - When updating stored customer work, retain and recover an original record/file
27
+ across the update, including its meaningful editable state. Freshly created
28
+ work does not prove preservation. For first-time persistence, prove new-work
29
+ recovery without inventing a pre-update baseline. Follow Deploy's saved-work
30
+ contract when the release is part of the task.
31
+ - Add focused regressions for demonstrated defects. Reopen an earlier completion
32
+ claim when new evidence contradicts it; do not preserve a checkmark over reality.
33
+
34
+ Use safe, authorized test identities and inputs. Keep synthetic activity separate
35
+ from customer/revenue metrics. Do not send customer messages, book real appointments,
36
+ create provider objects just to inspect their format, or spend money as a QA shortcut.
37
+ Payments owns the distinction between validate-only, isolated payment/delivery tests
38
+ and actual live purchases. A private test session is not evidence that login works.
39
+
40
+ ## Finish the owned work
41
+
42
+ Check TODOs as their results are proved and attach concise evidence. Preserve remaining
43
+ gaps and the next action in the same plan; do not replace unfinished work with a summary.
44
+ Complete the owned behavior and relevant recovery, not just the listed edits.
45
+
46
+ Use Git and Deploy for an authorized publication. Deploy the intended committed
47
+ revision and verify what actually serves, including integrations whose callbacks or
48
+ environment require it. A local-only or validation-only task retains its diff and
49
+ evidence for the integrator; it does not silently commit, push or deploy. Do not create
50
+ empty commits or deploy after every formal planning step.
51
+
52
+ Report implemented and verified scope separately from untested behavior and customer
53
+ impact. Use EGBE's handoff for incomplete work. Where a human will verify later, use
54
+ [private review](workflows/private-review-handoff.md) so the access and steps remain
55
+ usable after the implementation agent stops.