drm-core 1.0.0 → 1.3.0

package/scaffold/.drm-core/templates/funil-vsl-template.md

@@ -0,0 +1,470 @@
+---
+# ============================================================
+# ARQUITETURA DE FUNIL VSL — Template de Funil Completo
+# ============================================================
+# Template para documentar e planejar a arquitetura completa
+# de um funil de vendas baseado em VSL.
+# Inclui: diagrama, etapas, metricas, pixel events, funnel math.
+#
+tipo: funil-vsl
+formato: arquitetura-funil
+agente_executor: "@architect | @pm | @analyst"
+frameworks_aplicados:
+  - nome: "Funnel Hacking"
+    descricao: "Russell Brunson — engenharia reversa de funis comprovados"
+  - nome: "Pirate Metrics (AARRR)"
+    descricao: "Acquisition, Activation, Revenue, Retention, Referral"
+  - nome: "Funnel Math"
+    descricao: "Calculo reverso de trafego necessario baseado em metas de revenue"
+
+# --- CONTEXTO ---
+projeto:
+  nome: ""                    # [OBRIGATORIO] Nome do produto/funil
+  nicho: ""                   # [OBRIGATORIO] Nicho de mercado
+  ticket_medio: ""            # [OBRIGATORIO] Preco principal (AOV)
+  meta_revenue_mensal: ""     # [OBRIGATORIO] Meta de faturamento mensal. Ex: "R$ 50.000"
+  tipo_funil: ""              # [OBRIGATORIO] "vsl_direta | vsl_webinar | vsl_lancamento | vsl_evergreen | vsl_tripwire"
+  url_base: ""                # [OBRIGATORIO] Dominio base. Ex: "https://meusite.com"
+
+# --- TRAFEGO ---
+trafego:
+  fontes_primarias: []        # [OBRIGATORIO] Ex: ["meta_ads", "google_ads", "organico", "email"]
+  orcamento_mensal: ""        # [OBRIGATORIO] Ex: "R$ 10.000/mes"
+  cpc_estimado: ""            # [OBRIGATORIO] Ex: "R$ 2,50"
+  ctr_estimado: ""            # [OPCIONAL] Ex: "2%"
+
+# --- VERSAO ---
+versao: "1.0"
+data_criacao: ""
+autor: ""
+status: "rascunho"
+---
+
+# ARQUITETURA DE FUNIL — {{projeto.nome}}
+
+> **Tipo:** {{projeto.tipo_funil}} | **Ticket:** {{projeto.ticket_medio}}
+> **Meta mensal:** {{projeto.meta_revenue_mensal}} | **Budget ads:** {{trafego.orcamento_mensal}}
+
+---
+
+## DIAGRAMA VISUAL DO FUNIL
+
+> **Instrucoes:** Desenhe o fluxo completo do funil. Cada caixa = 1 etapa. Setas indicam fluxo principal e fluxos alternativos (retargeting, abandono, etc.)
+
+```
+╔══════════════════════════════════════════════════════════════════╗
+║                        DIAGRAMA DO FUNIL                        ║
+╚══════════════════════════════════════════════════════════════════╝
+
+[TRAFEGO]
+Meta Ads / Google Ads / Organico / Email
+    │
+    ▼
+┌─────────────────────────┐
+│  ETAPA 1: AD / CRIATIVO │ ←── Pixel: ViewContent
+│  URL: /ad               │
+│  Objetivo: Clique       │
+│  Metrica: CTR, CPC      │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│  ETAPA 2: LP / CAPTURA  │ ←── Pixel: Lead
+│  URL: /oferta            │
+│  Objetivo: Opt-in/Play  │
+│  Metrica: Opt-in rate   │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│  ETAPA 3: VSL PAGE      │ ←── Pixel: ViewContent (VSL)
+│  URL: /apresentacao     │
+│  Objetivo: Assistir VSL │
+│  Metrica: Watch rate    │
+└───────────┬─────────────┘
+            │
+            ├──── [Assistiu <25%] ──→ Retargeting Ad A
+            ├──── [Assistiu 25-75%] ──→ Retargeting Ad B
+            │
+            ▼
+┌─────────────────────────┐
+│  ETAPA 4: CHECKOUT      │ ←── Pixel: InitiateCheckout
+│  URL: /checkout         │
+│  Objetivo: Compra       │
+│  Metrica: Conv. rate    │
+└───────────┬─────────────┘
+            │
+            ├──── [Abandonou checkout] ──→ Email/WhatsApp recovery
+            │
+            ▼
+┌─────────────────────────┐
+│  ETAPA 5: OBRIGADO      │ ←── Pixel: Purchase
+│  URL: /obrigado         │
+│  Objetivo: Upsell/Onb   │
+│  Metrica: Upsell rate   │
+└───────────┬─────────────┘
+            │
+            ▼
+┌─────────────────────────┐
+│  ETAPA 6: UPSELL (OPC)  │ ←── Pixel: Purchase (upsell)
+│  URL: /oferta-especial  │     (OPCIONAL)
+│  Objetivo: Aumentar AOV │
+│  Metrica: Take rate     │
+└─────────────────────────┘
+
+    ╔═══════════════════════════════════════╗
+    ║        FLUXOS PARALELOS               ║
+    ╠═══════════════════════════════════════╣
+    ║ Email: Sequencia de follow-up (7 dias)║
+    ║ WhatsApp: Sequencia (ver template)    ║
+    ║ Retargeting: 3 audiencias (ver abaixo)║
+    ╚═══════════════════════════════════════╝
+```
+
+---
+
+## DETALHAMENTO POR ETAPA
+
+### ETAPA 1: AD / CRIATIVO
+
+```
+URL: [URL ou referencia. Ex: "Meta Ads Manager — Campanha X"]
+OBJETIVO: [O que esta etapa deve alcancar. Ex: "Gerar clique qualificado para a LP"]
+TIPO DE CONTEUDO: [video_reels | video_feed | imagem | carrossel | stories]
+COPY REF: [Referencia ao template de copy. Ex: "ad-meta-template.md — Variacao A"]
+PIXEL EVENTS:
+  - ViewContent (no clique do ad)
+METRICAS-CHAVE:
+  - CTR (Click Through Rate): [benchmark: 1-3%]
+  - CPC (Custo por Clique): [benchmark: R$ 1-5]
+  - CPM (Custo por Mil Impressoes): [benchmark: R$ 20-50]
+  - Hook Rate 3s: [benchmark: 25-40%]
+  - ThruPlay Rate: [benchmark: 15-30%]
+BENCHMARK MERCADO: [Valores de referencia para o nicho]
+META INTERNA: [Sua meta especifica]
+```
+
+### ETAPA 2: LANDING PAGE / CAPTURA
+
+```
+URL: {{projeto.url_base}}/[slug]
+OBJETIVO: [Ex: "Capturar lead (nome + email + telefone)" | "Direcionar para VSL"]
+TIPO DE PAGINA: [captura | pre-sell | quiz | direto_pra_vsl]
+COPY REF: [Ex: "pagina-vendas-template.md — Bloco 1 (Above the Fold)"]
+ELEMENTOS DA PAGINA:
+  - Headline: [1 frase]
+  - Sub-headline: [1 frase]
+  - Formulario: [campos capturados]
+  - CTA: [texto do botao]
+  - Trust badges: [quais]
+  - Video preview: [sim | nao]
+PIXEL EVENTS:
+  - Lead (no submit do formulario)
+  - ViewContent (no carregamento)
+METRICAS-CHAVE:
+  - Opt-in Rate: [benchmark: 20-40% para captura, 60-80% para pre-sell]
+  - Bounce Rate: [benchmark: < 60%]
+  - Time on Page: [benchmark: > 30s]
+BENCHMARK MERCADO:
+META INTERNA:
+```
+
+### ETAPA 3: VSL PAGE
+
+```
+URL: {{projeto.url_base}}/[slug]
+OBJETIVO: [Ex: "Assistir a VSL completa e clicar no botao de compra"]
+TIPO DE VSL: [completa | mini | curta]
+COPY REF: [Ex: "vsl-full-template.md"]
+ELEMENTOS DA PAGINA:
+  - Player de video: [autoplay | click-to-play]
+  - Botao CTA: [aparece apos X minutos | sempre visivel | slide-in]
+  - Tempo para CTA aparecer: [Ex: "15 minutos" | "imediato"]
+  - Headline acima do video: [sim | nao — texto]
+  - Elementos abaixo do video: [depoimentos | bullets | countdown]
+PIXEL EVENTS:
+  - ViewContent (carregamento)
+  - Eventos customizados: [VSL_25, VSL_50, VSL_75, VSL_100]
+  - AddToCart ou InitiateCheckout (clique no CTA)
+METRICAS-CHAVE:
+  - Play Rate: [benchmark: 40-60%]
+  - Watch Rate 25%: [benchmark: 30-50%]
+  - Watch Rate 50%: [benchmark: 15-30%]
+  - Watch Rate 75%: [benchmark: 10-20%]
+  - Watch Rate 100%: [benchmark: 5-15%]
+  - CTA Click Rate: [benchmark: 5-15%]
+BENCHMARK MERCADO:
+META INTERNA:
+```
+
+### ETAPA 4: CHECKOUT
+
+```
+URL: {{projeto.url_base}}/[slug] ou [plataforma_checkout_url]
+OBJETIVO: [Ex: "Completar a compra"]
+PLATAFORMA: [Hotmart | Kiwify | Eduzz | Stripe | PagSeguro | propria]
+ELEMENTOS:
+  - Resumo do pedido: [o que aparece]
+  - Order bump: [sim | nao — descricao + preco]
+  - Formas de pagamento: [cartao | boleto | pix]
+  - Parcelamento: [ate X vezes]
+  - Selos de seguranca: [quais]
+  - Exit intent: [sim | nao]
+  - Countdown: [sim | nao]
+PIXEL EVENTS:
+  - InitiateCheckout (carregamento do checkout)
+  - AddPaymentInfo (preencheu dados de pagamento)
+  - Purchase (compra confirmada)
+METRICAS-CHAVE:
+  - Checkout Rate: [benchmark: 30-60% de quem inicia]
+  - Abandono: [benchmark: 40-70%]
+  - Order Bump Take Rate: [benchmark: 15-30%]
+BENCHMARK MERCADO:
+META INTERNA:
+```
+
+### ETAPA 5: PAGINA DE OBRIGADO / CONFIRMACAO
+
+```
+URL: {{projeto.url_base}}/[slug]
+OBJETIVO: [Ex: "Confirmar compra, iniciar onboarding, oferecer upsell"]
+ELEMENTOS:
+  - Mensagem de confirmacao: [texto]
+  - Proximos passos: [instrucoes para o cliente]
+  - Video de onboarding: [sim | nao]
+  - Upsell/OTO: [sim | nao — descricao + preco]
+  - Compartilhamento social: [sim | nao]
+  - Grupo WhatsApp/Telegram: [link]
+PIXEL EVENTS:
+  - Purchase (confirmacao)
+METRICAS-CHAVE:
+  - Upsell Take Rate: [benchmark: 10-25%]
+  - Onboarding Completion: [benchmark: 60-80%]
+```
+
+### ETAPA 6: UPSELL / OTO (Opcional)
+
+```
+URL: {{projeto.url_base}}/[slug]
+OBJETIVO: [Ex: "Aumentar AOV com oferta complementar"]
+PRODUTO UPSELL: [Nome + descricao + preco]
+TIPO: [one_time_offer | order_bump | downsell | cross_sell]
+TEMPO LIMITE: [Ex: "15 minutos" | "unica oportunidade"]
+COPY REF: [Ex: "vsl-curta-template.md adaptada para OTO"]
+PIXEL EVENTS:
+  - Purchase (upsell)
+METRICAS-CHAVE:
+  - Take Rate: [benchmark: 10-25%]
+  - Revenue Uplift: [benchmark: 20-40% do AOV]
+```
+
+---
+
+## FLUXOS DE RETARGETING
+
+> **Instrucoes:** Defina as audiencias de retargeting e o conteudo servido para cada uma.
+
+```
+AUDIENCIA 1 — VISITOU LP MAS NAO ASSISTIU VSL:
+Definicao: [PageView LP, sem evento de Play]
+Janela: [Ex: "1-7 dias"]
+Conteudo: [Ex: "Ad com hook diferente + CTA para assistir VSL"]
+Budget alocado: [Ex: "20% do budget total"]
+
+AUDIENCIA 2 — ASSISTIU 25-75% DA VSL:
+Definicao: [Evento VSL_25 ou VSL_50, sem Purchase]
+Janela: [Ex: "1-14 dias"]
+Conteudo: [Ex: "Ad com depoimento + CTA direto para checkout"]
+Budget alocado: [Ex: "30% do budget de retargeting"]
+
+AUDIENCIA 3 — ABANDONOU CHECKOUT:
+Definicao: [InitiateCheckout sem Purchase]
+Janela: [Ex: "1-7 dias"]
+Conteudo: [Ex: "Ad com urgencia + bonus exclusivo"]
+Budget alocado: [Ex: "40% do budget de retargeting"]
+
+AUDIENCIA 4 — COMPRADORES (UPSELL/CROSS-SELL):
+Definicao: [Purchase]
+Janela: [Ex: "1-30 dias"]
+Conteudo: [Ex: "Ad para produto complementar"]
+Budget alocado: [Ex: "10% do budget total"]
+```
+
+---
+
+## FUNNEL MATH (Calculo Reverso)
+
+> **Instrucoes:** Calcule de tras pra frente: comece pela meta de revenue e calcule quanto trafego precisa.
+
+### Dados de Entrada
+
+```
+META DE REVENUE MENSAL: {{projeto.meta_revenue_mensal}}
+PRECO DO PRODUTO (AOV): {{projeto.ticket_medio}}
+UPSELL AOV (se aplicavel): R$ [valor]
+UPSELL TAKE RATE: [X]%
+```
+
+### Calculo
+
+```
+1. VENDAS NECESSARIAS POR MES:
+   Meta / AOV = [numero]
+   Ex: R$ 50.000 / R$ 497 = ~101 vendas
+
+   COM UPSELL:
+   AOV efetivo = AOV + (Upsell AOV x Take Rate)
+   Ex: R$ 497 + (R$ 197 x 20%) = R$ 536,40
+   Vendas ajustadas = R$ 50.000 / R$ 536,40 = ~94 vendas
+
+2. VISITANTES NO CHECKOUT NECESSARIOS:
+   Vendas / Checkout Rate = [numero]
+   Ex: 101 / 0.40 = ~253 visitantes no checkout
+
+3. VISUALIZACOES DA VSL NECESSARIAS:
+   Checkout visitors / CTA Click Rate = [numero]
+   Ex: 253 / 0.10 = ~2.530 visualizacoes da VSL
+
+4. VISITANTES NA LP NECESSARIOS:
+   VSL views / Play Rate = [numero]
+   Ex: 2.530 / 0.50 = ~5.060 visitantes na LP
+
+5. CLIQUES NO AD NECESSARIOS:
+   LP visitors / LP Conversion Rate = [numero]
+   Ex: 5.060 / 0.30 = ~16.867 cliques
+   (Se LP envia direto pra VSL sem captura: LP visitors = cliques)
+
+6. IMPRESSOES NECESSARIAS:
+   Cliques / CTR = [numero]
+   Ex: 16.867 / 0.02 = ~843.333 impressoes
+
+7. BUDGET NECESSARIO:
+   Cliques x CPC = [valor]
+   Ex: 16.867 x R$ 2.50 = R$ 42.167/mes
+
+8. ROAS PROJETADO:
+   Revenue / Budget = [numero]
+   Ex: R$ 50.000 / R$ 42.167 = 1.19 ROAS
+
+9. CPA (Custo por Aquisicao):
+   Budget / Vendas = [valor]
+   Ex: R$ 42.167 / 101 = R$ 417 CPA
+
+10. CPA MAXIMO PERMITIDO:
+    AOV x Margem = [valor]
+    Ex: R$ 497 x 0.60 (margem 60%) = R$ 298 CPA max
+```
+
+### Tabela Resumo Funnel Math
+
+```
+| Metrica | Valor Calculado | Benchmark | Status |
+|---------|----------------|-----------|--------|
+| Vendas/mes | [X] | — | — |
+| Visitors LP/mes | [X] | — | — |
+| VSL Views/mes | [X] | — | — |
+| Checkout Visitors/mes | [X] | — | — |
+| Cliques necessarios | [X] | — | — |
+| Impressoes necessarias | [X] | — | — |
+| Budget mensal | R$ [X] | R$ [orcamento] | 🟢🟡🔴 |
+| CPA projetado | R$ [X] | R$ [CPA max] | 🟢🟡🔴 |
+| ROAS projetado | [X] | > 2.0 | 🟢🟡🔴 |
+```
+
+### Break-Even Analysis
+
+```
+BREAK-EVEN CPA: R$ [valor]
+Calculo: AOV x Margem bruta
+Ex: R$ 497 x 0.60 = R$ 298
+
+BREAK-EVEN ROAS: [valor]
+Calculo: 1 / Margem bruta
+Ex: 1 / 0.60 = 1.67
+
+BREAK-EVEN DIARIO:
+Budget diario / AOV x Conv. Rate = vendas minimas/dia
+Ex: R$ 1.400/dia precisa de [X] vendas/dia para empatar
+
+DIAS PARA BREAK-EVEN COM LTV:
+Se LTV > AOV: Quantos dias ate o investimento se pagar com recompras?
+LTV estimado: R$ [valor]
+LTV/AOV ratio: [X]
+Payback period: [X] dias
+```
+
+---
+
+## PIXEL & TRACKING MAP
+
+```
+PLATAFORMA PIXEL: [Meta Pixel | Google Tag | ambos]
+PIXEL ID: [ID do pixel]
+
+| Etapa | Evento | Trigger | Parametros |
+|-------|--------|---------|-----------|
+| Ad clique | ViewContent | Clique no ad | content_name, content_category |
+| LP carrega | PageView | Page load | — |
+| LP opt-in | Lead | Form submit | lead_type, source |
+| VSL play | ViewContent | Video play | content_name="vsl" |
+| VSL 25% | Custom: VSL_25 | Video 25% | video_percent=25 |
+| VSL 50% | Custom: VSL_50 | Video 50% | video_percent=50 |
+| VSL 75% | Custom: VSL_75 | Video 75% | video_percent=75 |
+| VSL 100% | Custom: VSL_100 | Video 100% | video_percent=100 |
+| CTA clique | InitiateCheckout | Botao CTA | value, currency |
+| Checkout load | InitiateCheckout | Page load | value, currency |
+| Pagamento | AddPaymentInfo | Dados pagto | — |
+| Compra | Purchase | Confirmacao | value, currency, content_ids |
+| Upsell | Purchase | Compra upsell | value, currency, content_name="upsell" |
+
+UTM STRUCTURE:
+utm_source: [Ex: "meta", "google", "email"]
+utm_medium: [Ex: "cpc", "cpm", "organic"]
+utm_campaign: [Ex: "vsl-metodo-x-v1"]
+utm_content: [Ex: "hook-dor-a", "hook-curiosidade-b"]
+utm_term: [Ex: "interesse-fitness", "lookalike-1"]
+```
+
+---
+
+## HISTORICO DE VERSOES
+
+| Versao | Data | Autor | Alteracao |
+|--------|------|-------|-----------|
+| 1.0 | {{data_criacao}} | {{autor}} | Versao inicial |
+
+---
+
+## CHECKLIST FINAL
+
+```
+ARQUITETURA:
+- [ ] Diagrama visual completo
+- [ ] Todas as etapas detalhadas (URL, objetivo, metrica, benchmark)
+- [ ] Fluxos alternativos mapeados (retargeting, abandono)
+- [ ] Copy ref vinculada a cada etapa
+
+FUNNEL MATH:
+- [ ] Meta de revenue definida
+- [ ] Calculo reverso completo (revenue → trafego)
+- [ ] CPA projetado vs CPA maximo
+- [ ] ROAS projetado vs break-even
+- [ ] Budget necessario vs budget disponivel
+
+TRACKING:
+- [ ] Pixel events mapeados para cada etapa
+- [ ] UTMs definidos
+- [ ] Eventos customizados configurados
+- [ ] Conversions API (CAPI) configurada
+
+RETARGETING:
+- [ ] Audiencias definidas
+- [ ] Conteudo por audiencia
+- [ ] Budget alocado por audiencia
+
+INTEGRACAO:
+- [ ] Sequencia email vinculada (se aplicavel)
+- [ ] Sequencia WhatsApp vinculada (ver template)
+- [ ] CRM integrado
+- [ ] Checkout integrado com pixel
+```