drm-core 1.0.0 → 1.2.0

package/scaffold/.drm-core/tasks/copy/escrever-msgs-whatsapp.md

@@ -0,0 +1,220 @@
+---
+task: escrever-msgs-whatsapp()
+responsavel: Poseidon (WhatsApp)
+tipo: copy
+---
+
+# Escrever Mensagens WhatsApp
+
+## Descricao
+
+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.
+
+## Entrada
+
+| Campo | Origem | Obrigatorio | Validacao |
+|-------|--------|-------------|-----------|
+| Fluxo de mensagens | `fluxo-whatsapp-backend.md` output | Sim | Sequencia com triggers, timing e tipos |
+| Avatar detalhado | `criar-briefing.md` output | Sim | Linguagem, dores, desejos |
+| Produto/oferta | Briefing | Sim | Nome, beneficio, preco, link |
+| Tom de voz | Briefing | Sim | Formal, casual, autoridade, amigavel |
+| Variaveis disponiveis | Integracao | Sim | {nome}, {produto}, {link}, etc. |
+| Regras de opt-out | Compliance | Sim | Texto padrao de descadastro |
+
+## Saida
+
+| Campo | Destino | Template |
+|-------|---------|----------|
+| Pack de mensagens completo | `outputs/copy/whatsapp-{produto}-{data}.md` | — |
+| Fluxograma de decisao | Inline no documento | — |
+| Mensagens de opt-out | Inline no documento | — |
+
+## Pre-conditions
+
+- [ ] Fluxo de WhatsApp definido com sequencia e timing
+- [ ] Avatar detalhado disponivel
+- [ ] Tom de voz definido
+- [ ] Variaveis de personalizacao listadas
+- [ ] Regras de opt-out definidas
+- [ ] Produto e oferta claros
+
+## Workflow
+
+### Passo 1 — Mapear o fluxo completo
+
+1. Ler o output do `fluxo-whatsapp-backend.md` integralmente.
+2. Listar todas as mensagens na sequencia, anotando para cada uma:
+   - **ID da mensagem**: MSG-01, MSG-02, etc.
+   - **Trigger**: o que dispara essa mensagem (tempo, acao do usuario, evento)
+   - **Timing**: quando enviar (imediato, +1h, +24h, +48h, etc.)
+   - **Tipo**: texto, imagem, video, audio, documento, botoes, lista
+   - **Condicao**: se depende de resposta anterior (sim/nao/sem resposta)
+   - **Objetivo**: o que essa mensagem deve fazer o usuario pensar/sentir/fazer
+3. Desenhar o fluxograma de decisao em formato texto:
+   ```
+   MSG-01 (Welcome) → resposta? 
+     SIM → MSG-02a (Engajamento)
+     NAO → MSG-02b (Follow-up passivo)
+   ```
+
+### Passo 2 — Escrever cada mensagem
+
+Para CADA mensagem no fluxo:
+
+4. **Definir o header da mensagem**:
+   ```
+   ID: MSG-{numero}
+   Trigger: {o que dispara}
+   Timing: {quando envia}
+   Tipo: {texto/imagem/video/audio/botoes/lista}
+   Condicao: {se aplicavel}
+   Objetivo: {o que quer que o usuario faca}
+   ```
+
+5. **Escrever a copy** seguindo estas regras:
+   - Maximo 300 caracteres para a primeira mensagem (acima do "Ler mais")
+   - Tom conversacional — como uma pessoa real falando
+   - Usar nome do contato com variavel: "Oi {nome}!"
+   - Uma ideia por mensagem — se precisar dizer mais, quebrar em 2-3 mensagens separadas
+   - Nao usar paragrafos longos — maximo 3 linhas por bloco
+   - Emojis com moderacao (1-2 por mensagem, max)
+   - Sem linguagem robozinha ("Prezado cliente", "Segue em anexo")
+
+6. **Formatar por tipo de mensagem**:
+
+   **Texto simples**:
+   - Mensagem direta, quebras de linha para respiracao
+   - Terminar com pergunta ou CTA claro
+
+   **Mensagem com botoes** (max 3 botoes):
+   - Texto principal + opcoes claras
+   - Cada botao: max 20 caracteres
+   - Exemplo:
+     ```
+     Texto: "Qual dessas opcoes faz mais sentido pra voce?"
+     Botao 1: "Quero saber mais"
+     Botao 2: "Ja comprei"
+     Botao 3: "Nao tenho interesse"
+     ```
+
+   **Mensagem com lista** (max 10 itens):
+   - Header da lista
+   - Secoes com itens selecionaveis
+   - Cada item: titulo (24 chars) + descricao (72 chars)
+
+   **Audio**:
+   - Escrever o roteiro do audio (30-60 segundos)
+   - Indicar tom de voz e emocao
+   - Marcar pausas e enfases
+
+   **Imagem/video**:
+   - Descrever o visual necessario
+   - Escrever a legenda que acompanha
+   - Indicar CTA visual se houver
+
+### Passo 3 — Escrever fluxos condicionais
+
+7. **Para cada ponto de decisao**, escrever as ramificacoes:
+
+   **Se o usuario respondeu positivamente**:
+   - Mensagem de engajamento (reconhecer a resposta)
+   - Avancar para o proximo passo do funil
+   - Ser especifico ("Otimo! Entao vou te mostrar como...")
+
+   **Se o usuario respondeu negativamente**:
+   - Mensagem de respeito (nao insistir)
+   - Oferecer alternativa ou pedir feedback
+   - Mover para fluxo de nurturing mais lento
+
+   **Se o usuario nao respondeu**:
+   - Follow-up suave apos 24-48h
+   - Mudar o angulo (se a primeira foi beneficio, tentar prova social)
+   - Maximo 2 follow-ups sem resposta antes de pausar
+
+   **Se o usuario pediu opt-out**:
+   - Mensagem de confirmacao imediata
+   - Remover de automacoes
+   - Texto padrao: "Pronto, {nome}. Voce nao vai mais receber mensagens. Se mudar de ideia, e so me chamar aqui."
+
+### Passo 4 — Mensagens especiais
+
+8. **Mensagem de boas-vindas** (primeira do fluxo):
+   - Apresentar-se brevemente
+   - Confirmar o que o contato vai receber
+   - Definir expectativa de frequencia
+   - Incluir opt-out no rodape
+
+9. **Mensagem de qualificacao** (se fluxo inclui):
+   - Perguntas curtas e objetivas (1 por mensagem)
+   - Usar botoes quando possivel (reduz atrito)
+   - Nao fazer mais de 3 perguntas seguidas
+
+10. **Mensagem de oferta** (quando aplicavel):
+    - Reforcar o problema/desejo
+    - Apresentar a solucao de forma concisa
+    - Prova rapida (1 depoimento ou resultado)
+    - CTA com link direto
+    - Prazo/escassez se houver
+
+11. **Mensagem de lembrete** (carrinho abandonado, prazo):
+    - Tom amigavel, nao desesperado
+    - Relembrar beneficio principal
+    - Responder objecao provavel (preco? confianca? timing?)
+    - CTA direto
+
+### Passo 5 — Revisao e finalizacao
+
+12. **Revisar cada mensagem** nos criterios:
+    - Tom consistente em todo o fluxo?
+    - Variaveis usadas corretamente ({nome}, {link}, etc.)?
+    - Timing faz sentido (nao enviar 5 mensagens no mesmo dia)?
+    - Cada mensagem tem objetivo claro?
+    - Opt-out acessivel em pelo menos 1 mensagem do fluxo?
+    - Nenhuma mensagem parece spam?
+
+13. **Gerar documento final** com:
+    - Todas as mensagens numeradas na sequencia
+    - Fluxograma de decisao
+    - Tabela de timing
+    - Lista de variaveis utilizadas
+    - Mensagens de opt-out
+    - Notas de implementacao para o desenvolvedor
+
+## Post-conditions
+
+- [ ] Todas as mensagens do fluxo escritas
+- [ ] Fluxos condicionais cobrem: resposta positiva, negativa e sem resposta
+- [ ] Mensagem de opt-out presente
+- [ ] Variaveis de personalizacao indicadas corretamente
+- [ ] Timing de envio definido para cada mensagem
+- [ ] Tipo de cada mensagem especificado (texto, botoes, audio, etc.)
+- [ ] Documento salvo no path correto
+
+## Acceptance Criteria
+
+- [ ] Cada mensagem tem ID, trigger, timing, tipo e objetivo definidos
+- [ ] Tom conversacional consistente em todo o fluxo
+- [ ] Maximo 300 caracteres na primeira linha visivel
+- [ ] Fluxos condicionais cobrem todos os cenarios
+- [ ] Opt-out claro e acessivel
+- [ ] Nenhuma mensagem parece automatizada/robotica
+- [ ] Variaveis usadas corretamente
+- [ ] Maximo 1 mensagem por dia (exceto boas-vindas)
+- [ ] CTA claro nas mensagens de oferta
+
+## Frameworks
+
+- **Conversational Commerce**: Tom de conversa 1:1, nao broadcast
+- **Micro-compromissos**: Cada mensagem pede uma pequena acao
+- **Storytelling sequencial**: Cada mensagem constroi sobre a anterior
+
+## Error Handling
+
+| Erro | Acao |
+|------|------|
+| Fluxo de backend nao definido | BLOQUEAR. Executar `fluxo-whatsapp-backend.md` primeiro |
+| Avatar nao definido | BLOQUEAR. Retornar ao `criar-briefing.md` |
+| Mais de 3 follow-ups sem resposta | PARAR sequencia. Mover para fluxo frio |
+| Mensagem acima de 1000 caracteres | DIVIDIR em 2-3 mensagens menores |
+| Variavel inexistente no sistema | ALERTAR. Substituir por texto generico ou remover |
+| Sem opt-out no fluxo | BLOQUEAR. Adicionar mensagem de opt-out obrigatoriamente |

