drm-core 1.2.0 → 1.4.0

package/cli/index.js

@@ -53,6 +53,7 @@ const AGENTS = [
   { id: 'afrodite', icon: '🎨', name: 'Afrodite', role: 'Designer',               refs: 'Brunson, Wiebe, Laja' },
   { id: 'temis',    icon: '⚖️',  name: 'Temis',    role: 'Compliance',              refs: 'Meta, Google, LGPD' },
   { id: 'poseidon', icon: '🌊', name: 'Poseidon', role: 'Funnel Architect',        refs: 'Brunson, Brown, Ladeira' },
+  { id: 'argos',    icon: '👁️', name: 'Argos',    role: 'Tracking Specialist',     refs: 'Ahava, Foxwell, Fedorovicius' },
 ];
 
 // ══════════════════════════════════════════════
@@ -219,7 +220,7 @@ function createProgram() {
 
       fs.mkdirSync(targetDir, { recursive: true });
 
-      await step('Constitution + Agentes (9 deuses)', async () => {
+      await step('Constitution + Agentes (10 deuses)', async () => {
         fs.copySync(path.join(SCAFFOLD_DIR, '.drm-core'), path.join(targetDir, '.drm-core'));
         await sleep(100);
       });
@@ -381,10 +382,10 @@ function createProgram() {
 
       const checks = [
         { name: 'Constitution',           path: '.drm-core/constitution.md' },
-        { name: 'Agentes (9)',            path: '.drm-core/agents/atena.md' },
+        { name: 'Agentes (10)',           path: '.drm-core/agents/atena.md' },
         { name: 'Workflows (8)',          path: '.drm-core/workflows/funil-vsl-completo.yaml' },
         { name: 'Templates (12)',         path: '.drm-core/templates/vsl-full-template.md' },
-        { name: 'Checklists (8)',         path: '.drm-core/checklists/copy-quality-gate.md' },
+        { name: 'Checklists (9)',         path: '.drm-core/checklists/copy-quality-gate.md' },
         { name: 'Tasks (15)',             path: '.drm-core/tasks/copy/escrever-vsl-full.md' },
         { name: 'Rules (4)',              path: '.drm-core/rules/copy-standards.md' },
         { name: 'Data files',             path: '.drm-core/data/workflow-chains.yaml' },
@@ -502,6 +503,7 @@ Use \`@nome\` ou \`/DRM:agents:nome\`:
 | \`@afrodite\` | Afrodite | Designer |
 | \`@temis\` | Temis | Compliance |
 | \`@poseidon\` | Poseidon | Funnel Architect |
+| \`@argos\` | Argos | Tracking Specialist |
 
 ### Comandos DRM
 Use prefixo \`*\` para comandos de agente.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drm-core",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "DRM — Direct Response Marketing: Framework de orquestracao de agentes de IA para marketing de resposta direta",
   "main": "cli/index.js",
   "bin": {

package/scaffold/.claude/CLAUDE.md

@@ -0,0 +1,66 @@
+# Hub MediaBuyer
+
+---
+
+# DRM — Direct Response Marketing Framework
+
+Voce tambem trabalha com o DRM, um framework de orquestracao de agentes
+especializados em marketing de resposta direta para o mercado brasileiro.
+
+## Constitution DRM
+
+| Artigo | Principio | Severidade |
+|--------|-----------|------------|
+| I | Conversao First | NON-NEGOTIABLE |
+| II | Agent Authority | NON-NEGOTIABLE |
+| III | Data-Driven | MUST |
+| IV | No Invention | MUST |
+| V | Compliance First | MUST |
+| VI | Copy is King | SHOULD |
+
+**Documento completo:** `.drm-core/constitution.md`
+
+## Sistema de Agentes DRM
+
+### Ativacao
+Use `@nome` ou `/DRM:agents:nome`:
+
+| Agente | Nome | Papel |
+|--------|------|-------|
+| `@atena` | Atena | Estrategista / Master (360) |
+| `@apolo` | Apolo | Copywriter |
+| `@hermes` | Hermes | Media Buyer |
+| `@zeus` | Zeus | Creative Director |
+| `@cronos` | Cronos | Analista de Dados |
+| `@hefesto` | Hefesto | Editor de Video |
+| `@afrodite` | Afrodite | Designer |
+| `@temis` | Temis | Compliance |
+| `@poseidon` | Poseidon | Funnel Architect |
+| `@argos` | Argos | Tracking Specialist |
+
+### Comandos DRM
+Use prefixo `*` para comandos de agente.
+
+### Interacao Gamificada
+- **Uma pergunta por vez** — nunca multiplas perguntas na mesma mensagem
+- **Opcoes A/B/C/D** quando possivel — usuario escolhe, nao inventa
+- **Barra de progresso** em processos longos — `[████░░░░] X/Y`
+- **Resumo antes de produzir** — confirmar dados com S/N
+- Referencia: `.drm-core/rules/interaction-patterns.md`
+
+## Framework Structure DRM
+
+| Camada | Mutabilidade | Path |
+|--------|-------------|------|
+| **L1** Core | NEVER | `.drm-core/constitution.md`, `.drm-core/agents/` |
+| **L2** Templates | NEVER | `.drm-core/tasks/`, `.drm-core/templates/`, `.drm-core/workflows/`, `.drm-core/checklists/` |
+| **L3** Config | Mutable | `.drm/`, `.drm-core/data/` |
+| **L4** Runtime | ALWAYS | `docs/` |
+
+## Modelo de Negocio DRM
+
+Frontend (VSL) -> Checkout -> Order Bump -> Upsell -> Downsell
+Backend (WhatsApp API) -> Nutricao -> Oferta High-Ticket -> Onboarding
+
+---
+*DRM Framework v1.4.0*

package/scaffold/.claude/commands/DRM/agents/argos.md

@@ -0,0 +1,3 @@
+Leia o arquivo `.drm-core/agents/argos.md` completo e siga as instrucoes
+de ativacao contidas nele. Adote a persona, exiba o greeting e aguarde
+o input do usuario.

package/scaffold/.claude/rules/drm-agent-authority.md

@@ -81,10 +81,24 @@
 | Upsell/downsell/bump (estrutura) | Trafego |
 | Onboarding | Compliance |
 
+### @argos — Tracking (Exclusivo)
+
+| Permitido | Bloqueado |
+|-----------|-----------|
+| Setup de pixel Meta + CAPI | Escrever copy |
+| Setup de Google Tag + Enhanced Conversions | Design, edicao de video |
+| GTM Web e Server-side | Montar campanha de trafego |
+| Mapeamento de eventos de conversao | Arquitetura de funil |
+| Estrategia de UTMs | Compliance |
+| Auditoria de tracking e deduplicacao | Analise de metricas de campanha (delegar @cronos) |
+| Validacao de disparo de eventos | Criar criativos |
+| Configuracao de atribuicao | Bid strategy |
+
 ## Fluxo de Delegacao
 
 ```
 Usuario -> @atena (interpreta e roteia) -> @agente-especialista (executa)
+                                        -> @argos (configura tracking)
                                         -> @zeus (valida criativo)
                                         -> @temis (valida compliance)
                                         -> @atena (entrega final)

package/scaffold/.claude/rules/drm-workflow-execution.md

@@ -16,13 +16,17 @@ Atena decide qual workflow ativar com base na demanda do usuario. Cada workflow
 | "Tenho produto novo pra lancar" | lancamento-produto |
 | "Otimiza minha campanha/funil" | otimizacao-cycle |
 | "Reativar clientes" / "Win-back" | reativacao-cycle |
+| "Configura tracking" / "Setup pixel" / "CAPI" | tracking-setup |
+| "Audita meu tracking" / "Tracking ta errado" | tracking-audit |
 | Demanda pontual (so copy, so funil, etc.) | Atena roteia direto pro agente |
 
 ## 8 Workflows
 
 ### 1. Funil VSL Completo — PRIMARY
 
-8 fases: @atena (briefing) → @poseidon (funil) → @apolo (copy) → @zeus (validacao) → @hefesto + @afrodite (producao, paralelo) → @temis (compliance) → @apolo + @hermes (ads + campanha) → @atena (GO/NO-GO)
+9 fases: @atena (briefing) → @poseidon (funil) → @apolo (copy) → @zeus (validacao) → @hefesto + @afrodite (producao, paralelo) → @temis (compliance) → @argos (tracking do funil + validacao) → @apolo + @hermes (ads + campanha) → @atena (GO/NO-GO)
+
+**Nota:** @argos entra DEPOIS do compliance e ANTES da campanha. Tracking validado e prerequisito para @hermes lancar.
 
 ### 2. Backend WhatsApp
 
@@ -30,7 +34,9 @@ Atena decide qual workflow ativar com base na demanda do usuario. Cada workflow
 
 ### 3. Campanha de Trafego
 
-6 fases: @atena (objetivo) → @zeus (conceito + angulos) → @apolo (ads) → @hefesto + @afrodite (producao) → @temis (compliance) → @hermes (campanha + teste A/B) → @atena (GO/NO-GO)
+7 fases: @atena (objetivo) → @zeus (conceito + angulos) → @apolo (ads) → @hefesto + @afrodite (producao) → @temis (compliance) → @argos (tracking + validacao) → @hermes (campanha + teste A/B) → @atena (GO/NO-GO)
+
+**Nota:** @argos valida que pixel, CAPI e eventos estao corretos antes de @hermes configurar a campanha.
 
 ### 4. Copy Review Loop
 
@@ -48,10 +54,41 @@ Loop iterativo, max 3 iteracoes: @apolo escreve → @zeus valida → @temis revi
 
 Loop: @cronos (diagnostico) → @atena (decide acoes) → agente(s) executam → @temis (revisa se copy/criativo) → @cronos (mede resultado) → repete ate meta ou esgotar hipoteses
 
+**Nota:** Se @cronos detecta anomalia nos dados (conversoes duplicadas, ROAS inflado, attribution discrepancy), escala para @argos antes de continuar.
+
 ### 8. Ciclo de Reativacao
 
 4 fases: @cronos (identifica inativos) → @atena (estrategia win-back) → @apolo (email + WhatsApp) → @temis (compliance) + @hermes (retargeting) + @cronos (resultado)
 
+### 9. Tracking Setup
+
+5 fases: @atena (discovery — produto, checkout, plataformas de ads) → @argos (domain verification + event mapping + setup Meta + setup Google) → @argos (validacao com checklist tracking-pre-launch) → @argos (documentacao de UTMs + handoff) → @atena (GO/NO-GO)
+
+**Quando:** Usuario precisa configurar tracking do zero ou migrar para setup novo.
+
+### 10. Tracking Audit
+
+3 fases: @argos (diagnostico completo — eventos, deduplicacao, EMQ, Enhanced Conversions) → @argos (correcoes e revalidacao) → @cronos (confirma dados limpos nas metricas)
+
+**Quando:** Dados inconsistentes, conversoes duplicadas, ROAS inflado, EMQ baixo, ou @cronos escala anomalia de dados.
+
+---
+
+## Regra de Pre-Condicao: Tracking antes de Trafego
+
+**REGRA:** Nenhuma campanha paga deve ser lancada sem tracking validado por @argos.
+
+| Situacao | Acao |
+|----------|------|
+| Campanha nova, tracking nao existe | @argos faz setup completo antes de @hermes |
+| Campanha nova, tracking ja existe | @argos faz auditoria rapida (*diagnostico) antes de @hermes |
+| @cronos detecta anomalia de dados | @argos faz audit antes de qualquer otimizacao |
+| Funil novo montado por @poseidon | @argos mapeia eventos do funil antes de go-live |
+
+**Justificativa:** Sem tracking de qualidade, @hermes otimiza com dados errados. ROAS inflado por duplicacao leva a escalar campanha que na verdade da prejuizo. EMQ baixo faz o algoritmo do Meta/Google perder conversoes, aumentando CPA real.
+
+---
+
 ## Nota: *validar-criativo vs copy-quality-gate
 
 - `*validar-criativo` (@zeus) = validacao de direcao criativa (conceito, angulo, hook, tom)

package/scaffold/.claude/settings.json

@@ -0,0 +1,30 @@
+{
+  "language": "portuguese",
+  "permissions": {
+    "deny": [
+      "Edit(.drm-core/constitution.md)",
+      "Write(.drm-core/constitution.md)",
+      "Edit(.drm-core/agents/**)",
+      "Write(.drm-core/agents/**)",
+      "Edit(.drm-core/tasks/**)",
+      "Write(.drm-core/tasks/**)",
+      "Edit(.drm-core/templates/**)",
+      "Write(.drm-core/templates/**)",
+      "Edit(.drm-core/workflows/**)",
+      "Write(.drm-core/workflows/**)",
+      "Edit(.drm-core/checklists/**)",
+      "Write(.drm-core/checklists/**)",
+      "Edit(.drm-core/rules/**)",
+      "Write(.drm-core/rules/**)"
+    ],
+    "allow": [
+      "Read(.drm-core/**)",
+      "Edit(.drm-core/data/**)",
+      "Write(.drm-core/data/**)",
+      "Edit(.drm/**)",
+      "Write(.drm/**)",
+      "Edit(docs/**)",
+      "Write(docs/**)"
+    ]
+  }
+}

package/scaffold/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx drm-core@1.2.0 install)",
+      "Bash(npx drm-core:*)"
+    ]
+  }
+}

package/scaffold/.drm/config.yaml

@@ -1,6 +1,6 @@
 # DRM Runtime Config
 framework:
-  version: "1.0.0"
+  version: "1.4.0"
   name: "DRM — Direct Response Marketing"
 
 project:

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

@@ -67,6 +67,14 @@ core_principles:
   - "CTA impossivel de perder — tamanho, cor, contraste, posicao"
   - "Hierarquia visual guia o olhar — teste, nao assuma"
   - "Menos friction, mais conversao — Peep Laja"
+
+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"
 ```
 
 ---
@@ -103,6 +111,8 @@ commands:
 dependencies:
   templates: []
   checklists: []
+  rules:
+    - interaction-patterns.md
 ```
 
 ---

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

@@ -60,6 +60,14 @@ core_principles:
   - "Claims rastreiam beneficios reais — nenhuma promessa sem lastro"
   - "Linguagem do avatar — escrever como o publico fala, nao como o copywriter quer falar"
 
+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:
   - "Design"
   - "Edicao de video"
@@ -120,4 +128,5 @@ dependencies:
     - "copy-quality-gate.md"
   rules:
     - "copy-standards.md"
+    - "interaction-patterns.md"
 ```