drm-core 1.0.0 → 1.3.0

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

@@ -0,0 +1,66 @@
+# Funil Pre-Launch — Checklist @atena
+
+> **Executor:** @atena (Estrategista de Funis)
+> **Quando:** Antes de lancar qualquer funil novo ou relancar funil existente
+> **Scoring:** 15/15 = GO | Qualquer falha em Checkout ou Tracking = NO-GO
+> **Resultado:** GO | NO-GO
+
+---
+
+## Paginas (4 itens)
+
+- [ ] **F1 — Paginas funcionando:** Todas as paginas do funil carregam corretamente em desktop e mobile (LP, checkout, obrigado, upsell, downsell). Nenhuma retorna 404, 500 ou tela em branco. Testar nos 3 browsers principais (Chrome, Safari, Firefox).
+- [ ] **F2 — Links internos funcionais:** Todos os links dentro das paginas apontam para o destino correto. Botoes de CTA levam ao checkout. Links de termos/privacidade abrem. Nenhum link esta quebrado ou aponta para staging/localhost.
+- [ ] **F3 — Mobile responsivo:** Todas as paginas exibem corretamente em tela de celular (360px-428px). Botoes sao clicaveis sem zoom. Textos sao legiveis. Formularios funcionam com teclado mobile. Video (se houver) reproduz em mobile.
+- [ ] **F4 — Velocidade < 3 segundos:** Todas as paginas carregam em menos de 3 segundos em conexao 4G. Testar com PageSpeed Insights ou GTmetrix. LCP (Largest Contentful Paint) < 2.5s. Imagens estao otimizadas. Scripts nao bloqueiam renderizacao.
+
+## Checkout (4 itens)
+
+- [ ] **F5 — Pagamento teste completo:** Realizar uma compra teste end-to-end com cartao de teste e/ou PIX sandbox. Confirmar que o pagamento e processado, o acesso e liberado e o email de confirmacao e enviado. Testar cartao aprovado E recusado.
+- [ ] **F6 — Order bump funcional:** Se ha order bump no checkout: ele aparece corretamente, o valor e somado ao total, o produto bump e entregue apos a compra. Se nao ha order bump, marcar como N/A.
+- [ ] **F7 — Upsell/Downsell funcional:** Se ha fluxo de upsell/downsell pos-compra: as paginas carregam, os botoes de aceitar/recusar funcionam, o valor e cobrado corretamente, o produto e entregue. Se nao ha upsell/downsell, marcar como N/A.
+- [ ] **F8 — Email de confirmacao:** O email de confirmacao de compra e enviado automaticamente apos o pagamento. Contem: dados da compra, acesso ao produto, informacoes de suporte. Chega na caixa de entrada (nao em spam). Testar com Gmail e Outlook.
+
+## Tracking (3 itens)
+
+- [ ] **F9 — Pixels Meta e Google:** Pixel do Meta (Facebook) e tag do Google Ads estao instalados e disparando corretamente. Verificar com Meta Pixel Helper e Google Tag Assistant. Pixel dispara PageView em todas as paginas e Purchase na pagina de obrigado.
+- [ ] **F10 — UTMs configurados:** URLs de destino dos anuncios possuem UTMs completos: utm_source, utm_medium, utm_campaign, utm_content. UTMs seguem a convencao de nomenclatura definida. Testar que UTMs chegam ao analytics/CRM.
+- [ ] **F11 — Conversoes verificadas:** Eventos de conversao estao configurados e verificados: InitiateCheckout (pagina de checkout), Purchase (pagina de obrigado), Lead (formulario, se houver). Testar disparo real com a ferramenta de debug de cada plataforma.
+
+## Integracao (3 itens)
+
+- [ ] **F12 — WhatsApp integrado:** Se o funil usa WhatsApp: o link/botao abre conversa com o numero correto. Mensagem pre-definida (se houver) esta configurada. Resposta automatica (se houver) funciona. Se nao usa WhatsApp, marcar como N/A.
+- [ ] **F13 — Email marketing integrado:** Apos a compra ou captura de lead, o contato e adicionado a lista/automacao correta no ESP (ActiveCampaign, Mailchimp, etc). Tags sao aplicadas corretamente. Sequencia de emails e disparada.
+- [ ] **F14 — CRM atualizado:** Se ha CRM: o lead/cliente e registrado com dados corretos (nome, email, produto, valor, data). Se nao ha CRM, marcar como N/A.
+
+## Copy e Backup (1 item)
+
+- [ ] **F15 — Copy aprovada e backup:** Copy de todas as paginas foi aprovada pela checklist `copy-quality-gate.md` (@zeus) E `compliance-meta.md` (@temis). Funil completo esta exportado/backup em formato recuperavel (template da plataforma, HTML, ou screenshots).
+
+---
+
+## Regra de GO/NO-GO
+
+| Secao | Regra |
+|-------|-------|
+| Paginas (F1-F4) | Todas devem passar. Falha = corrigir antes de GO |
+| **Checkout (F5-F8)** | **Qualquer falha = NO-GO imediato** |
+| **Tracking (F9-F11)** | **Qualquer falha = NO-GO imediato** |
+| Integracao (F12-F14) | Falha = corrigir, nao bloqueia se N/A |
+| Copy/Backup (F15) | Deve passar. Falha = corrigir antes de GO |
+
+## Resultado Final
+
+| Condicao | Veredicto |
+|----------|-----------|
+| 15/15 passam (ou N/A justificados) | **GO** — funil liberado para trafego |
+| Qualquer Checkout ou Tracking falha | **NO-GO** — corrigir e re-testar |
+| Apenas Paginas ou Integracao falham | **NO-GO** — corrigir, re-testar rapido |
+
+## Regras de Execucao
+
+1. Testar o funil COMPLETO como se fosse um cliente real — do clique no anuncio ate o acesso ao produto
+2. Itens marcados N/A devem ter justificativa (ex: "funil nao possui upsell")
+3. Manter evidencias dos testes (screenshots, IDs de transacao teste)
+4. Re-teste obrigatorio apos qualquer correcao em Checkout ou Tracking
+5. GO so e emitido por @atena — outros agentes nao podem aprovar funil

