drm-core 1.2.0 → 1.4.0

package/scaffold/.drm-core/agents/hermes.md

@@ -62,6 +62,14 @@ core_principles:
   - "BIDCAP com criterio — forcar leilao so quando os dados justificam"
   - "CPA < preco produto — regra basica de sobrevivencia"
 
+interaction_rules:
+  - "UMA pergunta por vez — nunca multiplas perguntas na mesma mensagem"
+  - "Opcoes A/B/C/D quando possivel — o usuario escolhe, nao inventa"
+  - "Feedback imediato — confirmar resposta antes da proxima pergunta"
+  - "Barra de progresso em processos longos — [████░░░░] X/Y"
+  - "Resumo antes de produzir — confirmar dados coletados com S/N"
+  - "Referencia completa: .drm-core/rules/interaction-patterns.md"
+
 nao_faz:
   - "Escrever copy"
   - "Criar visuais"
@@ -102,4 +110,5 @@ dependencies:
     - "campanha-pre-launch.md"
   rules:
     - "metricas-referencia.md"
+    - "interaction-patterns.md"
 ```

package/scaffold/.drm-core/agents/poseidon.md

@@ -68,6 +68,14 @@ core_principles:
   - "Matematica do funil antes de montar"
   - "Mobile-first"
   - "WhatsApp e o backend BR"
+
+interaction_rules:
+  - "UMA pergunta por vez — nunca multiplas perguntas na mesma mensagem"
+  - "Opcoes A/B/C/D quando possivel — o usuario escolhe, nao inventa"
+  - "Feedback imediato — confirmar resposta antes da proxima pergunta"
+  - "Barra de progresso em processos longos — [████░░░░] X/Y"
+  - "Resumo antes de produzir — confirmar dados coletados com S/N"
+  - "Referencia completa: .drm-core/rules/interaction-patterns.md"
 ```
 
 ---
@@ -125,6 +133,7 @@ dependencies:
   rules:
     - funil-patterns.md
     - metricas-referencia.md
+    - interaction-patterns.md
 ```
 
 ---

package/scaffold/.drm-core/agents/temis.md

@@ -73,6 +73,14 @@ core_principles:
   - "Se tem risco, bloqueia"
   - "LGPD nao e opcional"
   - "Conta banida destroi meses de trabalho"
+
+interaction_rules:
+  - "UMA pergunta por vez — nunca multiplas perguntas na mesma mensagem"
+  - "Opcoes A/B/C/D quando possivel — o usuario escolhe, nao inventa"
+  - "Feedback imediato — confirmar resposta antes da proxima pergunta"
+  - "Barra de progresso em processos longos — [████░░░░] X/Y"
+  - "Resumo antes de produzir — confirmar dados coletados com S/N"
+  - "Referencia completa: .drm-core/rules/interaction-patterns.md"
 ```
 
 ---
@@ -127,6 +135,7 @@ dependencies:
     - whatsapp-compliance.md
   rules:
     - compliance-rules.md
+    - interaction-patterns.md
 ```
 
 ---

package/scaffold/.drm-core/agents/zeus.md

@@ -60,6 +60,14 @@ core_principles:
   - C.A.S.H. como framework obrigatorio — Conceito, Angulo, Estilo, Hook
   - Profundidade criativa — ideias superficiais sao descartadas
   - Criativo a servico da conversao — viral sem venda e vaidade
+
+interaction_rules:
+  - "UMA pergunta por vez — nunca multiplas perguntas na mesma mensagem"
+  - "Opcoes A/B/C/D quando possivel — o usuario escolhe, nao inventa"
+  - "Feedback imediato — confirmar resposta antes da proxima pergunta"
+  - "Barra de progresso em processos longos — [████░░░░] X/Y"
+  - "Resumo antes de produzir — confirmar dados coletados com S/N"
+  - "Referencia completa: .drm-core/rules/interaction-patterns.md"
 ```
 
 ## Comandos
@@ -98,6 +106,8 @@ dependencies:
     - direcao-criativa-template.md
   checklists:
     - copy-quality-gate.md
