drm-core 1.0.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/cli/index.js +396 -201
  2. package/package.json +1 -1
  3. package/scaffold/.claude/CLAUDE.md +65 -0
  4. package/scaffold/.claude/settings.json +30 -0
  5. package/scaffold/.claude/settings.local.json +8 -0
  6. package/scaffold/.drm-core/agents/afrodite.md +10 -0
  7. package/scaffold/.drm-core/agents/apolo.md +9 -0
  8. package/scaffold/.drm-core/agents/atena.md +9 -0
  9. package/scaffold/.drm-core/agents/cronos.md +9 -0
  10. package/scaffold/.drm-core/agents/hefesto.md +10 -0
  11. package/scaffold/.drm-core/agents/hermes.md +9 -0
  12. package/scaffold/.drm-core/agents/poseidon.md +9 -0
  13. package/scaffold/.drm-core/agents/temis.md +9 -0
  14. package/scaffold/.drm-core/agents/zeus.md +10 -0
  15. package/scaffold/.drm-core/checklists/campanha-pre-launch.md +49 -0
  16. package/scaffold/.drm-core/checklists/compliance-google.md +46 -0
  17. package/scaffold/.drm-core/checklists/compliance-meta.md +49 -0
  18. package/scaffold/.drm-core/checklists/compliance-tiktok.md +46 -0
  19. package/scaffold/.drm-core/checklists/compliance-vsl.md +48 -0
  20. package/scaffold/.drm-core/checklists/copy-quality-gate.md +55 -0
  21. package/scaffold/.drm-core/checklists/funil-pre-launch.md +66 -0
  22. package/scaffold/.drm-core/checklists/whatsapp-compliance.md +49 -0
  23. package/scaffold/.drm-core/data/agent-config.yaml +220 -0
  24. package/scaffold/.drm-core/data/workflow-chains.yaml +374 -0
  25. package/scaffold/.drm-core/rules/interaction-patterns.md +138 -0
  26. package/scaffold/.drm-core/tasks/analise/diagnostico-funil.md +314 -0
  27. package/scaffold/.drm-core/tasks/compliance/revisar-ad-meta.md +242 -0
  28. package/scaffold/.drm-core/tasks/copy/escrever-ad-meta.md +191 -0
  29. package/scaffold/.drm-core/tasks/copy/escrever-email-sequence.md +237 -0
  30. package/scaffold/.drm-core/tasks/copy/escrever-msgs-whatsapp.md +220 -0
  31. package/scaffold/.drm-core/tasks/copy/escrever-pagina-vendas.md +276 -0
  32. package/scaffold/.drm-core/tasks/copy/escrever-vsl-full.md +235 -0
  33. package/scaffold/.drm-core/tasks/direcao-criativa/criar-conceito.md +249 -0
  34. package/scaffold/.drm-core/tasks/direcao-criativa/validar-criativo.md +202 -0
  35. package/scaffold/.drm-core/tasks/estrategia/criar-briefing.md +221 -0
  36. package/scaffold/.drm-core/tasks/estrategia/pesquisa-mercado.md +200 -0
  37. package/scaffold/.drm-core/tasks/funil/arquitetar-funil-vsl.md +228 -0
  38. package/scaffold/.drm-core/tasks/funil/fluxo-whatsapp-backend.md +291 -0
  39. package/scaffold/.drm-core/tasks/trafego/escalar-campanha.md +256 -0
  40. package/scaffold/.drm-core/tasks/trafego/montar-campanha-meta.md +303 -0
  41. package/scaffold/.drm-core/templates/ad-meta-template.md +391 -0
  42. package/scaffold/.drm-core/templates/avatar-template.md +468 -0
  43. package/scaffold/.drm-core/templates/briefing-estrategico-template.md +462 -0
  44. package/scaffold/.drm-core/templates/compliance-report-template.md +86 -0
  45. package/scaffold/.drm-core/templates/estrutura-campanha-template.md +492 -0
  46. package/scaffold/.drm-core/templates/funil-vsl-template.md +470 -0
  47. package/scaffold/.drm-core/templates/msgs-whatsapp-template.md +516 -0
  48. package/scaffold/.drm-core/templates/pagina-vendas-template.md +517 -0
  49. package/scaffold/.drm-core/templates/relatorio-template.md +313 -0
  50. package/scaffold/.drm-core/templates/vsl-curta-template.md +341 -0
  51. package/scaffold/.drm-core/templates/vsl-full-template.md +780 -0
  52. package/scaffold/.drm-core/templates/vsl-mini-template.md +360 -0
  53. package/scaffold/.drm-core/workflows/backend-whatsapp.yaml +395 -0
  54. package/scaffold/.drm-core/workflows/campanha-trafego.yaml +465 -0
  55. package/scaffold/.drm-core/workflows/copy-review-loop.yaml +333 -0
  56. package/scaffold/.drm-core/workflows/funil-vsl-completo.yaml +544 -0
  57. package/scaffold/.drm-core/workflows/lancamento-produto.yaml +402 -0
  58. package/scaffold/.drm-core/workflows/microlead-pipeline.yaml +408 -0
  59. package/scaffold/.drm-core/workflows/otimizacao-cycle.yaml +394 -0
  60. package/scaffold/.drm-core/workflows/reativacao-cycle.yaml +468 -0