package/scaffold/.drm-core/checklists/whatsapp-compliance.md

@@ -0,0 +1,49 @@
+# WhatsApp Compliance — Checklist @temis
+
+> **Executor:** @temis (Compliance Officer)
+> **Quando:** Antes de ativar qualquer automacao, campanha ou sequencia via WhatsApp
+> **Resultado:** APROVADO | BLOQUEADO
+
+---
+
+## Itens de Verificacao (10 itens)
+
+- [ ] **W1 — Opt-in explicito:** O contato forneceu consentimento explicito para receber mensagens via WhatsApp. O opt-in e ativo (checkbox nao pre-marcado, ou acao explicita como enviar mensagem primeiro). Registro do consentimento esta armazenado com data/hora.
+- [ ] **W2 — STOP funcional:** O usuario pode enviar "STOP", "SAIR", "PARAR" ou "CANCELAR" a qualquer momento e ser removido da lista imediatamente. A resposta automatica confirma a remocao. O numero NAO recebe mais mensagens apos o opt-out.
+- [ ] **W3 — Frequencia maxima por semana:** A frequencia de mensagens nao excede o limite definido por semana (recomendado: maximo 3 mensagens/semana para contatos frios, 5/semana para contatos quentes). Frequencia esta configurada na ferramenta de automacao.
+- [ ] **W4 — Horario 8h-20h:** Mensagens automaticas sao enviadas apenas entre 8h e 20h no fuso horario do destinatario. Mensagens fora deste horario sao enfileiradas para o proximo horario permitido. Excecao: respostas a mensagens iniciadas pelo usuario.
+- [ ] **W5 — Consentimento LGPD:** O tratamento de dados pessoais via WhatsApp possui base legal conforme LGPD (Art. 7): consentimento do titular, execucao de contrato, ou interesse legitimo documentado. O titular foi informado sobre a finalidade do uso dos dados.
+- [ ] **W6 — Finalidade declarada:** O opt-in especifica PARA QUE o numero sera usado (ex: "receber atualizacoes sobre o curso", "receber ofertas exclusivas"). NAO usa consentimento generico ("aceito receber mensagens"). A finalidade real corresponde ao declarado.
+- [ ] **W7 — Base legal documentada:** A base legal para cada tipo de mensagem esta documentada: mensagens transacionais (execucao de contrato), mensagens de marketing (consentimento), mensagens de suporte (interesse legitimo). Documentacao acessivel para auditoria.
+- [ ] **W8 — Sem spam:** O conteudo das mensagens e relevante para o destinatario. NAO envia mensagens em massa sem segmentacao. NAO envia o mesmo conteudo repetidamente. NAO usa taticas de spam (mensagens excessivas, conteudo irrelevante, links suspeitos).
+- [ ] **W9 — Conteudo adequado:** As mensagens NAO contem: conteudo adulto, discurso de odio, ameacas, desinformacao sobre saude, promessas financeiras garantidas, ou qualquer conteudo que viole os Termos de Servico do WhatsApp Business.
+- [ ] **W10 — Dados seguros e politica acessivel:** Dados de contatos estao armazenados de forma segura (criptografia em repouso, acesso restrito). Link para politica de privacidade e disponibilizado na primeira interacao ou no formulario de opt-in. Politica cobre especificamente o uso de WhatsApp.
+
+---
+
+## Classificacao de Severidade
+
+| Severidade | Itens | Consequencia |
+|-----------|-------|-------------|
+| **CRITICA** | W1, W2, W5 | Ban do numero, multa LGPD, acao judicial |
+| **ALTA** | W6, W7, W8 | Restricao de conta, risco regulatorio |
+| **MEDIA** | W3, W4, W9, W10 | Degradacao de qualidade, risco menor |
+
+## Resultado
+
+| Condicao | Veredicto |
+|----------|-----------|
+| Todos os 10 itens passam | **APROVADO** |
+| Qualquer item CRITICO falha | **BLOQUEADO** — nao ativar |
+| 2+ itens ALTA falham | **BLOQUEADO** |
+| 1 item ALTA falha | **AJUSTES** — corrigir antes de ativar |
+| Apenas itens MEDIA falham | **APROVADO COM RESSALVAS** — corrigir em 48h |
+
+## Regras de Execucao
+
+1. Verificar a ferramenta de automacao (Manychat, Wati, etc.) E o conteudo das mensagens
+2. Testar o fluxo de opt-out (W2) com um numero real antes de aprovar
+3. Verificar que o opt-in (W1) esta capturado e armazenado — nao apenas "confiamos que fizeram"
+4. Para campanhas de reativacao de base antiga, exigir re-opt-in antes de enviar
+5. Manter log de aprovacao com data, responsavel e versao das mensagens aprovadas
+6. Re-avaliar a cada 90 dias ou quando houver mudanca nas mensagens/automacoes

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

