@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,335 @@
|
|
|
1
|
+
# Specification Contract
|
|
2
|
+
|
|
3
|
+
One folder holds everything about one quiz:
|
|
4
|
+
|
|
5
|
+
| Path | Author | Meaning |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| `egbe-docs/product/quizzes/<quiz-slug>/quiz.json` | Agent | The executable specification of the accepted experience. |
|
|
8
|
+
| `egbe-docs/product/quizzes/<quiz-slug>/QUIZ.md` | Compiler | The readable specification for review. |
|
|
9
|
+
| `egbe-docs/product/quizzes/<quiz-slug>/quiz.public.json` | Compiler | The part of the specification the page renders. |
|
|
10
|
+
| `egbe-docs/product/quizzes/<quiz-slug>/validation.json` | Compiler | The receipt of the last compile: status, date, hashes, counts, consent and reachability diagnostics. |
|
|
11
|
+
|
|
12
|
+
Resolve `egbe-docs/` from the product repository root. Keep it with the product source and use the repository's versioning workflow
|
|
13
|
+
when a commit is in scope. Optional research can live beside it; no report is
|
|
14
|
+
required to compile.
|
|
15
|
+
|
|
16
|
+
## Compile
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
python3 <skill-root>/scripts/compile-quiz-spec.py \
|
|
20
|
+
--workspace <workspace-root> --quiz-slug <quiz-slug>
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
The compiler reads `quiz.json`. Contract errors block compilation; nonblocking
|
|
24
|
+
diagnostics remain in `validation.json.warnings`. No research age, prescribed
|
|
25
|
+
length, wording limit or deviation justification is required.
|
|
26
|
+
|
|
27
|
+
- When the specification is ready, it writes the three compiled files, with
|
|
28
|
+
`"status": "ready"` in the receipt.
|
|
29
|
+
- When it is not, it removes `QUIZ.md` and `quiz.public.json` of an earlier
|
|
30
|
+
version and writes the receipt with `"status": "not_ready"` and the
|
|
31
|
+
problems, so that nothing stale can be mistaken for current.
|
|
32
|
+
- `--check` validates without writing or removing anything.
|
|
33
|
+
- `--today` fixes the date for reproducible tests. Do not use it to compile a
|
|
34
|
+
quiz.
|
|
35
|
+
|
|
36
|
+
The compiler checks structure and consistency. It does not know whether a
|
|
37
|
+
statement is true.
|
|
38
|
+
|
|
39
|
+
## General rules
|
|
40
|
+
|
|
41
|
+
- Unknown fields are errors.
|
|
42
|
+
- An id starts with a lowercase letter and contains lowercase letters, digits,
|
|
43
|
+
`-`, and `_`, 40 characters at most. The
|
|
44
|
+
ids of screens and results are unique among both; option ids are unique on
|
|
45
|
+
their screen.
|
|
46
|
+
- The name of a query parameter starts with a lowercase letter and contains
|
|
47
|
+
lowercase letters, digits, and `_`. It cannot be `email`, `mail`, `name`,
|
|
48
|
+
`phone`, or `tel`.
|
|
49
|
+
- A text the visitor reads is one line of plain text without line breaks. It
|
|
50
|
+
contains no claim to avoid.
|
|
51
|
+
- A same-origin path starts with `/` and has no fragment. An address is an
|
|
52
|
+
absolute `https` address without credentials or a fragment. Neither carries
|
|
53
|
+
personal data in its query.
|
|
54
|
+
|
|
55
|
+
## Specification
|
|
56
|
+
|
|
57
|
+
A complete example is in
|
|
58
|
+
`assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json`. It was compiled with
|
|
59
|
+
`--today 2026-09-28`.
|
|
60
|
+
|
|
61
|
+
```json
|
|
62
|
+
{
|
|
63
|
+
"contract": "quiz-funnel-spec-v1",
|
|
64
|
+
"quiz_slug": "books-checkup",
|
|
65
|
+
"product_slug": "example-books",
|
|
66
|
+
"route": "/quiz/books-checkup",
|
|
67
|
+
"language": "en",
|
|
68
|
+
"title": "Books checkup",
|
|
69
|
+
"ui": {"back": "Back", "progress": "Step {current} of {total}"},
|
|
70
|
+
"inputs": {},
|
|
71
|
+
"goal": {},
|
|
72
|
+
"proof": [],
|
|
73
|
+
"screens": [],
|
|
74
|
+
"results": []
|
|
75
|
+
}
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
- `quiz_slug` and `product_slug`: lowercase letters, digits, and `-`.
|
|
79
|
+
`quiz_slug` equals the name of the folder.
|
|
80
|
+
- `route`: a lowercase path without a query or a trailing slash. Its first
|
|
81
|
+
segment cannot be `account`, `admin`, `api`, `auth`, `checkout`,
|
|
82
|
+
`dashboard`, `login`, `logout`, `pricing`, `privacy`, `register`, `signup`,
|
|
83
|
+
or `terms`, and it cannot be the homepage.
|
|
84
|
+
- `language`: a language tag such as `en`, `es`, or `pt-BR`. Add the region
|
|
85
|
+
only when the copy is written for that region.
|
|
86
|
+
- `title`: the title of the page in the browser, in the language of the quiz.
|
|
87
|
+
- `ui.back`: the label of the back control. `ui.progress`: the label of the
|
|
88
|
+
progress indicator with the placeholders `{current}` and `{total}`. `{total}`
|
|
89
|
+
counts every screen before the result, questions and interstitial screens
|
|
90
|
+
alike, so word the label as steps, not as questions.
|
|
91
|
+
|
|
92
|
+
### `inputs`
|
|
93
|
+
|
|
94
|
+
```json
|
|
95
|
+
{
|
|
96
|
+
"product": "What the product is and does.",
|
|
97
|
+
"application": {"repository": "example-books", "url": "https://example-books.egbe.app"},
|
|
98
|
+
"segment": {"name": "", "situation": "", "problem": ""},
|
|
99
|
+
"offer": {
|
|
100
|
+
"promise": "",
|
|
101
|
+
"mechanism": "",
|
|
102
|
+
"terms": "",
|
|
103
|
+
"claims_to_avoid": [],
|
|
104
|
+
"not_for": []
|
|
105
|
+
},
|
|
106
|
+
"traffic": {"channels": ["meta_ads"], "geographies": ["US"], "promise": ""},
|
|
107
|
+
"sources": [{"label": "Caller request", "ref": "request"}]
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
- `offer.claims_to_avoid` and `offer.not_for` may be empty lists.
|
|
112
|
+
- `traffic.channels` names the channels, for example `meta_ads`, `google_ads`,
|
|
113
|
+
`reddit_ads`, `linkedin_ads`, `openai_ads`, `outreach_email`.
|
|
114
|
+
- `traffic.geographies` holds two-letter country codes. The compiler lists
|
|
115
|
+
those that need consent in the receipt.
|
|
116
|
+
- `traffic.promise` is the text of the ad or message. Leave the field out when
|
|
117
|
+
no ad exists yet.
|
|
118
|
+
- `sources[].ref` is `request`, `answer`, or the path or address of a
|
|
119
|
+
document.
|
|
120
|
+
- Proof that exists is recorded under `proof`, not here. A product without
|
|
121
|
+
proof has an empty `proof` list.
|
|
122
|
+
|
|
123
|
+
### `goal`
|
|
124
|
+
|
|
125
|
+
```json
|
|
126
|
+
{
|
|
127
|
+
"type": "call",
|
|
128
|
+
"statement": "The quiz should get visitors to book the free books review call.",
|
|
129
|
+
"destination": {"kind": "booking_url", "url": "https://cal.example.com/books-review"}
|
|
130
|
+
}
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
`statement` is optional context from the accepted project decisions. The
|
|
134
|
+
destination depends on the goal:
|
|
135
|
+
|
|
136
|
+
| Goal | `kind` | Fields |
|
|
137
|
+
|---|---|---|
|
|
138
|
+
| `call` | `booking_url` | `url`; optional `result_param`, `fallback_params` |
|
|
139
|
+
| `call` | `lead_form` | `action` (same-origin path), `fields`, `field_labels`, `submit_label`, `error`, `success` (`headline`, `body`); optional `consent_note` |
|
|
140
|
+
| `signup` | `signup` | `path` (same-origin) |
|
|
141
|
+
| `payment` | `checkout` | `path` (same-origin), `plan_key`, `price`; optional `plan_param` (default `plan`) |
|
|
142
|
+
|
|
143
|
+
- `fields` may contain `name`, `email`, `phone`, and `company`, each once, and
|
|
144
|
+
must contain `email` or `phone`. `field_labels` has one label per field.
|
|
145
|
+
- `result_param` must not already be in the query of `url`.
|
|
146
|
+
- The checkout `path` must not already carry the plan parameter.
|
|
147
|
+
- `price` is the price with its period, exactly as the product's plan catalog
|
|
148
|
+
states it, for example `$95 per month`. Every result that leads to the
|
|
149
|
+
checkout must contain it, character for character, in a text that every
|
|
150
|
+
visitor of that result reads: its headline, its body, the label or the note
|
|
151
|
+
of its call to action, or a point that is never left out. A point that
|
|
152
|
+
quotes a question with an escape option is left out for visitors who chose
|
|
153
|
+
that option, so the price in such a point does not count.
|
|
154
|
+
- See [conversion-handoff.md](conversion-handoff.md) for what each field does.
|
|
155
|
+
- A request form that continues to a scheduling page keeps the kind
|
|
156
|
+
`lead_form`. The scheduling address is not a field of the specification;
|
|
157
|
+
[conversion-handoff.md](conversion-handoff.md) says where it is kept and
|
|
158
|
+
recorded.
|
|
159
|
+
|
|
160
|
+
### `proof`
|
|
161
|
+
|
|
162
|
+
```json
|
|
163
|
+
{"id": "review-summary", "kind": "fact", "text": "Shown text.", "source": "Where it can be checked"}
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
`kind` is `count`, `fact`, `logo`, `statistic`, or `testimonial`. A
|
|
167
|
+
`testimonial` needs `author`; a `statistic` needs `citation`. Every entry must
|
|
168
|
+
be shown on a screen or a result; remove what is not shown.
|
|
169
|
+
|
|
170
|
+
### `screens`
|
|
171
|
+
|
|
172
|
+
The visitor passes the screens in order, then sees a result. The first screen
|
|
173
|
+
may be a question or an interstitial, including an introduction.
|
|
174
|
+
|
|
175
|
+
```json
|
|
176
|
+
{
|
|
177
|
+
"id": "worries",
|
|
178
|
+
"type": "question",
|
|
179
|
+
"select": "multi",
|
|
180
|
+
"headline": "What worries you most?",
|
|
181
|
+
"hint": "Choose all that apply.",
|
|
182
|
+
"purpose": "build_case",
|
|
183
|
+
"button": "Continue",
|
|
184
|
+
"options": [
|
|
185
|
+
{"id": "deadline", "label": "Tax deadline", "phrase": "the tax deadline"},
|
|
186
|
+
{"id": "nothing", "label": "None of these", "escape": true}
|
|
187
|
+
]
|
|
188
|
+
}
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
- `select` is `single` or `multi`. A `multi` question needs `button` and
|
|
192
|
+
cannot be passed with nothing chosen. A `single` question must not have a
|
|
193
|
+
button. `hint` is optional for either kind.
|
|
194
|
+
- Optional private `purpose` is `personalize`, `qualify`, or `build_case`; it
|
|
195
|
+
explains an answer's use and does not reach the browser. An unused answer is
|
|
196
|
+
a diagnostic, not a compilation failure.
|
|
197
|
+
- `lead` is optional introductory text on a question.
|
|
198
|
+
- `options`: a non-empty list. `label` is the text of the button. `phrase` is the same
|
|
199
|
+
answer worded for the middle of a sentence; tokens use it when it exists.
|
|
200
|
+
- `"escape": true` marks the option for visitors to whom no other option
|
|
201
|
+
applies or who prefer not to answer. A question has at most one and at least
|
|
202
|
+
one option besides it. On a multi-select question it excludes the others.
|
|
203
|
+
- `"sensitive": true` requires an escape option and keeps the chosen option in
|
|
204
|
+
the visitor's browser.
|
|
205
|
+
|
|
206
|
+
```json
|
|
207
|
+
{
|
|
208
|
+
"id": "halfway",
|
|
209
|
+
"type": "interstitial",
|
|
210
|
+
"kind": "encouragement",
|
|
211
|
+
"headline": "You are halfway there",
|
|
212
|
+
"body": "Three more answers and you will see what your books need first.",
|
|
213
|
+
"button": "Continue",
|
|
214
|
+
"variants": [
|
|
215
|
+
{
|
|
216
|
+
"when": {"all": [{"screen": "behind", "any_of": ["many", "year"]}]},
|
|
217
|
+
"headline": "This is what a catch-up is for",
|
|
218
|
+
"body": "Books that are {{answer:behind}} can be reconciled month by month."
|
|
219
|
+
}
|
|
220
|
+
]
|
|
221
|
+
}
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
- `kind` is `encouragement`, `proof`, or `teach`. A `proof` screen needs
|
|
225
|
+
`proof_ids`.
|
|
226
|
+
- `body`, `points`, `media`, and `proof_ids` are optional.
|
|
227
|
+
- `variants` is optional. The first variant whose `when` matches replaces the
|
|
228
|
+
fields it contains; the screen's own fields apply to everyone else. A
|
|
229
|
+
variant changes `headline`, `body`, `points`, `media`, or `proof_ids`, never
|
|
230
|
+
the button. Its conditions may name only questions that come before the
|
|
231
|
+
screen. A variant that no answer can reach, or variants that leave the
|
|
232
|
+
screen's own texts unreachable, are errors.
|
|
233
|
+
|
|
234
|
+
### `results`
|
|
235
|
+
|
|
236
|
+
Results are tested in order and the first match is shown. The last result has
|
|
237
|
+
no `when` and is the default. A `not_fit` result is shown as soon as the
|
|
238
|
+
answers given decide it, that is, when every answer the remaining questions
|
|
239
|
+
could receive leads to it; the remaining screens are skipped. A `not_fit`
|
|
240
|
+
result whose headline or body quotes a question that is not answered yet
|
|
241
|
+
waits for that question.
|
|
242
|
+
|
|
243
|
+
```json
|
|
244
|
+
{
|
|
245
|
+
"id": "catch-up",
|
|
246
|
+
"fit": "fit",
|
|
247
|
+
"when": {"all": [{"screen": "behind", "any_of": ["many", "year"]}]},
|
|
248
|
+
"headline": "Your books need a catch-up first",
|
|
249
|
+
"body": "On the free 20-minute review we list the missing months.",
|
|
250
|
+
"points": ["Your books: {{answer:behind}}", "On your mind: {{answer:worries}}"],
|
|
251
|
+
"cta": {"label": "Book the free review", "note": "The call takes 20 minutes."}
|
|
252
|
+
}
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
- `fit` is `fit`, `partial`, or `not_fit`. A `not_fit` result requires an
|
|
256
|
+
entry in `inputs.offer.not_for`.
|
|
257
|
+
- `cta` has a `label` and an optional `note`. Without a `destination` it leads
|
|
258
|
+
to the destination of the goal. At least one `fit` or `partial` result must
|
|
259
|
+
do so.
|
|
260
|
+
- A `cta` may carry its own `destination`: `{"kind": "link", "path": "/..."}`
|
|
261
|
+
or `{"kind": "link", "url": "https://..."}`. It must not lead to the
|
|
262
|
+
destination of the goal. A `not_fit` result needs its own destination or
|
|
263
|
+
`"cta": null`; only a `not_fit` result may have `"cta": null`.
|
|
264
|
+
- `points`, `media`, and `proof_ids` are optional.
|
|
265
|
+
- A result that no answer can reach is an error: its conditions cannot be met,
|
|
266
|
+
or earlier results catch every answer that meets them.
|
|
267
|
+
- A shared result is supported when the accepted experience records answers
|
|
268
|
+
for a later use rather than personalizing the result in this runtime.
|
|
269
|
+
|
|
270
|
+
### `media`
|
|
271
|
+
|
|
272
|
+
```json
|
|
273
|
+
{"src": "/quiz/books-checkup/summary.png", "alt": "A written summary of a review", "source": "Summary sent to a client on 2026-08-12, names removed"}
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
`src` is a same-origin path or an address. `alt` describes the image to a
|
|
277
|
+
visitor who cannot see it. `source` is for the founder and does not reach the
|
|
278
|
+
page.
|
|
279
|
+
|
|
280
|
+
### Conditions
|
|
281
|
+
|
|
282
|
+
`when` holds exactly one of `all` or `any`, each a list of conditions. A
|
|
283
|
+
condition names a question `screen` and exactly one of `any_of` or `none_of`,
|
|
284
|
+
each a list of option ids of that question. For a multi-select question,
|
|
285
|
+
`any_of` matches when at least one listed option was chosen and `none_of` when
|
|
286
|
+
none was.
|
|
287
|
+
|
|
288
|
+
The condition of a result must not name a sensitive question.
|
|
289
|
+
|
|
290
|
+
### Tokens
|
|
291
|
+
|
|
292
|
+
`{{answer:<question id>}}` is replaced by what the visitor chose.
|
|
293
|
+
|
|
294
|
+
Sensitive answers cannot be used in tokens: interstitial and result copy is
|
|
295
|
+
not masked by the question's recording selector. Keep those answers private;
|
|
296
|
+
this runtime has no private result-text rendering mode.
|
|
297
|
+
|
|
298
|
+
| Where | Which questions | What appears |
|
|
299
|
+
|---|---|---|
|
|
300
|
+
| `headline` and `body` of an interstitial screen, a variant, or a result | Single-choice questions without an escape option | The `phrase` of the chosen option, or its `label` |
|
|
301
|
+
| `points` of an interstitial screen, a variant, or a result | Any question | The chosen options separated by commas. The whole point is left out when the visitor chose the escape option, so a point that quotes such a question must not carry what every visitor has to read. |
|
|
302
|
+
| Anywhere else | — | An error |
|
|
303
|
+
|
|
304
|
+
An interstitial screen may quote only questions that come before it. Write
|
|
305
|
+
every sentence so that each possible answer reads well in it, and give options
|
|
306
|
+
a `phrase` when their label does not.
|
|
307
|
+
|
|
308
|
+
### Diagnostics and bounds
|
|
309
|
+
|
|
310
|
+
`multi_select_escape` flags a multi-select with no declining option;
|
|
311
|
+
`unused_answer` flags a declared personalization/qualification answer with no
|
|
312
|
+
local rule or token. Both are nonblocking: exhaustive choices or an external
|
|
313
|
+
follow-up can make them intentional. A sensitive question still needs a refusal
|
|
314
|
+
option and cannot choose a public result.
|
|
315
|
+
|
|
316
|
+
Exhaustive reachability is bounded to 200,000 combinations, including the work
|
|
317
|
+
needed to construct multi-select answer classes. If skipped, the receipt says
|
|
318
|
+
`reachability: "not_checked"` and identifies affected rules in `warnings`; this
|
|
319
|
+
is not a passing check. Verify relevant paths separately before release. The
|
|
320
|
+
last default result remains required. Runtime early-result inference is separately
|
|
321
|
+
bounded; when it cannot prove an early result it continues the accepted screens
|
|
322
|
+
and resolves the result from the completed answers.
|
|
323
|
+
|
|
324
|
+
The compiler checks configured `claims_to_avoid` (case/accent insensitive) and
|
|
325
|
+
exact configured checkout prices. It does not use matching digits as proof of
|
|
326
|
+
truth. Check claims and source attribution against real evidence separately.
|
|
327
|
+
|
|
328
|
+
## Hashes
|
|
329
|
+
|
|
330
|
+
The receipt and `quiz.public.json` carry hashes:
|
|
331
|
+
|
|
332
|
+
- `spec_sha256` names the specification and changes with any edit of
|
|
333
|
+
`quiz.json`.
|
|
334
|
+
- `public_sha256` changes only when the page itself changes; a visitor's saved
|
|
335
|
+
progress starts over when it does.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# Verification
|
|
2
|
+
|
|
3
|
+
Verify the changed behavior locally. When a release is in scope, repeat the
|
|
4
|
+
relevant checks on the deployed route; do not claim live verification from a build. Create no real booking,
|
|
5
|
+
account, request, or payment, and write no synthetic events into production
|
|
6
|
+
statistics.
|
|
7
|
+
|
|
8
|
+
## Before deploy
|
|
9
|
+
|
|
10
|
+
- `compile-quiz-spec.py --check` reports the specification as ready and prints
|
|
11
|
+
its hash.
|
|
12
|
+
- The `spec_sha256` of the `quiz.public.json` inside the application equals
|
|
13
|
+
that hash.
|
|
14
|
+
- The application's lint and build pass.
|
|
15
|
+
- Review `validation.json.warnings`. `reachability: "not_checked"` needs
|
|
16
|
+
separate path verification; it is not a passing exhaustive check.
|
|
17
|
+
|
|
18
|
+
## On the live route
|
|
19
|
+
|
|
20
|
+
Before the first page load of the verification session, set up the browser you
|
|
21
|
+
use so that nothing reaches production statistics: let the analytics tracker
|
|
22
|
+
load but block the requests it sends, and block the session recorder and every
|
|
23
|
+
advertising pixel. Keep this until the session ends. The blocked requests of
|
|
24
|
+
the tracker are the evidence for step 7.
|
|
25
|
+
|
|
26
|
+
Check on a phone-sized viewport of 375 by 667 and on a desktop viewport.
|
|
27
|
+
|
|
28
|
+
1. **Route.** Opening the address directly shows the accepted first screen, not the
|
|
29
|
+
homepage, a sign-in page, or an empty page. The page title, the language of
|
|
30
|
+
the quiz, and `noindex` are set.
|
|
31
|
+
2. **First screen.** The accepted first screen and its controls remain usable on
|
|
32
|
+
the target mobile viewport, including when long content needs scrolling. Nothing scrolls sideways on any screen.
|
|
33
|
+
3. **Movement.** A single-choice option advances without a button. A second
|
|
34
|
+
tap right after the first does not answer the next question. A multi-select
|
|
35
|
+
question does not advance without a choice, and switching an option keeps
|
|
36
|
+
focus and scroll position. An interstitial screen has one button. Refusal and navigation follow the accepted experience. The back control and the browser's own back return to the
|
|
37
|
+
previous screen and keep the answers. Reloading keeps the progress. After a
|
|
38
|
+
reload on the third screen, the back control pressed twice leads to the
|
|
39
|
+
first screen, and the browser's back from there leaves the quiz.
|
|
40
|
+
4. **Screens.** Every variant of an interstitial screen appears for the
|
|
41
|
+
answers that select it, and the screen's own texts appear for the others.
|
|
42
|
+
5. **Results.** Walk one path to every result. Each shows its own headline,
|
|
43
|
+
body, points, and image; every token is replaced by the chosen answer; a
|
|
44
|
+
point whose question was declined is absent; the default result appears
|
|
45
|
+
when no rule matches. Every image loads and shows what its `source` says.
|
|
46
|
+
A `not_fit` result appears right after the answer that decides it, without
|
|
47
|
+
the remaining questions; the back control and the browser's back return to
|
|
48
|
+
that question, and another answer to it continues with the next screen.
|
|
49
|
+
6. **Call to action and destination.** For each result the label, the note
|
|
50
|
+
under the button, and the destination match the specification, and a
|
|
51
|
+
`not_fit` result does not lead to the goal.
|
|
52
|
+
- `booking_url`: the link opens the scheduling page. For a visit that
|
|
53
|
+
arrived with campaign parameters the link carries them; for a visit
|
|
54
|
+
without them it carries the fallback values. Stop there.
|
|
55
|
+
- `lead_form`: labels, consent note, and the failure state appear as
|
|
56
|
+
specified. The endpoint rejects an invalid request and stores nothing.
|
|
57
|
+
Submit a valid request only when the product can mark and remove a test
|
|
58
|
+
record.
|
|
59
|
+
- `lead_form` that continues to a scheduling page: mock malformed contact,
|
|
60
|
+
other rejection, server error, no response and confirmed save. Each follows
|
|
61
|
+
the accepted recovery behavior; navigation alone never reports a saved
|
|
62
|
+
request. The calendar URL carries campaign/result identifiers, never
|
|
63
|
+
contact details. Returning with Back does not resubmit the form.
|
|
64
|
+
- `signup`: the link reaches the signup route. With the private validation
|
|
65
|
+
identity prepared by the product's authentication work, confirm that the
|
|
66
|
+
first page after signup shows the restored result in the same tab, and
|
|
67
|
+
the normal first page when no result is stored.
|
|
68
|
+
- `checkout`: the link reaches the checkout route with the plan. The price
|
|
69
|
+
and period on the result equal those of the plan catalog. Use the
|
|
70
|
+
validation mode of the product's checkout; do not pay.
|
|
71
|
+
7. **Analytics.** The blocked requests of one complete path carry the event
|
|
72
|
+
names and values that [measurement.md](measurement.md) lists, the first
|
|
73
|
+
answer included, and each event once: an answer that appears twice points
|
|
74
|
+
to a binding that repeats what the runtime had already kept. Where the
|
|
75
|
+
path ends in a link, the click of that link carries its keys in
|
|
76
|
+
kebab-case. The answer to a sensitive question is in none of them.
|
|
77
|
+
8. **Access.** Complete one path with the keyboard only. Focus is visible and
|
|
78
|
+
moves to each new headline. Text contrast is sufficient. With a
|
|
79
|
+
reduced-motion preference the quiz still works.
|
|
80
|
+
9. **Weight.** On a throttled mobile connection the first screen can be
|
|
81
|
+
used as soon as it is visible. Where the first screen is part of the
|
|
82
|
+
delivered document, hold back the request for the page's module, tap an
|
|
83
|
+
option, and release the request: the option shows as chosen while the
|
|
84
|
+
module is held back, the second screen appears after the release, and the
|
|
85
|
+
event of the first answer is among the blocked requests, once. For an
|
|
86
|
+
interstitial introduction, test an early continue tap and ensure it advances
|
|
87
|
+
once, also when saved progress exists. The route
|
|
88
|
+
loads no feature of the product's application.
|
|
89
|
+
10. **Links and consent.** The privacy, terms, and contact links work. The
|
|
90
|
+
consent mechanism appears where [implementation.md](implementation.md)
|
|
91
|
+
requires it.
|
|
92
|
+
11. **The rest of the product.** The homepage, signup, and checkout respond as
|
|
93
|
+
they did before the change.
|
|
94
|
+
|
|
95
|
+
## When a check fails
|
|
96
|
+
|
|
97
|
+
Fix the cause, redeploy when release is in scope, and repeat the failed check and the ones that depend
|
|
98
|
+
on it. A failure in the copy or the rules is fixed in `quiz.json` and compiled
|
|
99
|
+
again. When the cause is outside the quiz, such as a scheduling page that does
|
|
100
|
+
not open, report it as an open launch condition with the evidence instead of
|
|
101
|
+
working around it.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": 2,
|
|
3
|
+
"contract": "funnel-walk.v2",
|
|
4
|
+
"viewport": {"width": 390, "height": 844},
|
|
5
|
+
"min_observed_screens": 1,
|
|
6
|
+
"max_screens_per_attempt": 40,
|
|
7
|
+
"screen_kinds": ["landing", "question", "interstitial", "proof", "loader", "plan choice", "contact request", "teaser", "result", "offer", "booking", "account gate", "payment gate", "verification", "confirmation"],
|
|
8
|
+
"advance_types": ["automatic", "button", "link", "none"],
|
|
9
|
+
"stop_reasons": ["needs_approval", "needs_account", "needs_email", "phone", "sms", "captcha", "payment", "live_sales_call", "technical", "budget", "form_not_submitted", "own_no_submit", "completed"],
|
|
10
|
+
"research_statuses": ["queued", "in_progress", "needs_approval", "needs_account", "needs_email", "blocked", "completed", "boundary"],
|
|
11
|
+
"branch_roles": ["main", "auxiliary"],
|
|
12
|
+
"submission_kinds": ["lead_form", "quiz", "webinar_registration"],
|
|
13
|
+
"email_event_types": ["email_confirmation", "email_result"],
|
|
14
|
+
"approval": "human confirmation of the exact known forms and data; supplements for new forms, fields or data",
|
|
15
|
+
"forbidden": ["agent-created competitor account", "payment", "card entry", "live sales call booking", "CAPTCHA bypass", "random real phone number"],
|
|
16
|
+
"identity": "stable plus alias per funnel from a local research identity registry; no contact data in public evidence",
|
|
17
|
+
"observation": "real screenshot per observed screen; partial length and unseen outcomes remain unknown"
|
|
18
|
+
}
|