@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,520 @@
|
|
|
1
|
+
# Research Artifact Contract
|
|
2
|
+
|
|
3
|
+
Resolve every path from the current workspace root.
|
|
4
|
+
|
|
5
|
+
The paths below use the default research ID `market`. Before independent work,
|
|
6
|
+
choose a stable slug and set `EGBE_RESEARCH_ID` for every runner and downstream
|
|
7
|
+
consumer; substitute that ID in the documented paths. Resume with the same ID.
|
|
8
|
+
Do not change it between sections or reuse it for a different study. Keep public
|
|
9
|
+
outputs and versioned `work/` state together under `egbe-docs/research/<research-id>/`.
|
|
10
|
+
For substantial research, keep its question, relevant context/evidence, gaps,
|
|
11
|
+
requested result and constraints in `egbe-docs/research/<research-id>/brief.md`.
|
|
12
|
+
A narrow operation can use an existing task record or explicit CLI inputs;
|
|
13
|
+
neither a new document nor fixed Markdown headings are execution prerequisites.
|
|
14
|
+
|
|
15
|
+
`--context-file` selects optional provider-safe additional context. Only this
|
|
16
|
+
explicit content and the operation's declared upstream evidence may enter the
|
|
17
|
+
provider request; unrelated project files and personal details are not inputs.
|
|
18
|
+
The shared IO helper freezes selected text and source hashes in
|
|
19
|
+
`work/<section-id>/input-context.json` before collection. Receipts bind it as
|
|
20
|
+
`research_context: {path, sha256}`. Resume uses the saved snapshot, not a fresh
|
|
21
|
+
search for context. A changed source can limit applicability without corrupting
|
|
22
|
+
the saved result or authorizing a new paid run; retain both evidence and receipts.
|
|
23
|
+
Narrative continuation also verifies and reuses the saved assignment, query,
|
|
24
|
+
system prompt and `input-provenance.json`; its receipt binds the latter with
|
|
25
|
+
`input_provenance_sha256`. Updated installed prompts or upstream evidence do not
|
|
26
|
+
replace an in-flight request. Missing or damaged saved inputs stop continuation
|
|
27
|
+
before provider calls, rather than resetting the request.
|
|
28
|
+
|
|
29
|
+
The table describes supported outputs, not a package required for every task.
|
|
30
|
+
A bounded research operation needs only its own output and recovery evidence.
|
|
31
|
+
Recommendation/preview/synthesis/render artifacts belong only to a requested
|
|
32
|
+
publication. A Product handoff reuses relevant existing findings, sources,
|
|
33
|
+
coverage and unresolved questions; it does not require that publication package.
|
|
34
|
+
|
|
35
|
+
## Canonical Artifacts
|
|
36
|
+
|
|
37
|
+
| Artifact | Path | Required title |
|
|
38
|
+
| --- | --- | --- |
|
|
39
|
+
| Recommendation selection | `egbe-docs/research/market/pre-prd-recommendations.md` | YAML contract with `explanation_format: plain_text`, followed by one short plain-text explanation |
|
|
40
|
+
| Incremental full report | `egbe-docs/research/market/full-report.md` | `# Market Research Report` |
|
|
41
|
+
| Founder preview | `egbe-docs/research/market/preview.md` | `# Market Research: Findings and Recommendations` |
|
|
42
|
+
| Preview synthesis | `egbe-docs/research/market/preview-synthesis.json` | Strict schema version 1 JSON |
|
|
43
|
+
| Founder summary | `egbe-docs/research/market/summary.md` | Deterministic compact Markdown projection |
|
|
44
|
+
| Preview render receipt | `egbe-docs/research/market/preview-render.json` | Strict schema version 1 JSON |
|
|
45
|
+
| Keyword economics evidence | `egbe-docs/research/market/evidence/keyword-economics.json` | Schema version 2 aggregate; typed rows carry `locale_key` and `locale` |
|
|
46
|
+
| Competitor set evidence | `egbe-docs/research/market/evidence/competitors.json` | Strict schema version 1 JSON |
|
|
47
|
+
| Channel footprint evidence | `egbe-docs/research/market/evidence/channel-footprint.json` | Strict schema version 1 JSON |
|
|
48
|
+
| Creative patterns evidence | `egbe-docs/research/market/evidence/creative-patterns.json` | Strict schema version 1 JSON |
|
|
49
|
+
| Funnel teardown evidence | `egbe-docs/research/market/evidence/funnel-teardown.json` | Strict schema version 1 JSON |
|
|
50
|
+
| Lifecycle capture evidence | `egbe-docs/research/market/evidence/lifecycle-capture.json` | Strict schema version 1 JSON |
|
|
51
|
+
| Competitor ads evidence | `egbe-docs/research/market/evidence/competitor-ads.json` | Strict schema version 1 JSON |
|
|
52
|
+
| Competitor reviews evidence | `egbe-docs/research/market/evidence/review-mining.json` | Strict schema version 1 JSON |
|
|
53
|
+
| Communities analysis evidence | `egbe-docs/research/market/evidence/community-demand.json` | Strict schema version 1 JSON |
|
|
54
|
+
| Fleet benchmarks evidence | `egbe-docs/research/market/evidence/fleet-prior.json` | Strict schema version 1 JSON |
|
|
55
|
+
| Geography comparison analysis | `egbe-docs/research/market/evidence/geography-comparison.json` | Agent-authored schema version 1 comparison; not provider measurements |
|
|
56
|
+
|
|
57
|
+
The recommendation, synthesis, summary, render receipt, and evidence files are
|
|
58
|
+
machine-facing support artifacts. The full report and preview are durable
|
|
59
|
+
founder documents.
|
|
60
|
+
|
|
61
|
+
Section evidence files under `egbe-docs/research/market/evidence/` carry the
|
|
62
|
+
machine-readable rows behind a deterministic section: typed entries (keyword
|
|
63
|
+
metrics, SERP observations, competitor domains, budget simulations) each with
|
|
64
|
+
provenance and an evidence-tier marker. They are written only by the owning
|
|
65
|
+
section runner, verified together with the
|
|
66
|
+
report section they back, and consumed by downstream hypothesis tooling.
|
|
67
|
+
Narrative workflows must not edit them.
|
|
68
|
+
|
|
69
|
+
Geography Comparison is a separate analysis artifact, not one of those measured
|
|
70
|
+
datasets. `scripts/geography-comparison.py` prepares validated prior inputs and
|
|
71
|
+
publishes its structured comparison and exact report section together. Its
|
|
72
|
+
`request.json` binds context, source inputs and published files. It has no OS
|
|
73
|
+
Research job ID or Completion Review. Structural completion can include an
|
|
74
|
+
explicit `not_compared` scope decision or an uncertain comparison; consumers
|
|
75
|
+
must preserve that distinction, not call either a validated market winner.
|
|
76
|
+
|
|
77
|
+
The Preview workflow also reads the execution state at
|
|
78
|
+
`egbe-docs/research/market/work/preview-context.json`. It is the authoritative selected and
|
|
79
|
+
research outcomes projected by the runtime. It is versioned and must
|
|
80
|
+
not be rewritten by the workflow. Its ordered section IDs
|
|
81
|
+
and canonical labels are the immutable execution-plan snapshot; a newer skill
|
|
82
|
+
catalog must not expand work that is already running.
|
|
83
|
+
For standalone work, `scripts/build-preview-context.py` is the producer: it
|
|
84
|
+
freezes explicit selection and derives completion from receipts. See
|
|
85
|
+
`../workflows/local-research.md`; do not hand-author completed statuses.
|
|
86
|
+
Section entries contain `id`, `label`, `status`, optional verified `coverage`,
|
|
87
|
+
and `closed_by_caller: true` only for an explicit `--failed` decision.
|
|
88
|
+
`partial` and `no_data` are distinct outcomes, not manual closures. Their Preview
|
|
89
|
+
meaning and evidence use are defined in `../workflows/preview.md`.
|
|
90
|
+
|
|
91
|
+
## Section Isolation
|
|
92
|
+
|
|
93
|
+
Use the exact H2 from `references/catalog.v1.json`. A section workflow owns only
|
|
94
|
+
that H2 and its body. It must not create, rewrite, or remove another section.
|
|
95
|
+
|
|
96
|
+
Run `scripts/upsert-markdown-section.py` from this skill bundle to create or
|
|
97
|
+
replace the owned section. The helper preserves all other report content and
|
|
98
|
+
keeps repeated execution idempotent. Supply non-empty content and never edit
|
|
99
|
+
the report with an unconstrained whole-file rewrite.
|
|
100
|
+
|
|
101
|
+
From the workspace root, invoke it as:
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
python <skill-root>/scripts/upsert-markdown-section.py \
|
|
105
|
+
--report egbe-docs/research/market/full-report.md \
|
|
106
|
+
--heading "<exact catalog heading>" \
|
|
107
|
+
--content "<non-empty section content>"
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Resolve `<skill-root>` to the extracted directory containing this skill's
|
|
111
|
+
`SKILL.md`. For multiline future content, pass `--content-file` instead of
|
|
112
|
+
`--content`.
|
|
113
|
+
|
|
114
|
+
Market Size And Dynamics, Target Audience, Competitive Landscape, Value
|
|
115
|
+
Proposition, Pricing And Monetization, Acquisition Channels, Demand Validation,
|
|
116
|
+
and Unit Economics write cited research through their section runners. Organic
|
|
117
|
+
Trend Watch delegates provider work and analysis to the dedicated
|
|
118
|
+
`egbe-os-organic-trend-watch` skill while retaining this bundle's report ownership.
|
|
119
|
+
Keyword Economics writes its section and evidence file exclusively through
|
|
120
|
+
`scripts/run-keyword-economics.py`: the runner calls metered OS DataForSEO
|
|
121
|
+
tools, renders deterministic tables, caches every upstream response under
|
|
122
|
+
`egbe-docs/research/market/work/keyword_economics/`, and persists the report and evidence
|
|
123
|
+
in one verified publication. Its completion proof is the runtime state receipt
|
|
124
|
+
(`request.json` with result and evidence SHA-256 hashes); it has no LLM-based
|
|
125
|
+
Research Completion Review.
|
|
126
|
+
Competitor Set (catalog ID `competitor_set`, internal) follows the same
|
|
127
|
+
deterministic contract through `scripts/run-competitor-set.py`: inputs from
|
|
128
|
+
optional typed `egbe-docs/research/market/intake.json` or explicit CLI inputs
|
|
129
|
+
(the supplied offer and distinct founder-named/page-mentioned competitors),
|
|
130
|
+
candidate discovery from the offer via OS tools
|
|
131
|
+
(DataForSEO Google results, SpyFu keyword ad history) and OS search, then the
|
|
132
|
+
keyword overlap and SpyFu PPC competitors of the confirmed direct
|
|
133
|
+
competitors, an ad check (SpyFu domain stats, home-page ad pixels, the
|
|
134
|
+
official Meta Ad Library), the executing agent's listicle reading, profiles,
|
|
135
|
+
classification decisions and optional review recorded in
|
|
136
|
+
`egbe-docs/research/market/work/competitor_set/` (`listicles.json`, `profiles.json`,
|
|
137
|
+
`decisions.json`, `review.json`), cache and receipts in the same directory,
|
|
138
|
+
evidence at `egbe-docs/research/market/evidence/competitors.json`, one verified publication,
|
|
139
|
+
and no Research Completion Review. Until the files cover every domain the
|
|
140
|
+
runner asks for the receipt stays `pending`, never `completed`.
|
|
141
|
+
Channel Footprint (catalog ID `channel_footprint`, internal) follows the
|
|
142
|
+
same deterministic contract through `scripts/run-channel-footprint.py`:
|
|
143
|
+
tracking tags fetched from competitor pages and tag-manager containers,
|
|
144
|
+
ad-library presence via OS scrape actors and the official Meta Ad Library
|
|
145
|
+
endpoint, SpyFu's modeled Google Ads spend via OS tools, the public
|
|
146
|
+
traffic-source split, web search partner signals and Wayback Machine page
|
|
147
|
+
history, cache and receipts under
|
|
148
|
+
`egbe-docs/research/market/work/channel_footprint/`, evidence at
|
|
149
|
+
`egbe-docs/research/market/evidence/channel-footprint.json`, one verified publication, and
|
|
150
|
+
no Research Completion Review. Its v2 evidence preserves competitor tiers,
|
|
151
|
+
normalized advertisements, per-country observations, native delivery date
|
|
152
|
+
scope, sampling limits, coverage and effective shared policy with its hash.
|
|
153
|
+
The agent supplies hashed relevance decisions for the collected candidates;
|
|
154
|
+
missing decisions leave the attempt pending. Finalization validates these
|
|
155
|
+
decisions before materializing the report and evidence. Explicit unknown
|
|
156
|
+
relevance remains a limitation, never program-level proof. Pixel-only or
|
|
157
|
+
undated channels remain candidates independently of campaign proof.
|
|
158
|
+
It takes its competitor domains and tier provenance from the Competitor Set
|
|
159
|
+
and Keyword Economics evidence files like the Ads runner.
|
|
160
|
+
Creative Patterns (catalog ID `creative_patterns`, internal) follows
|
|
161
|
+
the same deterministic contract through `scripts/run-creative-patterns.py`:
|
|
162
|
+
a creative corpus from OS scrape actors, the official Meta Ad Library
|
|
163
|
+
endpoint and SpyFu ad history, classification through OS
|
|
164
|
+
`/v1/media/classify-creative` against `references/config/creative-taxonomy.v1.json`,
|
|
165
|
+
cache, the fixed cutoff (`as-of.json`) and receipts under
|
|
166
|
+
`egbe-docs/research/market/work/creative_patterns/`, evidence at
|
|
167
|
+
`egbe-docs/research/market/evidence/creative-patterns.json`, one verified publication, and
|
|
168
|
+
no Research Completion Review. When completed Channel Footprint v2 is
|
|
169
|
+
available, reuse its relevant ad corpus and per-country observations,
|
|
170
|
+
validate its receipt and shared policy, and retain member-level lineage in
|
|
171
|
+
creative and pattern evidence. A stale/pending v2 input is not silently
|
|
172
|
+
replaced by global scraping. Legacy standalone collection remains unscoped
|
|
173
|
+
and cannot acquire country-specific eligibility without the channel gate.
|
|
174
|
+
It takes its competitor domains from the Competitor Set and Keyword
|
|
175
|
+
Economics evidence files like the Ads runner.
|
|
176
|
+
Competitor Ads follows the same deterministic contract through
|
|
177
|
+
`scripts/run-competitor-ads.py`: ad-transparency data via OS scrape actors
|
|
178
|
+
plus the official Meta Ad Library endpoint, cache and receipts under
|
|
179
|
+
`egbe-docs/research/market/work/competitor_ads/`, evidence at
|
|
180
|
+
`egbe-docs/research/market/evidence/competitor-ads.json`, one verified publication, and no
|
|
181
|
+
Research Completion Review. It consumes the Competitor Set evidence file
|
|
182
|
+
(caller-classified competitors, in stable inspection order) and the Keyword Economics evidence file
|
|
183
|
+
(discovered competitor domains) as optional inputs, never the accumulated full
|
|
184
|
+
report.
|
|
185
|
+
Competitor Reviews follows the same contract through
|
|
186
|
+
`scripts/run-review-mining.py`: G2 and Trustpilot review pulls via OS scrape
|
|
187
|
+
actors, cache and receipts under `egbe-docs/research/market/work/review_mining/`,
|
|
188
|
+
evidence at `egbe-docs/research/market/evidence/review-mining.json`, one verified
|
|
189
|
+
publication, no Research Completion Review, and the same receipt-validated
|
|
190
|
+
Competitor Set and Keyword Economics domain inputs.
|
|
191
|
+
Communities Analysis (catalog ID `community_demand`) follows the same contract through
|
|
192
|
+
`scripts/run-community-demand.py`: Hacker News via the keyless Algolia
|
|
193
|
+
API, fresh Reddit via an OS scrape actor, and best-effort YouTube comments
|
|
194
|
+
via OS tools, cache and receipts under
|
|
195
|
+
`egbe-docs/research/market/work/community_demand/`, evidence at
|
|
196
|
+
`egbe-docs/research/market/evidence/community-demand.json`, one verified publication, no
|
|
197
|
+
Research Completion Review. Its queries come from `--seed-keywords` (seed-
|
|
198
|
+
derived category AND problem phrases, per its workflow) merged with the
|
|
199
|
+
receipt-validated Keyword Economics keyword rows when that section has
|
|
200
|
+
completed; `--product-context` mechanism tokens flag which quotes speak to
|
|
201
|
+
this product's mechanics rather than the bare category.
|
|
202
|
+
|
|
203
|
+
Funnel Teardown (catalog ID `funnel_teardown`, internal) publishes through
|
|
204
|
+
`scripts/run-funnel-teardown.py`. Its v2 inputs are the completed 03 country/channel
|
|
205
|
+
proof, completed 04 creative corpus and the shared
|
|
206
|
+
`egbe-docs/research/market/evidence/creative-selection.v1.json` manifest. The runner prepares
|
|
207
|
+
all distinct selected campaign destinations and finalizes local browser observations;
|
|
208
|
+
it does not replace missing ad destinations with competitor homepages. Verified ad
|
|
209
|
+
CTA/history enrichment has its own lineage and pinned runtime record. Country and
|
|
210
|
+
channel belong to the campaign; a geolocation or language redirect is an observed
|
|
211
|
+
mismatch, not new market proof.
|
|
212
|
+
|
|
213
|
+
The executing agent records phone-viewport screenshots and main/auxiliary branches
|
|
214
|
+
in `egbe-docs/research/market/work/funnel_teardown/walks.json`, following
|
|
215
|
+
`references/contracts/funnel-teardown.md` and the shared `walk-mechanics.v2.json`.
|
|
216
|
+
`research-context.json` records the explicit buyer persona and own-product URLs.
|
|
217
|
+
`approval-plan.json`, `approvals.json` and `submissions.json` bind exact forms/data to
|
|
218
|
+
human chat authorization and submission intent/outcome. New fields require a
|
|
219
|
+
supplement; an unknown submission outcome must be checked before retrying.
|
|
220
|
+
The shared private `egbe-docs/research/market/work/identity-registry.json` allocates stable aliases;
|
|
221
|
+
`lifecycle-handoff.json` transfers approved submissions to 02, whose funnel-mail mode
|
|
222
|
+
captures same-day confirmations/results without claiming lifecycle completion.
|
|
223
|
+
Public evidence redacts private contacts and email verification links.
|
|
224
|
+
|
|
225
|
+
The evidence at `egbe-docs/research/market/evidence/funnel-teardown.json` contains linked
|
|
226
|
+
campaign, landing, path, pattern and coverage rows plus screenshot references/hashes.
|
|
227
|
+
Its receipt pins upstream receipts/evidence, selection, policy, persona, enrichment,
|
|
228
|
+
walks, approval/submission journals, email events and assets. Pending approval/email,
|
|
229
|
+
budget checkpoints and uncertain submissions remain `pending`. Permitted account,
|
|
230
|
+
CAPTCHA, SMS, payment and live-call boundaries can be published with explicit unknown
|
|
231
|
+
downstream. Own-product paths never submit and never enter competitor proof/counts.
|
|
232
|
+
Legacy v1 walks remain diagnostic context and require fresh collection for proof.
|
|
233
|
+
Advertising duration, native activity and observed recurrence are separate
|
|
234
|
+
measurements; none establishes conversion, profitability or permission to copy.
|
|
235
|
+
|
|
236
|
+
Lifecycle Capture (catalog ID `lifecycle_capture`, internal) follows
|
|
237
|
+
the same deterministic contract through `scripts/run-lifecycle-capture.py`:
|
|
238
|
+
research subscriptions at the competitors with plus-addressed aliases of
|
|
239
|
+
the claw mailbox, selected from early reviewed public entry discovery and
|
|
240
|
+
completed by the assigned human with verified access to the planned aliases and
|
|
241
|
+
mailbox, recorded by the executing agent in
|
|
242
|
+
`egbe-docs/research/market/work/lifecycle_capture/subscriptions.json`, the inbox read
|
|
243
|
+
through the OS mail routes by alias and start date, cache and receipts under
|
|
244
|
+
`egbe-docs/research/market/work/lifecycle_capture/`,
|
|
245
|
+
evidence at `egbe-docs/research/market/evidence/lifecycle-capture.json`, one verified
|
|
246
|
+
publication, and no Research Completion Review. It takes its competitor domains
|
|
247
|
+
from the Competitor Set and Keyword Economics evidence files like the Ads
|
|
248
|
+
runner. Until every competitor is subscribed or skipped with a reason the
|
|
249
|
+
start receipt stays `pending`; already recorded subscriptions may be harvested
|
|
250
|
+
explicitly while others await the assigned human. Day-3 partial and day-14 full
|
|
251
|
+
windows retain publication status `completed`, with separate observation and
|
|
252
|
+
coverage metadata. Later harvests replace current evidence and preserve
|
|
253
|
+
immutable private snapshots. The
|
|
254
|
+
sign-up policy of its workflow and exact human-approved Funnel Teardown
|
|
255
|
+
forms are the permitted research submissions on competitor sites.
|
|
256
|
+
Read [the Lifecycle Capture contract](lifecycle-capture.md) for discovery,
|
|
257
|
+
stable mailbox-wide allocation and human signup milestones. The caller supplies
|
|
258
|
+
scheduling and bounded reminders; scheduler ids stay outside domain artifacts.
|
|
259
|
+
Ordinary message bodies and campaign material remain in the versioned cache,
|
|
260
|
+
not in public reports. Before its first cache write, the runner separates
|
|
261
|
+
access-bearing links and credentials into
|
|
262
|
+
`egbe-docs/research/market/.local/lifecycle_capture/mail-cache/` and stores a
|
|
263
|
+
sanitized response in `work/`. Analysis and resume use that portable response;
|
|
264
|
+
authorized confirmation actions may use the local original. Live credentials
|
|
265
|
+
are not transferable through Git, and public-report scrubbing is not a
|
|
266
|
+
substitute for this cache boundary.
|
|
267
|
+
|
|
268
|
+
Keyword Economics is optional for these three runners, and Competitor Set is
|
|
269
|
+
optional for the Ads and Reviews runners: absent, failed, incomplete or
|
|
270
|
+
invalid evidence is omitted, with a warning and the reason in their
|
|
271
|
+
`keyword-inputs.json` or `competitor-set-inputs.json`. Explicit
|
|
272
|
+
domains/queries still work. Without any usable inputs, the runner stops
|
|
273
|
+
rather than treating missing evidence as zero demand.
|
|
274
|
+
|
|
275
|
+
Fleet Benchmarks follows the same contract through
|
|
276
|
+
`scripts/run-fleet-prior.py`: past fleet experiments genuinely comparable
|
|
277
|
+
to this product via the OS GTM knowledge endpoint `POST /gtm/comparables`
|
|
278
|
+
(the whole verified/directional pool reviewed semantically by the OS-side
|
|
279
|
+
`gtm-comparables-judge` LLM — the judge runs in the gateway, never in the
|
|
280
|
+
runner), cache and receipts under `egbe-docs/research/market/work/fleet_prior/`,
|
|
281
|
+
evidence at `egbe-docs/research/market/evidence/fleet-prior.json`, one verified
|
|
282
|
+
publication, no Research Completion Review. Cross-niche aggregate channel
|
|
283
|
+
benchmarks and fleet-CPC-vs-auction comparisons are intentionally excluded
|
|
284
|
+
from this section; an empty comparable result is recorded as a coverage
|
|
285
|
+
fact about our own pool, never invented around, and a partial (bounded)
|
|
286
|
+
review that returned no match is refused rather than recorded as no-match.
|
|
287
|
+
|
|
288
|
+
Value Proposition, Pricing And Monetization, Acquisition Channels, and Demand
|
|
289
|
+
Validation, and Unit Economics may read only the completed supporting results
|
|
290
|
+
declared by their bundled runners. The shared deterministic loader validates
|
|
291
|
+
each section-keyed runtime receipt and file hashes, preserves the declared
|
|
292
|
+
order, omits missing or invalid results, and never reads this accumulated full
|
|
293
|
+
report as provider input.
|
|
294
|
+
|
|
295
|
+
The same receipt reader supplies bounded structured measurements to AI queries.
|
|
296
|
+
Keyword, ad, review and community observations retain locale, source hashes,
|
|
297
|
+
retrieval dates, contrary signals and omitted-row counts. Failed/skipped inputs
|
|
298
|
+
are explicit limitations. Without
|
|
299
|
+
a supplied selection, missing data is unknown, not evidence of absent demand.
|
|
300
|
+
`input-provenance.json` records these inputs. Changed measurements affect current
|
|
301
|
+
applicability; an explicitly authorized new study incorporates them into its new
|
|
302
|
+
query. Continuation retains the original query and inputs. No changed file launches
|
|
303
|
+
a paid rerun by itself. Fleet internals are not sent to external research.
|
|
304
|
+
The caller owns scheduling from its immutable execution order; the
|
|
305
|
+
bundle reports pending measurements without changing that order. Local selection
|
|
306
|
+
defers dependent work until selected measurements finish or are closed explicitly.
|
|
307
|
+
|
|
308
|
+
Organic Trend Watch uses
|
|
309
|
+
`egbe-docs/research/market/work/organic_trend_watch/context.json`, built only by
|
|
310
|
+
`scripts/build-organic-trend-context.py` for this PMR adapter. Its schema-version-1
|
|
311
|
+
manifest requires a scoped `assignment`, contains only explicitly selected
|
|
312
|
+
provider-safe context and may contain full validated
|
|
313
|
+
results for Target Audience, Competitive Landscape, Value Proposition, and
|
|
314
|
+
Acquisition Channels in that fixed order. Missing, skipped, failed, stale, or
|
|
315
|
+
tampered supporting results are omitted. The manifest records the relative
|
|
316
|
+
source path and SHA-256 for selected inputs and every included result; it never reads
|
|
317
|
+
the accumulated full report. The dedicated skill owns the manifest consumer,
|
|
318
|
+
provider runtime, analysis, `result.md`, and receipt contracts.
|
|
319
|
+
|
|
320
|
+
Before report materialization,
|
|
321
|
+
`scripts/finalize-organic-trend-watch.py` invokes the validator shipped in the
|
|
322
|
+
same downloaded `egbe-os-organic-trend-watch` bundle. Product Market Research does not
|
|
323
|
+
duplicate or reinterpret that receipt schema. Only after successful validation
|
|
324
|
+
does the finalizer upsert the exact runtime `result.md` under the canonical
|
|
325
|
+
Organic Trend Watch H2 and invoke the shared report persistence helper.
|
|
326
|
+
|
|
327
|
+
After report materialization and persistence succeed, the finalizer atomically
|
|
328
|
+
writes the PMR-owned
|
|
329
|
+
`egbe-docs/research/market/work/organic_trend_watch/integration-receipt.json`. This stable
|
|
330
|
+
boundary binds the opaque dedicated-skill receipt, exact `result.md`, exact
|
|
331
|
+
materialized report section, collection epoch and timestamps, coverage/status,
|
|
332
|
+
and local publication. It does not require or invent a Git commit SHA.
|
|
333
|
+
`partial` and `no_data` remain limited evidence, not completed coverage.
|
|
334
|
+
Downstream completion consumers validate this integration receipt
|
|
335
|
+
and the published section only; they must not duplicate provider,
|
|
336
|
+
normalization, media, or analysis rules owned by `egbe-os-organic-trend-watch`. A failed
|
|
337
|
+
validation, materialization, or persistence must not publish the integration
|
|
338
|
+
receipt.
|
|
339
|
+
|
|
340
|
+
## Preview Link
|
|
341
|
+
|
|
342
|
+
The preview links to `full-report.md` beside it by default; no instance ID or
|
|
343
|
+
Dashboard route is needed. Use `--local-report-link` only to override it with a
|
|
344
|
+
safe relative link or an explicit HTTP(S) report URL. The render receipt records
|
|
345
|
+
local materialization and file hashes, not remote publication or Git proof.
|
|
346
|
+
|
|
347
|
+
## Preview Assembly
|
|
348
|
+
|
|
349
|
+
Run `scripts/write-preview.py` to render the Preview and founder summary from
|
|
350
|
+
the validated synthesis and runtime context. The workflow owns semantic
|
|
351
|
+
synthesis; the writer owns Markdown structure, research coverage, the full
|
|
352
|
+
report link, length limits, and render hashes. When no successful section has
|
|
353
|
+
created the full report, the writer initializes only its canonical H1 so the
|
|
354
|
+
founder still receives an honest failure Preview. Never author the Preview or
|
|
355
|
+
chat summary independently.
|
|
356
|
+
|
|
357
|
+
## Persistence Boundary
|
|
358
|
+
|
|
359
|
+
Each completed section materializes and verifies its report and evidence in the
|
|
360
|
+
selected research folder. Runners do not commit or push: use the product's normal
|
|
361
|
+
Git workflow for both outputs and `work/`: scope, decisions, raw provider results,
|
|
362
|
+
paid job IDs, receipts and review state must survive handoff. Keep credentials
|
|
363
|
+
and process locks out of Git; report exports still exclude internal/private data.
|
|
364
|
+
No Git repository is required to collect research. Receipts record
|
|
365
|
+
`publication_mode: local` with no invented commit SHA.
|
|
366
|
+
AI publication proof remains in the section's `publication.json`; its accepted
|
|
367
|
+
completion review is still required. Preserve caches and receipts on retry.
|
|
368
|
+
|
|
369
|
+
The Competitor Set, Channel Footprint and Creative Patterns runners store each
|
|
370
|
+
provider cache entry gzip-compressed as `<digest>.json.gz` and read an older
|
|
371
|
+
plain `<digest>.json` as well, so earlier workspaces replay from their cache
|
|
372
|
+
with no new provider call. `python3 scripts/research-artifact-io.py --compact
|
|
373
|
+
"$WS"` compresses an existing workspace's entries of those sections and
|
|
374
|
+
hard-links byte-identical images named by their SHA-256 (cache images and
|
|
375
|
+
`egbe-docs/research/market/assets/`); nothing is re-fetched. Public evidence stays
|
|
376
|
+
plain JSON for every reader.
|
|
377
|
+
|
|
378
|
+
The Competitor Set, Channel Footprint, Creative Patterns, Funnel Teardown, Lifecycle Capture, Ads, Reviews, Communities and Fleet runners mark a new attempt `pending`
|
|
379
|
+
before input validation or collection, and `failed` on error. They retain cached
|
|
380
|
+
responses and collected files for retry, but only successful publication restores
|
|
381
|
+
`completed`; a previous result does not prove that the new attempt succeeded.
|
|
382
|
+
|
|
383
|
+
Recommendation and Preview writers follow the same publication boundary.
|
|
384
|
+
Preserve unrelated local changes. Do not create or modify
|
|
385
|
+
`egbe-docs/product/prd.md` from this skill.
|
|
386
|
+
|
|
387
|
+
Provider queries, job metadata, and completed temporary results under
|
|
388
|
+
`egbe-docs/research/market/work/` are portable execution state, not founder documents
|
|
389
|
+
or public exports. Each OS Research section runner owns its
|
|
390
|
+
section-keyed runtime state and reuses a completed matching result before
|
|
391
|
+
attempting report materialization again.
|
|
392
|
+
|
|
393
|
+
## Research Completion Review
|
|
394
|
+
|
|
395
|
+
After a OS Research runner succeeds, review the cached
|
|
396
|
+
`egbe-docs/research/market/work/<section-id>/result.md` before finishing the workflow. Review
|
|
397
|
+
only whether the research answer is physically cut off. Ignore the
|
|
398
|
+
final `### Sources` appendix added by the runner.
|
|
399
|
+
|
|
400
|
+
Record exactly one classification with
|
|
401
|
+
`scripts/review-research-completion.py`:
|
|
402
|
+
|
|
403
|
+
- `complete`: the answer ends at a normal semantic boundary;
|
|
404
|
+
- `uncertain`: the ending is abrupt or imperfect, but there is no direct proof
|
|
405
|
+
of a physical cutoff;
|
|
406
|
+
- `definitely_truncated`: the answer ends mid-word or mid-sentence; leaves an
|
|
407
|
+
open Markdown link, fence, table, or equivalent construct; ends with a
|
|
408
|
+
heading, list marker, or colon without its content; or starts an explicitly
|
|
409
|
+
bounded list and is cut off inside the current item.
|
|
410
|
+
|
|
411
|
+
Do not classify a response as definitely truncated merely because it is short,
|
|
412
|
+
misses a requested section, has weak evidence or sources, violates the desired
|
|
413
|
+
format, or ends abruptly after a grammatically complete statement. Those are
|
|
414
|
+
content or compliance problems, not proof of transport truncation. Use
|
|
415
|
+
`uncertain` when the physical cutoff cannot be proven; uncertainty never starts
|
|
416
|
+
another research submission.
|
|
417
|
+
|
|
418
|
+
For an accepted ending, run one of:
|
|
419
|
+
|
|
420
|
+
```bash
|
|
421
|
+
python <skill-root>/scripts/review-research-completion.py \
|
|
422
|
+
--workspace . \
|
|
423
|
+
--section-id <section-id> \
|
|
424
|
+
--classification complete
|
|
425
|
+
```
|
|
426
|
+
|
|
427
|
+
```bash
|
|
428
|
+
python <skill-root>/scripts/review-research-completion.py \
|
|
429
|
+
--workspace . \
|
|
430
|
+
--section-id <section-id> \
|
|
431
|
+
--classification uncertain
|
|
432
|
+
```
|
|
433
|
+
|
|
434
|
+
For definite truncation, supply a literal 12–500 character excerpt from the
|
|
435
|
+
last 2,000 characters of the provider answer, before the generated Sources
|
|
436
|
+
appendix. Write that excerpt as UTF-8 to
|
|
437
|
+
`egbe-docs/research/market/work/<section-id>/truncation-evidence.txt` with the normal file
|
|
438
|
+
editing tool; do not interpolate provider text into a shell argument. Then run:
|
|
439
|
+
|
|
440
|
+
```bash
|
|
441
|
+
python <skill-root>/scripts/review-research-completion.py \
|
|
442
|
+
--workspace . \
|
|
443
|
+
--section-id <section-id> \
|
|
444
|
+
--classification definitely_truncated \
|
|
445
|
+
--evidence-file egbe-docs/research/market/work/<section-id>/truncation-evidence.txt
|
|
446
|
+
```
|
|
447
|
+
|
|
448
|
+
On the first definite truncation, the helper archives the rejected job and
|
|
449
|
+
result, invalidates its completed cache, and authorizes one fresh request. Run
|
|
450
|
+
the same section runner once more, then review and record the replacement
|
|
451
|
+
ending. If the replacement is also definitely truncated, invoke the review
|
|
452
|
+
helper with its exact tail excerpt; it records retry exhaustion and fails. Do
|
|
453
|
+
not start a third request.
|
|
454
|
+
|
|
455
|
+
The review receipt is runtime state bound to the exact query, system prompt,
|
|
456
|
+
request, and result hashes. A missing or stale receipt, or a current
|
|
457
|
+
`definitely_truncated` decision, does not qualify as completed supporting
|
|
458
|
+
research. The helper enforces state integrity and retry count; it does not make
|
|
459
|
+
the classification for the agent.
|
|
460
|
+
|
|
461
|
+
|
|
462
|
+
## Public media for research consumers
|
|
463
|
+
|
|
464
|
+
Research consumers use current receipt-validated evidence and available public
|
|
465
|
+
media. Section 04 Creative Patterns owns creative extraction and its native
|
|
466
|
+
`publish_previews` output: public files under
|
|
467
|
+
`egbe-docs/research/market/assets/creative-patterns/` and evidence `media_assets` with
|
|
468
|
+
their hashes; a published preview is a hard link to its cached bytes when
|
|
469
|
+
both sit on one filesystem. These native files do not require a `public_exports` wrapper.
|
|
470
|
+
Publication covers the canonical top selection and every creative row a
|
|
471
|
+
consumer may cite: relevant, language-allowed, with its country
|
|
472
|
+
in the evidence `target_countries` and a known channel. When such a preview
|
|
473
|
+
cannot be copied, its asset is marked `publication_status: unavailable` and a
|
|
474
|
+
`preview_publication` `media_gap` coverage row names the creative ID.
|
|
475
|
+
Section 05 Funnel Teardown owns campaign-linked walks, screen content,
|
|
476
|
+
screenshots and their provenance; consume its published native evidence
|
|
477
|
+
and declared media when available. Richer sanitized JSON may optionally be
|
|
478
|
+
declared by an evidence document as `public_exports`:
|
|
479
|
+
|
|
480
|
+
```json
|
|
481
|
+
{
|
|
482
|
+
"public_exports": [
|
|
483
|
+
{"path": "egbe-docs/research/market/creative-media/export.json", "sha256": "<file SHA-256>", "kind": "creative_media"}
|
|
484
|
+
]
|
|
485
|
+
}
|
|
486
|
+
```
|
|
487
|
+
|
|
488
|
+
This is an optional consumer boundary, not an assertion that every producer
|
|
489
|
+
already emits this field and not a new collection algorithm. The owning
|
|
490
|
+
section prepares sanitized JSON and local assets. Consumers use available
|
|
491
|
+
native evidence/media and declared exports; missing extraction stays a visible
|
|
492
|
+
gap. Work needed to supply missing creative or funnel material belongs to
|
|
493
|
+
sections 04/05, not to a report presentation step.
|
|
494
|
+
Export paths are workspace-relative under `egbe-docs/`,
|
|
495
|
+
resolve within it and cannot point into `cache`, `caches`, `snapshots` or
|
|
496
|
+
private runtime. The exact JSON SHA-256 is bound through the evidence and
|
|
497
|
+
its completed receipt. Declare updated hashes when content changes.
|
|
498
|
+
|
|
499
|
+
An export object may contain `rows` (preserving each row's type), `creatives`
|
|
500
|
+
(default type `creative`), `funnels`/`walks` (`funnel_walk`), `sequences`
|
|
501
|
+
(`lifecycle_sequence`) and `gaps` (`extraction_gap`). Keep complete fields,
|
|
502
|
+
including stable IDs, full text, reasons/priority from the founder, channel,
|
|
503
|
+
competitor/domain, format/funnel type, target market or EU-proxy scope,
|
|
504
|
+
observation/verification status and source URLs (`link`, `landing_url`,
|
|
505
|
+
`address`). A funnel has an ordered `screens` array of full screen records,
|
|
506
|
+
with copy, screenshots and walk/source links. Local public media is declared
|
|
507
|
+
in `media` or `assets` as `{role, path, sha256}`. Convenient `image_path`,
|
|
508
|
+
`asset_path`, `preview_path`, `screenshot_path`, `keyframe_path` fields and
|
|
509
|
+
matching `*_sha256` may identify the corresponding media. Use public
|
|
510
|
+
workspace-relative paths with exact hashes; source URLs do not replace local
|
|
511
|
+
media dependencies.
|
|
512
|
+
|
|
513
|
+
Record extraction gaps explicitly with `domain`, `channel`, `status` and
|
|
514
|
+
`reason`/`detail`, or per-record `extraction_status` and `extraction_reason`.
|
|
515
|
+
Missing pictures/screens stay gaps; presentation must not invent replacements.
|
|
516
|
+
Keep lifecycle exports to sanitized public sequence observations and dates.
|
|
517
|
+
Never export mailbox addresses, aliases, raw email bodies, private signup
|
|
518
|
+
plans, credentials or snapshots. No runtime directory is copied wholesale
|
|
519
|
+
into a shared report or ZIP. Existing section collection and publication
|
|
520
|
+
ownership remains unchanged.
|
|
@@ -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
|
+
}
|