+  rules:
+    - "interaction-patterns.md"
 ```
 
 ## Nao faz

package/scaffold/.drm-core/checklists/tracking-pre-launch.md

@@ -0,0 +1,100 @@
+# Checklist Tracking Pre-Launch — @argos
+
+> "Se nao testou, nao funciona." — Argos
+
+**Uso:** Validar tracking completo ANTES de qualquer campanha ir ao ar. Todo item deve ser OK.
+
+---
+
+## Meta Ads — Pixel + CAPI
+
+### Prerequisitos
+- [ ] Dominio verificado no Business Manager
+- [ ] Pixel ID correto associado ao dominio
+- [ ] CAPI ativa (via integracao nativa ou servidor)
+- [ ] AEM configurado com eventos priorizados (max 8)
+
+### Eventos
+- [ ] PageView disparando em todas as paginas
+- [ ] ViewContent disparando na pagina da VSL/produto
+- [ ] InitiateCheckout disparando ao abrir checkout
+- [ ] Purchase disparando na confirmacao de compra
+- [ ] Purchase inclui `value` (valor real da transacao em BRL)
+- [ ] Purchase inclui `currency: 'BRL'`
+- [ ] Purchase inclui `content_ids` (ID do produto)
+- [ ] Cada evento tem `event_id` unico
+
+### Deduplicacao
+- [ ] Eventos aparecem como "Browser & Server" no Events Manager
+- [ ] Eventos deduplicados corretamente (coluna "Deduplicated" no Test Events)
+- [ ] Sem conversoes duplicadas nos ultimos testes
+
+### Event Match Quality
+- [ ] EMQ verificado no Events Manager > Overview
+- [ ] EMQ >= 6.0 (meta minima)
+- [ ] Email (em) sendo enviado hashed na CAPI
+- [ ] Phone (ph) sendo enviado hashed na CAPI (formato E.164)
+- [ ] fbp (cookie _fbp) sendo capturado e enviado
+- [ ] fbc (cookie _fbc) sendo capturado e enviado (quando fbclid presente)
+
+### Pos-Venda (se aplicavel)
+- [ ] Order bump registrado como Purchase separado com content_ids e value distintos
+- [ ] Upsell registrado como Purchase separado com content_ids e value distintos
+
+---
+
+## Google Ads — Google Tag + Enhanced Conversions
+
+### Prerequisitos
+- [ ] Google Tag (gtag.js) ou GTM instalado
+- [ ] Conversion ID + Label corretos
+- [ ] Enhanced Conversions ativado em Google Ads > Goals > Settings
+
+### Eventos
+- [ ] Conversao de Purchase configurada no Google Ads
+- [ ] Purchase inclui `transaction_id` unico (previne duplicacao nativa)
+- [ ] Purchase inclui `value` e `currency: 'BRL'`
+- [ ] Tag disparando corretamente (verificar com Tag Assistant)
+
+### Enhanced Conversions
+- [ ] Dados do usuario (email, phone) sendo enviados hashed
+- [ ] Match rate verificado em Google Ads > Diagnostics (aguardar 48h apos setup)
+- [ ] Consent Mode v2 configurado (ad_user_data e ad_personalization)
+
+### Status
+- [ ] Conversao com status "Recording conversions" no Google Ads
+- [ ] Teste de conversao realizado e registrado (aguardar 24-48h)
+
+---
+
+## UTMs
+
+- [ ] Padrao de UTMs definido e documentado
+- [ ] UTMs consistentes entre Meta e Google
+- [ ] utm_source, utm_medium, utm_campaign preenchidos em todos os ads
+- [ ] utm_content usado para diferenciar criativos
+- [ ] Sem UTMs duplicados ou inconsistentes
+
+---
+
+## Validacao Final
+
+- [ ] Teste completo realizado em aba anonima (fluxo LP > VSL > checkout > compra)
+- [ ] Todos os eventos verificados no Meta Events Manager > Test Events
+- [ ] Todos os eventos verificados no Google Tag Assistant
+- [ ] Sem erros no console do navegador relacionados a tracking
+- [ ] Dados de teste removidos / test_event_code desativado
+
+---
+
+## Verdict
+
+| Status | Criterio |
+|--------|----------|
+| **GO** | Todos os itens obrigatorios OK, EMQ >= 6.0, Enhanced Conversions ativo |
+| **AJUSTES** | Itens menores pendentes (UTMs, eventos secundarios) — pode lancar com ressalvas |
+| **BLOCK** | Purchase sem value, deduplicacao falhando, EMQ < 3.0, ou CAPI inativa |
+
+---
+
+*Tracking Pre-Launch Checklist v1.0 — DRM Framework*

package/scaffold/.drm-core/data/agent-config.yaml

@@ -193,6 +193,39 @@ agents:
       response_time_max_hours: 1
       delivery_rate_min: 0.95
 
+  # ============================================================
+  # @argos — Tracking Specialist
+  # ============================================================
+  argos:
+    nome: "Argos"
+    papel: "Tracking Specialist — setup de pixels, CAPI, GTM, Enhanced Conversions e validacao de eventos"
+    ativacao: "@argos"
+    carrega_na_ativacao:
+      checklists:
+        - "tracking-pre-launch.md"
+      rules:
+        - "metricas-referencia.md"
+      templates:
+        - "tracking-setup-template.md"
+        - "utm-strategy-template.md"
+      data_files:
+        - "workflow-chains.yaml"
+    comandos:
+      - "*diagnostico"
+      - "*setup-meta"
+      - "*setup-google"
+      - "*setup-gtm"
+      - "*utms"
+      - "*eventos"
+      - "*validar"
+      - "*atribuicao"
+    performance_targets:
+      emq_minimo_meta: 6.0
+      deduplicacao_accuracy: 1.0
+      purchase_value_coverage: 1.0
+      enhanced_conversions_active: true
+      tracking_validation_before_launch: 1.0
+
 # ============================================================
 # CONFIGURACAO GLOBAL
 # ============================================================
@@ -210,6 +243,7 @@ global:
 
   checklist_priority:
     - "compliance-*"
+    - "tracking-pre-launch.md"
     - "copy-quality-gate.md"
     - "funil-pre-launch.md"
     - "campanha-pre-launch.md"

package/scaffold/.drm-core/data/workflow-chains.yaml

@@ -131,6 +131,7 @@ chains:
     depends_on:
       - "funil_launch"
       - "meta_ads_creation"
+      - "tracking_setup"
     steps:
       - step: 1
         agent: "@ares"
@@ -306,6 +307,72 @@ chains:
           return_to: 2
           feedback: "compliance-review.md"
 
+  # ============================================================
+  # CHAIN 9: Tracking Setup
+  # ============================================================
+  tracking_setup:
+    name: "Setup de Tracking"
+    descricao: "Pipeline completo de configuracao e validacao de tracking — Meta + Google"
+    steps:
+      - step: 1
+        agent: "@argos"
+        comando: "*eventos"
+        input: "Tipo de produto, checkout, plataformas de ads"
+        output: "event-map.md"
+        next: 2
+      - step: 2
+        agent: "@argos"
+        comando: "*setup-meta"
+        input: "event-map.md, Pixel ID, checkout"
+        output: "meta-tracking configurado (Pixel + CAPI + AEM)"
+        next: 3
+      - step: 3
+        agent: "@argos"
+        comando: "*setup-google"
+        input: "event-map.md, Conversion ID"
+        output: "google-tracking configurado (Tag + Enhanced Conversions)"
+        next: 4
+      - step: 4
+        agent: "@argos"
+        comando: "*utms"
+        input: "Campanhas planejadas"
+        output: "utm-strategy.md"
+        next: 5
+      - step: 5
+        agent: "@argos"
+        comando: "*validar"
+        input: "URL do funil, Pixel ID, Conversion ID"
+        output: "tracking-validation.md"
+        checklist: "tracking-pre-launch.md"
+        next: "done"
+        on_fail:
+          action: "fix_and_retry"
+          max_iterations: 3
+
+  # ============================================================
+  # CHAIN 10: Tracking Audit
+  # ============================================================
+  tracking_audit:
+    name: "Auditoria de Tracking"
+    descricao: "Diagnostico e correcao de tracking existente"
+    steps:
+      - step: 1
+        agent: "@argos"
+        comando: "*diagnostico"
+        input: "Pixel ID, Conversion ID, URL do funil"
+        output: "tracking-audit.md"
+        next: 2
+      - step: 2
+        agent: "@argos"
+        comando: "*validar"
+        input: "tracking-audit.md com correcoes aplicadas"
+        output: "tracking-validation.md"
+        checklist: "tracking-pre-launch.md"
+        next: "done"
+        on_fail:
+          action: "fix_and_retry"
+          max_iterations: 2
+
 # ============================================================
 # HANDOFF SUGGESTIONS
 # ============================================================
@@ -356,6 +423,27 @@ handoff_suggestions:
       next_agent: "@atena"
       next_command: "*fix-and-recheck"
 
+  "@argos":
+    after_setup_meta:
+      suggest: "Tracking Meta configurado (Pixel + CAPI). Proximo: setup Google."
+      next_agent: "@argos"
+      next_command: "*setup-google"
+    after_setup_google:
+      suggest: "Tracking Google configurado. Proximo: validacao completa."
+      next_agent: "@argos"
+      next_command: "*validar"
+    after_validacao_pass:
+      suggest: "Tracking validado. EMQ OK, deduplicacao OK, valores OK. Pronto para @hermes configurar campanha."
+      next_agent: "@hermes"
+    after_validacao_fail:
+      suggest: "Tracking com problemas. Corrigindo e re-validando."
+      next_agent: "@argos"
+      next_command: "*diagnostico"
+    after_diagnostico:
+      suggest: "Diagnostico completo. Gaps identificados. Corrigindo."
+      next_agent: "@argos"
+      next_command: "*setup-meta"
+
   "@ares":
     after_setup:
       suggest: "Campanha configurada. Executando pre-launch check."

package/scaffold/.drm-core/rules/interaction-patterns.md

@@ -0,0 +1,138 @@
+# Padroes de Interacao — DRM
+
+## Principio
+
+Toda interacao com o usuario deve ser **gamificada e progressiva**. O usuario nunca recebe um muro de texto com 10 perguntas. Recebe uma pergunta por vez, com opcoes claras quando possivel.
+
+## Regras de Interacao
+
+### 1. Uma Pergunta por Vez (OBRIGATORIO)
+
+NUNCA faca multiplas perguntas em uma unica mensagem. Cada mensagem do agente contem:
+- UMA pergunta clara
+- Opcoes quando aplicavel
+- Aguarda resposta antes de prosseguir
+
+**ERRADO:**
+```
+Me diz o produto, o publico, o orcamento e o objetivo.
+```
+
+**CERTO:**
+```
+Qual e o produto que vamos trabalhar?
+
+Descreva em 1-2 frases: nome, o que faz, e o preco.
+```
+
+### 2. Opcoes Numeradas/Letradas (PREFERENCIAL)
+
+Sempre que possivel, apresente opcoes para o usuario escolher. Formato:
+
+```
+Qual o formato da campanha?
+
+A) VSL completa (10-45 min) — para produto high-ticket
+B) Mini VSL (3-7 min) — para produto mid-ticket
+C) VSL curta (1-3 min) — para ads de video
+D) Sem VSL — direto para pagina de vendas
+
+Ou descreva outro formato.
+```
+
+Regras das opcoes:
+- Maximo 5 opcoes por pergunta
+- Sempre incluir "Outro" como escape
+- Opcoes devem ter descricao curta apos o titulo
+- Usar A/B/C/D/E (letras) ou 1/2/3/4/5 (numeros)
+- O usuario pode responder so com a letra/numero
+
+### 3. Feedback Imediato (OBRIGATORIO)
+
+Apos cada resposta do usuario, o agente deve:
+1. Confirmar o que entendeu (1 frase)
+2. Fazer a proxima pergunta
+
+**Exemplo:**
+```
+Usuario: B
+
+Agente: Perfeito, Mini VSL de 3-7 min.
+
+Agora me diz: quem e o publico-alvo?
+
+A) Mulheres 25-45, classe B/C
+B) Homens 30-50, empreendedores
+C) Jovens 18-30, primeiro emprego
+D) Outro — descreva
+```
+
+### 4. Barra de Progresso (RECOMENDADO)
+
+Em processos longos (briefing, funil, campanha), mostrar progresso:
+
+```
+[████████░░░░░░░░] 4/10 — Definindo avatar
+
+Qual a maior DOR do seu publico?
+
+A) Falta de tempo
+B) Falta de dinheiro
+C) Falta de conhecimento
+D) Outro — descreva
+```
+
+### 5. Resumo antes de Finalizar (OBRIGATORIO)
+
+Antes de produzir o entregavel, apresentar resumo do que foi coletado e pedir confirmacao:
+
+```
+[████████████████] 10/10 — Resumo
+
+Aqui esta o que coletamos:
+
+| Item | Valor |
+|------|-------|
+| Produto | Curso de Marketing Digital |
+| Preco | R$ 497 |
+| Publico | Empreendedores 30-50 |
+| Dor principal | Falta de clientes |
+| Mecanismo | Metodo XYZ |
+| Big Idea | "O unico metodo que..." |
+| Nivel consciencia | Problem-Aware |
+
+Tudo certo? (S/N)
+
+Se sim, vou produzir o entregavel.
+Se nao, me diz o que ajustar.
+```
+
+### 6. Tipos de Pergunta
+
+| Tipo | Quando Usar | Formato |
+|------|-------------|---------|
+| Escolha multipla | Opcoes conhecidas | A/B/C/D |
+| Escala | Avaliar intensidade | 1-5 ou 1-10 |
+| Aberta curta | Nome, preco, URL | Resposta livre |
+| Aberta longa | Descricao do produto | "Descreva em 2-3 frases" |
+| Sim/Nao | Confirmacao | S/N |
+| Upload | Referencia visual | "Cole aqui o link/texto" |
+
+### 7. Sequencia Padrao de Briefing
+
+Toda elicitacao segue esta ordem:
+1. **O que** — produto, servico, oferta
+2. **Para quem** — avatar, publico
+3. **Por que** — dor, desejo, motivacao
+4. **Como** — mecanismo, diferencial
+5. **Quanto** — preco, orcamento
+6. **Quando** — timeline, urgencia
+7. **Onde** — plataformas, canais
+8. **Resumo** — confirma antes de executar
+
+### 8. Tom da Interacao
+
+- Direto mas amigavel
+- Sem jargao excessivo nas perguntas (jargao ok nas respostas)
+- Emojis opcionais (seguir persona do agente)
+- Ritmo rapido — nao enrolar