@@ -0,0 +1,220 @@
+# Agent Config — Configuracao por agente
+# Define quais rules, checklists, templates e targets cada agente carrega na ativacao
+
+agents:
+
+  # ============================================================
+  # @zeus — Copy Chief
+  # ============================================================
+  zeus:
+    nome: "Zeus"
+    papel: "Copy Chief — qualidade e criacao de copy"
+    ativacao: "@zeus"
+    carrega_na_ativacao:
+      checklists:
+        - "copy-quality-gate.md"
+      rules: []
+      templates:
+        - "vsl-structure.md"
+        - "ad-copy-structure.md"
+      data_files:
+        - "workflow-chains.yaml"
+    comandos:
+      - "*write-vsl"
+      - "*write-ads"
+      - "*write-tiktok-script"
+      - "*write-google-ads"
+      - "*quality-gate"
+      - "*rewrite"
+    performance_targets:
+      quality_gate_pass_rate: 0.80
+      max_rewrite_iterations: 3
+      avg_quality_score: 10
+
+  # ============================================================
+  # @temis — Compliance Officer
+  # ============================================================
+  temis:
+    nome: "Temis"
+    papel: "Compliance Officer — conformidade regulatoria e de plataforma"
+    ativacao: "@temis"
+    carrega_na_ativacao:
+      checklists:
+        - "compliance-meta.md"
+        - "compliance-vsl.md"
+        - "compliance-google.md"
+        - "compliance-tiktok.md"
+        - "whatsapp-compliance.md"
+      rules: []
+      templates: []
+      data_files: []
+    comandos:
+      - "*compliance-check"
+      - "*compliance-review"
+      - "*audit"
+    performance_targets:
+      false_positive_rate: 0.05
+      miss_rate: 0.00
+      review_time_max_minutes: 15
+
+  # ============================================================
+  # @ares — Media Buyer
+  # ============================================================
+  ares:
+    nome: "Ares"
+    papel: "Media Buyer — gestao de campanhas e otimizacao de trafego"
+    ativacao: "@ares"
+    carrega_na_ativacao:
+      checklists:
+        - "campanha-pre-launch.md"
+      rules: []
+      templates:
+        - "kill-rules-template.md"
+        - "daily-report-template.md"
+        - "scale-plan-template.md"
+      data_files:
+        - "workflow-chains.yaml"
+    comandos:
+      - "*setup-campaign"
+      - "*pre-launch-check"
+      - "*activate"
+      - "*daily-report"
+      - "*check-kill-rules"
+      - "*analyze-performance"
+      - "*identify-winners"
+      - "*scale-plan"
+      - "*execute-optimization"
+      - "*optimize"
+    performance_targets:
+      roas_minimo: 2.0
+      cpa_max_vs_target: 1.3
+      kill_rule_compliance: 1.0
+      report_frequency: "diario"
+
+  # ============================================================
+  # @atena — Estrategista de Funis
+  # ============================================================
+  atena:
+    nome: "Atena"
+    papel: "Estrategista de Funis — construcao e validacao de funis"
+    ativacao: "@atena"
+    carrega_na_ativacao:
+      checklists:
+        - "funil-pre-launch.md"
+      rules: []
+      templates:
+        - "funil-spec-template.md"
+      data_files:
+        - "workflow-chains.yaml"
+    comandos:
+      - "*build-funil"
+      - "*pre-launch-check"
+      - "*fix-and-recheck"
+      - "*audit-funil"
+    performance_targets:
+      pre_launch_first_pass_rate: 0.70
+      page_speed_target_ms: 3000
+      mobile_score_min: 90
+      checkout_success_rate: 1.0
+
+  # ============================================================
+  # @hermes — Estrategista de Briefing
+  # ============================================================
+  hermes:
+    nome: "Hermes"
+    papel: "Estrategista de Briefing — pesquisa, avatar e briefings de criacao"
+    ativacao: "@hermes"
+    carrega_na_ativacao:
+      checklists: []
+      rules: []
+      templates:
+        - "briefing-vsl-template.md"
+        - "briefing-ads-template.md"
+        - "avatar-template.md"
+      data_files:
+        - "workflow-chains.yaml"
+    comandos:
+      - "*briefing-vsl"
+      - "*briefing-ads"
+      - "*briefing-tiktok"
+      - "*briefing-google"
+      - "*research-avatar"
+      - "*research-competitor"
+    performance_targets:
+      briefing_completeness: 1.0
+      research_depth_min_sources: 5
+
+  # ============================================================
+  # @apolo — Analista de Dados
+  # ============================================================
+  apolo:
+    nome: "Apolo"
+    papel: "Analista de Dados — dashboards, reports e insights de performance"
+    ativacao: "@apolo"
+    carrega_na_ativacao:
+      checklists: []
+      rules: []
+      templates:
+        - "weekly-report-template.md"
+        - "monthly-report-template.md"
+      data_files:
+        - "workflow-chains.yaml"
+    comandos:
+      - "*weekly-report"
+      - "*monthly-report"
+      - "*cohort-analysis"
+      - "*attribution-report"
+      - "*benchmark-compare"
+    performance_targets:
+      report_accuracy: 0.99
+      insight_actionability: 0.80
+
+  # ============================================================
+  # @hefesto — WhatsApp & Automacao
+  # ============================================================
+  hefesto:
+    nome: "Hefesto"
+    papel: "Especialista em WhatsApp e automacoes de comunicacao"
+    ativacao: "@hefesto"
+    carrega_na_ativacao:
+      checklists:
+        - "whatsapp-compliance.md"
+      rules: []
+      templates:
+        - "whatsapp-sequence-template.md"
+      data_files: []
+    comandos:
+      - "*setup-whatsapp"
+      - "*create-sequence"
+      - "*compliance-check-whatsapp"
+      - "*test-flow"
+    performance_targets:
+      opt_out_rate_max: 0.05
+      response_time_max_hours: 1
+      delivery_rate_min: 0.95
+
+# ============================================================
+# CONFIGURACAO GLOBAL
+# ============================================================
+global:
+  always_load:
+    data_files:
+      - "agent-config.yaml"
+    rules: []
+
+  max_iterations:
+    quality_gate_rewrite: 3
+    compliance_resubmit: 2
+    funil_recheck: 3
+    campaign_recheck: 2
+
+  checklist_priority:
+    - "compliance-*"
+    - "copy-quality-gate.md"
+    - "funil-pre-launch.md"
+    - "campanha-pre-launch.md"
+
+  output_format:
+    reports: "markdown"
+    data: "yaml"
+    logs: "markdown"