drm-core 1.0.0

package/scaffold/.drm-core/constitution.md

@@ -0,0 +1,171 @@
+# Constituicao DRM — Direct Response Marketing Framework
+
+> "O framework que converte. Sem excecao."
+
+---
+
+## Artigo I — Conversao First (NON-NEGOTIABLE)
+
+**Principio:** "Se nao converte, nao existe."
+
+**Severidade do Gate:** BLOCK
+
+**Enforcement:**
+- Campo `objetivo-conversao` e **obrigatorio** em todo output produzido por qualquer agente
+- Nenhum criativo, copy, funil ou campanha avanca sem objetivo de conversao explicito
+
+**Validacao obrigatoria:**
+1. **CTA em toda copy** — Sem CTA = BLOCK automatico. Toda peca deve ter chamada para acao clara, especifica e mensuravel
+2. **Objetivo mensuravel em criativos** — Todo criativo deve declarar qual metrica sera impactada (clique, lead, venda, agendamento)
+3. **Metrica de conversao por etapa de funil** — Cada etapa do funil deve ter sua metrica de conversao definida antes da producao
+
+**Exemplos de violacao:**
+- Copy sem CTA → BLOCK
+- Criativo "de branding" sem objetivo mensuravel → BLOCK
+- Funil sem metricas por etapa → BLOCK
+- Output sem campo `objetivo-conversao` → BLOCK
+
+---
+
+## Artigo II — Agent Authority (NON-NEGOTIABLE)
+
+**Principio:** "Cada deus reina no seu dominio."
+
+**Severidade do Gate:** BLOCK
+
+**Matriz de autoridade:**
+
+| Agente | Dominio | Autoridade Exclusiva |
+|--------|---------|---------------------|
+| `@atena` | Estrategia | Planejamento estrategico, posicionamento, big ideas |
+| `@apolo` | Copy | Toda palavra escrita — VSL, ads, emails, headlines |
+| `@hermes` | Trafego | Gestao de campanhas, otimizacao de midia, distribuicao |
+| `@zeus` | Direcao Criativa | Validacao criativa, direcao visual/narrativa, aprovacao final de pecas |
+| `@cronos` | Dados | Relatorios, analise de metricas, dashboards, benchmarks |
+| `@hefesto` | Video | Producao de video, edicao, motion, roteirizacao tecnica |
+| `@afrodite` | Design | Design grafico, identidade visual, criativos estaticos |
+| `@temis` | Compliance | Validacao regulatoria, politicas de plataforma, LGPD |
+| `@poseidon` | Funil | Arquitetura de funil, paginas, fluxos, automacoes |
+
+**Regras de delegacao:**
+- Agente so opera dentro do seu dominio
+- Invasao de dominio = BLOCK
+- Colaboracao entre agentes e permitida, mas cada um entrega apenas no seu escopo
+- Conflitos entre agentes → escalam para `@zeus` (criativo) ou `@atena` (estrategico)
+
+---
+
+## Artigo III — Data-Driven (MUST)
+
+**Principio:** "Sem dado, sem decisao."
+
+**Severidade do Gate:**
+- BLOCK para decisoes de **escala** e **otimizacao**
+- WARN para decisoes de **criativo**
+
+**O que constitui "dado":**
+1. Relatorio oficial de `@cronos` com fonte e periodo
+2. Metricas com fonte rastreavel (plataforma, ferramenta, relatorio)
+3. Benchmark documentado em `metricas-referencia.md`
+
+**Pre-conditions:**
+- **Escalar campanha** → exige relatorio de `@cronos` com metricas dos ultimos 7 dias minimo. Sem relatorio = BLOCK
+- **Otimizar campanha** → exige diagnostico de `@cronos` identificando gargalo. Sem diagnostico = BLOCK
+- **Pausar campanha** → exige justificativa com dados. Sem dados = BLOCK
+
+**Excecao documentada:**
+- **Lancamento novo** (primeiros 3-7 dias): decisoes podem ser tomadas sem historico, mas devem declarar `base: lancamento-novo` e definir metricas de acompanhamento
+
+---
+
+## Artigo IV — No Invention (MUST)
+
+**Principio:** "O mercado dita. Nos executamos."
+
+**Severidade do Gate:** BLOCK
+
+**Regras:**
+1. **Claim sem fonte = removido** — Toda afirmacao sobre resultado, beneficio ou transformacao deve ter fonte rastreavel (depoimento, estudo, dado interno, pesquisa)
+2. **Promessa sem base = cortada** — Promessas de resultado devem ser baseadas em dados reais de clientes ou benchmarks documentados
+3. **Feature inventada = bloqueada** — Nao adicionar funcionalidades, bonus ou beneficios que o produto nao possui
+4. **Mecanismo inventado = bloqueado** — O mecanismo unico deve ser real e verificavel
+
+**Fontes aceitas:**
+- Depoimentos reais de clientes
+- Dados internos de vendas/resultados
+- Pesquisas publicadas (com referencia)
+- Benchmarks do mercado documentados
+- Briefing aprovado do cliente/produto
+
+**Fontes NAO aceitas:**
+- "Todo mundo sabe que..."
+- Resultados hipoteticos sem base
+- Comparacoes sem dados
+- Promessas absolutas ("garantido", "100%", "sempre")
+
+---
+
+## Artigo V — Compliance First (MUST)
+
+**Principio:** "Conta banida e game over."
+
+**Severidade do Gate:** BLOCK
+
+**Fluxo obrigatorio:**
+1. Qualquer peca antes de publicar → `@temis` valida
+2. `@temis` emite verdict formal
+3. Sem verdict de `@temis` = publicacao bloqueada
+
+**Verdicts de `@temis`:**
+
+| Verdict | Significado | Acao |
+|---------|------------|------|
+| `APROVADO` | Peca em conformidade total | Pode publicar |
+| `AJUSTES NECESSARIOS` | Problemas corrigiveis identificados | Maximo 2 rodadas de ajuste, depois escala |
+| `BLOQUEADO` | Violacao grave detectada | Peca nao pode ser publicada. Requer reescrita |
+
+**Escopo de validacao:**
+- Politicas da plataforma (Meta, Google, TikTok)
+- Regulatorio brasileiro (CONAR, CDC, Procon)
+- LGPD (dados pessoais, consentimento)
+- Claims e promessas (Artigo IV)
+- Imagens e video (direitos autorais, antes/depois)
+
+---
+
+## Artigo VI — Copy is King (SHOULD)
+
+**Principio:** "A palavra vende. O resto amplifica."
+
+**Severidade do Gate:** WARN
+
+**Ordem de producao obrigatoria:**
+1. `@apolo` escreve a copy (mensagem central, headlines, CTA, roteiro)
+2. `@zeus` valida a direcao criativa (alinhamento com estrategia, tom, posicionamento)
+3. `@hefesto` produz video / `@afrodite` produz design (baseado na copy aprovada)
+4. `@poseidon` monta o funil (usando copy e criativos aprovados)
+5. `@hermes` distribui (campanha configurada com criativos finais)
+
+**Violacoes:**
+- Produzir video antes da copy estar aprovada → WARN
+- Montar funil sem copy finalizada → WARN
+- Distribuir sem pecas aprovadas por `@zeus` → WARN
+
+**Logica:** A copy define a mensagem. O criativo amplifica. O funil entrega. O trafego distribui. Inverter essa ordem gera retrabalho e pecas desalinhadas.
+
+---
+
+## Tabela de Severidade dos Gates
+
+| Artigo | Principio | Severidade | Trigger |
+|--------|-----------|-----------|---------|
+| I | Conversao First | **BLOCK** | Output sem `objetivo-conversao`, copy sem CTA, criativo sem metrica |
+| II | Agent Authority | **BLOCK** | Agente operando fora do seu dominio |
+| III | Data-Driven | **BLOCK** / **WARN** | Escala/otimizacao sem relatorio (BLOCK), criativo sem dado (WARN) |
+| IV | No Invention | **BLOCK** | Claim sem fonte, promessa sem base, feature inventada |
+| V | Compliance First | **BLOCK** | Publicacao sem verdict de `@temis` |
+| VI | Copy is King | **WARN** | Producao fora de ordem (criativo antes de copy) |
+
+---
+
+*DRM Constitution v1.0 — Direct Response Marketing Framework*

