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,291 @@
1
+ ---
2
+ task: fluxo-whatsapp-backend()
3
+ responsavel: Estrategista
4
+ tipo: funil
5
+ ---
6
+
7
+ # Fluxo WhatsApp Backend
8
+
9
+ ## Descricao
10
+
11
+ Definir a sequencia completa de mensagens de WhatsApp para automacao de vendas e relacionamento: trigger de entrada, sequencia de mensagens (boas-vindas, dia 1, dia 3, dia 5, dia 7, qualificacao, oferta, follow-up), timing de envio, tipos de mensagem, criterios de qualificacao e estrutura de oferta high-ticket.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Arquitetura do funil | `arquitetar-funil-vsl.md` output | Sim | Etapas e triggers definidos |
18
+ | Avatar detalhado | `criar-briefing.md` output | Sim | Dores, desejos, linguagem |
19
+ | Produto/oferta | Briefing | Sim | Nome, preco, beneficio |
20
+ | Oferta high-ticket | Usuario | Nao | Se houver mentoria/consultoria/grupo |
21
+ | Ferramenta de automacao | Usuario | Sim | Utalk, Wati, Z-API, Manychat, etc. |
22
+ | Numero de WhatsApp | Usuario | Sim | Numero business verificado |
23
+ | Horario de envio permitido | Usuario | Sim | Janela de envio (ex: 8h-20h) |
24
+
25
+ ## Saida
26
+
27
+ | Campo | Destino | Template |
28
+ |-------|---------|----------|
29
+ | Fluxo completo de mensagens | `outputs/funil/fluxo-whatsapp-{produto}-{data}.md` | — |
30
+ | Fluxograma de decisao | Secao do documento | — |
31
+ | Criterios de qualificacao | Secao do documento | — |
32
+ | Configuracao tecnica | Secao do documento | — |
33
+
34
+ ## Pre-conditions
35
+
36
+ - [ ] Arquitetura do funil definida com triggers de WhatsApp
37
+ - [ ] Avatar detalhado disponivel
38
+ - [ ] Produto e oferta claros
39
+ - [ ] Ferramenta de automacao escolhida
40
+ - [ ] Numero de WhatsApp Business ativo
41
+ - [ ] Horario de envio definido
42
+
43
+ ## Workflow
44
+
45
+ ### Passo 1 — Definir trigger de entrada
46
+
47
+ 1. **Identificar o evento que inicia o fluxo**:
48
+ - Opt-in em landing page (lead capturado)
49
+ - Compra realizada (pos-compra)
50
+ - Abandono de carrinho (recuperacao)
51
+ - Click em anuncio com CTA "Enviar Mensagem"
52
+ - Lead respondeu a um anuncio
53
+ - Importacao manual de lista
54
+
55
+ 2. **Documentar o trigger**:
56
+ ```
57
+ TRIGGER
58
+ Evento: [descricao do evento]
59
+ Origem: [LP, checkout, anuncio, manual]
60
+ Dados recebidos: {nome}, {email}, {telefone}, {produto}, {valor}
61
+ Condicao: [ex: lead novo, nao duplicado]
62
+ Acao: Iniciar sequencia [nome da sequencia]
63
+ ```
64
+
65
+ ### Passo 2 — Definir sequencia principal
66
+
67
+ 3. **Mapear cada mensagem** na timeline:
68
+
69
+ **MSG-01: Boas-vindas** (imediato apos trigger)
70
+ - Objetivo: Confirmar contato, definir expectativa
71
+ - Tipo: Texto com botoes
72
+ - Conteudo: Saudacao + quem e voce + o que vai receber + pergunta de engajamento
73
+ - Condicao: Nenhuma (sempre envia)
74
+ - Regra: Enviar dentro de 5 minutos do trigger
75
+
76
+ **MSG-02: Valor dia 1** (+24h)
77
+ - Objetivo: Entregar conteudo de valor, construir autoridade
78
+ - Tipo: Texto + link ou audio
79
+ - Conteudo: Dica pratica relacionada ao problema do avatar
80
+ - Condicao: Nao enviou opt-out
81
+
82
+ **MSG-03: Historia dia 3** (+72h)
83
+ - Objetivo: Gerar conexao emocional, identificacao
84
+ - Tipo: Texto ou audio (60-90s)
85
+ - Conteudo: Mini-historia de transformacao (propria ou de cliente)
86
+ - Condicao: Nao enviou opt-out
87
+
88
+ **MSG-04: Prova social dia 5** (+120h)
89
+ - Objetivo: Construir credibilidade, reduzir ceticismo
90
+ - Tipo: Imagem/video + legenda
91
+ - Conteudo: Depoimento de cliente com resultado concreto
92
+ - Condicao: Nao enviou opt-out
93
+
94
+ **MSG-05: Qualificacao dia 7** (+168h)
95
+ - Objetivo: Identificar leads quentes, segmentar
96
+ - Tipo: Texto com botoes ou lista
97
+ - Conteudo: Pergunta de qualificacao (ver passo 4)
98
+ - Condicao: Nao enviou opt-out
99
+ - Acao: Baseado na resposta, segmentar (ver passo 5)
100
+
101
+ 4. **Para cada mensagem, definir**:
102
+ ```
103
+ MSG-[numero]
104
+ Nome: [nome descritivo]
105
+ Timing: [quando envia relativo ao trigger]
106
+ Horario: [dentro da janela permitida]
107
+ Tipo: [texto/botoes/lista/audio/imagem/video/documento]
108
+ Objetivo: [o que essa mensagem deve fazer]
109
+ Conteudo: [descricao do conteudo — a copy sera escrita em escrever-msgs-whatsapp.md]
110
+ Condicao de envio: [quando enviar / quando NAO enviar]
111
+ Acao pos-envio: [o que acontece baseado na resposta]
112
+ ```
113
+
114
+ ### Passo 3 — Definir fluxo de qualificacao
115
+
116
+ 5. **Criterios de qualificacao** (BANT adaptado para WhatsApp):
117
+ - **Budget**: Tem capacidade de investimento?
118
+ - Pergunta indireta: "Quanto voce ja investiu tentando resolver [problema]?"
119
+ - **Authority**: E o decisor?
120
+ - Pergunta: "Voce decide sozinho(a) ou precisa consultar alguem?"
121
+ - **Need**: A dor e urgente?
122
+ - Pergunta: "De 0 a 10, quanto [problema] te afeta hoje?"
123
+ - **Timeline**: Quer resolver agora?
124
+ - Pergunta: "Se existisse uma solucao, voce estaria pronto para comecar quando?"
125
+
126
+ 6. **Classificar leads**:
127
+
128
+ | Classificacao | Criterio | Proximo passo |
129
+ |---------------|----------|---------------|
130
+ | QUENTE | Respondeu positivamente em 2+ criterios | Fluxo de oferta (passo 4) |
131
+ | MORNO | Respondeu positivamente em 1 criterio | Fluxo de nurturing (mais conteudo) |
132
+ | FRIO | Nao respondeu ou negativo em todos | Pausar, reativar em 15 dias |
133
+ | OPT-OUT | Pediu para sair | Remover imediatamente |
134
+
135
+ ### Passo 4 — Definir fluxo de oferta
136
+
137
+ 7. **Sequencia de oferta** (para leads QUENTES):
138
+
139
+ **MSG-OFERTA-01: Abertura** (+1h apos qualificacao)
140
+ - Tipo: Audio (2-3 min) ou texto longo
141
+ - Conteudo: Reconhecer a situacao do lead, apresentar solucao personalizada
142
+ - Tom: Consultivo, nao vendedor
143
+
144
+ **MSG-OFERTA-02: Detalhes** (+4h ou proximo dia)
145
+ - Tipo: Texto + link ou documento
146
+ - Conteudo: Detalhes da oferta, o que esta incluso, link para pagina/formulario
147
+ - Incluir: Preco, parcelamento, garantia
148
+
149
+ **MSG-OFERTA-03: Prova** (+24h)
150
+ - Tipo: Video ou imagem
151
+ - Conteudo: Case de sucesso relevante para o perfil do lead
152
+ - Objetivo: Reduzir objecoes
153
+
154
+ **MSG-OFERTA-04: Objecao** (+48h se nao converteu)
155
+ - Tipo: Texto
156
+ - Conteudo: Responder objecao mais provavel (baseado no perfil)
157
+ - Tom: Empático, sem pressao
158
+
159
+ **MSG-OFERTA-05: Fechamento** (+72h se nao converteu)
160
+ - Tipo: Texto curto
161
+ - Conteudo: Ultimo lembrete, prazo/escassez se aplicavel
162
+ - Tom: Direto mas respeitoso
163
+ - Regra: Se nao responder, mover para nurturing longo
164
+
165
+ ### Passo 5 — Definir fluxo de follow-up
166
+
167
+ 8. **Sequencia de follow-up** (para quem nao converteu):
168
+
169
+ **FOLLOW-01: Reengajamento** (+7 dias apos ultima oferta)
170
+ - Conteudo: Novo conteudo de valor (diferente do ja enviado)
171
+ - Objetivo: Manter o relacionamento
172
+
173
+ **FOLLOW-02: Novo angulo** (+14 dias)
174
+ - Conteudo: Abordar o problema por um angulo diferente
175
+ - Objetivo: Reacender interesse
176
+
177
+ **FOLLOW-03: Check-in** (+21 dias)
178
+ - Conteudo: Pergunta simples ("Como voce esta com [problema]?")
179
+ - Objetivo: Reabrir conversa
180
+
181
+ **FOLLOW-04: Oferta especial** (+30 dias)
182
+ - Conteudo: Oferta diferenciada ou condicao especial
183
+ - Condicao: Somente se respondeu a pelo menos 1 follow-up
184
+
185
+ 9. **Regras de follow-up**:
186
+ - Max 2 mensagens sem resposta antes de pausar
187
+ - Nunca enviar mais de 1 mensagem por dia
188
+ - Respeitar horario permitido (8h-20h)
189
+ - Se opt-out, parar imediatamente
190
+
191
+ ### Passo 6 — Definir oferta high-ticket (se aplicavel)
192
+
193
+ 10. **Estrutura para oferta high-ticket** (mentoria, consultoria, grupo):
194
+ - Lead qualificado como QUENTE + criterios adicionais:
195
+ - Renda compativel
196
+ - Disponibilidade de tempo
197
+ - Comprometimento demonstrado
198
+ - Fluxo: Qualificacao → Agendamento de call → Call de vendas → Follow-up
199
+ - Ferramenta de agendamento: Calendly, SavvyCal, etc.
200
+
201
+ 11. **Mensagem de convite para call**:
202
+ - Tipo: Texto + link de agendamento
203
+ - Conteudo: "Baseado no que voce me contou, acredito que posso te ajudar de forma mais personalizada. Tenho X vagas para [oferta high-ticket]. Quer que eu te explique como funciona? Agenda um horario aqui: [link]"
204
+ - Regra: Somente para leads que responderam positivamente na qualificacao
205
+
206
+ ### Passo 7 — Configuracao tecnica
207
+
208
+ 12. **Documentar setup tecnico**:
209
+ ```
210
+ CONFIGURACAO
211
+ Ferramenta: [nome da ferramenta]
212
+ Numero WhatsApp: [numero]
213
+ Webhook de entrada: [URL]
214
+ Integracao checkout: [Hotmart/Kiwify → Zapier/Make → Ferramenta]
215
+ Integracao CRM: [se aplicavel]
216
+ Variaveis disponiveis: {nome}, {email}, {telefone}, {produto}, {valor}
217
+ Horario de envio: [janela]
218
+ Timezone: America/Sao_Paulo
219
+ ```
220
+
221
+ 13. **Definir tags/segmentos**:
222
+
223
+ | Tag | Quando aplicar | Acao |
224
+ |-----|---------------|------|
225
+ | LEAD_NOVO | Trigger inicial | Iniciar sequencia |
226
+ | ENGAJADO | Respondeu mensagem | Priorizar |
227
+ | QUALIFICADO | Passou na qualificacao | Fluxo de oferta |
228
+ | CLIENTE | Comprou | Fluxo pos-compra |
229
+ | OPT_OUT | Pediu para sair | Remover de tudo |
230
+ | INATIVO | 15 dias sem resposta | Fluxo de reativacao |
231
+
232
+ ### Passo 8 — Compilar documento final
233
+
234
+ 14. **Gerar documento final** com:
235
+ - Trigger de entrada documentado
236
+ - Timeline completa de mensagens (sequencia principal)
237
+ - Fluxograma de decisao (ramificacoes)
238
+ - Criterios de qualificacao
239
+ - Fluxo de oferta (leads quentes)
240
+ - Fluxo de follow-up (nao convertidos)
241
+ - Oferta high-ticket (se aplicavel)
242
+ - Configuracao tecnica
243
+ - Tags e segmentos
244
+ - Regras de compliance (opt-out, horario, frequencia)
245
+
246
+ ## Post-conditions
247
+
248
+ - [ ] Trigger de entrada definido com dados e condicoes
249
+ - [ ] Sequencia principal com todas as mensagens mapeadas
250
+ - [ ] Cada mensagem com: timing, tipo, objetivo, condicao
251
+ - [ ] Criterios de qualificacao definidos (BANT)
252
+ - [ ] Classificacao de leads (quente/morno/frio/opt-out)
253
+ - [ ] Fluxo de oferta para leads quentes
254
+ - [ ] Fluxo de follow-up para nao convertidos
255
+ - [ ] Configuracao tecnica documentada
256
+ - [ ] Tags e segmentos definidos
257
+ - [ ] Documento salvo no path correto
258
+
259
+ ## Acceptance Criteria
260
+
261
+ - [ ] Minimo 5 mensagens na sequencia principal
262
+ - [ ] Timing respeita janela de envio definida
263
+ - [ ] Max 1 mensagem por dia (exceto boas-vindas)
264
+ - [ ] Qualificacao com pelo menos 2 criterios
265
+ - [ ] Fluxo de oferta com pelo menos 3 mensagens
266
+ - [ ] Follow-up com max 4 mensagens
267
+ - [ ] Opt-out acessivel em toda a sequencia
268
+ - [ ] Tags de segmentacao definidas
269
+ - [ ] Regras de pausa automatica definidas (2 msgs sem resposta)
270
+ - [ ] Configuracao tecnica completa (ferramenta, webhook, integracoes)
271
+
272
+ ## Frameworks
273
+
274
+ - **BANT Adaptado**: Budget, Authority, Need, Timeline para qualificacao via chat
275
+ - **Conversational Commerce**: Vendas atraves de conversa 1:1
276
+ - **Lead Scoring**: Classificacao por engajamento e qualificacao
277
+ - **Nurturing Funnel**: Progressao de valor antes de oferta
278
+
279
+ ## Error Handling
280
+
281
+ | Erro | Acao |
282
+ |------|------|
283
+ | Arquitetura do funil nao definida | BLOQUEAR. Executar `arquitetar-funil-vsl.md` primeiro |
284
+ | Avatar nao definido | BLOQUEAR. Retornar ao `criar-briefing.md` |
285
+ | Ferramenta de automacao nao escolhida | ALERTAR. Recomendar opcoes e pedir decisao |
286
+ | Numero nao verificado como Business | ALERTAR. Envio pode ser bloqueado pelo WhatsApp |
287
+ | Mais de 1 msg/dia na sequencia | CORRIGIR. Redistribuir timing |
288
+ | Qualificacao sem criterios claros | BLOQUEAR. Definir pelo menos 2 criterios BANT |
289
+ | Follow-up acima de 4 msgs sem resposta | CORRIGIR. Reduzir para max 2 antes de pausar |
290
+ | Sem regra de opt-out | BLOQUEAR. Adicionar opt-out obrigatoriamente |
291
+ | Horario de envio fora da janela | CORRIGIR. Ajustar para dentro da janela permitida |
@@ -0,0 +1,256 @@
1
+ ---
2
+ task: escalar-campanha()
3
+ responsavel: Media Buyer
4
+ tipo: trafego
5
+ ---
6
+
7
+ # Escalar Campanha Meta Ads
8
+
9
+ ## Descricao
10
+
11
+ Analisar campanhas com performance comprovada e executar escala controlada: identificar winners (criativos, ad sets, audiencias), decidir entre escala horizontal (novas audiencias/criativos) e vertical (aumento de budget), definir schedule de aumento gradual (20% a cada 48h), estabelecer novas kill rules para budget escalado e monitorar degradacao de performance.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Relatorio de performance | `diagnostico-funil.md` output OU dados da campanha | Sim | Minimo 7 dias de dados |
18
+ | Campanha ativa | Meta Ads Manager | Sim | Campanha rodando com conversoes |
19
+ | CPA alvo | Briefing | Sim | Valor em R$ |
20
+ | ROAS alvo | Briefing | Sim | Valor minimo |
21
+ | Budget atual | Campanha ativa | Sim | Valor em R$/dia |
22
+ | Budget maximo disponivel | Usuario | Sim | Teto de investimento |
23
+ | Criativos disponiveis | Banco de criativos | Nao | Novos criativos para renovacao |
24
+
25
+ ## Saida
26
+
27
+ | Campo | Destino | Template |
28
+ |-------|---------|----------|
29
+ | Plano de escala | `outputs/trafego/escala-{campanha}-{data}.md` | — |
30
+ | Schedule de aumentos | Secao do documento | — |
31
+ | Novas kill rules | Secao do documento | — |
32
+ | Checklist de monitoramento | Secao do documento | — |
33
+
34
+ ## Pre-conditions
35
+
36
+ - [ ] Campanha rodando ha pelo menos 7 dias
37
+ - [ ] CPA atual <= CPA alvo por pelo menos 5 dias consecutivos
38
+ - [ ] ROAS atual >= ROAS alvo por pelo menos 5 dias consecutivos
39
+ - [ ] Volume minimo: 10+ conversoes nos ultimos 7 dias
40
+ - [ ] Frequencia media < 2 (cold traffic)
41
+ - [ ] Relatorio de performance disponivel e atualizado
42
+ - [ ] Budget maximo aprovado pelo usuario
43
+
44
+ ## Workflow
45
+
46
+ ### Passo 1 — Analisar winners
47
+
48
+ 1. **Extrair metricas dos ultimos 7 dias** por nivel:
49
+
50
+ **Por anuncio (ad)**:
51
+
52
+ | Anuncio | Impressoes | CTR | CPC | CPA | ROAS | Freq | Status |
53
+ |---------|-----------|-----|-----|-----|------|------|--------|
54
+ | [nome] | [valor] | [%] | [R$] | [R$] | [x] | [num] | WINNER/LOSER |
55
+
56
+ **Por ad set (audiencia)**:
57
+
58
+ | Ad Set | Impressoes | CTR | CPC | CPA | ROAS | Freq | Status |
59
+ |--------|-----------|-----|-----|-----|------|------|--------|
60
+ | [nome] | [valor] | [%] | [R$] | [R$] | [x] | [num] | WINNER/LOSER |
61
+
62
+ **Por campanha**:
63
+
64
+ | Campanha | Gasto | Receita | CPA | ROAS | Conversoes | Status |
65
+ |----------|-------|---------|-----|------|------------|--------|
66
+ | [nome] | [R$] | [R$] | [R$] | [x] | [num] | ESCALAVEL/NAO |
67
+
68
+ 2. **Classificar cada elemento**:
69
+ - **WINNER**: CPA < CPA alvo E CTR > 1% E ROAS > meta
70
+ - **ESTAVEL**: CPA <= CPA alvo + 20% E CTR > 0.8%
71
+ - **LOSER**: CPA > CPA alvo + 50% OU CTR < 0.5%
72
+ - **INCONCLUSIVO**: Dados insuficientes (< 1000 impressoes ou < 2x CPA gasto)
73
+
74
+ 3. **Identificar padroes**:
75
+ - Qual formato de criativo performa melhor? (video vs imagem vs carrossel)
76
+ - Qual angulo de copy performa melhor?
77
+ - Qual audiencia tem menor CPA?
78
+ - Qual posicionamento entrega mais volume com CPA aceitavel?
79
+ - Ha degradacao de performance ao longo dos 7 dias?
80
+
81
+ ### Passo 2 — Decidir tipo de escala
82
+
83
+ 4. **Avaliar condicoes para cada tipo**:
84
+
85
+ | Condicao | Escala Vertical | Escala Horizontal |
86
+ |----------|----------------|-------------------|
87
+ | Audiencia saturando (freq > 2) | Nao recomendado | Sim |
88
+ | CPA estavel, freq baixa | Sim | Opcional |
89
+ | Budget atual < 30% do budget max | Sim | Sim |
90
+ | Poucos criativos (< 3 winners) | Cauteloso | Sim (novos criativos) |
91
+ | Muitos criativos winners | Sim | Sim |
92
+ | Audiencia pequena (< 500k) | Nao recomendado | Sim (expandir) |
93
+
94
+ 5. **Decidir a estrategia**:
95
+ - **So vertical**: CPA estavel + freq baixa + audiencia grande
96
+ - **So horizontal**: Audiencia saturando OU precisa testar novos angulos
97
+ - **Vertical + horizontal**: Melhor cenario — budget permite ambos
98
+
99
+ ### Passo 3 — Executar escala vertical
100
+
101
+ 6. **Schedule de aumento de budget**:
102
+ ```
103
+ SCHEDULE DE ESCALA VERTICAL
104
+
105
+ Budget atual: R$ [valor]/dia
106
+ Budget alvo: R$ [valor]/dia
107
+ Aumento por step: 20% (MAXIMO)
108
+ Intervalo entre steps: 48 horas (MINIMO)
109
+
110
+ Step 1: Dia [X] — R$ [atual] → R$ [atual * 1.2]
111
+ Step 2: Dia [X+2] — R$ [...] → R$ [...]
112
+ Step 3: Dia [X+4] — R$ [...] → R$ [...]
113
+ ...
114
+ Step N: Dia [X+N*2] — R$ [...] → R$ [alvo]
115
+ ```
116
+
117
+ 7. **Regras de monitoramento por step**:
118
+ - Apos cada aumento, monitorar CPA nas proximas 24h
119
+ - Se CPA subir > 30% em relacao ao CPA pre-aumento: REVERTER aumento imediatamente
120
+ - Se CPA subir 15-30%: esperar mais 24h antes de decidir
121
+ - Se CPA se mantiver (+/- 15%): prosseguir para proximo step em 48h
122
+ - NUNCA fazer 2 aumentos no mesmo dia
123
+
124
+ 8. **Regras de budget por ad set (se ABO)**:
125
+ - Alocar 70-80% do aumento para ad sets WINNER
126
+ - Alocar 20-30% para ad sets ESTAVEIS
127
+ - NUNCA aumentar budget de ad sets LOSER
128
+ - Se um ad set winner comeca a perder performance apos aumento: reverter
129
+
130
+ ### Passo 4 — Executar escala horizontal
131
+
132
+ 9. **Novas audiencias** (duplicar ad sets winners):
133
+ - Duplicar o ad set winner com o MESMO criativo e copy
134
+ - Trocar APENAS a audiencia
135
+ - Opcoes de nova audiencia:
136
+ - LAL maior (se tinha 1%, testar 2-3%)
137
+ - Nova fonte de LAL (se era compradores, testar leads)
138
+ - Novos interesses (adjacentes ao original)
139
+ - Broad (sem segmentacao)
140
+ - IMPORTANTE: excluir audiencia do ad set original (evitar sobreposicao)
141
+ - Budget do novo ad set: igual ao original (nao inflacionar)
142
+
143
+ 10. **Novos criativos** (se disponiveis):
144
+ - Criar novos anuncios dentro dos ad sets winners
145
+ - Manter os winners rodando (NUNCA pausar o que funciona)
146
+ - Novos criativos devem trazer: novo hook, novo angulo, novo formato
147
+ - Testar 2-3 novos criativos por vez (nao inundar)
148
+
149
+ 11. **Novos angulos de copy**:
150
+ - Se o angulo de DOR e o winner, testar angulo de DESEJO
151
+ - Se Primary Text curto e winner, testar longo
152
+ - Manter o hook vencedor em novas variacoes
153
+
154
+ ### Passo 5 — Novas kill rules para budget escalado
155
+
156
+ 12. **Ajustar kill rules** para o novo patamar:
157
+
158
+ | Regra | Budget normal | Budget escalado | Justificativa |
159
+ |-------|-------------|----------------|---------------|
160
+ | CPA maximo | 1.5x CPA alvo | 1.3x CPA alvo | Margem menor em escala |
161
+ | Tempo sem conversao | 2x CPA gasto | 1.5x CPA gasto | Decisao mais rapida |
162
+ | Frequencia max (cold) | 3 | 2.5 | Saturacao mais rapida em escala |
163
+ | CTR minimo | 0.8% | 1.0% | Qualidade mais importante em volume |
164
+ | Review diario | Opcional | OBRIGATORIO | Monitoramento intensivo |
165
+
166
+ 13. **Definir alertas**:
167
+ - CPA > CPA alvo + 20% → notificar
168
+ - Gasto diario > 120% do budget definido → notificar
169
+ - CTR caiu > 30% vs dia anterior → notificar
170
+ - Zero conversoes em 6h → notificar
171
+
172
+ ### Passo 6 — Monitoramento pos-escala
173
+
174
+ 14. **Checklist diario de monitoramento** (primeiras 2 semanas apos escala):
175
+ - [ ] CPA esta dentro do alvo? (+/- 15%)
176
+ - [ ] ROAS esta acima do minimo?
177
+ - [ ] Frequencia esta abaixo do limite?
178
+ - [ ] CTR esta estavel ou crescendo?
179
+ - [ ] Volume de conversoes aumentou proporcionalmente ao budget?
180
+ - [ ] Nenhum ad set com gasto mas sem conversao?
181
+ - [ ] Criativos nao estao fatigados (CTR caindo)?
182
+ - [ ] CPM esta estavel (nao inflacionou)?
183
+
184
+ 15. **Acoes corretivas**:
185
+ - CPA subiu apos escala → reverter ultimo aumento e esperar 72h
186
+ - ROAS caiu → verificar se e problema de criativo, audiencia ou bid
187
+ - Frequencia subiu → escala horizontal (nova audiencia)
188
+ - Volume nao acompanhou budget → audiencia pequena, expandir
189
+ - CPM subiu muito → audiencia competitiva, testar horarios diferentes
190
+
191
+ ### Passo 7 — Plano de renovacao criativa
192
+
193
+ 16. **Ciclo de renovacao**:
194
+ - Semana 1-2 apos escala: monitorar winners atuais
195
+ - Semana 3: introduzir 2-3 novos criativos
196
+ - Semana 4: avaliar novos vs antigos, pausar perdedores
197
+ - Repetir ciclo a cada 2-3 semanas
198
+
199
+ 17. **Sinais de fadiga criativa**:
200
+ - CTR caiu > 30% em 7 dias
201
+ - CPA subiu > 25% sem mudanca de audiencia ou bid
202
+ - Frequencia subiu > 50%
203
+ - Acao: introduzir novos criativos, NAO pausar os antigos ate novos provarem performance
204
+
205
+ ### Passo 8 — Compilar documento final
206
+
207
+ 18. **Gerar documento final** com:
208
+ - Analise de winners (anuncios, ad sets, campanhas)
209
+ - Decisao de tipo de escala (vertical/horizontal/ambos)
210
+ - Schedule de aumentos detalhado
211
+ - Novas kill rules para budget escalado
212
+ - Plano de renovacao criativa
213
+ - Checklist diario de monitoramento
214
+ - Acoes corretivas pre-definidas
215
+ - Projecao de resultados pos-escala
216
+
217
+ ## Post-conditions
218
+
219
+ - [ ] Winners identificados por nivel (anuncio, ad set, campanha)
220
+ - [ ] Tipo de escala decidido com justificativa
221
+ - [ ] Schedule de aumentos com datas e valores
222
+ - [ ] Kill rules ajustadas para budget escalado
223
+ - [ ] Checklist de monitoramento diario definido
224
+ - [ ] Plano de renovacao criativa com timeline
225
+ - [ ] Documento salvo no path correto
226
+
227
+ ## Acceptance Criteria
228
+
229
+ - [ ] Analise baseada em minimo 7 dias de dados
230
+ - [ ] Winners classificados com criterios objetivos (CPA, CTR, ROAS)
231
+ - [ ] Aumento maximo de 20% por step documentado
232
+ - [ ] Intervalo minimo de 48h entre steps documentado
233
+ - [ ] Kill rules mais rigorosas que as originais
234
+ - [ ] Regras de reversao definidas (quando voltar atras)
235
+ - [ ] Checklist diario com itens verificaveis
236
+ - [ ] Projecao de resultados pos-escala calculada
237
+
238
+ ## Frameworks
239
+
240
+ - **20% Scaling Rule**: Aumento gradual para preservar fase de aprendizado
241
+ - **Horizontal vs Vertical**: Decisao baseada em audiencia e frequencia
242
+ - **Creative Fatigue Cycle**: Renovacao a cada 2-3 semanas
243
+ - **Kill Rules Escaladas**: Regras mais rigorosas para budget maior
244
+
245
+ ## Error Handling
246
+
247
+ | Erro | Acao |
248
+ |------|------|
249
+ | Relatorio de performance nao disponivel | BLOQUEAR. Executar `diagnostico-funil.md` ou coletar dados primeiro |
250
+ | CPA atual > CPA alvo | BLOQUEAR. Nao escalar campanha com CPA fora do alvo |
251
+ | Menos de 7 dias de dados | BLOQUEAR. Aguardar mais dados antes de decidir |
252
+ | Volume < 10 conversoes/semana | ALERTAR. Dados podem ser insuficientes para decisoes confiaveis |
253
+ | Frequencia > 2 (cold traffic) | PRIORIZAR escala horizontal sobre vertical |
254
+ | CPA subiu > 30% apos aumento | REVERTER aumento imediatamente |
255
+ | Budget maximo atingido | FOCAR em otimizacao, nao escala. Melhorar CPA/AOV |
256
+ | Sem criativos novos para renovacao | ALERTAR. Solicitar producao de novos criativos antes de escalar |