--- name: cdp-edge description: > CDP Edge — Sistema multi-agente para Quantum Tracking. Arquitetura Cloudflare Native (Workers + D1). Gera tracking para Meta (CAPI v25.0), TikTok (API v1.3), GA4 (MP) e Spotify (v1). **Human-Behavior Engine**: Captura rage clicks, tab focus, heatmaps (D1) e pulse heartbeat nativamente. **Niche AI**: Detecção automática de cenários (Imobiliário, Vendas, SaaS) para injeção estratégica. Possui agentes especialistas para análise de página, arquitetura de servidor e validação rigorosa. Use SEMPRE que o usuário pedir: pixel, tracking, CAPI, Cloudflare, rastrear conversão, "configura meu servidor", "v25.0" ou "rastreamento nativo". --- # CDP Edge — Quantum Tracking O CDP Edge é um sistema de rastreamento focado em **atribuição direta** no ecossistema Cloudflare. > ⚠️ **STATUS DA SKILL**: 8/8 modelos são Quantum (100%) > - ✅ `captura-de-lead.md` — Quantum Tier > - ✅ `captura-lead-evento-externo.md` — Quantum Tier > - ✅ `checkout-proprio.md` — Quantum Tier > - ✅ `pagina-obrigado.md` — Quantum Tier > - ✅ `quiz-funnel.md` — Quantum Tier > - ✅ `webinar-registration.md` — Quantum Tier > - ✅ `multi-step-checkout.md` — **Quantum Tier** (Server-Side Completo) > - ✅ `trafego-direto.md` — **Quantum Tracking** --- ## 🏗️ ARQUITETURA QUANTUM ```mermaid graph TD A[Browser: cdpTrack SDK] -->|Fetch API| B[Cloudflare Workers] B -->|Persistência| C[Cloudflare D1 Database] B -->|CAPI v25.0| D[Meta API] B -->|v1.3| E[TikTok API] B -->|MP| F[GA4 Collect] ``` **Agentes Especialistas:** - **Master Orchestrator**: Comandante que gerencia o fluxo de trabalho. - **Page Analyzer (Deep Explorer)**: Identifica botões e formulários no código-fonte. - **Meta Agent**: Especialista em Meta Pixel e Conversions API (CAPI). - **Google Agent**: Especialista em GA4, Google Ads e Measurement Protocol. - **TikTok Agent**: Especialista em TikTok Pixel e Events API. - **Spotify Agent**: Especialista em Spotify Ad Studio e Conversions API. - **Server Tracking (Cloudflare Architect)**: Gere Workers, D1, R2 e Queues. - **Validator Agent**: Auditor supremo que garante a conformidade do código. - **Dashboard Agent**: Sincronização de métricas Meta Ads + D1. **Localizar agentes:** ``` Glob: **/tracking-events-generator/agents/*.md ``` Cada arquivo `.md` nessa pasta é o prompt completo de um agente especialista. --- ## COMANDOS DISPONÍVEIS ### /setup — Configuração completa (fluxo principal) **Ler o Master Orchestrator antes de iniciar:** ``` Read: {SKILL_BASE}/agents/master-orchestrator.md ``` Seguir o fluxo definido nesse arquivo. Ele define todas as fases: perguntas, análise, geração, validação e entrega. **Resumo do fluxo /setup:** 1. `AskUserQuestion` — 3 perguntas: plataformas, tipo de produto, infraestrutura 2. `request_cowork_directory` — acesso à pasta do projeto 3. Spawnar **Page Analyzer (Deep Explorer)** → mapeia eventos em todos os arquivos 4. Spawnar em paralelo: **Meta Agent**, **Google Agent**, **TikTok Agent** (conforme plataforma) 5. Se server-side selecionado: spawnar **Server Tracking (Cloudflare Architect)** 6. Spawnar **Validator Agent (Auditor Supreme)** → audita todos os outputs, corrige erros 7. Entregar resultado consolidado ao usuário ### /analyze — Só analisar páginas (sem gerar código) ``` 1. request_cowork_directory 2. Spawnar225. 🔎 **Page Analyzer Agent** → Detecta Nicho (Fase 0), mapeia elementos e sugere micro-eventos. 226. 🧠 **Premium Tracking Intelligence Agent** → Define estratégia de tracking (events, micro-events, behavioral signals). 227. ⚡ **Browser Tracking Agent** → Gera cdpTrack.js + **Behavior Engine** (scroll, rage click, heatmap). 3. Retornar mapa de eventos em formato legível (não JSON bruto) ``` ### /validate — Auditar tracking existente ``` 1. Pedir ao usuário que cole o código atual 2. Spawnar Validator Agent com esse código 3. Retornar relatório: o que está correto, o que está errado, o que falta ``` ### /server — Só configurar server-side ``` 1. AskUserQuestion: infraestrutura (Cloudflare Workers), integrações externas 2. Spawnar **Server Tracking (Cloudflare Architect)** 3. Spawnar **Validator Agent (Auditor Supreme)** 4. Entregar configuração completa ``` ### /infra — Guia de setup de infraestrutura ``` 1. Ler docs/guia-cloudflare-iniciante.md 2. Entregar guia linear passo a passo (do zero ao deploy) Cobre: conta Cloudflare → Wrangler → D1 → worker.js → secrets → D1 Match → deploy → webhook compra → WhatsApp → domínio ``` --- ## 🛰️ AGENTES ESPECIALISTAS 1. **Master Orchestrator**: O comandante que gerencia o fluxo de trabalho. 2. **Deep Explorer (Page Analyzer)**: Lê o código-fonte e identifica botões/formulários. 3. **Cloudflare Architect (Server Agent)**: Gera o código para Workers e esquemas D1. 4. **Validator**: Audita os arquivos e garante a conformidade do código. 5. **Spotify Agent**: Gera código Spotify Pixel + Conversions API. --- ## 🏗️ REQUISITOS TÉCNICOS (QUANTUM) - **Browser/Worker**: Rastreamento executado em JavaScript puro e Cloudflare Workers. - **Persistência**: Leads e vendas armazenados no **D1 Database**. - **Segurança**: Hashing WebCrypto (SHA256) na borda. --- ## 📋 COMANDOS ### /setup — Configuração Quantum Inicia o fluxo de perguntas, análise de projeto e geração de infraestrutura Cloudflare. ### /server — Gerar Worker v25.0 Gera apenas o código do `worker.js` com suporte a Meta CAPI e TikTok API v1.3. --- ## 📚 BASE DE CONHECIMENTO Consulte `knowledge-base.md` para padrões técnicos de Hashing, Deduplicação e Esquemas de Banco de Dados. ## 📁 MODELOS TÉCNICOS Localizados em `models/`: | Modelo | Status | Descrição | |--------|---------|-----------| | `captura-de-lead.md` | ✅ Quantum | Formulários de captura de leads (email/telefone) | | `captura-lead-evento-externo.md` | ✅ Quantum Tier | Formulário + webhook de compra (Hotmart/Kiwify/Eduzz/Ticto) | | `trafego-direto.md` | ✅ Quantum Tier | Página de vendas sem formulário → checkout externo (track_user_id anônimo) | | `checkout-proprio.md` | ✅ Quantum Tier | Checkout integrado na página (cartão/Stripe) | | `pagina-obrigado.md` | ✅ Quantum Tier | Thank-you page pós-compra (deduplicação) | | `quiz-funnel.md` | ✅ Quantum Tier | Funis de quiz com micro-eventos | | `webinar-registration.md` | ✅ Quantum Tier | Inscrição em webinars | | `multi-step-checkout.md` | ⚠️ Browser-Only | Checkout em múltiplas etapas (em migração para Quantum Tier) | **Estatística**: 7/8 modelos são 100% Cloudflare Native (87.5%) > Novos modelos são adicionados sempre que o usuário fornecer estruturas de referência. --- ## 🚧 TRANSIÇÃO LEGACY → QUANTUM **O que foi removido:** - ❌ **GTM Web + GTM Server (Stape)** — totalmente removido do código Quantum Tier - ❌ **Modelos obsoletos** — movidos para `backup_pre_legacy_purge/` **O que permanece em documentação:** - ⚠️ `knowledge-base.md` contém referências legadas de GTM (PASSO 2.x) - ⚠️ Isso é para compatibilidade com usuários que ainda usam GTM Server - ⚠️ Para projetos NOVOS, ignore qualquer referência a GTM/Stape **Regra de ouro atual:** > **Cloudflare Workers + D1 = 100% obrigatório para projetos novos** > GTM/Stape apenas para manutenção de projetos existentes (Legacy) --- ## BASE DE CONHECIMENTO TÉCNICA ## BASE DE CONHECIMENTO TÉCNICA Todo o conteúdo técnico de referência (PASSO 1 ao PASSO 8) está em: ``` {SKILL_BASE}/knowledge-base.md ``` Os agentes especialistas consultam esse arquivo **sob demanda**, lendo apenas as seções relevantes para a tarefa que estão executando. Isso mantém o contexto de cada agente leve e focado. ### Índice da knowledge-base.md | Seção | Conteúdo | Agente que usa | |---|---|---| | PASSO 1 | tracking.config.js — estrutura e campos | browser-tracking, todos | | PASSO 2.1–2.6 | tracking.js — SDK base, inicialização, cookies | browser-tracking | | PASSO 2.7–2.13 | tracking.js — eventos (Lead, Purchase, etc.) | browser-tracking, meta, google, youtube, tiktok | | PASSO 3–5 | Checklist de validação e testes | browser-tracking, validator | | PASSO 6 | Cloudflare Workers + D1 (cdp-edge-db) | server-tracking | ### Documentação de referência (docs/) ``` {SKILL_BASE}/docs/ └── guia-cloudflare-iniciante.md ← guia linear completo: do zero ao deploy (20 partes) Cobre: conta → Wrangler → D1 → worker.js → secrets → D1 SQL → deploy → webhook compra → WhatsApp → domínio. - **Diferencial:** Zero latência, 100% Edge, sem GTM/Stape. ``` Quando o usuário perguntar sobre setup da Cloudflare, como instalar, como fazer deploy, webhook → ler `docs/guia-cloudflare-iniciante.md`. ### Como os agentes devem consultar ``` Read: {SKILL_BASE}/knowledge-base.md Buscar seção: "PASSO X.Y" Ler apenas essa seção, não o arquivo inteiro ``` Se precisar de múltiplas seções, fazer múltiplos reads focados por seção. --- ## MODELOS DE PÁGINA (templates prontos) Modelos são checklists completos e validados para cada tipo de página. O Page Analyzer identifica qual modelo se aplica; o Master Orchestrator carrega o modelo e o repassa aos agentes especialistas. ``` {SKILL_BASE}/models/ ├── captura-de-lead.md ← formulário de lead simples (sem compra externa) ├── captura-lead-evento-externo.md ← lead + compra via webhook (Hotmart/Kiwify/Eduzz/Ticto) ├── trafego-direto.md ← VSL/LP sem formulário → checkout externo (track_user_id anônimo) ├── checkout-proprio.md ← checkout integrado (cartão/Stripe/MercadoPago) ├── pagina-obrigado.md ← thank-you page (Purchase no carregamento) ├── quiz-funnel.md ← funis de quiz com micro-eventos comportamentais ├── webinar-registration.md ← inscrição em webinars/eventos ao vivo └── multi-step-checkout.md ← ⚠️ checkout multi-etapa (Browser-Only — migração pendente para Quantum Tier) ``` **Cada modelo contém:** - Lista completa de parâmetros Quantum Tier - Tags para Meta, TikTok, GA4 e Google Ads (Web + Server) - Checklist de validação - Notas de adaptação (ex: IDs de campos a substituir) > Novos modelos são adicionados sempre que o usuário fornece estruturas de referência. --- ## QUANDO NÃO USAR AGENTES (modo rápido) Para perguntas simples e pontuais — ex: "qual evento uso para WhatsApp?", "qual endpoint do TikTok?" — responder diretamente consultando a knowledge-base sem spawnar agentes. Agentes só são necessários para tarefas de geração de código ou análise de arquivos.