package/scaffold/.drm-core/rules/compliance-rules.md

@@ -0,0 +1,153 @@
+# Regras de Compliance — DRM Framework
+
+> "Conta banida e game over." — Artigo V, Constituicao DRM
+
+---
+
+## Regras por Plataforma
+
+### Meta Ads (Facebook / Instagram)
+
+| # | Regra | Consequencia da Violacao |
+|---|-------|-------------------------|
+| 1 | Proibido antes/depois em imagens de saude/corpo | Rejeicao do anuncio + risco de ban |
+| 2 | Proibido claims de resultados garantidos ("voce VAI ganhar R$10k") | Rejeicao + restricao de conta |
+| 3 | Proibido mencionar atributos pessoais diretamente ("voce que e gordo") | Rejeicao imediata |
+| 4 | Proibido conteudo enganoso ou clickbait extremo | Reducao de distribuicao + rejeicao |
+| 5 | Proibido landing pages que nao correspondem ao anuncio | Rejeicao + queda de quality score |
+| 6 | Proibido uso de marca Meta/Facebook sem autorizacao | Rejeicao |
+| 7 | Proibido conteudo sensacionalista ou que explore medos | Rejeicao + restricao |
+| 8 | Obrigatorio ter politica de privacidade na landing page | Rejeicao |
+| 9 | Proibido redirecionamentos automaticos ou pop-ups agressivos | Rejeicao + restricao |
+| 10 | Proibido discriminacao por raca, genero, religiao, orientacao sexual | Ban permanente |
+
+### Google Ads
+
+| # | Regra | Consequencia da Violacao |
+|---|-------|-------------------------|
+| 1 | Proibido superlativos sem fonte ("o melhor do Brasil") | Rejeicao do anuncio |
+| 2 | Proibido claims de saude sem disclaimer | Rejeicao + suspensao |
+| 3 | Obrigatorio correspondencia entre keyword, anuncio e landing page | Queda de Quality Score + rejeicao |
+| 4 | Proibido uso de marcas registradas de terceiros sem autorizacao | Rejeicao + possivel acao legal |
+
+### TikTok Ads
+
+| # | Regra | Consequencia da Violacao |
+|---|-------|-------------------------|
+| 1 | Proibido conteudo que simule interface do TikTok (botoes falsos, notificacoes) | Rejeicao imediata |
+| 2 | Proibido claims de saude/financeiros sem disclaimer | Rejeicao + restricao |
+| 3 | Proibido conteudo adulto, violento ou chocante | Ban permanente |
+| 4 | Obrigatorio respeitar direitos autorais de musicas/sons | Rejeicao + strike |
+
+---
+
+## Regulatorio Brasileiro
+
+### CONAR (Conselho Nacional de Autorregulamentacao Publicitaria)
+
+- Publicidade deve ser honesta, verdadeira e identificavel como publicidade
+- Proibido publicidade enganosa ou abusiva
+- Depoimentos devem ser reais e verificaveis
+- Comparacoes devem ser objetivas e comprovanveis
+- Publicidade para criancas tem restricoes especificas
+
+### CDC — Codigo de Defesa do Consumidor
+
+| Item | Regra |
+|------|-------|
+| **Direito de arrependimento** | 7 dias para compras online (Art. 49). Obrigatorio informar |
+| **Publicidade enganosa** | Informacao falsa sobre produto/servico = infracao (Art. 37) |
+| **Publicidade abusiva** | Explorar medo, supersticao ou deficiencia = infracao (Art. 37) |
+| **Oferta vinculante** | Preco/condicao anunciada deve ser cumprida (Art. 30) |
+| **Informacoes claras** | Preco, condicoes, riscos devem ser explicitos (Art. 31) |
+
+### Procon
+
+- Reclamacoes de consumidores podem gerar multas e processos
+- Praticas abusivas sao fiscalizadas ativamente
+- Clausulas abusivas em contratos sao nulas
+- Publicidade deve corresponder exatamente ao produto/servico entregue
+
+---
+
+## LGPD — Lei Geral de Protecao de Dados
+
+| # | Requisito | Detalhes |
+|---|-----------|---------|
+| 1 | **Consentimento explicito** | Coletar dados pessoais exige consentimento claro e especifico. Opt-in ativo (nao pre-marcado) |
+| 2 | **Finalidade declarada** | Informar para que os dados serao usados ANTES da coleta. Uso diferente do declarado = violacao |
+| 3 | **Base legal** | Toda coleta/tratamento deve ter base legal (consentimento, contrato, interesse legitimo, etc.) |
+| 4 | **Direitos do titular** | Garantir acesso, correcao, exclusao, portabilidade dos dados quando solicitado |
+| 5 | **DPO (Encarregado)** | Nomear responsavel pelo tratamento de dados. Informar contato publicamente |
+| 6 | **Notificacao de incidentes** | Em caso de vazamento, notificar ANPD e titulares em prazo razoavel |
+
+**Aplicacao pratica em marketing digital:**
+- Formularios de captura devem ter checkbox de consentimento (nao pre-marcado)
+- Politica de privacidade deve estar linkada em toda landing page
+- Listas de email/WhatsApp devem ter base legal documentada
+- Pixels de rastreamento devem estar declarados na politica de privacidade
+- Dados de clientes nao podem ser compartilhados sem consentimento
+
+---
+
+## WhatsApp — Regras de Comunicacao
+
+| # | Regra | Detalhes |
+|---|-------|---------|
+| 1 | **Opt-in obrigatorio** | Contato so pode ser adicionado com consentimento explicito. Comprar listas = violacao |
+| 2 | **Opcao STOP** | Toda mensagem deve ter opcao clara de descadastramento ("Digite SAIR para nao receber mais mensagens") |
+| 3 | **Frequencia controlada** | Maximo de mensagens por dia/semana definido e respeitado. Excesso = bloqueio pelo WhatsApp |
+| 4 | **Horario comercial** | Envios preferencialmente em horario comercial (8h-20h). Evitar madrugadas e fins de semana cedo |
+| 5 | **LGPD aplicavel** | Todas as regras de LGPD se aplicam integralmente ao WhatsApp |
+| 6 | **Proibido spam** | Mensagens nao solicitadas, repetitivas ou irrelevantes configuram spam. Risco de ban do numero |
+
+**Boas praticas:**
+- Segmentar listas por interesse e etapa do funil
+- Personalizar mensagens (nome, contexto da compra)
+- Respeitar o "nao" — contato que pediu para sair NUNCA mais recebe
+- Manter historico de consentimento documentado
+- Usar templates aprovados pelo WhatsApp Business API quando aplicavel
+
+---
+
+## Fluxo de Validacao `@temis`
+
+```
+Peca criada
+    |
+    v
+@temis recebe para validacao
+    |
+    v
+Checklist de compliance:
+    [1] Politicas da plataforma?
+    [2] CONAR/CDC/Procon?
+    [3] LGPD?
+    [4] Claims verificaveis? (Art. IV)
+    [5] Antes/depois proibido?
+    [6] Disclaimers necessarios?
+    |
+    v
+Verdict:
+    APROVADO ---------> Pode publicar
+    AJUSTES ----------> Corrigir (max 2 rodadas)
+    BLOQUEADO --------> Reescrever do zero
+```
+
+---
+
+## Checklist Pre-Publicacao de Compliance
+
+- [ ] Politica de privacidade na landing page
+- [ ] Consentimento LGPD em formularios (opt-in ativo)
+- [ ] Nenhum claim sem fonte verificavel
+- [ ] Nenhuma promessa de resultado garantido
+- [ ] Nenhuma referencia a atributos pessoais diretos
+- [ ] Direito de arrependimento informado (7 dias)
+- [ ] Disclaimers necessarios presentes
+- [ ] Opcao de descadastramento em comunicacoes
+- [ ] Verdict de `@temis`: APROVADO
+
+---
+
+*Compliance Rules v1.0 — DRM Framework*

