drm-core 1.0.0 → 1.3.0

package/scaffold/.drm-core/tasks/estrategia/pesquisa-mercado.md

@@ -0,0 +1,200 @@
+---
+task: pesquisa-mercado()
+responsavel: Analista
+tipo: estrategia
+---
+
+# Pesquisa de Mercado
+
+## Descricao
+
+Analisar o cenario competitivo do nicho: identificar os 3 principais concorrentes, seus angulos, mecanismos, precos e ofertas. Classificar o nivel de sofisticacao do mercado (Schwartz), identificar lacunas e oportunidades, e documentar todos os achados para embasar decisoes de copy e estrategia.
+
+## Entrada
+
+| Campo | Origem | Obrigatorio | Validacao |
+|-------|--------|-------------|-----------|
+| Nicho/mercado | Usuario ou briefing | Sim | Descricao do segmento |
+| Produto a posicionar | Briefing | Sim | Nome e descricao |
+| Publico-alvo | Briefing ou avatar | Sim | Quem compra nesse mercado |
+| Links de concorrentes | Usuario | Nao | URLs de paginas de vendas, VSLs, ads |
+| Palavras-chave do nicho | Usuario | Nao | Termos de busca relevantes |
+
+## Saida
+
+| Campo | Destino | Template |
+|-------|---------|----------|
+| Relatorio de pesquisa | `outputs/estrategia/pesquisa-mercado-{nicho}-{data}.md` | — |
+| Mapa de concorrentes | Secao do relatorio | — |
+| Nivel de sofisticacao | Secao do relatorio | — |
+| Oportunidades identificadas | Secao do relatorio | — |
+
+## Pre-conditions
+
+- [ ] Nicho/mercado definido
+- [ ] Produto a posicionar identificado
+- [ ] Publico-alvo conhecido (mesmo que em alto nivel)
+
+## Workflow
+
+### Passo 1 — Identificar concorrentes
+
+1. **Listar todos os concorrentes conhecidos** do nicho (diretos e indiretos).
+2. **Selecionar os 3 principais** (diretos) baseado em:
+   - Volume de anuncios ativos (presenca em Meta Ads, Google Ads)
+   - Tamanho da audiencia (seguidores, lista de email estimada)
+   - Tempo de mercado
+   - Relevancia para o mesmo publico-alvo
+3. Se o usuario forneceu links, priorizar esses concorrentes.
+4. Se nao ha links, usar pesquisa por palavras-chave do nicho.
+
+### Passo 2 — Analisar cada concorrente
+
+Para CADA um dos 3 concorrentes, documentar:
+
+5. **Informacoes basicas**:
+   - Nome da empresa/produto
+   - URL da pagina de vendas
+   - Tempo de mercado estimado
+   - Presenca digital (redes sociais, canal YouTube, podcast)
+
+6. **Oferta principal**:
+   - O que vendem (curso, mentoria, software, produto fisico)
+   - Preco: valor a vista e parcelado
+   - Garantia: tipo e prazo
+   - Bonus inclusos
+   - Estrutura de funil (front-end, upsell, downsell)
+
+7. **Copy e comunicacao**:
+   - Headline principal da pagina de vendas
+   - Promessa central (o que prometem entregar)
+   - Mecanismo que usam (se houver) — nome e explicacao
+   - Angulos de copy dominantes:
+     - Medo/dor: quais dores exploram?
+     - Desejo: quais resultados prometem?
+     - Curiosidade: quais loops abertos criam?
+     - Urgencia: que tipo de escassez usam?
+     - Autoridade: como se posicionam como experts?
+   - Tom de voz (formal, casual, agressivo, empático)
+   - Provas que apresentam (depoimentos, dados, cases)
+
+8. **Pontos fortes e fracos**:
+   - **Fortes**: O que fazem bem na comunicacao? O que convence?
+   - **Fracos**: Onde a argumentacao falha? O que esta faltando? Onde ha inconsistencia?
+   - **Objecoes nao respondidas**: Quais duvidas o publico ficaria apos ler?
+
+### Passo 3 — Mapear padroes do mercado
+
+9. **Identificar o que TODOS fazem** (commodity do mercado):
+   - Promessas identicas ou muito similares
+   - Mesmos angulos repetidos
+   - Mesmas provas (tipo generico)
+   - Mesmo tom de voz
+   - Formato de funil padrao
+
+10. **Identificar o que NINGUEM faz** (oportunidades):
+    - Angulos nao explorados
+    - Provas que ninguem apresenta
+    - Dores do publico que ninguem aborda
+    - Formatos de conteudo nao usados
+    - Segmentos do publico ignorados
+
+11. **Tabela comparativa**:
+
+    | Aspecto | Concorrente A | Concorrente B | Concorrente C | Nosso produto |
+    |---------|---------------|---------------|---------------|---------------|
+    | Preco | | | | |
+    | Promessa | | | | |
+    | Mecanismo | | | | |
+    | Garantia | | | | |
+    | Provas | | | | |
+    | Angulo dominante | | | | |
+    | Ponto fraco | | | | |
+
+### Passo 4 — Classificar sofisticacao do mercado
+
+12. **Avaliar o nivel de sofisticacao** (Schwartz 1-5):
+
+    | Sinal | Nivel provavel |
+    |-------|----------------|
+    | Pouca concorrencia, promessas simples funcionam | 1 |
+    | Concorrentes fazem promessas similares | 2 |
+    | Publico compara e desconfia das promessas | 3 |
+    | Concorrentes ja usam mecanismos | 4 |
+    | Publico extremamente cetico, ja comprou e se frustrou | 5 |
+
+13. **Evidencias para a classificacao**:
+    - Listar 3-5 evidencias concretas que sustentam o nivel escolhido
+    - Exemplo: "Nivel 3 — Evidencia: 2 dos 3 concorrentes usam headline de promessa direta ('Emagreca 10kg'), indicando que o mercado ja viu essas promessas mas ainda nao exige mecanismo."
+
+### Passo 5 — Identificar gaps e oportunidades
+
+14. **Gaps de conteudo**:
+    - Topicos que o publico busca mas nenhum concorrente aborda
+    - Perguntas frequentes sem resposta no mercado
+    - Formatos (video, podcast, newsletter) subutilizados
+
+15. **Gaps de oferta**:
+    - Faixas de preco nao atendidas
+    - Modelos de entrega nao usados (comunidade, 1:1, grupo)
+    - Bonus que ninguem oferece mas seria valioso
+    - Garantias mais agressivas que nenhum concorrente da
+
+16. **Gaps de comunicacao**:
+    - Objecoes que ninguem responde
+    - Provas que ninguem apresenta (mas nos temos)
+    - Angulos emocionais nao explorados
+    - Historia de origem diferenciada
+
+17. **Priorizar as 3 maiores oportunidades**:
+    - Oportunidade 1: [descricao + por que e relevante]
+    - Oportunidade 2: [descricao + por que e relevante]
+    - Oportunidade 3: [descricao + por que e relevante]
+
+### Passo 6 — Compilar relatorio
+
+18. **Gerar documento final** com:
+    - Resumo executivo (1 paragrafo)
+    - Analise detalhada dos 3 concorrentes (passo 2)
+    - Tabela comparativa (passo 3)
+    - Padroes do mercado (passo 3)
+    - Nivel de sofisticacao + evidencias (passo 4)
+    - Gaps e oportunidades (passo 5)
+    - Top 3 oportunidades priorizadas
+    - Recomendacoes estrategicas (como usar os achados)
+
+## Post-conditions
+
+- [ ] 3 concorrentes analisados em profundidade
+- [ ] Tabela comparativa completa
+- [ ] Nivel de sofisticacao classificado com evidencias
+- [ ] Pelo menos 3 oportunidades identificadas
+- [ ] Relatorio salvo no path correto
+
+## Acceptance Criteria
+
+- [ ] Cada concorrente tem: oferta, copy, angulos, pontos fortes/fracos documentados
+- [ ] Padroes do mercado mapeados (o que todos fazem vs ninguem faz)
+- [ ] Nivel de sofisticacao justificado com 3+ evidencias
+- [ ] Oportunidades sao acionaveis (nao genericas)
+- [ ] Tabela comparativa inclui nosso produto para contraste
+- [ ] Recomendacoes conectam achados a acoes de copy/estrategia
+- [ ] Relatorio e auto-suficiente (qualquer agente consegue usar)
+
+## Frameworks
+
+- **Schwartz Market Sophistication**: 5 niveis de sofisticacao
+- **Analise competitiva**: Oferta, copy, angulos, provas
+- **Gap analysis**: Conteudo, oferta, comunicacao
+- **Blue Ocean**: Identificar espacos nao disputados
+
+## Error Handling
+
+| Erro | Acao |
+|------|------|
+| Nenhum concorrente identificado | Expandir busca para concorrentes indiretos e substitutos |
+| Links de concorrentes inacessiveis | Usar cache, screenshots ou descricoes do usuario |
+| Mercado muito novo (sem concorrentes) | Classificar como nivel 1, focar em substitutos e adjacentes |
+| Informacoes de preco indisponiveis | Marcar como "N/D" e anotar limitacao |
+| Classificacao de sofisticacao inconclusiva | Pedir input do usuario sobre experiencia do publico com compras anteriores |
+| Nenhuma oportunidade clara | Revisitar a analise com foco em sub-nichos ou micro-segmentos |