package/scaffold/.drm-core/tasks/copy/escrever-pagina-vendas.md

@@ -0,0 +1,276 @@
+---
+task: escrever-pagina-vendas()
+responsavel: Zeus (Copywriter)
+tipo: copy
+---
+
+# Escrever Pagina de Vendas
+
+## Descricao
+
+Escrever a copy completa de uma pagina de vendas long-form usando o template `pagina-vendas-template.md`. A pagina segue a estrutura: Above the Fold, Dor, Solucao, Produto, Bullets, Prova, Stack de Valor, Garantia, FAQ e CTA. Cada secao e escrita com copy de resposta direta otimizada para conversao.
+
+## Entrada
+
+| Campo | Origem | Obrigatorio | Validacao |
+|-------|--------|-------------|-----------|
+| Briefing do produto | `criar-briefing.md` output | Sim | Produto, promessa, preco, garantia |
+| Avatar detalhado | `criar-briefing.md` output | Sim | Dores, desejos, objecoes, linguagem |
+| Mecanismo unico | `criar-briefing.md` output | Sim | Nome + explicacao |
+| Big Idea | `criar-briefing.md` output | Sim | Frase central |
+| Provas disponiveis | Usuario/briefing | Sim | Depoimentos, dados, cases |
+| Estrutura do funil | `arquitetar-funil-vsl.md` output | Nao | URL, bump, upsell (se aplicavel) |
+| Template | `pagina-vendas-template.md` | Sim | Arquivo acessivel |
+
+## Saida
+
+| Campo | Destino | Template |
+|-------|---------|----------|
+| Copy da pagina completa | `outputs/copy/pagina-vendas-{produto}-{data}.md` | `pagina-vendas-template.md` |
+| Briefing para designer | Inline no documento | — |
+| Checklist de qualidade | Inline no documento | — |
+
+## Pre-conditions
+
+- [ ] Briefing completo e aprovado
+- [ ] Avatar detalhado com linguagem real
+- [ ] Mecanismo unico nomeado
+- [ ] Big Idea definida
+- [ ] Pelo menos 5 provas disponiveis
+- [ ] Preco e condicoes de pagamento definidos
+- [ ] Garantia definida (tipo e prazo)
+- [ ] Template `pagina-vendas-template.md` acessivel
+
+## Workflow
+
+### Passo 1 — Above the Fold (primeira tela visivel)
+
+1. **Escrever a headline principal**:
+   - Deve comunicar o beneficio principal em 1 frase
+   - Max 12 palavras
+   - Formatos eficazes: "Como [resultado] sem [objecao]", "[Resultado] em [prazo]", "O [mecanismo] que [resultado]"
+   - Escrever 3 opcoes, escolher a melhor
+
+2. **Escrever a sub-headline**:
+   - Expandir a headline com detalhe ou prova
+   - Max 25 palavras
+   - Deve responder "como?" ou "por que acreditar?"
+
+3. **Escrever o CTA principal** (botao):
+   - Verbo de acao + beneficio: "Quero [resultado]", "Acessar agora", "Comecar minha transformacao"
+   - Max 5 palavras
+   - Cor do botao: indicar contraste (nota para designer)
+
+4. **Prova rapida abaixo do CTA**:
+   - Numero de alunos/clientes, ou
+   - 1 depoimento curto (1 frase), ou
+   - Selo de garantia
+
+5. **Notas para o designer**:
+   - Imagem/video hero: descrever o que deve mostrar
+   - Elementos de confianca: selos, logos, certificacoes
+   - Responsividade: como deve adaptar para mobile
+
+### Passo 2 — Secao de Dor
+
+6. **Abrir com identificacao**:
+   - "Voce ja [situacao dolorosa]?"
+   - Descrever 3-5 situacoes concretas que o avatar vive
+   - Usar linguagem exata do publico (extrair do avatar)
+
+7. **Agitar a dor**:
+   - Mostrar consequencias de nao resolver o problema
+   - Usar dados/estatisticas quando possivel
+   - Criar urgencia natural ("A cada dia que passa...")
+
+8. **Invalidar solucoes anteriores**:
+   - "Voce ja tentou [solucao A] e nao funcionou?"
+   - Listar 3-4 alternativas comuns e por que falham
+   - Conectar as falhas a ausencia do mecanismo
+
+### Passo 3 — Secao de Solucao
+
+9. **Transicao para a esperanca**:
+   - "Existe um caminho diferente..."
+   - Introduzir o mecanismo pelo nome
+   - Explicar de forma simples (Nivel 1 — analogia)
+
+10. **Apresentar o mecanismo**:
+    - Nome em destaque (bold, tamanho maior)
+    - Explicacao em 3-5 frases (Nivel 2 — causa e efeito)
+    - 1 prova do mecanismo (estudo, dado, resultado)
+
+11. **Pintar o resultado**:
+    - "Imagine voce [resultado desejado]..."
+    - Descrever o "depois" em detalhes sensoriais
+    - 3-5 bullets com resultados especificos
+
+### Passo 4 — Secao do Produto
+
+12. **Revelar o produto**:
+    - "Apresentando: [Nome do Produto]"
+    - 1 frase que conecta produto ao mecanismo
+    - Imagem/mockup do produto (nota para designer)
+
+13. **Descrever os modulos/entregaveis**:
+    - Para cada modulo/componente:
+      - Nome do modulo
+      - O que contem (aulas, materiais, templates)
+      - Resultado que o modulo entrega
+      - Imagem ilustrativa (nota para designer)
+    - Ordem: do mais impactante ao menos
+
+14. **Listar bonus** (se houver):
+    - Para cada bonus:
+      - Nome + "BONUS [numero]"
+      - Descricao em 2-3 frases
+      - Valor individual (para stack)
+      - Por que e relevante
+
+### Passo 5 — Bullets de beneficios
+
+15. **Escrever 10-15 bullets de beneficios**:
+    - Formato: "Como [resultado] mesmo que [objecao]"
+    - OU: "[Resultado] — [detalhe que gera curiosidade]"
+    - Cada bullet deve ser autonomo (funciona sozinho)
+    - Alternar entre beneficios tangveis e intangiveis
+    - Ordenar: mais impactante primeiro e ultimo, medianos no meio
+
+### Passo 6 — Secao de Prova
+
+16. **Organizar provas sociais**:
+    - Depoimentos em formato: nome + resultado + contexto
+    - Priorizar: video > imagem com texto > texto puro
+    - Minimo 5 depoimentos, ideal 8-12
+    - Variar perfis (idade, situacao, resultado)
+
+17. **Adicionar provas de autoridade**:
+    - Credenciais do criador
+    - Mencoes em midia
+    - Numeros: alunos, faturamento, anos de experiencia
+    - Logos de empresas parceiras/clientes
+
+18. **Provas de resultado**:
+    - Screenshots de resultados
+    - Antes/depois (quando aplicavel e permitido)
+    - Graficos de crescimento
+    - Print de ganhos (se financeiro, com disclaimer)
+
+### Passo 7 — Stack de Valor
+
+19. **Montar a tabela de stack**:
+    - Listar cada componente da oferta
+    - Atribuir valor individual (o que custaria separado)
+    - Somar o valor total
+    - Mostrar o preco real como fracao do total
+    - Formato:
+      ```
+      [Modulo 1] ............. R$ X
+      [Modulo 2] ............. R$ Y
+      [Bonus 1] .............. R$ Z
+      Valor Total: R$ [soma]
+      Voce paga apenas: R$ [preco]
+      ```
+
+20. **Condicoes de pagamento**:
+    - Preco a vista com desconto (se houver)
+    - Parcelamento: "12x de R$ X no cartao"
+    - Indicar bandeiras aceitas
+
+### Passo 8 — Garantia
+
+21. **Escrever a garantia**:
+    - Tipo: incondicional (devolucao sem perguntas) ou condicional (com criterio)
+    - Prazo: 7, 15, 30 dias (o que for definido)
+    - Tom: confiante, sem hesitacao
+    - Exemplo: "Se em [prazo] voce nao [resultado], devolvemos 100% do seu investimento. Sem perguntas, sem burocracia."
+    - Selo visual de garantia (nota para designer)
+
+22. **Inversao de risco**:
+    - Explicar por que oferece garantia ("Porque tenho certeza de que funciona")
+    - Transferir o risco do comprador para o vendedor
+
+### Passo 9 — FAQ
+
+23. **Escrever 8-12 perguntas frequentes**:
+    - Priorizar objecoes de compra disfarçadas de perguntas
+    - Estrutura: pergunta direta + resposta que vende
+    - Perguntas obrigatorias:
+      1. "Funciona para [meu caso especifico]?"
+      2. "Em quanto tempo vejo resultado?"
+      3. "E se eu nao gostar?"
+      4. "Preciso ter experiencia?"
+      5. "Como funciona o acesso?"
+      6. "Posso parcelar?"
+      7. "Tem suporte?"
+      8. "Por que esse preco?"
+
+### Passo 10 — CTA Final
+
+24. **Escrever o bloco de fechamento**:
+    - Recap dos 3 principais beneficios
+    - Urgencia/escassez (se real)
+    - Comparacao: custo do problema vs preco da solucao
+    - CTA final identico ao primeiro (consistencia)
+    - "Futuro com" vs "futuro sem" o produto
+
+25. **Rodape**:
+    - Termos de uso, politica de privacidade
+    - CNPJ/razao social
+    - Disclaimer de resultados (se aplicavel)
+    - Copyright
+
+### Passo 11 — Self-review
+
+26. **Revisar a pagina completa**:
+    - Fluxo logico: cada secao leva naturalmente a proxima?
+    - Consistencia: mesmo tom, mesmo "voce", mesma promessa?
+    - Mobile: textos curtos o suficiente para mobile?
+    - Velocidade: nao ha blocos de texto densos demais?
+    - CTAs: aparecem a cada 2-3 secoes?
+    - Provas: distribuidas ao longo da pagina?
+    - Objecoes: todas respondidas antes do CTA final?
+
+## Post-conditions
+
+- [ ] Todas as 10 secoes escritas
+- [ ] Headline testavel (3 opcoes disponveis)
+- [ ] Pelo menos 5 provas sociais incluidas
+- [ ] Stack de valor completo com precos
+- [ ] Garantia escrita e clara
+- [ ] FAQ com pelo menos 8 perguntas
+- [ ] CTAs em pelo menos 3 pontos da pagina
+- [ ] Notas para designer incluidas
+- [ ] Documento salvo no path correto
+
+## Acceptance Criteria
+
+- [ ] Cada secao segue o template `pagina-vendas-template.md`
+- [ ] Headline principal com max 12 palavras
+- [ ] Mecanismo nomeado e explicado na secao de solucao
+- [ ] Bullets de beneficios: 10-15, cada um autonomo
+- [ ] Stack de valor com valores individuais e total
+- [ ] Garantia explicita com prazo
+- [ ] FAQ responde as 8 objecoes obrigatorias
+- [ ] Copy sem promessas proibidas
+- [ ] Tom conversacional e consistente
+- [ ] Formatada para leitura em mobile (blocos curtos)
+
+## Frameworks
+
+- **PAS**: Problema, Agitacao, Solucao — macro estrutura
+- **RMBC**: Mecanismo como peca central da argumentacao
+- **Schwartz**: Nivel de consciencia determina profundidade
+- **Stack de Valor**: Russell Brunson — ancoragem de preco
+
+## Error Handling
+
+| Erro | Acao |
+|------|------|
+| Briefing incompleto | BLOQUEAR. Retornar ao `criar-briefing.md` |
+| Provas insuficientes (< 5) | ALERTAR. Solicitar mais provas antes de finalizar |
+| Preco nao definido | BLOQUEAR. Nao e possivel escrever stack sem preco |
+| Garantia nao definida | BLOQUEAR. Nao e possivel escrever sem garantia |
+| Headline acima de 12 palavras | REESCREVER mais concisa |
+| Secao de dor sem linguagem do avatar | REVISAR com frases reais do publico |
+| FAQ com menos de 8 perguntas | COMPLETAR com objecoes faltantes |