@@ -0,0 +1,314 @@
1
+ ---
2
+ task: diagnostico-funil()
3
+ responsavel: Analista
4
+ tipo: analise
5
+ ---
6
+
7
+ # Diagnostico de Funil
8
+
9
+ ## Descricao
10
+
11
+ Coletar metricas de cada etapa do funil, comparar com benchmarks de referencia (metricas-referencia.md), identificar o gargalo principal (maior gap entre metrica real e benchmark), diagnosticar a causa raiz usando arvore de decisao por etapa (LP baixa → copy/design/velocidade, Checkout baixa → confianca/preco/UX, Upsell baixa → oferta/timing), e recomendar acoes corretivas com atribuicao de agente responsavel.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Metricas do funil | Meta Ads Manager + Plataforma | Sim | Dados de pelo menos 7 dias |
18
+ | Arquitetura do funil | `arquitetar-funil-vsl.md` output | Sim | Etapas definidas |
19
+ | Benchmarks | `metricas-referencia.md` | Sim | Valores de referencia por etapa |
20
+ | Periodo de analise | Usuario | Sim | Data inicio e fim (min 7 dias) |
21
+ | Volume de trafego | Meta Ads | Sim | Impressoes, cliques, gastos |
22
+ | Dados de conversao | Plataforma de checkout | Sim | Vendas, abandono, upsell take |
23
+
24
+ ## Saida
25
+
26
+ | Campo | Destino | Template |
27
+ |-------|---------|----------|
28
+ | Relatorio de diagnostico | `outputs/analise/diagnostico-funil-{data}.md` | — |
29
+ | Mapa de metricas por etapa | Secao do relatorio | — |
30
+ | Identificacao do gargalo | Secao do relatorio | — |
31
+ | Diagnostico de causa raiz | Secao do relatorio | — |
32
+ | Plano de acao com responsaveis | Secao do relatorio | — |
33
+
34
+ ## Pre-conditions
35
+
36
+ - [ ] Funil ativo com trafego ha pelo menos 7 dias
37
+ - [ ] Acesso aos dados de Meta Ads (impressoes, cliques, CPC, CTR)
38
+ - [ ] Acesso aos dados da plataforma de checkout (vendas, abandono)
39
+ - [ ] Benchmarks de referencia disponiveis
40
+ - [ ] Periodo de analise definido
41
+
42
+ ## Workflow
43
+
44
+ ### Passo 1 — Coletar metricas por etapa
45
+
46
+ 1. **Coletar dados de cada etapa do funil**:
47
+
48
+ | Etapa | Metrica | Valor real | Benchmark | Gap | Status |
49
+ |-------|---------|-----------|-----------|-----|--------|
50
+ | **Anuncio** | CPM | R$ [valor] | R$ 15-30 | [%] | OK/ALERTA/CRITICO |
51
+ | **Anuncio** | CTR | [%] | > 1.5% | [%] | OK/ALERTA/CRITICO |
52
+ | **Anuncio** | CPC | R$ [valor] | R$ 1-3 | [%] | OK/ALERTA/CRITICO |
53
+ | **Anuncio** | Hook rate (3s view) | [%] | > 25% | [%] | OK/ALERTA/CRITICO |
54
+ | **Anuncio** | ThruPlay (15s+) | [%] | > 15% | [%] | OK/ALERTA/CRITICO |
55
+ | **LP/VSL** | Taxa de visualizacao | [%] | > 30% (play) | [%] | OK/ALERTA/CRITICO |
56
+ | **LP/VSL** | Tempo medio na pagina | [seg] | > 120s | [%] | OK/ALERTA/CRITICO |
57
+ | **LP/VSL** | Taxa de clique no CTA | [%] | > 10% | [%] | OK/ALERTA/CRITICO |
58
+ | **LP/VSL** | Bounce rate | [%] | < 60% | [%] | OK/ALERTA/CRITICO |
59
+ | **Checkout** | Taxa de inicio | [%] | > 30% dos cliques CTA | [%] | OK/ALERTA/CRITICO |
60
+ | **Checkout** | Taxa de conclusao | [%] | > 50% dos que iniciam | [%] | OK/ALERTA/CRITICO |
61
+ | **Checkout** | Taxa de abandono | [%] | < 50% | [%] | OK/ALERTA/CRITICO |
62
+ | **Bump** | Take rate | [%] | > 20% | [%] | OK/ALERTA/CRITICO |
63
+ | **Upsell** | Take rate | [%] | > 15% | [%] | OK/ALERTA/CRITICO |
64
+ | **Downsell** | Take rate | [%] | > 10% | [%] | OK/ALERTA/CRITICO |
65
+ | **Global** | CPA | R$ [valor] | R$ [alvo] | [%] | OK/ALERTA/CRITICO |
66
+ | **Global** | ROAS | [x] | > [alvo]x | [%] | OK/ALERTA/CRITICO |
67
+ | **Global** | AOV | R$ [valor] | R$ [esperado] | [%] | OK/ALERTA/CRITICO |
68
+
69
+ 2. **Classificar status de cada metrica**:
70
+ - **OK**: Dentro do benchmark (+/- 10%)
71
+ - **ALERTA**: 10-30% abaixo do benchmark
72
+ - **CRITICO**: > 30% abaixo do benchmark
73
+
74
+ ### Passo 2 — Identificar gargalo principal
75
+
76
+ 3. **Calcular o gap percentual** de cada metrica:
77
+ ```
78
+ Gap = (Benchmark - Valor Real) / Benchmark * 100
79
+ ```
80
+
81
+ 4. **Rankear por impacto no resultado final**:
82
+ - Multiplicar o gap pelo peso da etapa:
83
+
84
+ | Etapa | Peso | Justificativa |
85
+ |-------|------|---------------|
86
+ | Anuncio (CTR) | 3 | Afeta todo o funil |
87
+ | LP/VSL (CTA click) | 3 | Determina volume no checkout |
88
+ | Checkout (conclusao) | 5 | Conversao final |
89
+ | Bump (take rate) | 1 | Impacto no AOV |
90
+ | Upsell (take rate) | 2 | Impacto significativo no AOV |
91
+
92
+ ```
93
+ Impacto = Gap% * Peso
94
+ ```
95
+
96
+ 5. **Identificar o gargalo**: Etapa com maior valor de Impacto.
97
+ ```
98
+ GARGALO IDENTIFICADO
99
+ Etapa: [nome da etapa]
100
+ Metrica: [qual metrica]
101
+ Valor real: [X]
102
+ Benchmark: [Y]
103
+ Gap: [Z%]
104
+ Impacto calculado: [valor]
105
+ ```
106
+
107
+ ### Passo 3 — Diagnosticar causa raiz
108
+
109
+ 6. **Aplicar arvore de decisao** baseada na etapa do gargalo:
110
+
111
+ **Se gargalo e no ANUNCIO (CTR/Hook rate baixo)**:
112
+ ```
113
+ CTR < 1.5%?
114
+ ├── Hook rate < 25%?
115
+ │ ├── SIM → Problema: HOOK FRACO
116
+ │ │ Causa provavel: Hook nao prende nos 3 primeiros segundos
117
+ │ │ Acoes: Testar novos hooks, mudar formato visual, testar novo angulo
118
+ │ │ Responsavel: Diretor Criativo (criar-conceito.md)
119
+ │ └── NAO → Problema: BODY/CTA FRACO
120
+ │ Causa provavel: Hook funciona mas copy nao converte
121
+ │ Acoes: Revisar Primary Text, testar CTA diferente
122
+ │ Responsavel: Copywriter (escrever-ad-meta.md)
123
+ └── CPM > 2x media?
124
+ ├── SIM → Problema: AUDIENCIA SATURADA/CARA
125
+ │ Causa provavel: Audiencia muito pequena ou competitiva
126
+ │ Acoes: Testar nova audiencia, expandir LAL, testar broad
127
+ │ Responsavel: Media Buyer (montar-campanha-meta.md)
128
+ └── NAO → Problema: CRIATIVO NAO RELEVANTE
129
+ Causa provavel: Criativo nao ressoa com a audiencia
130
+ Acoes: Testar novo angulo, novo formato, novo conceito
131
+ Responsavel: Diretor Criativo (criar-conceito.md)
132
+ ```
133
+
134
+ **Se gargalo e na LP/VSL (taxa de clique CTA baixa)**:
135
+ ```
136
+ CTA click < 10%?
137
+ ├── Bounce rate > 60%?
138
+ │ ├── Tempo < 10s?
139
+ │ │ ├── SIM → Problema: VELOCIDADE DE CARREGAMENTO
140
+ │ │ │ Causa: Pagina lenta, usuario sai antes de carregar
141
+ │ │ │ Acoes: Otimizar imagens, minificar JS/CSS, CDN
142
+ │ │ │ Responsavel: Desenvolvedor
143
+ │ │ └── NAO → Problema: DESCONEXAO ANUNCIO-LP
144
+ │ │ Causa: Promessa do anuncio nao corresponde a LP
145
+ │ │ Acoes: Alinhar headline da LP com anuncio
146
+ │ │ Responsavel: Copywriter (escrever-pagina-vendas.md)
147
+ │ └── Bounce rate normal?
148
+ │ ├── Tempo > 120s mas sem CTA click?
149
+ │ │ ├── SIM → Problema: CTA FRACO OU ESCONDIDO
150
+ │ │ │ Causa: Usuario le mas nao encontra ou nao clica no CTA
151
+ │ │ │ Acoes: CTA mais visivel, mais CTAs ao longo da pagina, copy do botao
152
+ │ │ │ Responsavel: Copywriter + Designer
153
+ │ │ └── NAO → Problema: COPY NAO CONVENCE
154
+ │ │ Causa: Conteudo nao gera desejo suficiente
155
+ │ │ Acoes: Reforcar provas, mecanismo, stack de valor
156
+ │ │ Responsavel: Copywriter (escrever-pagina-vendas.md)
157
+ │ └── Play rate < 30% (se VSL)?
158
+ │ └── SIM → Problema: VSL NAO ENGAJA
159
+ │ Causa: Pre-lead ou lead fracos, video nao carrega
160
+ │ Acoes: Revisar hook da VSL, testar autoplay, testar thumbnail
161
+ │ Responsavel: Copywriter (escrever-vsl-full.md)
162
+ ```
163
+
164
+ **Se gargalo e no CHECKOUT (taxa de conclusao baixa)**:
165
+ ```
166
+ Conclusao < 50%?
167
+ ├── Abandono no campo de pagamento?
168
+ │ ├── SIM → Problema: CONFIANCA/SEGURANCA
169
+ │ │ Causa: Usuario nao confia para colocar cartao
170
+ │ │ Acoes: Selos de seguranca, depoimentos no checkout, garantia visivel
171
+ │ │ Responsavel: Designer + Copywriter
172
+ │ └── NAO (abandono antes)?
173
+ │ ├── Campo de endereco? → Problema: FRICAO NO FORMULARIO
174
+ │ │ Acoes: Reduzir campos, auto-complete CEP
175
+ │ │ Responsavel: Desenvolvedor
176
+ │ └── Primeiro campo?
177
+ │ ├── Preco visivel pela primeira vez?
178
+ │ │ ├── SIM → Problema: CHOQUE DE PRECO
179
+ │ │ │ Causa: Preco nao foi ancorado antes do checkout
180
+ │ │ │ Acoes: Ancorar preco na LP, mostrar valor antes
181
+ │ │ │ Responsavel: Copywriter (escrever-pagina-vendas.md)
182
+ │ │ └── NAO → Problema: UX DO CHECKOUT
183
+ │ │ Causa: Interface confusa, muitos passos
184
+ │ │ Acoes: Simplificar checkout, one-page, progress bar
185
+ │ │ Responsavel: Desenvolvedor/Plataforma
186
+ ```
187
+
188
+ **Se gargalo e no UPSELL (take rate baixa)**:
189
+ ```
190
+ Take rate < 15%?
191
+ ├── Pagina de upsell carrega?
192
+ │ ├── NAO → Problema: TECNICO
193
+ │ │ Acoes: Corrigir redirecionamento pos-compra
194
+ │ │ Responsavel: Desenvolvedor
195
+ │ └── SIM
196
+ │ ├── Video de upsell existe?
197
+ │ │ ├── NAO → Problema: SEM ARGUMENTO
198
+ │ │ │ Causa: Upsell so com texto nao converte
199
+ │ │ │ Acoes: Criar video de upsell (3-5 min)
200
+ │ │ │ Responsavel: Copywriter
201
+ │ │ └── SIM → Problema: OFERTA FRACA
202
+ │ │ Causa: Upsell nao e percebido como necessario
203
+ │ │ Acoes: Reposicionar como acelerador, ajustar preco, mudar produto
204
+ │ │ Responsavel: Estrategista (arquitetar-funil-vsl.md)
205
+ │ └── Preco do upsell > 150% do front-end?
206
+ │ └── SIM → Problema: PRECO DESPROPORCIONAL
207
+ │ Acoes: Reduzir preco ou aumentar valor percebido
208
+ │ Responsavel: Estrategista
209
+ ```
210
+
211
+ ### Passo 4 — Recomendar acoes
212
+
213
+ 7. **Para cada problema identificado**, definir acao:
214
+ ```
215
+ ACAO [numero]
216
+ Problema: [descricao]
217
+ Etapa do funil: [onde ocorre]
218
+ Causa raiz: [diagnostico]
219
+ Acao recomendada: [o que fazer]
220
+ Responsavel: [agente/funcao]
221
+ Task relacionada: [task do DRM-Core a executar]
222
+ Prioridade: [CRITICA/ALTA/MEDIA/BAIXA]
223
+ Impacto esperado: [qual metrica deve melhorar e em quanto]
224
+ Prazo sugerido: [dias para implementar]
225
+ ```
226
+
227
+ 8. **Priorizar acoes** por impacto:
228
+ - Prioridade 1: Gargalo principal (maior impacto no resultado final)
229
+ - Prioridade 2: Quick wins (facil de implementar com impacto moderado)
230
+ - Prioridade 3: Otimizacoes incrementais
231
+
232
+ 9. **Tabela resumo de acoes**:
233
+
234
+ | # | Acao | Etapa | Prioridade | Responsavel | Task | Prazo |
235
+ |---|------|-------|-----------|-------------|------|-------|
236
+ | 1 | [acao] | [etapa] | CRITICA | [agente] | [task] | [dias] |
237
+ | 2 | [acao] | [etapa] | ALTA | [agente] | [task] | [dias] |
238
+ | ... | ... | ... | ... | ... | ... | ... |
239
+
240
+ ### Passo 5 — Calcular impacto projetado
241
+
242
+ 10. **Projetar resultado se acoes forem implementadas**:
243
+ ```
244
+ CENARIO ATUAL
245
+ Trafego: [cliques/dia]
246
+ CPA: R$ [valor]
247
+ Vendas: [numero/dia]
248
+ ROAS: [x]
249
+ AOV: R$ [valor]
250
+ Receita: R$ [valor/dia]
251
+
252
+ CENARIO PROJETADO (apos correcoes)
253
+ Metrica corrigida: [qual] de [atual] para [projetado]
254
+ Novo CPA: R$ [valor]
255
+ Novas vendas: [numero/dia]
256
+ Novo ROAS: [x]
257
+ Novo AOV: R$ [valor]
258
+ Nova receita: R$ [valor/dia]
259
+
260
+ GANHO PROJETADO: R$ [diferenca]/dia = R$ [diferenca * 30]/mes
261
+ ```
262
+
263
+ ### Passo 6 — Compilar relatorio
264
+
265
+ 11. **Gerar documento final** com:
266
+ - Resumo executivo (1 paragrafo: gargalo + acao principal)
267
+ - Mapa de metricas por etapa (tabela completa)
268
+ - Gargalo identificado com calculo de impacto
269
+ - Diagnostico de causa raiz (arvore de decisao aplicada)
270
+ - Plano de acao priorizado com responsaveis
271
+ - Projecao de resultado apos correcoes
272
+ - Proximos passos recomendados
273
+
274
+ ## Post-conditions
275
+
276
+ - [ ] Metricas de todas as etapas coletadas e comparadas com benchmarks
277
+ - [ ] Gargalo principal identificado com calculo de impacto
278
+ - [ ] Causa raiz diagnosticada via arvore de decisao
279
+ - [ ] Plano de acao com pelo menos 3 acoes priorizadas
280
+ - [ ] Cada acao tem responsavel e task atribuidos
281
+ - [ ] Projecao de resultado calculada
282
+ - [ ] Relatorio salvo no path correto
283
+
284
+ ## Acceptance Criteria
285
+
286
+ - [ ] Todas as etapas do funil tem metricas coletadas
287
+ - [ ] Cada metrica tem: valor real, benchmark, gap%, status
288
+ - [ ] Gargalo identificado com criterio objetivo (maior impacto)
289
+ - [ ] Causa raiz segue arvore de decisao (nao e opiniao)
290
+ - [ ] Acoes sao especificas e acionaveis (nao genericas)
291
+ - [ ] Cada acao tem responsavel nomeado
292
+ - [ ] Tasks do DRM-Core referenciadas nas acoes
293
+ - [ ] Projecao de ganho calculada em R$/mes
294
+ - [ ] Relatorio tem resumo executivo para decisao rapida
295
+
296
+ ## Frameworks
297
+
298
+ - **Funnel Diagnostics**: Analise etapa-por-etapa com benchmarks
299
+ - **Root Cause Analysis**: Arvore de decisao por etapa
300
+ - **Impact Score**: Gap% * Peso da etapa
301
+ - **Metricas de Referencia**: Benchmarks por tipo de funil e nicho
302
+
303
+ ## Error Handling
304
+
305
+ | Erro | Acao |
306
+ |------|------|
307
+ | Dados insuficientes (< 7 dias) | ALERTAR. Analise pode nao ser confiavel, anotar limitacao |
308
+ | Volume muito baixo (< 100 cliques) | ALERTAR. Metricas podem nao ser significativas estatisticamente |
309
+ | Metrica indisponvel (sem tracking) | MARCAR como "N/D", recomendar implementacao de tracking |
310
+ | Todas as metricas OK (nenhum gargalo) | REPORTAR como saudavel, recomendar escala |
311
+ | Multiplos gargalos com impacto similar | PRIORIZAR o mais proximo do topo do funil (anuncio > LP > checkout) |
312
+ | Benchmarks desatualizados | ALERTAR. Usar com cautela, recomendar atualizacao |
313
+ | Dados inconsistentes (Meta vs plataforma) | ALERTAR. Usar dados do pixel como primario, plataforma como secundario |
314
+ | Funil sem upsell/bump | ADAPTAR. Avaliar apenas etapas existentes |
@@ -0,0 +1,242 @@
1
+ ---
2
+ task: revisar-ad-meta()
3
+ responsavel: Compliance
4
+ tipo: compliance
5
+ ---
6
+
7
+ # Revisar Anuncio Meta (Compliance)
8
+
9
+ ## Descricao
10
+
11
+ Ler a copy e especificacoes de um anuncio Meta Ads, aplicar checklist de compliance de 12 itens baseado nas politicas de publicidade da Meta, classificar riscos por severidade (CRITICO, ALTO, MEDIO, BAIXO), sugerir correcao para cada risco, verificar consistencia entre anuncio e landing page, e emitir veredicto final.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Copy do anuncio | `escrever-ad-meta.md` output | Sim | Primary Text + Headline + Description |
18
+ | Especificacoes do criativo | Output de copy/criativo | Sim | Formato, imagem/video descricao |
19
+ | URL da landing page | Usuario | Sim | Link funcional |
20
+ | Nicho/vertical | Briefing | Sim | Saude, financas, educacao, etc. |
21
+ | Pais de veiculacao | Usuario | Sim | Regras variam por pais |
22
+ | Tipo de produto | Briefing | Sim | Digital, fisico, servico |
23
+
24
+ ## Saida
25
+
26
+ | Campo | Destino | Template |
27
+ |-------|---------|----------|
28
+ | Relatorio de compliance | `outputs/compliance/revisao-meta-{data}.md` | — |
29
+ | Flags de risco | Secao do relatorio | — |
30
+ | Sugestoes de correcao | Secao do relatorio | — |
31
+ | Veredicto final | Header do relatorio | — |
32
+
33
+ ## Pre-conditions
34
+
35
+ - [ ] Copy do anuncio completa (todas as variacoes)
36
+ - [ ] Descricao ou referencia do criativo visual
37
+ - [ ] URL da landing page definida
38
+ - [ ] Nicho identificado (regras especiais para saude, financas, etc.)
39
+
40
+ ## Workflow
41
+
42
+ ### Passo 1 — Ler copy e especificacoes
43
+
44
+ 1. **Ler o anuncio completo**:
45
+ - Primary Text (todas as variacoes)
46
+ - Headline (todas as variacoes)
47
+ - Description (todas as variacoes)
48
+ - CTA button selecionado
49
+ - Descricao do criativo visual (imagem/video)
50
+
51
+ 2. **Identificar o nicho/vertical** e ativar regras especiais:
52
+
53
+ | Vertical | Regras adicionais |
54
+ |----------|------------------|
55
+ | Saude/bem-estar | Sem promessas de cura, sem antes/depois, sem resultados garantidos |
56
+ | Financas/renda | Sem promessas de ganhos especificos, disclaimer obrigatorio |
57
+ | Suplementos | Sem claims medicos, sem referencia a doencas |
58
+ | Emagrecimento | Sem antes/depois, sem promessas de kg, sem timeline especifica |
59
+ | Educacao/cursos | Sem garantia de emprego, sem promessas de salario |
60
+ | Criptomoedas | Restricoes severas, muitos paises bloqueiam |
61
+
62
+ ### Passo 2 — Aplicar checklist de compliance (12 itens)
63
+
64
+ 3. **Avaliar cada item** com status PASS/FAIL e severidade se FAIL:
65
+
66
+ **Item 1 — Promessas de resultado garantido**
67
+ - Verifica: O anuncio promete resultado especifico como garantido?
68
+ - Proibido: "Voce VAI ganhar R$ 10.000", "Garantido que emagrece 10kg"
69
+ - Permitido: "Nossos alunos relatam [resultado]", "Metodo usado por [X] pessoas"
70
+ - Severidade se FAIL: CRITICO
71
+
72
+ **Item 2 — Ganhos financeiros especificos**
73
+ - Verifica: Ha mencao de valores monetarios como resultado do produto?
74
+ - Proibido: "Ganhe R$ 5.000/mes", "Fature 6 digitos"
75
+ - Permitido: "Aumente sua receita", "Otimize seus resultados financeiros"
76
+ - Severidade se FAIL: CRITICO
77
+
78
+ **Item 3 — Antes e depois**
79
+ - Verifica: Ha imagens ou claims de antes/depois que implicam resultado garantido?
80
+ - Proibido: Fotos de transformacao fisica, "De [situacao ruim] para [situacao boa]" com timeline
81
+ - Permitido: Depoimentos em texto, resultados com disclaimer
82
+ - Severidade se FAIL: ALTO
83
+
84
+ **Item 4 — Conteudo discriminatorio**
85
+ - Verifica: Ha segmentacao ou linguagem que discrimina por atributos protegidos?
86
+ - Proibido: Referencia direta a raca, etnia, religiao, orientacao sexual, deficiencia
87
+ - Permitido: Segmentacao por interesse e comportamento
88
+ - Severidade se FAIL: CRITICO
89
+
90
+ **Item 5 — Atributos pessoais**
91
+ - Verifica: O anuncio afirma ou implica conhecer atributos pessoais do usuario?
92
+ - Proibido: "Voce que e gordo", "Se voce esta endividado", "Voce que tem diabetes"
93
+ - Permitido: "Para quem quer emagrecer", "Se voce busca equilibrio financeiro"
94
+ - Severidade se FAIL: ALTO
95
+
96
+ **Item 6 — Conteudo enganoso ou clickbait**
97
+ - Verifica: O anuncio promete algo que a LP nao entrega?
98
+ - Proibido: Headline sensacionalista sem correspondencia, botoes falsos, fake notifications
99
+ - Permitido: Curiosidade genuina, promessas que a LP cumpre
100
+ - Severidade se FAIL: ALTO
101
+
102
+ **Item 7 — Marcas registradas**
103
+ - Verifica: Ha uso de marcas/logos/nomes de terceiros sem autorizacao?
104
+ - Proibido: Logo do Facebook/Instagram/Google sem permissao, nomes de celebridades
105
+ - Permitido: "Anuncie no Facebook" (uso referencial), mencoes editoriais
106
+ - Severidade se FAIL: MEDIO
107
+
108
+ **Item 8 — Conteudo sensacionalista sobre saude**
109
+ - Verifica: Ha claims medicos ou de saude exagerados?
110
+ - Proibido: "Cura", "tratamento", "previne doenca", "aprovado por medicos" (sem ser)
111
+ - Permitido: "Contribui para o bem-estar", "auxiliar na rotina de saude"
112
+ - Severidade se FAIL: CRITICO (se saude) / MEDIO (se outro nicho)
113
+
114
+ **Item 9 — Consistencia anuncio-LP**
115
+ - Verifica: A promessa do anuncio corresponde ao conteudo da LP?
116
+ - Proibido: Anuncio promete X, LP vende Y
117
+ - Verificar: Headline do anuncio alinhada com headline da LP
118
+ - Severidade se FAIL: ALTO
119
+
120
+ **Item 10 — Conteudo visual restrito**
121
+ - Verifica: Imagem/video contem conteudo proibido?
122
+ - Proibido: Nudez, violencia, drogas, armas, conteudo chocante, sensacionalismo visual
123
+ - Verificar: Texto na imagem dentro do limite (anteriormente 20%, hoje flexivel mas impacta delivery)
124
+ - Severidade se FAIL: CRITICO
125
+
126
+ **Item 11 — Disclaimers necessarios**
127
+ - Verifica: Ha disclaimers obrigatorios presentes?
128
+ - Quando necessario:
129
+ - Resultados financeiros: "Resultados podem variar"
130
+ - Saude: "Consulte seu medico"
131
+ - Suplementos: "Nao substitui alimentacao equilibrada"
132
+ - Depoimentos: "Resultados individuais podem variar"
133
+ - Severidade se FAIL: MEDIO
134
+
135
+ **Item 12 — Funcionalidade do link**
136
+ - Verifica: O link de destino funciona e leva ao destino correto?
137
+ - Verificar: URL valida, pagina carrega, nao redireciona para pagina diferente
138
+ - Verificar: Pagina tem politica de privacidade acessivel
139
+ - Severidade se FAIL: ALTO
140
+
141
+ ### Passo 3 — Classificar e priorizar riscos
142
+
143
+ 4. **Para cada item com FAIL**, documentar:
144
+ ```
145
+ RISCO [numero]
146
+ Item: [nome do item]
147
+ Severidade: [CRITICO/ALTO/MEDIO/BAIXO]
148
+ Trecho problematico: "[texto exato do anuncio]"
149
+ Motivo: [por que viola a politica]
150
+ Sugestao de correcao: "[texto corrigido sugerido]"
151
+ Politica Meta relacionada: [referencia a politica especifica]
152
+ ```
153
+
154
+ 5. **Tabela resumo de riscos**:
155
+
156
+ | # | Item | Status | Severidade | Acao |
157
+ |---|------|--------|-----------|------|
158
+ | 1 | Promessas garantidas | PASS/FAIL | — | — |
159
+ | 2 | Ganhos financeiros | PASS/FAIL | — | — |
160
+ | ... | ... | ... | ... | ... |
161
+
162
+ ### Passo 4 — Verificar consistencia com LP
163
+
164
+ 6. **Comparar anuncio com landing page**:
165
+ - Headline do anuncio alinhada com headline da LP?
166
+ - Promessa do anuncio cumprida na LP?
167
+ - Tom de voz consistente?
168
+ - Produto/oferta identico?
169
+ - Preco consistente (se mencionado)?
170
+ - Garantia consistente (se mencionada)?
171
+
172
+ 7. **Se houver inconsistencia**:
173
+ - Documentar o que difere
174
+ - Recomendar: ajustar anuncio para alinhar com LP OU ajustar LP para alinhar com anuncio
175
+ - Severidade: ALTO (Meta rejeita por experiencia pos-clique inconsistente)
176
+
177
+ ### Passo 5 — Emitir veredicto
178
+
179
+ 8. **Classificar o veredicto**:
180
+
181
+ **APROVADO** (zero CRITICO, zero ALTO, max 2 MEDIO):
182
+ - Anuncio pode ser publicado
183
+ - Listar items MEDIO/BAIXO como recomendacoes opcionais
184
+
185
+ **AJUSTES NECESSARIOS** (zero CRITICO, 1+ ALTO ou 3+ MEDIO):
186
+ - Anuncio precisa de correcoes antes de publicar
187
+ - Listar correcoes em ordem de prioridade
188
+ - Fornecer texto corrigido sugerido para cada item
189
+
190
+ **REPROVADO** (1+ CRITICO):
191
+ - Anuncio NAO pode ser publicado
192
+ - Risco de rejeicao imediata, restricao de conta ou ban
193
+ - Listar todos os itens CRITICOS com correcao obrigatoria
194
+ - Requerer nova revisao apos correcoes
195
+
196
+ ### Passo 6 — Gerar relatorio
197
+
198
+ 9. **Compilar relatorio final** com:
199
+ - Header: data, tipo de anuncio, vertical, veredicto
200
+ - Checklist de 12 itens com status
201
+ - Tabela de riscos encontrados
202
+ - Detalhamento por risco (trecho + motivo + sugestao)
203
+ - Verificacao de consistencia anuncio-LP
204
+ - Veredicto final com instrucoes
205
+ - Notas de regras especiais do vertical
206
+
207
+ ## Post-conditions
208
+
209
+ - [ ] Todos os 12 itens verificados
210
+ - [ ] Riscos classificados por severidade
211
+ - [ ] Sugestao de correcao para cada risco
212
+ - [ ] Consistencia anuncio-LP verificada
213
+ - [ ] Veredicto emitido (APROVADO, AJUSTES, REPROVADO)
214
+ - [ ] Relatorio salvo no path correto
215
+
216
+ ## Acceptance Criteria
217
+
218
+ - [ ] Cada item tem justificativa (nao apenas PASS/FAIL)
219
+ - [ ] Riscos CRITICOS bloqueiam aprovacao
220
+ - [ ] Sugestoes de correcao sao textos prontos para usar
221
+ - [ ] Vertical do nicho foi considerado (regras especiais)
222
+ - [ ] Consistencia com LP verificada
223
+ - [ ] Relatorio e acionavel (copywriter sabe exatamente o que mudar)
224
+ - [ ] Politica Meta referenciada nos itens de risco
225
+
226
+ ## Frameworks
227
+
228
+ - **Meta Advertising Policies**: Base para os 12 itens de compliance
229
+ - **Risk Severity Matrix**: CRITICO (ban), ALTO (rejeicao), MEDIO (limitacao), BAIXO (otimizacao)
230
+ - **Pre-Submission Review**: Revisao antes de submeter para evitar restricoes
231
+
232
+ ## Error Handling
233
+
234
+ | Erro | Acao |
235
+ |------|------|
236
+ | Copy do anuncio nao fornecida | BLOQUEAR. Sem copy nao ha revisao |
237
+ | LP inacessivel | ALERTAR. Revisar copy isoladamente, anotar que LP nao foi verificada |
238
+ | Nicho nao identificado | PERGUNTAR. Regras especiais dependem do vertical |
239
+ | Item ambiguo (area cinza) | Classificar como MEDIO e recomendar versao mais segura |
240
+ | Multiplas variacoes do anuncio | Revisar CADA variacao separadamente |
241
+ | Regras do pais diferem | ALERTAR. Indicar quais itens podem variar por pais |
242
+ | Criativo visual nao disponivel | ALERTAR. Revisar apenas copy, anotar que visual nao foi verificado |