package/scaffold/.drm-core/tasks/funil/arquitetar-funil-vsl.md

@@ -0,0 +1,228 @@
+---
+task: arquitetar-funil-vsl()
+responsavel: Estrategista
+tipo: funil
+---
+
+# Arquitetar Funil VSL
+
+## Descricao
+
+Definir a arquitetura completa de um funil de vendas baseado em VSL: cada etapa (Landing Page, Checkout, Order Bump, Upsell, Downsell, Thank You Page), com URL, objetivo, metrica principal, benchmark esperado. Definir a oferta do bump, upsell e downsell. Calcular a matematica do funil e planejar integracao com WhatsApp.
+
+## Entrada
+
+| Campo | Origem | Obrigatorio | Validacao |
+|-------|--------|-------------|-----------|
+| Briefing do produto | `criar-briefing.md` output | Sim | Produto, preco, garantia |
+| Produto principal | Briefing | Sim | Nome, preco, entregaveis |
+| Produtos complementares | Usuario | Nao | Para bump, upsell, downsell |
+| Plataforma de checkout | Usuario | Sim | Hotmart, Kiwify, Eduzz, Stripe |
+| Budget mensal | Briefing | Sim | Valor em R$ |
+| CPA alvo | Briefing | Sim | Valor em R$ |
+| Integracao WhatsApp | Usuario | Nao | Sim/Nao, ferramenta |
+
+## Saida
+
+| Campo | Destino | Template |
+|-------|---------|----------|
+| Arquitetura do funil | `outputs/funil/arquitetura-funil-{produto}-{data}.md` | — |
+| Matematica do funil | Secao do documento | — |
+| Briefing de cada etapa | Secao do documento | — |
+| Fluxo de integracao WhatsApp | Secao do documento | — |
+
+## Pre-conditions
+
+- [ ] Briefing do produto completo
+- [ ] Preco do produto principal definido
+- [ ] Plataforma de checkout escolhida
+- [ ] Budget e CPA alvo definidos
+
+## Workflow
+
+### Passo 1 — Definir etapas do funil
+
+1. **Mapear cada etapa** do funil na sequencia:
+
+   | Etapa | URL sugerida | Objetivo | Metrica principal | Benchmark |
+   |-------|-------------|----------|-------------------|-----------|
+   | Landing Page (VSL) | /vsl ou /apresentacao | Assistir VSL e clicar no CTA | Play rate > 30%, CTA click > 10% | — |
+   | Checkout | /checkout | Concluir compra | Conversao > 50% dos que chegam | — |
+   | Order Bump | No checkout | Adicionar item complementar | Take rate > 20-30% | — |
+   | Upsell 1 | /oferta-especial | Comprar upgrade/acelerador | Take rate > 15-20% | — |
+   | Downsell | /ultima-chance | Aceitar versao reduzida | Take rate > 10-15% | — |
+   | Thank You Page | /obrigado | Confirmar, orientar, engajar | Engajamento > 70% | — |
+
+2. **Para cada etapa, definir**:
+   - Nome descritivo
+   - URL path
+   - Objetivo primario (o que o usuario DEVE fazer)
+   - Metrica principal (como medir sucesso)
+   - Benchmark de referencia
+   - Conteudo necessario (copy, design, video)
+
+### Passo 2 — Definir Order Bump
+
+3. **Escolher produto para bump** (checkbox no checkout):
+   - Deve ser COMPLEMENTAR ao produto principal (nao substituto)
+   - Preco: 20-40% do produto principal
+   - Entrega imediata (download, acesso instantaneo)
+   - Nao requer explicacao longa (decisao impulsiva)
+
+4. **Definir a oferta do bump**:
+   - Nome do produto bump
+   - Preco: R$ [valor]
+   - Descricao em 1-2 frases (aparece no checkbox)
+   - Beneficio principal: "Adicione [produto] e [resultado]"
+   - Exemplo: "Adicione o Template Pack por apenas R$ 47 e economize 10 horas de trabalho"
+
+### Passo 3 — Definir Upsell
+
+5. **Escolher produto para upsell** (pagina pos-compra):
+   - Deve ser um ACELERADOR de resultados
+   - Preco: 50-150% do produto principal
+   - Complementa e amplifica o produto principal
+   - Posicionamento: "Voce acabou de dar o primeiro passo. Agora acelere seus resultados com..."
+
+6. **Definir a oferta do upsell**:
+   - Nome do produto upsell
+   - Preco: R$ [valor]
+   - Preco ancora: R$ [valor original] (se aplicavel)
+   - Descricao: 3-5 frases que vendem o upgrade
+   - CTA: "Sim, quero acelerar!" / "Nao obrigado, prefiro ir devagar"
+   - Tempo limite na pagina: 15 minutos (se usar countdown)
+   - Video de upsell: sim/nao (se sim, max 3-5 minutos)
+
+### Passo 4 — Definir Downsell
+
+7. **Criar versao reduzida** (aparece se recusar upsell):
+   - Versao simplificada do upsell OU produto alternativo de menor valor
+   - Preco: 30-50% do preco do upsell
+   - Posicionamento: "Entendo que [upsell] pode nao ser pra agora. Que tal [downsell] por apenas R$ [valor]?"
+   - Deve ser genuinamente util (nao refugo)
+
+8. **Definir a oferta do downsell**:
+   - Nome do produto downsell
+   - Preco: R$ [valor]
+   - Descricao: 2-3 frases
+   - CTA: "Quero essa opcao!" / "Nao obrigado"
+
+### Passo 5 — Thank You Page
+
+9. **Definir conteudo da pagina de obrigado**:
+   - Confirmacao da compra (tranquilizar)
+   - Proximos passos claros e numerados:
+     1. Verifique seu email para acesso
+     2. Entre no grupo [link]
+     3. Comece pelo modulo X
+   - Video de boas-vindas (opcional, 1-2 min)
+   - Convite para comunidade/grupo
+   - Compartilhamento social (opcional)
+   - Trigger de WhatsApp: enviar mensagem de boas-vindas
+
+### Passo 6 — Matematica do funil
+
+10. **Calcular metricas projetadas**:
+
+    ```
+    MATEMATICA DO FUNIL
+
+    Investimento mensal: R$ [budget]
+    CPM medio (estimado): R$ [valor]
+    Impressoes: [budget / CPM * 1000]
+    CTR estimado: [X]%
+    Cliques para LP: [impressoes * CTR]
+    CPC estimado: R$ [budget / cliques]
+
+    Taxa de conversao LP: [X]%
+    Vendas front-end: [cliques * taxa]
+    Receita front-end: [vendas * preco]
+
+    Bump take rate: [X]%
+    Receita bump: [vendas * take rate * preco bump]
+
+    Upsell take rate: [X]%
+    Receita upsell: [vendas * take rate upsell * preco upsell]
+
+    Downsell take rate: [X]% (dos que recusaram upsell)
+    Receita downsell: [vendas * (1 - take rate upsell) * take rate downsell * preco downsell]
+
+    RECEITA TOTAL MENSAL: R$ [soma]
+    CPA REAL: R$ [budget / vendas front-end]
+    AOV (Average Order Value): R$ [receita total / vendas front-end]
+    ROAS: [receita total / budget]x
+    LUCRO: R$ [receita total - budget - custos]
+    ```
+
+11. **Definir cenarios**:
+    - **Otimista**: Benchmarks no topo (+20%)
+    - **Realista**: Benchmarks medianos
+    - **Pessimista**: Benchmarks no piso (-20%)
+    - Para cada cenario: receita, CPA, ROAS, lucro
+
+### Passo 7 — Integracao WhatsApp
+
+12. **Definir triggers de WhatsApp** (se integracao ativa):
+
+    | Evento | Acao WhatsApp | Timing |
+    |--------|--------------|--------|
+    | Opt-in na LP | Mensagem de boas-vindas + link VSL | Imediato |
+    | Inicio de checkout | Lembrete se nao completar | +30 min |
+    | Compra realizada | Confirmacao + proximos passos | Imediato |
+    | Abandono de carrinho | Sequencia de recuperacao | +1h, +24h, +48h |
+    | Pos-compra (dia 3) | Check-in + dica de uso | +3 dias |
+    | Pos-compra (dia 7) | Case de sucesso + oferta complementar | +7 dias |
+
+13. **Conectar com `fluxo-whatsapp-backend.md`**:
+    - Indicar quais triggers precisam ser implementados
+    - Definir variaveis que o checkout deve enviar ({nome}, {produto}, {valor})
+    - Ferramenta de integracao: [Zapier, Make, API direta]
+
+### Passo 8 — Compilar documento final
+
+14. **Gerar documento final** com:
+    - Diagrama do funil (texto/ASCII)
+    - Detalhamento de cada etapa
+    - Matematica do funil com 3 cenarios
+    - Integracao WhatsApp (se aplicavel)
+    - Checklist de implementacao
+    - Ferramentas necessarias
+
+## Post-conditions
+
+- [ ] Todas as etapas do funil definidas (LP, Checkout, Bump, Upsell, Downsell, TYP)
+- [ ] Cada etapa com URL, objetivo, metrica e benchmark
+- [ ] Bump, upsell e downsell com nome, preco e descricao
+- [ ] Matematica do funil calculada com 3 cenarios
+- [ ] Integracao WhatsApp mapeada (se aplicavel)
+- [ ] Documento salvo no path correto
+
+## Acceptance Criteria
+
+- [ ] Funil tem minimo 4 etapas (LP, Checkout, Bump, TYP)
+- [ ] Bump e complementar e com preco 20-40% do front-end
+- [ ] Upsell e acelerador e com preco 50-150% do front-end
+- [ ] Downsell e versao reduzida do upsell
+- [ ] Matematica do funil fecha (numeros consistentes)
+- [ ] CPA projetado esta dentro do CPA alvo
+- [ ] Thank You Page tem proximos passos claros
+- [ ] Integracao WhatsApp com triggers definidos (se aplicavel)
+
+## Frameworks
+
+- **Value Ladder** (Russell Brunson): Escada de valor do front-end ao high-ticket
+- **Funnel Math**: Calculo de CPM, CPC, CPA, AOV, ROAS
+- **Order Bump Psychology**: Decisao impulsiva no momento de compra
+- **Upsell Ascension**: Oferecer mais no pico emocional pos-compra
+
+## Error Handling
+
+| Erro | Acao |
+|------|------|
+| Briefing incompleto | BLOQUEAR. Retornar ao `criar-briefing.md` |
+| Preco do produto nao definido | BLOQUEAR. Sem preco nao ha matematica |
+| Sem produto para bump/upsell | ALERTAR. Funil funciona sem, mas AOV sera menor |
+| CPA projetado > CPA alvo | ALERTAR. Revisar preco, taxa de conversao ou budget |
+| ROAS < 1 em cenario realista | BLOQUEAR. Funil nao e viavel. Revisar oferta ou custo |
+| Plataforma nao suporta upsell | ADAPTAR. Usar email pos-compra como alternativa |
+| Integracao WhatsApp nao disponivel | ADAPTAR. Substituir por email/SMS |