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,191 @@
1
+ ---
2
+ task: escrever-ad-meta()
3
+ responsavel: Zeus (Copywriter)
4
+ tipo: copy
5
+ ---
6
+
7
+ # Escrever Anuncio Meta Ads
8
+
9
+ ## Descricao
10
+
11
+ Receber angulos criativos do framework C.A.S.H., escrever variacoes de anuncios para Meta Ads (Facebook/Instagram) com Hook (3s), Body e CTA. Produzir 3-5 variacoes por angulo com Primary Text, Headline e Description. Aplicar self-review de compliance Meta antes de entregar.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Angulos criativos (C.A.S.H.) | `criar-conceito.md` output | Sim | Minimo 3 angulos com hooks definidos |
18
+ | Avatar detalhado | `criar-briefing.md` output | Sim | Dores, desejos, linguagem do publico |
19
+ | Produto/oferta | Briefing | Sim | Nome, beneficio principal, preco, link |
20
+ | Tipo de campanha | Usuario | Sim | Conversao, trafego, leads, engajamento |
21
+ | Formato do criativo | Usuario | Sim | Imagem, video, carrossel, stories |
22
+ | Link de destino | Usuario | Sim | URL da LP ou pagina de vendas |
23
+ | Nivel de consciencia | Briefing | Sim | 1-5 Schwartz |
24
+
25
+ ## Saida
26
+
27
+ | Campo | Destino | Template |
28
+ |-------|---------|----------|
29
+ | Pack de anuncios (3-5 variacoes por angulo) | `outputs/copy/ads-meta-{produto}-{data}.md` | — |
30
+ | Checklist compliance preenchido | Inline no documento | `compliance-meta.md` |
31
+ | Mapa de testes A/B | Inline no documento | — |
32
+
33
+ ## Pre-conditions
34
+
35
+ - [ ] Angulos criativos definidos (minimo 3)
36
+ - [ ] Hooks definidos para cada angulo (minimo 3 por angulo)
37
+ - [ ] Avatar detalhado disponivel
38
+ - [ ] Produto e oferta claros
39
+ - [ ] Link de destino definido e funcional
40
+ - [ ] Formato do criativo definido
41
+
42
+ ## Workflow
43
+
44
+ ### Passo 1 — Mapear angulos e hooks
45
+
46
+ 1. Listar todos os angulos recebidos do `criar-conceito.md`.
47
+ 2. Para cada angulo, listar os hooks associados.
48
+ 3. Classificar cada angulo por emocao dominante:
49
+ - **Medo/dor**: foca no que o avatar perde se nao agir
50
+ - **Desejo/aspiracao**: foca no resultado que o avatar quer
51
+ - **Curiosidade**: foca em revelar algo desconhecido
52
+ - **Urgencia**: foca em por que agir agora
53
+ - **Prova social**: foca em resultados de outros
54
+ 4. Definir qual angulo sera o "controle" (aquele com maior potencial baseado no nivel de consciencia).
55
+
56
+ ### Passo 2 — Escrever variacoes por angulo
57
+
58
+ Para CADA angulo, escrever 3-5 variacoes de anuncio seguindo esta estrutura:
59
+
60
+ 5. **Hook (primeiros 3 segundos / primeira linha)**:
61
+ - Deve parar o scroll imediatamente
62
+ - Maximo 10 palavras
63
+ - Formatos eficazes: pergunta direta, afirmacao chocante, numero impactante, "Voce sabia que...", identificacao ("Se voce [situacao]...")
64
+ - Escrever 3 opcoes de hook por variacao
65
+
66
+ 6. **Body (corpo do anuncio)**:
67
+ - **Primary Text** (texto principal — aparece acima da imagem/video):
68
+ - Versao curta: 2-3 linhas (para testes iniciais)
69
+ - Versao media: 5-7 linhas (para publico mais consciente)
70
+ - Versao longa: 10-15 linhas (para retargeting/most aware)
71
+ - Estrutura: Hook → Agitacao → Solucao → Prova → CTA
72
+ - Usar quebras de linha para escaneabilidade
73
+ - Usar emojis com moderacao (max 3-5 por texto)
74
+
75
+ 7. **Headline** (aparece abaixo da imagem/video):
76
+ - Maximo 40 caracteres
77
+ - Foco no beneficio principal OU curiosidade
78
+ - 2 opcoes por variacao
79
+
80
+ 8. **Description** (texto menor abaixo da headline):
81
+ - Maximo 30 caracteres
82
+ - Complementar a headline (nao repetir)
83
+ - Pode ser CTA curto ou reforco de prova
84
+ - 2 opcoes por variacao
85
+
86
+ 9. **CTA Button**: Selecionar o mais adequado:
87
+ - Saiba Mais (trafego frio, curiosidade)
88
+ - Comprar Agora (trafego quente, conversao)
89
+ - Cadastre-se (leads)
90
+ - Assistir Mais (video, VSL)
91
+ - Enviar Mensagem (WhatsApp)
92
+
93
+ ### Passo 3 — Adaptar por formato
94
+
95
+ 10. **Para imagem estatica**:
96
+ - Texto no criativo: max 20% da area (regra Meta)
97
+ - Headline do criativo: max 5 palavras
98
+ - O Primary Text carrega a copy
99
+
100
+ 11. **Para video**:
101
+ - Hook nos primeiros 3 segundos (texto + visual)
102
+ - Legendas obrigatorias (85% assiste sem som)
103
+ - CTA visual no final do video
104
+ - Duracao recomendada: 15s (stories), 30-60s (feed), 2-5min (in-stream)
105
+
106
+ 12. **Para carrossel**:
107
+ - Card 1: Hook visual + texto impactante
108
+ - Cards 2-4: Beneficios ou passos (1 por card)
109
+ - Card 5: CTA + oferta
110
+ - Headline de cada card: max 5 palavras
111
+
112
+ 13. **Para stories/reels**:
113
+ - Formato vertical (9:16)
114
+ - Hook nos primeiros 1.5 segundos
115
+ - Texto centralizado, fonte grande
116
+ - CTA com swipe up ou link
117
+
118
+ ### Passo 4 — Montar mapa de testes A/B
119
+
120
+ 14. Organizar as variacoes em uma matriz de teste:
121
+ - **Teste 1 (Hook)**: Mesmo body, variar apenas o hook
122
+ - **Teste 2 (Angulo)**: Variar o angulo, manter formato
123
+ - **Teste 3 (Formato)**: Mesmo angulo, variar Primary Text curto vs longo
124
+ - **Teste 4 (CTA)**: Variar headline + description
125
+ 15. Definir ordem de prioridade dos testes (hook primeiro, depois angulo).
126
+
127
+ ### Passo 5 — Self-review compliance Meta
128
+
129
+ 16. Para CADA variacao, verificar os 12 itens de compliance:
130
+ 1. Sem promessas de resultados garantidos
131
+ 2. Sem mencao de ganhos financeiros especificos
132
+ 3. Sem antes/depois que implique resultado garantido
133
+ 4. Sem conteudo discriminatorio (idade, raca, genero, religiao)
134
+ 5. Sem mencao de atributos pessoais ("Voce que e gordo...")
135
+ 6. Sem conteudo enganoso ou clickbait extremo
136
+ 7. Sem uso de marcas registradas sem autorizacao
137
+ 8. Sem conteudo sensacionalista sobre saude
138
+ 9. Link de destino corresponde a promessa do anuncio
139
+ 10. Imagem/video nao contem conteudo restrito
140
+ 11. Disclaimer presente quando necessario (resultados podem variar)
141
+ 12. Texto na imagem dentro do limite de 20%
142
+
143
+ 17. Para cada item reprovado:
144
+ - Marcar severidade: CRITICO (bloqueia), ALTO (risco de rejeicao), MEDIO (risco de limitacao), BAIXO (melhoria recomendada)
145
+ - Sugerir reescrita que mantem o impacto sem violar a regra
146
+
147
+ 18. **Gerar documento final** com:
148
+ - Todas as variacoes organizadas por angulo
149
+ - Mapa de testes A/B
150
+ - Checklist de compliance preenchido
151
+ - Status por variacao: APROVADO, AJUSTE NECESSARIO, REPROVADO
152
+
153
+ ## Post-conditions
154
+
155
+ - [ ] Minimo 3 variacoes por angulo
156
+ - [ ] Cada variacao tem: Primary Text + Headline + Description + CTA
157
+ - [ ] Compliance Meta verificado para todas as variacoes
158
+ - [ ] Mapa de testes A/B definido
159
+ - [ ] Nenhuma variacao com flag CRITICO de compliance
160
+ - [ ] Documento salvo no path correto
161
+
162
+ ## Acceptance Criteria
163
+
164
+ - [ ] Hooks prendem atencao em 3 segundos (curtos, diretos, impactantes)
165
+ - [ ] Primary Text segue estrutura Hook-Agitacao-Solucao-Prova-CTA
166
+ - [ ] Headlines dentro do limite de 40 caracteres
167
+ - [ ] Descriptions dentro do limite de 30 caracteres
168
+ - [ ] Linguagem corresponde ao avatar
169
+ - [ ] Variacoes sao genuinamente diferentes (nao apenas sinonimos)
170
+ - [ ] Compliance Meta aprovado em todas as variacoes (zero CRITICO)
171
+ - [ ] CTA alinhado com o objetivo da campanha
172
+ - [ ] Mapa de testes A/B coerente e priorizdo
173
+
174
+ ## Frameworks
175
+
176
+ - **C.A.S.H.**: Conceito, Angulo, Estilo, Hook — base para angulos
177
+ - **AIDA**: Atencao (hook), Interesse (agitacao), Desejo (solucao/prova), Acao (CTA)
178
+ - **PAS**: Problema, Agitacao, Solucao — estrutura do Primary Text
179
+ - **Schwartz Awareness**: Determina profundidade e abordagem do texto
180
+
181
+ ## Error Handling
182
+
183
+ | Erro | Acao |
184
+ |------|------|
185
+ | Angulos nao definidos | BLOQUEAR. Retornar ao `criar-conceito.md` |
186
+ | Avatar nao definido | BLOQUEAR. Retornar ao `criar-briefing.md` |
187
+ | Compliance CRITICO detectado | REESCREVER variacao especifica mantendo angulo |
188
+ | Menos de 3 variacoes por angulo | COMPLETAR. Escrever variacoes adicionais |
189
+ | Hook com mais de 10 palavras | ENCURTAR. Reescrever mais direto |
190
+ | Headline acima de 40 caracteres | CORTAR. Reescrever mais concisa |
191
+ | Link de destino invalido | ALERTAR usuario. Nao finalizar sem link valido |
@@ -0,0 +1,237 @@
1
+ ---
2
+ task: escrever-email-sequence()
3
+ responsavel: Zeus (Copywriter)
4
+ tipo: copy
5
+ ---
6
+
7
+ # Escrever Sequencia de Emails
8
+
9
+ ## Descricao
10
+
11
+ Definir a estrutura completa de uma sequencia de emails (trigger, objetivo, quantidade, timing) e escrever cada email com subject line, preview text, body e CTA. Aplicavel a lancamentos, nurturing, carrinho abandonado, pos-compra e reativacao.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Tipo da sequencia | Usuario | Sim | Lancamento, nurturing, carrinho, pos-compra, reativacao |
18
+ | Avatar detalhado | `criar-briefing.md` output | Sim | Dores, desejos, linguagem |
19
+ | Produto/oferta | Briefing | Sim | Nome, beneficio, preco, link |
20
+ | Trigger da sequencia | Usuario | Sim | Evento que inicia (opt-in, compra, abandono, data) |
21
+ | Objetivo da sequencia | Usuario | Sim | Venda, engajamento, retencao, reativacao |
22
+ | Provas disponiveis | Briefing | Sim | Depoimentos, cases, dados |
23
+ | Plataforma de email | Usuario | Nao | ActiveCampaign, Mailchimp, RD Station, etc. |
24
+
25
+ ## Saida
26
+
27
+ | Campo | Destino | Template |
28
+ |-------|---------|----------|
29
+ | Sequencia completa de emails | `outputs/copy/email-sequence-{tipo}-{produto}-{data}.md` | — |
30
+ | Calendario de envio | Inline no documento | — |
31
+ | Metricas esperadas | Inline no documento | — |
32
+
33
+ ## Pre-conditions
34
+
35
+ - [ ] Tipo da sequencia definido
36
+ - [ ] Trigger claro e implementavel
37
+ - [ ] Objetivo mensuravel
38
+ - [ ] Avatar detalhado disponivel
39
+ - [ ] Produto e oferta claros
40
+ - [ ] Pelo menos 3 provas disponiveis
41
+
42
+ ## Workflow
43
+
44
+ ### Passo 1 — Definir estrutura da sequencia
45
+
46
+ 1. **Determinar a quantidade de emails** baseado no tipo:
47
+
48
+ | Tipo | Quantidade | Frequencia |
49
+ |------|-----------|------------|
50
+ | Lancamento | 7-12 emails | Diario no periodo de abertura |
51
+ | Nurturing | 5-8 emails | 2-3x por semana |
52
+ | Carrinho abandonado | 3-4 emails | 1h, 24h, 48h, 72h |
53
+ | Pos-compra | 4-6 emails | Dias 0, 1, 3, 7, 14, 30 |
54
+ | Reativacao | 3-5 emails | Dias 0, 3, 7, 14, 21 |
55
+
56
+ 2. **Definir o objetivo de cada email** na sequencia:
57
+ - Email 1: [objetivo especifico — ex: confirmar opt-in e entregar lead magnet]
58
+ - Email 2: [objetivo especifico — ex: contar historia e gerar conexao]
59
+ - Email N: [objetivo especifico — ex: CTA final com urgencia]
60
+
61
+ 3. **Mapear a jornada emocional**:
62
+ - Email 1: Boas-vindas/reciprocidade (entregar valor)
63
+ - Emails 2-3: Conexao/identificacao (historia, dor)
64
+ - Emails 4-5: Educacao/autoridade (mecanismo, prova)
65
+ - Emails 6-7: Oferta/desejo (apresentar produto)
66
+ - Emails finais: Urgencia/fechamento (prazo, escassez)
67
+
68
+ 4. **Criar calendario de envio**:
69
+ ```
70
+ Email 1: Dia 0 (imediato apos trigger) — Objetivo: X
71
+ Email 2: Dia 1 (09:00) — Objetivo: Y
72
+ Email 3: Dia 3 (09:00) — Objetivo: Z
73
+ ```
74
+
75
+ ### Passo 2 — Escrever cada email
76
+
77
+ Para CADA email na sequencia:
78
+
79
+ 5. **Subject Line** (linha de assunto):
80
+ - Escrever 3 opcoes para teste A/B
81
+ - Max 50 caracteres (ideal 30-40)
82
+ - Formatos eficazes:
83
+ - Pergunta: "Voce comete esse erro?"
84
+ - Numero: "3 motivos para [resultado]"
85
+ - Curiosidade: "Isso explica tudo..."
86
+ - Urgencia: "Ultimas horas para [beneficio]"
87
+ - Pessoal: "{nome}, preciso te contar algo"
88
+ - EVITAR: caps lock excessivo, muitos emojis, palavras spam (gratis, urgente, clique aqui)
89
+
90
+ 6. **Preview Text** (texto de pre-visualizacao):
91
+ - Complementar a subject line (nao repetir)
92
+ - Max 90 caracteres
93
+ - Deve gerar curiosidade suficiente para abrir
94
+ - Exemplo: Subject "3 motivos..." — Preview "O terceiro vai te surpreender"
95
+
96
+ 7. **Body** (corpo do email):
97
+
98
+ **Abertura** (primeiras 2-3 linhas):
99
+ - Prender atencao imediatamente
100
+ - Conectar com o assunto (cumprir a promessa da subject)
101
+ - Personalizar com {nome} quando possivel
102
+
103
+ **Desenvolvimento** (corpo principal):
104
+ - Uma unica ideia central por email
105
+ - Paragrafos curtos (2-3 linhas max)
106
+ - Usar storytelling quando possivel
107
+ - Incluir prova/dado quando relevante
108
+ - Manter tom pessoal (1 pessoa falando para 1 pessoa)
109
+ - Extensao por tipo:
110
+ - Email de conteudo: 300-500 palavras
111
+ - Email de historia: 400-700 palavras
112
+ - Email de venda: 500-1000 palavras
113
+ - Email de urgencia: 200-400 palavras
114
+
115
+ **Fechamento + CTA**:
116
+ - Transicao natural para a acao
117
+ - CTA claro e unico (1 link/botao principal)
118
+ - Texto do CTA: verbo + beneficio
119
+ - Repetir o CTA 2-3 vezes no email (inicio, meio, fim para emails de venda)
120
+ - PS: Incluir P.S. com beneficio adicional ou urgencia
121
+
122
+ 8. **Assinatura**:
123
+ - Nome do remetente
124
+ - Cargo/titulo
125
+ - Link para opt-out (obrigatorio)
126
+
127
+ ### Passo 3 — Sequencias especificas
128
+
129
+ 9. **Se LANCAMENTO**, incluir:
130
+ - Email de abertura do carrinho (dia do lancamento)
131
+ - Email de bonus (dia 2-3)
132
+ - Email de objecoes (dia 4-5)
133
+ - Email de prova social (dia 5-6)
134
+ - Email de lembrete (penultimo dia)
135
+ - Email de fechamento (ultimo dia — enviar 2: manha e noite)
136
+ - Contador regressivo no template (nota para implementacao)
137
+
138
+ 10. **Se CARRINHO ABANDONADO**, incluir:
139
+ - Email 1 (1h): Lembrete suave ("Esqueceu algo?")
140
+ - Email 2 (24h): Responder objecao principal (preco? confianca?)
141
+ - Email 3 (48h): Prova social + urgencia suave
142
+ - Email 4 (72h): Ultimo lembrete + bonus exclusivo (se aplicavel)
143
+ - Condicao de saida: se comprou, parar sequencia
144
+
145
+ 11. **Se POS-COMPRA**, incluir:
146
+ - Email 0 (imediato): Confirmacao + acesso + proximos passos
147
+ - Email 1 (dia 1): Boas-vindas + por onde comecar
148
+ - Email 2 (dia 3): Dica de uso + case de sucesso
149
+ - Email 3 (dia 7): Check-in + suporte
150
+ - Email 4 (dia 14): Resultado esperado + upsell soft
151
+ - Email 5 (dia 30): Depoimento + convite para comunidade
152
+
153
+ 12. **Se NURTURING**, incluir:
154
+ - Alternar entre conteudo puro e soft sell
155
+ - Proporcao: 3 emails de valor para 1 de oferta
156
+ - Cada email de conteudo termina com micro-CTA
157
+ - Segmentar por engajamento apos email 3
158
+
159
+ 13. **Se REATIVACAO**, incluir:
160
+ - Email 1: "Sentimos sua falta" + lembrete de valor
161
+ - Email 2: Conteudo relevante (re-engajar)
162
+ - Email 3: Oferta especial exclusiva
163
+ - Email 4: Ultimo aviso antes de remover da lista
164
+ - Email 5: Confirmacao de remocao (se nao engajou)
165
+
166
+ ### Passo 4 — Definir metricas esperadas
167
+
168
+ 14. **Benchmarks por metrica**:
169
+
170
+ | Metrica | Benchmark | Alerta |
171
+ |---------|-----------|--------|
172
+ | Taxa de abertura | 20-30% | < 15% |
173
+ | Taxa de clique | 3-5% | < 2% |
174
+ | Taxa de conversao | 1-3% | < 0.5% |
175
+ | Taxa de descadastro | < 0.5% | > 1% |
176
+ | Taxa de bounce | < 2% | > 5% |
177
+
178
+ ### Passo 5 — Revisao e finalizacao
179
+
180
+ 15. **Revisar a sequencia completa**:
181
+ - Cada email tem subject + preview + body + CTA?
182
+ - Subject lines sao unicas (nao repetitivas)?
183
+ - Jornada emocional faz sentido na sequencia?
184
+ - Nao ha emails redundantes?
185
+ - Frequencia esta adequada (nao cansa o lead)?
186
+ - Opt-out presente em todos os emails?
187
+ - Variaveis de personalizacao usadas corretamente?
188
+
189
+ 16. **Gerar documento final** com:
190
+ - Calendario de envio completo
191
+ - Todos os emails escritos na sequencia
192
+ - 3 opcoes de subject por email
193
+ - Metricas esperadas
194
+ - Condicoes de saida/segmentacao
195
+ - Notas de implementacao
196
+
197
+ ## Post-conditions
198
+
199
+ - [ ] Todos os emails da sequencia escritos
200
+ - [ ] Cada email tem: subject (3 opcoes), preview, body, CTA
201
+ - [ ] Calendario de envio definido
202
+ - [ ] Jornada emocional coerente
203
+ - [ ] Metricas esperadas documentadas
204
+ - [ ] Opt-out em todos os emails
205
+ - [ ] Documento salvo no path correto
206
+
207
+ ## Acceptance Criteria
208
+
209
+ - [ ] Quantidade de emails adequada ao tipo de sequencia
210
+ - [ ] Subject lines com max 50 caracteres e 3 opcoes cada
211
+ - [ ] Preview text complementar (nao repetitivo)
212
+ - [ ] Body com paragrafos curtos e 1 ideia por email
213
+ - [ ] CTA claro e unico por email
214
+ - [ ] P.S. presente nos emails de venda
215
+ - [ ] Frequencia nao excede 1/dia (exceto lancamento)
216
+ - [ ] Tom consistente e pessoal
217
+ - [ ] Condicoes de saida definidas
218
+
219
+ ## Frameworks
220
+
221
+ - **Soap Opera Sequence** (Andre Chaperon): Storytelling sequencial com cliffhangers
222
+ - **AIDA por email**: Cada email segue Atencao-Interesse-Desejo-Acao
223
+ - **Jornada emocional**: Progressao de reciprocidade ate urgencia
224
+ - **Schwartz**: Nivel de consciencia determina profundidade por email
225
+
226
+ ## Error Handling
227
+
228
+ | Erro | Acao |
229
+ |------|------|
230
+ | Tipo de sequencia nao definido | BLOQUEAR. Perguntar ao usuario |
231
+ | Trigger nao definido | BLOQUEAR. Sem trigger nao ha automacao |
232
+ | Avatar nao definido | BLOQUEAR. Retornar ao `criar-briefing.md` |
233
+ | Subject acima de 50 chars | REESCREVER mais concisa |
234
+ | Email sem CTA | ADICIONAR CTA antes de finalizar |
235
+ | Mais de 2 CTAs diferentes por email | SIMPLIFICAR. 1 CTA principal por email |
236
+ | Sequencia sem opt-out | BLOQUEAR. Adicionar opt-out obrigatoriamente |
237
+ | Mais de 12 emails em sequencia | ALERTAR. Pode ser excessivo, revisar necessidade |
@@ -0,0 +1,220 @@
1
+ ---
2
+ task: escrever-msgs-whatsapp()
3
+ responsavel: Poseidon (WhatsApp)
4
+ tipo: copy
5
+ ---
6
+
7
+ # Escrever Mensagens WhatsApp
8
+
9
+ ## Descricao
10
+
11
+ Receber o fluxo de WhatsApp definido pelo `fluxo-whatsapp-backend.md`, escrever a copy de cada mensagem respeitando timing, tipo de midia, variaveis de personalizacao e fluxos condicionais. Incluir mensagens de opt-out e compliance.
12
+
13
+ ## Entrada
14
+
15
+ | Campo | Origem | Obrigatorio | Validacao |
16
+ |-------|--------|-------------|-----------|
17
+ | Fluxo de mensagens | `fluxo-whatsapp-backend.md` output | Sim | Sequencia com triggers, timing e tipos |
18
+ | Avatar detalhado | `criar-briefing.md` output | Sim | Linguagem, dores, desejos |
19
+ | Produto/oferta | Briefing | Sim | Nome, beneficio, preco, link |
20
+ | Tom de voz | Briefing | Sim | Formal, casual, autoridade, amigavel |
21
+ | Variaveis disponiveis | Integracao | Sim | {nome}, {produto}, {link}, etc. |
22
+ | Regras de opt-out | Compliance | Sim | Texto padrao de descadastro |
23
+
24
+ ## Saida
25
+
26
+ | Campo | Destino | Template |
27
+ |-------|---------|----------|
28
+ | Pack de mensagens completo | `outputs/copy/whatsapp-{produto}-{data}.md` | — |
29
+ | Fluxograma de decisao | Inline no documento | — |
30
+ | Mensagens de opt-out | Inline no documento | — |
31
+
32
+ ## Pre-conditions
33
+
34
+ - [ ] Fluxo de WhatsApp definido com sequencia e timing
35
+ - [ ] Avatar detalhado disponivel
36
+ - [ ] Tom de voz definido
37
+ - [ ] Variaveis de personalizacao listadas
38
+ - [ ] Regras de opt-out definidas
39
+ - [ ] Produto e oferta claros
40
+
41
+ ## Workflow
42
+
43
+ ### Passo 1 — Mapear o fluxo completo
44
+
45
+ 1. Ler o output do `fluxo-whatsapp-backend.md` integralmente.
46
+ 2. Listar todas as mensagens na sequencia, anotando para cada uma:
47
+ - **ID da mensagem**: MSG-01, MSG-02, etc.
48
+ - **Trigger**: o que dispara essa mensagem (tempo, acao do usuario, evento)
49
+ - **Timing**: quando enviar (imediato, +1h, +24h, +48h, etc.)
50
+ - **Tipo**: texto, imagem, video, audio, documento, botoes, lista
51
+ - **Condicao**: se depende de resposta anterior (sim/nao/sem resposta)
52
+ - **Objetivo**: o que essa mensagem deve fazer o usuario pensar/sentir/fazer
53
+ 3. Desenhar o fluxograma de decisao em formato texto:
54
+ ```
55
+ MSG-01 (Welcome) → resposta?
56
+ SIM → MSG-02a (Engajamento)
57
+ NAO → MSG-02b (Follow-up passivo)
58
+ ```
59
+
60
+ ### Passo 2 — Escrever cada mensagem
61
+
62
+ Para CADA mensagem no fluxo:
63
+
64
+ 4. **Definir o header da mensagem**:
65
+ ```
66
+ ID: MSG-{numero}
67
+ Trigger: {o que dispara}
68
+ Timing: {quando envia}
69
+ Tipo: {texto/imagem/video/audio/botoes/lista}
70
+ Condicao: {se aplicavel}
71
+ Objetivo: {o que quer que o usuario faca}
72
+ ```
73
+
74
+ 5. **Escrever a copy** seguindo estas regras:
75
+ - Maximo 300 caracteres para a primeira mensagem (acima do "Ler mais")
76
+ - Tom conversacional — como uma pessoa real falando
77
+ - Usar nome do contato com variavel: "Oi {nome}!"
78
+ - Uma ideia por mensagem — se precisar dizer mais, quebrar em 2-3 mensagens separadas
79
+ - Nao usar paragrafos longos — maximo 3 linhas por bloco
80
+ - Emojis com moderacao (1-2 por mensagem, max)
81
+ - Sem linguagem robozinha ("Prezado cliente", "Segue em anexo")
82
+
83
+ 6. **Formatar por tipo de mensagem**:
84
+
85
+ **Texto simples**:
86
+ - Mensagem direta, quebras de linha para respiracao
87
+ - Terminar com pergunta ou CTA claro
88
+
89
+ **Mensagem com botoes** (max 3 botoes):
90
+ - Texto principal + opcoes claras
91
+ - Cada botao: max 20 caracteres
92
+ - Exemplo:
93
+ ```
94
+ Texto: "Qual dessas opcoes faz mais sentido pra voce?"
95
+ Botao 1: "Quero saber mais"
96
+ Botao 2: "Ja comprei"
97
+ Botao 3: "Nao tenho interesse"
98
+ ```
99
+
100
+ **Mensagem com lista** (max 10 itens):
101
+ - Header da lista
102
+ - Secoes com itens selecionaveis
103
+ - Cada item: titulo (24 chars) + descricao (72 chars)
104
+
105
+ **Audio**:
106
+ - Escrever o roteiro do audio (30-60 segundos)
107
+ - Indicar tom de voz e emocao
108
+ - Marcar pausas e enfases
109
+
110
+ **Imagem/video**:
111
+ - Descrever o visual necessario
112
+ - Escrever a legenda que acompanha
113
+ - Indicar CTA visual se houver
114
+
115
+ ### Passo 3 — Escrever fluxos condicionais
116
+
117
+ 7. **Para cada ponto de decisao**, escrever as ramificacoes:
118
+
119
+ **Se o usuario respondeu positivamente**:
120
+ - Mensagem de engajamento (reconhecer a resposta)
121
+ - Avancar para o proximo passo do funil
122
+ - Ser especifico ("Otimo! Entao vou te mostrar como...")
123
+
124
+ **Se o usuario respondeu negativamente**:
125
+ - Mensagem de respeito (nao insistir)
126
+ - Oferecer alternativa ou pedir feedback
127
+ - Mover para fluxo de nurturing mais lento
128
+
129
+ **Se o usuario nao respondeu**:
130
+ - Follow-up suave apos 24-48h
131
+ - Mudar o angulo (se a primeira foi beneficio, tentar prova social)
132
+ - Maximo 2 follow-ups sem resposta antes de pausar
133
+
134
+ **Se o usuario pediu opt-out**:
135
+ - Mensagem de confirmacao imediata
136
+ - Remover de automacoes
137
+ - Texto padrao: "Pronto, {nome}. Voce nao vai mais receber mensagens. Se mudar de ideia, e so me chamar aqui."
138
+
139
+ ### Passo 4 — Mensagens especiais
140
+
141
+ 8. **Mensagem de boas-vindas** (primeira do fluxo):
142
+ - Apresentar-se brevemente
143
+ - Confirmar o que o contato vai receber
144
+ - Definir expectativa de frequencia
145
+ - Incluir opt-out no rodape
146
+
147
+ 9. **Mensagem de qualificacao** (se fluxo inclui):
148
+ - Perguntas curtas e objetivas (1 por mensagem)
149
+ - Usar botoes quando possivel (reduz atrito)
150
+ - Nao fazer mais de 3 perguntas seguidas
151
+
152
+ 10. **Mensagem de oferta** (quando aplicavel):
153
+ - Reforcar o problema/desejo
154
+ - Apresentar a solucao de forma concisa
155
+ - Prova rapida (1 depoimento ou resultado)
156
+ - CTA com link direto
157
+ - Prazo/escassez se houver
158
+
159
+ 11. **Mensagem de lembrete** (carrinho abandonado, prazo):
160
+ - Tom amigavel, nao desesperado
161
+ - Relembrar beneficio principal
162
+ - Responder objecao provavel (preco? confianca? timing?)
163
+ - CTA direto
164
+
165
+ ### Passo 5 — Revisao e finalizacao
166
+
167
+ 12. **Revisar cada mensagem** nos criterios:
168
+ - Tom consistente em todo o fluxo?
169
+ - Variaveis usadas corretamente ({nome}, {link}, etc.)?
170
+ - Timing faz sentido (nao enviar 5 mensagens no mesmo dia)?
171
+ - Cada mensagem tem objetivo claro?
172
+ - Opt-out acessivel em pelo menos 1 mensagem do fluxo?
173
+ - Nenhuma mensagem parece spam?
174
+
175
+ 13. **Gerar documento final** com:
176
+ - Todas as mensagens numeradas na sequencia
177
+ - Fluxograma de decisao
178
+ - Tabela de timing
179
+ - Lista de variaveis utilizadas
180
+ - Mensagens de opt-out
181
+ - Notas de implementacao para o desenvolvedor
182
+
183
+ ## Post-conditions
184
+
185
+ - [ ] Todas as mensagens do fluxo escritas
186
+ - [ ] Fluxos condicionais cobrem: resposta positiva, negativa e sem resposta
187
+ - [ ] Mensagem de opt-out presente
188
+ - [ ] Variaveis de personalizacao indicadas corretamente
189
+ - [ ] Timing de envio definido para cada mensagem
190
+ - [ ] Tipo de cada mensagem especificado (texto, botoes, audio, etc.)
191
+ - [ ] Documento salvo no path correto
192
+
193
+ ## Acceptance Criteria
194
+
195
+ - [ ] Cada mensagem tem ID, trigger, timing, tipo e objetivo definidos
196
+ - [ ] Tom conversacional consistente em todo o fluxo
197
+ - [ ] Maximo 300 caracteres na primeira linha visivel
198
+ - [ ] Fluxos condicionais cobrem todos os cenarios
199
+ - [ ] Opt-out claro e acessivel
200
+ - [ ] Nenhuma mensagem parece automatizada/robotica
201
+ - [ ] Variaveis usadas corretamente
202
+ - [ ] Maximo 1 mensagem por dia (exceto boas-vindas)
203
+ - [ ] CTA claro nas mensagens de oferta
204
+
205
+ ## Frameworks
206
+
207
+ - **Conversational Commerce**: Tom de conversa 1:1, nao broadcast
208
+ - **Micro-compromissos**: Cada mensagem pede uma pequena acao
209
+ - **Storytelling sequencial**: Cada mensagem constroi sobre a anterior
210
+
211
+ ## Error Handling
212
+
213
+ | Erro | Acao |
214
+ |------|------|
215
+ | Fluxo de backend nao definido | BLOQUEAR. Executar `fluxo-whatsapp-backend.md` primeiro |
216
+ | Avatar nao definido | BLOQUEAR. Retornar ao `criar-briefing.md` |
217
+ | Mais de 3 follow-ups sem resposta | PARAR sequencia. Mover para fluxo frio |
218
+ | Mensagem acima de 1000 caracteres | DIVIDIR em 2-3 mensagens menores |
219
+ | Variavel inexistente no sistema | ALERTAR. Substituir por texto generico ou remover |
220
+ | Sem opt-out no fluxo | BLOQUEAR. Adicionar mensagem de opt-out obrigatoriamente |