@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,300 @@
|
|
|
1
|
+
# Competitor Set
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md`. This section uses NO OS Research
|
|
4
|
+
job: the bundled deterministic runner discovers candidates from measured
|
|
5
|
+
sources, you enrich and tier them in four bounded files, and the runner
|
|
6
|
+
validates the files, checks who buys ads, composes the list and renders the
|
|
7
|
+
section plus a machine-readable evidence file. Do not write or edit section
|
|
8
|
+
prose, tables, or the evidence file by hand. The caller supplies the comparison scope and criteria. Choose this operation
|
|
9
|
+
when the assignment needs a sourced, bounded comparison sample.
|
|
10
|
+
|
|
11
|
+
Source the offer identity carefully: a product page can live on the domain of a
|
|
12
|
+
different product. Provider domain-wide traffic must not be attributed to a
|
|
13
|
+
seller or a small feature merely because they share a host.
|
|
14
|
+
|
|
15
|
+
## 1. Inputs
|
|
16
|
+
|
|
17
|
+
Use explicit CLI inputs or optional typed
|
|
18
|
+
`egbe-docs/research/market/intake.json` (`--intake` selects another path). The agent
|
|
19
|
+
can write or edit that JSON directly from the relevant evidence; there is no
|
|
20
|
+
required intake interview, separate offer file or prose-heading parser. Include
|
|
21
|
+
only fields useful to the assignment:
|
|
22
|
+
|
|
23
|
+
- the offer card: job (the pain it solves), buyer, offer class (what kind of
|
|
24
|
+
purchase it is) and the classes that count as comparable, duration, price
|
|
25
|
+
(`price_usd`, the cost to the result), the comparable price floor
|
|
26
|
+
(`price_floor_usd`, only when supplied; descriptive, not an eligibility gate) and 1-3
|
|
27
|
+
category phrases a buyer would search. Three is this adapter's paid-query
|
|
28
|
+
ceiling, not an evidence-sufficiency rule;
|
|
29
|
+
- `operator_named`: competitors the caller named (explicit scope: always
|
|
30
|
+
profiled, always kept in the final list, the only seeds of alternatives
|
|
31
|
+
queries);
|
|
32
|
+
- `page_mentioned`: competitors the product page mentions (comparison tables,
|
|
33
|
+
"vs" sections). They are ordinary candidates: no bonus, no default tier,
|
|
34
|
+
never a query seed;
|
|
35
|
+
- `product_domain` (excluded from the candidates, never a search seed),
|
|
36
|
+
`markets` (country codes, primary first), and explicit `languages` or
|
|
37
|
+
`market_languages` when needed by later selected operations;
|
|
38
|
+
- `ltv_usd`, with explicit `ltv_provenance` (`given`, `estimated` or `unknown`)
|
|
39
|
+
and `ltv_basis` when relevant. An absent source is unknown, not an estimate.
|
|
40
|
+
|
|
41
|
+
For example, a selected comparison can use:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"schema_version": 1,
|
|
46
|
+
"offer": {
|
|
47
|
+
"job": "Run remote workshops", "buyer": "Facilitators",
|
|
48
|
+
"offer_class": "Whiteboard software", "category_phrases": ["online whiteboard"],
|
|
49
|
+
"confirmed_by_operator": true, "basis": "Founder confirmed the current offer in this task."
|
|
50
|
+
},
|
|
51
|
+
"operator_named": [], "operator_named_asked": true,
|
|
52
|
+
"page_mentioned": ["comparison.example"],
|
|
53
|
+
"markets": ["US", "GB"], "languages": ["en"],
|
|
54
|
+
"market_languages": {"US": ["en", "es"]}
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
An empty named list with `operator_named_asked: true` means explicitly none;
|
|
59
|
+
omitted/false means unknown. Mark an offer `confirmed_by_operator` only from
|
|
60
|
+
actual confirmation, or `inferred: true` for an explicit inference, retaining
|
|
61
|
+
the supporting `basis`. Without a basis neither status is established. Do not
|
|
62
|
+
infer these labels from prose or invent an offer/amount to fill optional fields.
|
|
63
|
+
The validator checks supplied types and conflicts before any provider call.
|
|
64
|
+
|
|
65
|
+
Flags override the intake for manual runs: `--domains` (competitors named by the founder),
|
|
66
|
+
`--page-domains`, `--seed-keywords` (category phrases), `--price-floor-usd`,
|
|
67
|
+
`--product-domain`, `--country`. Domains from a completed Keyword Economics
|
|
68
|
+
section join as ordinary candidates. Without category phrases and without
|
|
69
|
+
competitors named by the founder the runner stops rather than inventing a market.
|
|
70
|
+
Pass `--context-file` only for relevant provider-safe background beyond these
|
|
71
|
+
inputs. The operation freezes effective inputs in `work/competitor_set/inputs.json`
|
|
72
|
+
before collection and records their hash. Resume uses the same input; changing
|
|
73
|
+
the question or collection inputs requires separately scoped work under another
|
|
74
|
+
research ID, not an automatic paid rerun. The local `--max-competitors` output
|
|
75
|
+
limit may change without recollecting. A clone retains the frozen inputs even
|
|
76
|
+
when an original external source path is unavailable.
|
|
77
|
+
|
|
78
|
+
## 2. Round 1: discovery from the offer
|
|
79
|
+
|
|
80
|
+
From the workspace root, resolve `<skill-root>` to the extracted directory
|
|
81
|
+
containing this skill's `SKILL.md`, then run:
|
|
82
|
+
|
|
83
|
+
```bash
|
|
84
|
+
python3 <skill-root>/scripts/run-competitor-set.py --workspace .
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
The runner needs `OS_API_KEY` (and optional `OS_URL`). It runs, each with its
|
|
88
|
+
own budget:
|
|
89
|
+
|
|
90
|
+
- Google results, paid and organic (DataForSEO `serp`), for every category
|
|
91
|
+
phrase and its "best" list: who pays for and ranks on the offer's own
|
|
92
|
+
search, and the listicle pages that compare such offers;
|
|
93
|
+
- SpyFu's keyword ad history for every category phrase: the domains that
|
|
94
|
+
bought Google ads on it within the last 12 months (older advertisers do not
|
|
95
|
+
count);
|
|
96
|
+
- Brave web search for the same queries as a second engine;
|
|
97
|
+
- "<brand> alternatives" for up to three competitors named by the founder.
|
|
98
|
+
|
|
99
|
+
There is no keyword-overlap or PPC lookup in this round: relationships come
|
|
100
|
+
from confirmed competitors in round 2. Review and listing directories are
|
|
101
|
+
recorded, never promoted; listicle pages are recorded for reading.
|
|
102
|
+
|
|
103
|
+
The run exits with code 2 and writes
|
|
104
|
+
`egbe-docs/research/market/work/competitor_set/candidates.json`: the pool with its
|
|
105
|
+
sources and signal strength, `profile_required.round1`, `listicles_to_read`
|
|
106
|
+
and `missing` (what the runner still needs). Each candidate carries up to
|
|
107
|
+
three `pages` where it ranked or advertised: start profiling there, because
|
|
108
|
+
a reseller's or a host's page shows what the domain really sells.
|
|
109
|
+
|
|
110
|
+
A seller's own subdomain on a course or creator host (thinkific.com,
|
|
111
|
+
teachable.com, kajabi.com, substack.com and the like) is a candidate of its
|
|
112
|
+
own, named by that subdomain, never the host. When the seller also has its
|
|
113
|
+
own site, profile that domain with `found_in` and fold the subdomain into it
|
|
114
|
+
with `same_as`. Such a subdomain is never a round-2 seed, and the ad check
|
|
115
|
+
does not read the host's Google spend as the seller's.
|
|
116
|
+
|
|
117
|
+
- The profiling list holds every named and page-mentioned competitor, then
|
|
118
|
+
every domain worth profiling, up to 25: the ones that pay on Google for the
|
|
119
|
+
offer's own search (paid results or SpyFu ad history) first, then the
|
|
120
|
+
strongest of the rest. Worth profiling means it ranks or pays on Google for
|
|
121
|
+
a category query, or shows up in two independent places
|
|
122
|
+
(two queries, two engines, an advertised phrase plus a listicle, two
|
|
123
|
+
listicle pages). A single second-engine result, a single advertised phrase
|
|
124
|
+
or a single listicle mention is a weak hit. Signals are counted per query
|
|
125
|
+
and engine, never per result row, so a site with many pages gets no extra
|
|
126
|
+
weight. A domain you decide `excluded` costs no profile and frees its place
|
|
127
|
+
for the next one, so rerun after excluding the obvious non-competitors.
|
|
128
|
+
- The reading list holds up to 12 listicle pages, "best" lists first, at most
|
|
129
|
+
two pages per site, never a site's own search results.
|
|
130
|
+
|
|
131
|
+
Candidates outside the profiling list are recorded with the reason they were
|
|
132
|
+
not profiled.
|
|
133
|
+
|
|
134
|
+
## 3. Enrich: listicles, profiles, decisions, review
|
|
135
|
+
|
|
136
|
+
Write four files next to `candidates.json`. Keep the work bounded: the pages
|
|
137
|
+
listed, up to three pages per profiled site (home, offer, pricing), the
|
|
138
|
+
profiling list, at most 5 domains of your own (a domain round 2 also
|
|
139
|
+
records is a discovery, even with `found_in`). Profile in parallel batches
|
|
140
|
+
when your environment can run sub-agents, and decide obvious non-competitors
|
|
141
|
+
(publishers, job boards, Q&A sites, cloud vendors without paid training)
|
|
142
|
+
`excluded` without a profile: that frees their place on the list. These file formats are needed only by this chosen collection adapter, not by every research assignment. Review is optional.
|
|
143
|
+
|
|
144
|
+
**`listicles.json`.** Read every page in `listicles_to_read` (and only those)
|
|
145
|
+
and record each program it lists:
|
|
146
|
+
|
|
147
|
+
```json
|
|
148
|
+
{"schema_version": 1, "read_on": "2026-10-06", "pages": [
|
|
149
|
+
{"url": "<address from listicles_to_read>", "status": "read", "entries": [
|
|
150
|
+
{"name": "Program or product", "domain": "seller.com", "offer": "...", "format": "...", "price_text": "...", "duration": "...", "audience": "..."}]},
|
|
151
|
+
{"url": "<address>", "status": "unreadable", "reason": "HTTP 404"}]}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
A listed domain no source recorded joins the pool with provenance
|
|
155
|
+
`agent_research` and the page as `found_in`; a domain on two or more pages
|
|
156
|
+
joins the profiling list on the next run.
|
|
157
|
+
|
|
158
|
+
**`profiles.json`.** Profile every domain on the profiling list, and any
|
|
159
|
+
other domain you want to propose, on its own site: what it sells for this
|
|
160
|
+
job, in which format, at which price, to whom, and whether it still sells:
|
|
161
|
+
|
|
162
|
+
```json
|
|
163
|
+
{"schema_version": 1, "profiled_on": "2026-10-06", "profiles": [
|
|
164
|
+
{"domain": "seller.com", "name": "Seller", "operating": true,
|
|
165
|
+
"offer": "Closest offer to ours", "offer_url": "https://seller.com/program",
|
|
166
|
+
"offer_class": "live online cohort", "offer_match": "same",
|
|
167
|
+
"price_text": "$2,200 one-time", "price_usd": 2200, "duration": "8 weeks",
|
|
168
|
+
"buyer": "...", "same_buyer": true, "job": "...", "same_job": true,
|
|
169
|
+
"marketplace": false, "focused": true, "main_business": "...", "markets": "US, EU",
|
|
170
|
+
"evidence_urls": ["https://seller.com/program", "https://seller.com/pricing"],
|
|
171
|
+
"found_in": null}]}
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
- `offer_match`: `same` (our offer class), `comparable` (one of the classes
|
|
175
|
+
the offer card lists as comparable), `different`, or `none` (nothing for
|
|
176
|
+
this job).
|
|
177
|
+
- `price_usd` is the cost to the result: a one-time price, or a subscription
|
|
178
|
+
times the time it takes to finish; `null` when the price is not public.
|
|
179
|
+
- `evidence_urls` are the pages you read (at least one).
|
|
180
|
+
- `focused: false` when the offer is a side line of a big multi-product
|
|
181
|
+
domain (a university, a large platform, a company that sells mostly
|
|
182
|
+
something else); such a domain is never a round-2 seed, and its ad check
|
|
183
|
+
counts only ads on the offer's own phrases. Leave it out or `true` when
|
|
184
|
+
the domain is mainly about offers like this one.
|
|
185
|
+
- `found_in` is required for a domain no source recorded: the page where you
|
|
186
|
+
found it (a listicle, a marketplace listing, a search result). These
|
|
187
|
+
additions carry provenance `agent_research`, never `operator_named`. Never
|
|
188
|
+
pass them with `--domains`.
|
|
189
|
+
- Marketplaces: a marketplace whose catalog for this job is offers of our
|
|
190
|
+
class for our buyer, and which buys traffic for them, is one competitor
|
|
191
|
+
(its domain), profiled like any other. A seller on it with its own site and
|
|
192
|
+
its own advertising is a separate candidate. That the product itself is
|
|
193
|
+
also sold there is never a reason to exclude it. A marketplace of a
|
|
194
|
+
different class (cheap self-paced video, for example) is profiled by its
|
|
195
|
+
typical offer.
|
|
196
|
+
|
|
197
|
+
**`decisions.json`** (schema version 2). One decision per profiled or listed
|
|
198
|
+
domain:
|
|
199
|
+
|
|
200
|
+
```json
|
|
201
|
+
{"schema_version": 2, "decided_on": "2026-10-06", "decisions": [
|
|
202
|
+
{"domain": "seller.com", "name": "Seller", "competitor_tier": "direct", "reason": "Same buyer, same job, same format and price band."},
|
|
203
|
+
{"domain": "library.example", "competitor_tier": "indirect", "reason": "Self-paced subscription for the same buyer."}]}
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
Use `direct`, `indirect`, `substitute` or `excluded` for the caller's
|
|
207
|
+
comparison roles and explain the role using sourced profile facts. No fixed
|
|
208
|
+
buyer/job/price formula overrides that judgment. Substitutes may be relevant
|
|
209
|
+
when the question asks about alternatives; low price is an observation, not an
|
|
210
|
+
automatic exclusion. Explicit exclusions need a reason; named domains still
|
|
211
|
+
need a profile so the exclusion is inspectable.
|
|
212
|
+
|
|
213
|
+
A second domain of the same offer (a redirect, an academy domain, a
|
|
214
|
+
university brand on a program a partner runs and sells elsewhere) is folded
|
|
215
|
+
into the canonical one with `"same_as": "canonical.com"` on an `excluded`
|
|
216
|
+
decision: its discovery facts, ads on the offer's phrases included, count for
|
|
217
|
+
the canonical domain, and one program never takes two places in the list.
|
|
218
|
+
|
|
219
|
+
**Optional `review.json`.** Record an additional review if it is useful for the
|
|
220
|
+
assignment. It does not gate the operation or require a separate agent. Retain
|
|
221
|
+
the checked domains, objections and resolutions when provided:
|
|
222
|
+
|
|
223
|
+
```json
|
|
224
|
+
{"schema_version": 1, "rounds": [
|
|
225
|
+
{"reviewer": "separate agent", "reviewed_on": "2026-10-06",
|
|
226
|
+
"discovery_round": 1, "checked": ["seller.com", "library.example"],
|
|
227
|
+
"objections": [{"domain": "library.example", "objection": "...", "resolution": "accepted", "note": "..."}],
|
|
228
|
+
"missing": [{"domain": "rival.com", "why": "...", "resolution": "added", "note": "..."}]}]}
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
Resolve every objection (`accepted` or `rejected`; a rejection needs a note)
|
|
232
|
+
and every missing rival (`added` means profiled and decided; `rejected` needs
|
|
233
|
+
a note), then rerun the same command.
|
|
234
|
+
|
|
235
|
+
## 4. Round 2: relationships of the confirmed direct competitors
|
|
236
|
+
|
|
237
|
+
When round 1 is complete, the runner takes up to three confirmed direct
|
|
238
|
+
competitors whose domain is focused on such offers (those named by the founder first,
|
|
239
|
+
then those that advertise on the offer's phrases), tops them up with comparable indirect ones when there are
|
|
240
|
+
fewer, and runs the DataForSEO keyword-overlap report and SpyFu's PPC
|
|
241
|
+
competitors for each. A stable-domain sample of new related domains forms
|
|
242
|
+
`profile_required.round2` (up to 10); single hits are eligible. Record sourced
|
|
243
|
+
profiles and decisions for the chosen sample, or explicit exclusions for
|
|
244
|
+
out-of-scope hits. There is no third automatic collection round and no mandatory
|
|
245
|
+
review gate.
|
|
246
|
+
|
|
247
|
+
## 5. Ad check, composition and publication
|
|
248
|
+
|
|
249
|
+
With everything decided, the runner checks every domain that can enter the
|
|
250
|
+
list (up to 25): the round-1 ad facts (Google ads on the offer's phrases,
|
|
251
|
+
paid results on its queries), SpyFu's modeled Google spend over six months in
|
|
252
|
+
the primary market and, when it shows none, up to two more target markets,
|
|
253
|
+
ad pixels on the home page (a free fetch) and, when nothing on Google shows,
|
|
254
|
+
the official Meta Ad Library for EU delivery. Each competitor gets
|
|
255
|
+
`ads_seen`, `pixels_only`, `unknown` (the lookups failed) or
|
|
256
|
+
`none_detected`. For an offer that is a side line of a multi-product domain
|
|
257
|
+
(`focused: false`) only the ads on the offer's own phrases count, and
|
|
258
|
+
without them the verdict is `unknown`: the domain's overall spend, pixels and
|
|
259
|
+
Meta ads promote the rest of its business. Channel Footprint measures the
|
|
260
|
+
channels in depth later; these observations do not choose the sample or a business priority.
|
|
261
|
+
|
|
262
|
+
The output preserves explicitly named scope, then takes a stable-domain sample
|
|
263
|
+
of caller-classified non-excluded candidates. Direct, indirect and substitute
|
|
264
|
+
roles remain visible. Ad activity, modeled spend and price do not determine
|
|
265
|
+
which business opportunity is best. The `rank` field records this
|
|
266
|
+
inspection order.
|
|
267
|
+
|
|
268
|
+
Up to `--max-competitors` (default 10); a shorter list stays short. The
|
|
269
|
+
runner then:
|
|
270
|
+
|
|
271
|
+
- writes evidence rows to `egbe-docs/research/market/evidence/competitors.json`:
|
|
272
|
+
every competitor with its provenance (`operator_named`, `product_page`,
|
|
273
|
+
`discovered`, `keyword_economics` or `agent_research` with the page),
|
|
274
|
+
offer, format, price against the floor, ad activity with its facts and why
|
|
275
|
+
it is in the list; every other candidate with the reason it is not;
|
|
276
|
+
- materializes the exact section under `## Competitor set` in
|
|
277
|
+
`egbe-docs/research/market/full-report.md`;
|
|
278
|
+
- verifies the report and evidence together; Git remains caller-owned;
|
|
279
|
+
- records the completed state receipt under
|
|
280
|
+
`egbe-docs/research/market/work/competitor_set/`, with the hashes of the intake and the
|
|
281
|
+
provided enrichment files.
|
|
282
|
+
|
|
283
|
+
Rerunning with the same files replays the cache and changes nothing.
|
|
284
|
+
|
|
285
|
+
## 6. Known limits and failure handling
|
|
286
|
+
|
|
287
|
+
Discovery covers the primary market; the ad check looks at up to two more
|
|
288
|
+
target markets. SpyFu covers Google search only, and the Meta check sees EU
|
|
289
|
+
delivery only: an advertiser that runs Meta outside the EU and no Google ads
|
|
290
|
+
shows as `pixels_only` at best. A provider failure on the core Google results
|
|
291
|
+
stops the attempt with the query that failed and the budget already spent;
|
|
292
|
+
rerunning continues from the cache. A query the provider rejects is cached
|
|
293
|
+
as unavailable and never retried unchanged; it is reported in
|
|
294
|
+
`rejected_calls`, apart from the answered calls in `provider_calls`. SpyFu,
|
|
295
|
+
Brave and the Meta check are best effort: an unavailable provider is
|
|
296
|
+
recorded and the run continues, but exhausting any per-attempt budget stops
|
|
297
|
+
the attempt so the next one resumes. When no discovery query answered at
|
|
298
|
+
all, the attempt stops `failed`: an unsearched market never becomes a
|
|
299
|
+
completed section. A `decisions.json` with schema version 1 is rejected: it
|
|
300
|
+
predates these rules, so profile and decide again.
|
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
# Creative Patterns
|
|
2
|
+
|
|
3
|
+
Internal competitor research section: what competitors advertise,
|
|
4
|
+
where, in which form, and which comparable selling messages they keep using.
|
|
5
|
+
Longevity, active delivery, variants and library reach show observed use; they do
|
|
6
|
+
not establish conversion performance. Use it when the bounded assignment needs
|
|
7
|
+
creative evidence; the user need not name its internal catalog ID.
|
|
8
|
+
|
|
9
|
+
## Inputs and collection
|
|
10
|
+
|
|
11
|
+
Use the completed Competitor Set and Channel Footprint, retaining competitor tiers,
|
|
12
|
+
observed channels, source ad IDs, relevance decisions, markets and evidence-policy
|
|
13
|
+
hashes. Relevance uses the optional typed offer and explicitly selected
|
|
14
|
+
provider-safe `--context-file` text frozen by the shared input helper, not an
|
|
15
|
+
automatic scan of project files. Accepted languages come from explicit flags or
|
|
16
|
+
typed `intake.json` fields `languages` and `market_languages`; no headings or
|
|
17
|
+
country names imply a language. `--languages` overrides the typed global list
|
|
18
|
+
and suppresses typed per-market overrides unless `--market-languages` is also
|
|
19
|
+
supplied. Otherwise explicit per-market flags override the typed mapping.
|
|
20
|
+
Native dates and activity keep their source scope; the runner does not classify
|
|
21
|
+
creative success from age or recent sightings.
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
python3 scripts/run-creative-patterns.py \
|
|
25
|
+
--workspace . \
|
|
26
|
+
--product-domain product.com
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
The runner needs `OS_API_KEY` and optionally `OS_URL`. Read its `--help` for
|
|
30
|
+
attempt limits, section limits, accepted-language and video-cap options. Reuse
|
|
31
|
+
compatible Channel Footprint observations first, then enrich them through the
|
|
32
|
+
source that supports each assigned channel.
|
|
33
|
+
Maintain explicit channel × competitor × market coverage, including channels
|
|
34
|
+
without a collector. `no_data`, unavailable media, unsupported source, unknown
|
|
35
|
+
format, sample limits and `budget_deferred` remain distinct outcomes. A tracking
|
|
36
|
+
tag or traffic estimate alone does not become an observed creative.
|
|
37
|
+
|
|
38
|
+
`--max-channels N` limits the deep work to the express scope: in each market,
|
|
39
|
+
a stable-name sample of N observed comparable channels per market. This is
|
|
40
|
+
an execution bound, not a recommendation. Other cells get a
|
|
41
|
+
`not_deepened` coverage row; the evidence records `deepened_cells`. 0 (the
|
|
42
|
+
default) deepens every cell.
|
|
43
|
+
|
|
44
|
+
Keep strict advertiser identity. Destination plus advertiser identity can verify
|
|
45
|
+
the competitor; third-party advertisers pointing to its site remain excluded and
|
|
46
|
+
reported. A legal-entity match needs the source's supported identity evidence.
|
|
47
|
+
Do not treat affiliate creatives as the competitor's direct advertising.
|
|
48
|
+
|
|
49
|
+
Each native ad ID is an independent creative. Repeated observations of that ID
|
|
50
|
+
retain provenance and market scope, while different IDs with identical copy or
|
|
51
|
+
different images remain separate. Dynamic/carousel assets retain their actual
|
|
52
|
+
cards, texts and media associations; never synthesize a cartesian set of variants.
|
|
53
|
+
Similar-copy and media relationships describe variations without merging ads or
|
|
54
|
+
borrowing the oldest variant's serving history.
|
|
55
|
+
|
|
56
|
+
Download available images and video immediately after collection. Signed URLs
|
|
57
|
+
may expire; content hashes and local cached files preserve evidence for retries.
|
|
58
|
+
Do not silently convert a media download failure into a successful visual analysis.
|
|
59
|
+
|
|
60
|
+
## Video and classification
|
|
61
|
+
|
|
62
|
+
YouTube creatives resolve the native video ID from the Transparency creative
|
|
63
|
+
page when possible, then use YouTube metadata and available captions. Meta video
|
|
64
|
+
files can supply preview frames and extracted audio. Detailed analysis defaults
|
|
65
|
+
to five unique videos per competitor in each channel × market, with a configurable
|
|
66
|
+
cap. The cap limits detailed video analysis, not the number of collected ads.
|
|
67
|
+
|
|
68
|
+
Use captions first and OS `/v1/media/transcribe` for uncaptained speech when that
|
|
69
|
+
capability is configured. Supply extracted audio bytes and their hash; do not
|
|
70
|
+
send an arbitrary remote URL to the transcription endpoint. Send frames and
|
|
71
|
+
available transcript to `/v1/media/analyze`. Record the opening hook, visible
|
|
72
|
+
text, visible speaker treatment, visual approach and their frame/transcript
|
|
73
|
+
references. Missing captions, speech capability, video files or frames remain
|
|
74
|
+
explicit gaps. Official EU Meta rows with no assets can support their observed
|
|
75
|
+
text and scoped reach, not a visual format inferred from another market's ad.
|
|
76
|
+
|
|
77
|
+
Restore native text, legible OCR and available speech before judging relevance.
|
|
78
|
+
Relevance compares buyer, job and offer with the researched product; a shared
|
|
79
|
+
brand or keyword is insufficient. Unknown means unresolved, not irrelevant.
|
|
80
|
+
Retain previously grounded Footprint decisions; a grounded new disagreement
|
|
81
|
+
keeps both decisions and the supporting excerpt. Foreign-language exclusions
|
|
82
|
+
follow the intake policy for that ad's market.
|
|
83
|
+
|
|
84
|
+
Classify every relevant ad in the collected sample within the section budget;
|
|
85
|
+
there is no twelve-ad competitor/platform cap. The bounded collection interleaves observed groups before deepening one
|
|
86
|
+
large group; this is coverage sampling, not a recommendation ranking. Unknown relevance can be resolved through classification but does
|
|
87
|
+
not enter relevant tops or convergence until resolved. Unknown format remains
|
|
88
|
+
unknown. A missing URL does not establish a landing type or conversion path.
|
|
89
|
+
|
|
90
|
+
`POST /v1/media/classify-creative` retains `creative-taxonomy.v1` and adds optional
|
|
91
|
+
`semantic_context` under `creative-semantics.v1`. The generic taxonomy stays
|
|
92
|
+
category-independent. `scripts/creative-semantics.py` builds and validates the
|
|
93
|
+
full context and accepted languages. Compatible cutoffs reuse a frozen base
|
|
94
|
+
context; validated cached and earlier-batch meanings anchor subsequent requests.
|
|
95
|
+
The per-ad cache binds that base, market-language policy and full source/media
|
|
96
|
+
hashes; each batch receipt additionally binds its actual request-anchor hash. The classifier returns full available verbatim
|
|
97
|
+
`observed_text` with extraction provenance and category semantics:
|
|
98
|
+
|
|
99
|
+
- relevance and language with supporting ad excerpts;
|
|
100
|
+
- category angles on buyer/context, job, mechanism, outcome, proof, price/terms
|
|
101
|
+
and action, with concrete meanings drawn from the offer and competitor text;
|
|
102
|
+
- a canonical message-family meaning with buyer, job, offer/mechanism, outcome
|
|
103
|
+
and conversion details, plus a verbatim example.
|
|
104
|
+
|
|
105
|
+
Reuse known canonical meanings across batches only when they match. The helper
|
|
106
|
+
freezes angle/family IDs and dictionary hashes from validated observations,
|
|
107
|
+
retains their supporting ad IDs, and reports unclassified IDs as incomplete
|
|
108
|
+
dictionary discovery. Families group selling meaning, not exact headline text.
|
|
109
|
+
Generic labels such as “desired outcome” do not constitute a semantic family.
|
|
110
|
+
Different offers, guarantees, audiences or conversion paths remain distinguishable.
|
|
111
|
+
Stack names, cohorts and course duration are possible category data, not universal
|
|
112
|
+
requirements. SaaS and consumer-product categories use the same contract.
|
|
113
|
+
|
|
114
|
+
## Evidence, patterns and report
|
|
115
|
+
|
|
116
|
+
Retain native duration, source scope and date basis. Capture/listing history
|
|
117
|
+
is not serving duration; missing activity is not stopped activity. Compute
|
|
118
|
+
patterns within market, channel, creative type and format. Counts describe
|
|
119
|
+
distinct observed competitors, not successful campaigns; preserve direct/indirect
|
|
120
|
+
roles, relevance, language and source-member lineage. Active/stopped/unknown
|
|
121
|
+
statuses describe provider observations and do not predict performance.
|
|
122
|
+
|
|
123
|
+
The report has two views:
|
|
124
|
+
|
|
125
|
+
1. Market → channel → creative type → competitor, up to three examples in each
|
|
126
|
+
cell. Show complete available ad text, image or video preview, confirmed age
|
|
127
|
+
and its basis, running status, library link, market scope and media gaps.
|
|
128
|
+
Types are text, static image and video; carousel/dynamic format stays noted
|
|
129
|
+
within static image when supported by source evidence. Unknown format/type
|
|
130
|
+
stays visible. Same-text ads with different images can occupy separate slots.
|
|
131
|
+
2. Patterns by channel, type and format within each market, including description,
|
|
132
|
+
semantic families, angles, observed recurrence, dated competitors and concrete ads.
|
|
133
|
+
A top channel with no extractable creatives states the reason explicitly.
|
|
134
|
+
|
|
135
|
+
The published inspection sample uses stable creative IDs within each cell;
|
|
136
|
+
it does not select winners from age, variants or source availability. Compare
|
|
137
|
+
reach only within compatible market/source scope when the assignment calls for it.
|
|
138
|
+
|
|
139
|
+
Show all observed prices, financing, discounts, guarantees and outcome/salary
|
|
140
|
+
promises per competitor, using whole sentences and source links. Preserve the
|
|
141
|
+
original image alongside OCR text where applicable. Label competitor promises
|
|
142
|
+
as information, not verified claims that a proposed campaign may repeat.
|
|
143
|
+
UI limits may paginate or expand details but must not discard promises silently.
|
|
144
|
+
|
|
145
|
+
Keep observed landing URLs. Funnel Teardown may later add a validated conversion
|
|
146
|
+
path (webinar, quiz, call, checkout, etc.); this section does not launch section 05.
|
|
147
|
+
The evidence index and downstream consumers retain creative/classification pairs, market scope,
|
|
148
|
+
dictionary meanings and exact `source_ad_ref` lineage. Verify actual Meta and
|
|
149
|
+
YouTube references through the consumers, not only platform-name presence.
|
|
150
|
+
|
|
151
|
+
## Cache, budgets and completion
|
|
152
|
+
|
|
153
|
+
The first attempt fixes the cutoff in `as-of.json`. Retries replay that cutoff's
|
|
154
|
+
raw provider responses and shared content cache; `--refresh` starts a new cutoff
|
|
155
|
+
after completion. Snapshots retain native identity and observation provenance.
|
|
156
|
+
Compatible source responses can survive changes to semantic policy, while
|
|
157
|
+
derived labels depend on full offer context, accepted languages, taxonomy,
|
|
158
|
+
semantic context/dictionary, policy and media hashes.
|
|
159
|
+
|
|
160
|
+
Detailed video analysis defaults to five unique videos per competitor/channel/
|
|
161
|
+
market. The cumulative ceiling defaults to 240 paid starts; classification and
|
|
162
|
+
media-call attempt limits default to 40 and 100. These are resource counts, not
|
|
163
|
+
a monetary estimate; actual provider tariffs determine cost. The rich semantic
|
|
164
|
+
classifier batches up to four ads and separates long text/speech into smaller
|
|
165
|
+
requests. Public input text bounds remain explicit coverage gaps when exceeded;
|
|
166
|
+
complete native text stays in the corpus and report.
|
|
167
|
+
|
|
168
|
+
Separate per-attempt limits from a persisted cumulative section ceiling. On a
|
|
169
|
+
ceiling, save the partial result, consumed resources and remaining tasks as
|
|
170
|
+
`budget_deferred`; a rerun cannot reset cumulative spend. Downloaded assets,
|
|
171
|
+
classification answers and unique video analyses are cached by their content.
|
|
172
|
+
Account refusals, exhausted upstream budgets and unavailable required endpoints
|
|
173
|
+
stop dependent paid calls; invalid batch answers get bounded retries and a
|
|
174
|
+
visible gap. Cached replays incur no new charge.
|
|
175
|
+
|
|
176
|
+
Legacy merged evidence cannot recover vanished visual variants. Rebuild from
|
|
177
|
+
compatible raw provider caches where available; otherwise mark legacy coverage
|
|
178
|
+
explicitly and collect missing raw evidence within budget. Do not relabel the
|
|
179
|
+
single merged row as a recovered set of independent ads.
|
|
180
|
+
|
|
181
|
+
On completion, the runner writes evidence to
|
|
182
|
+
`egbe-docs/research/market/evidence/creative-patterns.json`, materializes
|
|
183
|
+
`## Creative patterns` in `egbe-docs/research/market/full-report.md`, and records the receipt
|
|
184
|
+
under `egbe-docs/research/market/work/creative_patterns/`. Materialization verifies
|
|
185
|
+
local files; the caller owns their normal Git workflow. Hash-verified
|
|
186
|
+
previews are copied to `egbe-docs/research/market/assets/creative-patterns/` and
|
|
187
|
+
published with the Markdown; report refs resolve inside the project repository.
|
|
188
|
+
Partial
|
|
189
|
+
evidence remains distinguishable from complete coverage of the collected sample.
|
|
190
|
+
|
|
191
|
+
Preview publication covers two sets of creative rows:
|
|
192
|
+
|
|
193
|
+
1. The canonical top selection below, which the report shows.
|
|
194
|
+
2. Every citable original creative row, selected or not: it is
|
|
195
|
+
relevant, its language is allowed (`language_status: allowed` and
|
|
196
|
+
`language_allowed: true`), and it
|
|
197
|
+
belongs to a researched market × channel cell (its country is one of the
|
|
198
|
+
evidence `target_countries` and its channel is known).
|
|
199
|
+
`creative-selection.py` `citable()` owns this rule, so a cited original
|
|
200
|
+
never stays under the private runtime cache.
|
|
201
|
+
|
|
202
|
+
Each row publishes its image or video-preview assets, or else its first key
|
|
203
|
+
frame. The copy uses the same checks for both sets: the source must be inside
|
|
204
|
+
the workspace, 5 MiB or less, and match its recorded hash, and its bytes must
|
|
205
|
+
be JPEG, PNG or WebP. The file is named by its SHA-256. The evidence asset
|
|
206
|
+
then points at the `egbe-docs/` asset path and keeps the cache path as `source_path`.
|
|
207
|
+
A failed copy marks the asset `publication_status: unavailable` and adds a
|
|
208
|
+
`preview_publication` `media_gap` coverage row with the creative ID; the
|
|
209
|
+
section is then partial. Only collected public ad-library media is copied.
|
|
210
|
+
Rows outside both sets, such as irrelevant,
|
|
211
|
+
excluded-language or out-of-market rows, keep their cache paths. Rows are visited in evidence order and files are
|
|
212
|
+
content-addressed, so a replay produces the same evidence bytes.
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
## Published inspection sample for Funnel Teardown
|
|
216
|
+
|
|
217
|
+
The canonical selector in `scripts/creative-selection.py` owns the existing
|
|
218
|
+
three-example resource-bounded inspection sample and stable ID order. The report and
|
|
219
|
+
preview publication use that same choice; publication also covers the
|
|
220
|
+
citable rows described above. The runner publishes
|
|
221
|
+
`egbe-docs/research/market/evidence/creative-selection.v1.json` and embeds the same
|
|
222
|
+
manifest in evidence v2 as `selection`. Its cells and flattened
|
|
223
|
+
`selected_creatives` preserve market/channel/type/competitor, rank, landing
|
|
224
|
+
URL and source ad lineage. Source hashes pin the corpus, classifications,
|
|
225
|
+
angle dictionary, policy, input scope and completed competitor/channel files.
|
|
226
|
+
Both the evidence inputs and receipt pin its path and byte hash. Downstream
|
|
227
|
+
Funnel Teardown consumes these concrete selected IDs; it does not reconstruct
|
|
228
|
+
the choice from Markdown or introduce another ranking.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Demand validation
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md` and `../prompts/demand-validation.md`
|
|
4
|
+
for evidence checks and output mechanics. The current assignment, not the
|
|
5
|
+
bundled topic brief, defines the question and depth.
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
python <skill-root>/scripts/run-demand-validation.py --workspace . \
|
|
9
|
+
--assignment "The bounded question, scope and comparison criteria from the current task"
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Use `--assignment-file` for existing task text when convenient; no new format
|
|
13
|
+
is required. The runner keeps provider-safe product context and includes only
|
|
14
|
+
valid completed supporting results/measurements. Missing optional inputs are
|
|
15
|
+
limitations, not reasons to collect unrequested sections. A selected unfinished
|
|
16
|
+
measurement used by this section must finish or be closed before it can be cited.
|
|
17
|
+
|
|
18
|
+
The actual assignment, query, system prompt, job state and result live under
|
|
19
|
+
`egbe-docs/research/<id>/work/demand_validation/`. The result materializes under
|
|
20
|
+
`## Demand validation` in the existing incremental report. Retrying unchanged inputs
|
|
21
|
+
resumes/reuses the job before publication; changed inputs preserve that work
|
|
22
|
+
and require a separate research ID, not a silent new provider call.
|
|
23
|
+
|
|
24
|
+
After success, complete the shared Research Completion Review for
|
|
25
|
+
`demand_validation`. Preserve failed/uncertain state; do not replace a provider response
|
|
26
|
+
with invented output. The caller owns Git publication and may continue the
|
|
27
|
+
surrounding task when this operation finishes.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Fleet Benchmarks
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md`. This section uses NO OS Research
|
|
4
|
+
job and no free-form web research: the bundled deterministic runner asks one
|
|
5
|
+
OS GTM knowledge endpoint — `POST /gtm/comparables` — for the fleet's own
|
|
6
|
+
past experiments that are genuinely comparable to THIS product, and renders
|
|
7
|
+
the section body plus a machine-readable evidence file itself. On the OS
|
|
8
|
+
side the whole verified/directional pool (PII-redacted at the source) is
|
|
9
|
+
reviewed by a server-side LLM judge (`gtm-comparables-judge` role) that
|
|
10
|
+
matches semantically — differently-worded launches still match, keyword
|
|
11
|
+
overlap alone does not. Do not write or edit section prose, tables, or the
|
|
12
|
+
evidence file by hand.
|
|
13
|
+
|
|
14
|
+
The section deliberately contains ONLY comparable experiments. Aggregate
|
|
15
|
+
cross-niche channel benchmarks (`GET /gtm/benchmarks`) and fleet-CPC-vs-
|
|
16
|
+
auction comparisons were removed from it: pooled all-niche medians say
|
|
17
|
+
nothing about the product under research and invite wrong conclusions. When
|
|
18
|
+
no comparable experiment exists, the section states that explicitly as a
|
|
19
|
+
coverage fact about our own pool — never as evidence against the idea.
|
|
20
|
+
|
|
21
|
+
## 1. Inputs
|
|
22
|
+
|
|
23
|
+
- `--seed-keywords "phrase one, phrase two"` — up to 5 category or problem
|
|
24
|
+
phrases selected from the assignment and relevant evidence (lowercase, no
|
|
25
|
+
boolean operators or own-product brand names). They are
|
|
26
|
+
the product context the judge matches experiments against.
|
|
27
|
+
- `--geo "US"` — optional launch geography, passed to the judge as context
|
|
28
|
+
(not a hard filter: an otherwise comparable experiment from another geo
|
|
29
|
+
is kept, with the mismatch noted); pass the geography supplied for this question.
|
|
30
|
+
|
|
31
|
+
## 2. Run the deterministic runner
|
|
32
|
+
|
|
33
|
+
From the workspace root, resolve `<skill-root>` to the extracted directory
|
|
34
|
+
containing this skill's `SKILL.md`, then run:
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
python3 <skill-root>/scripts/run-fleet-prior.py --workspace . \
|
|
38
|
+
--seed-keywords "<category phrase>, <problem phrase>"
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment.
|
|
42
|
+
It requests the judged comparable experiments and:
|
|
43
|
+
|
|
44
|
+
- writes fleet_case and coverage rows to
|
|
45
|
+
`egbe-docs/research/market/evidence/fleet-prior.json`;
|
|
46
|
+
- materializes the exact section under `## Fleet benchmarks` in
|
|
47
|
+
`egbe-docs/research/market/full-report.md`;
|
|
48
|
+
- verifies the report and evidence together; Git remains caller-owned;
|
|
49
|
+
- records the completed state receipt under
|
|
50
|
+
`egbe-docs/research/market/work/fleet_prior/`.
|
|
51
|
+
|
|
52
|
+
The judge call runs inside the OS gateway and is billed to the claw's own
|
|
53
|
+
LLM key; the runner itself calls no LLM. Every response is cached in the
|
|
54
|
+
runtime directory, so re-running the same command replays cached data with
|
|
55
|
+
zero new reads.
|
|
56
|
+
|
|
57
|
+
## 3. Known limits and failure handling
|
|
58
|
+
|
|
59
|
+
The fleet prior is evidence of what WE measured — biased toward the niches
|
|
60
|
+
and budgets the fleet has tried. Small-n results are directional. An empty
|
|
61
|
+
comparable-experiment result is a coverage fact about our own pool, never
|
|
62
|
+
evidence against the idea, and the section says so explicitly. The judge is
|
|
63
|
+
instructed to be conservative (exclude when unsure) and the runner never
|
|
64
|
+
invents fleet records: only record ids that exist in the pool can be
|
|
65
|
+
returned. Large pools are judged in bounded chunks server-side; if the
|
|
66
|
+
review was partial (the judge did not see the whole pool) and returned no
|
|
67
|
+
match, the runner refuses to record a no-match conclusion and stops — rerun
|
|
68
|
+
later. A partial review that did return matches renders them and names the
|
|
69
|
+
gap explicitly.
|
|
70
|
+
|
|
71
|
+
If the runner reports no seed terms, supply `--seed-keywords` from the assignment
|
|
72
|
+
and relevant evidence. If no suitable category or problem phrase is known,
|
|
73
|
+
record the section as could-not-complete with that reason.
|
|
74
|
+
For any other failure (including an unconfigured judge model or an
|
|
75
|
+
unavailable LLM upstream), preserve the runtime state and stop; a later
|
|
76
|
+
attempt resumes from cache. Do not substitute web search, generic OS
|
|
77
|
+
Research, `POST /gtm/search`, or an agent-written result, and do not edit
|
|
78
|
+
`egbe-docs/research/market/full-report.md` or the evidence file manually. Completion is
|
|
79
|
+
validated deterministically from the runtime receipt; this section has no
|
|
80
|
+
LLM-based Research Completion Review step.
|