@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,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,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.
|