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