package/scaffold/.drm-core/rules/copy-standards.md

@@ -0,0 +1,154 @@
+# Padroes de Copy — DRM Framework
+
+> "A palavra vende. O resto amplifica." — Artigo VI, Constituicao DRM
+
+---
+
+## Frameworks Aceitos
+
+| Framework | Autor | Uso Principal |
+|-----------|-------|---------------|
+| **RMBC** (Research, Mechanism, Brief, Copy) | Stefan Georgi | VSLs, cartas de venda longas |
+| **5 Niveis de Consciencia** | Eugene Schwartz | Definicao de abordagem por nivel do lead |
+| **C.A.S.H.** (Conceito, Angulo, Estilo, Hook) | Stefan Georgi | Ads de resposta direta, criativos |
+| **PAS** (Problem, Agitate, Solution) | Classico DR | Emails, ads curtos, posts |
+| **AIDA** (Attention, Interest, Desire, Action) | Classico DR | Landing pages, sequencias |
+| **Simple Writing System** | John Carlton | Copy conversacional, storytelling |
+
+---
+
+## 8 Regras Inegociaveis de Copy
+
+### Regra 1 — CTA Obrigatorio
+Toda peca de copy DEVE ter pelo menos um CTA (Call to Action) claro, especifico e acionavel.
+- CTA vago ("saiba mais") → reescrever com acao especifica
+- CTA ausente → BLOCK (Artigo I)
+- CTA ideal: verbo de acao + beneficio + urgencia
+
+**Exemplos:**
+- Ruim: "Clique aqui"
+- Bom: "Comece seu teste gratuito de 7 dias agora"
+- Excelente: "Garanta sua vaga antes que as 50 vagas acabem — clique no botao abaixo"
+
+### Regra 2 — Mecanismo Unico
+Todo produto/oferta DEVE ter um mecanismo unico claramente articulado.
+- O mecanismo explica POR QUE a solucao funciona
+- Deve ser real e verificavel (Artigo IV — No Invention)
+- Diferencia da concorrencia e justifica a compra
+
+### Regra 3 — Hook em 3 Segundos
+Os primeiros 3 segundos (video) ou primeira linha (texto) DEVEM capturar atencao.
+- Hook deve gerar curiosidade, identificacao ou choque
+- Testar multiplos hooks por peca (minimo 3 variacoes)
+- Hook fraco = desperdicio de verba
+
+**Tipos de hook eficazes:**
+- Pergunta provocativa
+- Afirmacao contraintuitiva
+- Dado surpreendente
+- Historia pessoal impactante
+- Chamada direta ao publico-alvo
+
+### Regra 4 — Nivel de Consciencia Antes de Escrever
+ANTES de escrever qualquer copy, definir o nivel de consciencia do publico (Schwartz).
+
+| Nivel | Consciencia | Abordagem |
+|-------|------------|-----------|
+| 1 | **Inconsciente** | Nao sabe que tem o problema. Liderar com historia/conteudo |
+| 2 | **Consciente do problema** | Sabe que tem o problema, nao sabe a solucao. Agitar a dor |
+| 3 | **Consciente da solucao** | Sabe que existem solucoes, nao conhece a sua. Apresentar mecanismo |
+| 4 | **Consciente do produto** | Conhece seu produto, ainda nao comprou. Prova social + oferta |
+| 5 | **Mais consciente** | Ja comprou ou quase comprou. Oferta direta + urgencia |
+
+### Regra 5 — Claims Rastreiam Beneficios
+Todo claim (afirmacao) deve rastrear um beneficio real e verificavel.
+- Claim → Beneficio → Fonte/Prova
+- Sem cadeia de rastreio = claim removido (Artigo IV)
+
+### Regra 6 — Linguagem BR
+Toda copy DEVE ser escrita em portugues brasileiro natural e conversacional.
+- Evitar portugues de Portugal
+- Usar vocabulario do publico-alvo
+- Contraccoes e informalidade sao aceitas quando apropriadas
+- Tom: como se estivesse falando com um amigo que precisa de ajuda
+
+### Regra 7 — Objetivo-Conversao Declarado
+Toda peca de copy DEVE declarar seu `objetivo-conversao` antes da producao.
+- Qual acao o leitor/espectador deve tomar?
+- Qual metrica mede o sucesso dessa peca?
+- Campo obrigatorio no header de todo documento de copy
+
+### Regra 8 — Sem Jargao
+Proibido usar jargao tecnico, termos de marketing ou linguagem corporativa na copy voltada ao consumidor.
+- "Sinergia", "otimizar", "alavancar" → PROIBIDO
+- "Metodologia proprietaria" → substituir por explicacao simples
+- Se o publico nao usa a palavra no dia a dia, trocar
+
+---
+
+## Estrutura VSL — Metodo RMBC (Stefan Georgi)
+
+### Secao 1 — Pre-Lead (Hook)
+- **Objetivo:** Capturar atencao nos primeiros 3-5 segundos
+- **Conteudo:** Hook principal + identificacao do publico
+- **Duracao:** 15-30 segundos
+- **Regra:** Testar minimo 3 variacoes de hook
+
+### Secao 2 — Lead
+- **Objetivo:** Conectar emocionalmente e estabelecer relevancia
+- **Conteudo:** Historia de identificacao, dor principal, promessa implicita
+- **Duracao:** 1-3 minutos
+- **Regra:** Nivel de consciencia define o tipo de lead
+
+| Nivel Consciencia | Tipo de Lead |
+|-------------------|-------------|
+| 1-2 (Inconsciente/Problema) | Lead indireto — historia, analogia |
+| 3 (Solucao) | Lead de solucao — mecanismo novo |
+| 4-5 (Produto/Mais consciente) | Lead direto — oferta, prova |
+
+### Secao 3 — Background Story / Credibilidade
+- **Objetivo:** Estabelecer autoridade e confianca
+- **Conteudo:** Historia do criador/especialista, credenciais relevantes, jornada
+- **Duracao:** 2-4 minutos
+- **Regra:** Historia deve ser real (Artigo IV). Credenciais verificaveis
+
+### Secao 4 — Mecanismo do Problema
+- **Objetivo:** Explicar POR QUE o problema existe e por que solucoes anteriores falharam
+- **Conteudo:** Inimigo comum, razao oculta, mecanismo que causa o problema
+- **Duracao:** 3-5 minutos
+- **Regra:** Mecanismo deve ser compreensivel para leigo (Regra 8 — Sem Jargao)
+
+### Secao 5 — Mecanismo da Solucao
+- **Objetivo:** Apresentar o mecanismo unico que resolve o problema
+- **Conteudo:** Como funciona, por que e diferente, por que funciona agora
+- **Duracao:** 3-5 minutos
+- **Regra:** Mecanismo unico obrigatorio (Regra 2). Real e verificavel (Artigo IV)
+
+### Secao 6 — Product Build-up + Oferta
+- **Objetivo:** Apresentar o produto e construir valor antes do preco
+- **Conteudo:** O que esta incluso, bonus, garantia, ancoragem de preco
+- **Duracao:** 3-5 minutos
+- **Regra:** Stack de valor deve ser honesto. Preco ancora deve ter base real
+
+### Secao 7 — Close (CTA + Urgencia)
+- **Objetivo:** Converter. Fazer o espectador tomar acao AGORA
+- **Conteudo:** CTA claro, urgencia real, reversal de risco, ultimo empurrao emocional
+- **Duracao:** 2-3 minutos
+- **Regra:** CTA obrigatorio (Regra 1). Urgencia deve ser real, nao fabricada
+
+---
+
+## Checklist Pre-Publicacao de Copy
+
+- [ ] `objetivo-conversao` declarado no header
+- [ ] Nivel de consciencia do publico definido
+- [ ] CTA claro e especifico presente
+- [ ] Mecanismo unico articulado
+- [ ] Hook testavel nos primeiros 3 segundos
+- [ ] Claims rastreiam beneficios com fonte
+- [ ] Linguagem BR natural, sem jargao
+- [ ] Validacao de `@temis` solicitada (Artigo V)
+
+---
+
+*Copy Standards v1.0 — DRM Framework*