@lucapimenta/copy-chief-black 1.0.0

package/framework/templates/story-vsl-capitulo.md

@@ -0,0 +1,396 @@
+---
+template_name: "story-vsl-capitulo"
+template_version: "1.0.0"
+template_type: "story"
+description: "Story template para producao de capitulos individuais de VSL"
+phase: "production"
+deliverable_type: "vsl"
+output_format: "markdown"
+---
+
+# Story: VSL Capitulo [##] ([TIPO]) — [OFFER_NAME]
+
+> Template: story-vsl-capitulo.md v1.0
+> Criado: [DATA]
+> Oferta: [NICHO]/[OFERTA]
+> Fase: PRODUCTION
+> Ref: rmbc-ii-workflow.md (estrutura RMBC II de Stefan Georgi)
+> MCP: write_chapter OBRIGATORIO para cada capitulo
+
+---
+
+## Status
+- [ ] Story criada
+- [ ] Capitulo anterior revisado (continuidade)
+- [ ] write_chapter (MCP) executado
+- [ ] Primeira versao completa
+- [ ] blind_critic >= 8
+- [ ] Transicoes in/out verificadas
+- [ ] Retencao checkpoint atingida
+- [ ] Integrado na VSL completa
+- [ ] Humano aprovou
+
+---
+
+## Identificacao do Capitulo
+
+| Campo | Valor |
+|-------|-------|
+| **Capitulo #** | [01-06] |
+| **Tipo** | [ver tabela abaixo] |
+| **Objetivo do Capitulo** | [1 frase] |
+| **Duracao Target** | [minutos:segundos] |
+| **Retencao Target** | [X% dos que iniciaram] |
+| **Posicao no Arco Emocional** | [ver diagrama abaixo] |
+
+### Mapa dos 6 Capitulos (Baseado em RMBC II)
+
+| # | Tipo | Objetivo Core | Elemento HELIX | Duracao Sugerida |
+|---|------|---------------|----------------|------------------|
+| 01 | Hook/Lead | Parar, criar loop aberto | NUUPPECC Lead + DRE | 0:30-1:30 |
+| 02 | Problema/Background | Agitar dor, externalizar culpa | DRE + Vilao + Story | 2:00-4:00 |
+| 03 | Descoberta/Mecanismo | Revelar MUP, reframe | MUP (Sexy Cause) | 2:00-3:00 |
+| 04 | Solucao/Produto | Apresentar MUS, produto | MUS + Ingrediente Hero | 2:00-3:00 |
+| 05 | Oferta/Stack | Stack de valor, ancoragem | Oferta + Bonus | 1:30-2:30 |
+| 06 | CTA/Close | Fechar com urgencia | Garantia + Consequencia | 1:00-2:00 |
+
+### Regra 3-7-18 (Georgi)
+
+| Formato | Duracao Total | Uso |
+|---------|---------------|-----|
+| Curto | ~3 min | Social ads, retargeting |
+| Medio | ~7 min | Maioria dos casos |
+| Longo | ~18 min | Ofertas complexas, high-ticket |
+
+**Formato desta VSL:** [CURTO/MEDIO/LONGO]
+**Duracao Total Target:** [X minutos]
+
+---
+
+## Arco Emocional da VSL
+
+```
+Emocao
+  ^
+  |         ESPERANCA
+  |        /         \
+  |       /    5      \  6
+  |      /   Oferta    \ Close
+  |   3 /               \
+  |  Descoberta          ──> ACAO
+  |  (virada)
+  |
+  |  1
+  | Hook ──── 2 ──────┐
+  |         Problema   │
+  |                    v
+  |              DESESPERO
+  |              (ponto mais baixo)
+  +──────────────────────────────> Tempo
+```
+
+**Posicao DESTE capitulo no arco:** [descrever]
+**Emocao DOMINANTE neste capitulo:** [qual]
+**Nivel de intensidade:** [1-10, onde 10 = pico emocional]
+
+---
+
+## Contexto HELIX (Especifico para Este Capitulo)
+
+### MUP
+> Fonte: mecanismo-unico.yaml
+
+- **Sexy Cause:** [nome]
+- **Problema Fundamental:** [descricao]
+- **Usado neste capitulo?** [SIM (caps 02-03) / REFERENCIADO / NAO]
+
+### MUS
+> Fonte: mecanismo-unico.yaml
+
+- **Gimmick Name:** [nome]
+- **Ingrediente Hero:** [componente]
+- **Authority Hook:** [validacao]
+- **Origin Story:** [resumo]
+- **Usado neste capitulo?** [SIM (caps 03-04) / REFERENCIADO / NAO]
+
+### DRE
+- **Emocao:** [qual]
+- **Nivel de Escalada NESTE capitulo:** [1-5]
+- **Progressao:** Cap anterior = nivel [X] → Este cap = nivel [Y] → Proximo cap = nivel [Z]
+
+### One Belief
+"[crenca unica]"
+**Momento de introducao:** [em qual capitulo o One Belief e plantado vs colhido]
+
+### Promessa Central
+"[promessa]"
+**Usada neste capitulo?** [SIM/NAO — se SIM, como]
+
+### Vilao + Solucoes Falsas
+- **Vilao:** [quem/o que]
+- **Usado neste capitulo?** [SIM (cap 02) / REFERENCIADO / NAO]
+- **Solucoes Falsas descartadas neste capitulo?** [listar se aplicavel]
+
+---
+
+## Retencao Checkpoints
+
+### Metricas Target por Capitulo
+
+| Capitulo | Checkpoint | Retencao Target | Tecnica de Retencao |
+|----------|------------|-----------------|---------------------|
+| 01 (Hook) | 0:03 — Scroll parou | 90%+ | Pattern interrupt visual/verbal |
+| 01 (Hook) | 0:30 — Loop aberto | 75%+ | Promessa + curiosidade |
+| 02 (Problema) | 2:00 — Identificacao | 65%+ | "Isso sou eu" + sinestesia |
+| 03 (Descoberta) | 4:00 — Aha moment | 55%+ | Reframe + evidencia |
+| 04 (Solucao) | 6:00 — Credibilidade | 45%+ | Authority + prova |
+| 05 (Oferta) | 8:00 — Valor percebido | 40%+ | Stack + ancoragem |
+| 06 (CTA) | Final — Acao | 35%+ | Urgencia + consequencia |
+
+**Checkpoint DESTE capitulo:**
+- **Timestamp alvo:** [mm:ss]
+- **Retencao target:** [X%]
+- **Tecnica principal:** [qual tecnica de retencao usar]
+- **Indicador de falha:** [se retencao cair abaixo de X%, o que revisar]
+
+---
+
+## Transition Hooks (Entrada/Saida)
+
+### Hook de Entrada (Como Este Capitulo Comeca)
+
+**Capitulo anterior terminou com:**
+> "[ultima frase ou ideia do capitulo anterior]"
+
+**Loop aberto pendente do capitulo anterior:**
+> "[se houver — qual]"
+
+**Primeira frase deste capitulo deve:**
+- [Conectar com / Resolver / Escalar o que veio antes]
+- **Tecnica:** [continuidade direta / pattern interrupt / revelacao / escalada]
+
+**Primeiras palavras sugeridas:**
+```
+[Rascunho da primeira frase de transicao]
+```
+
+### Hook de Saida (Como Este Capitulo Termina)
+
+**Proximo capitulo precisa receber:**
+- [Que estado emocional / informacao / loop aberto]
+
+**Ultima frase deste capitulo deve:**
+- [Criar ponte / Abrir loop / Escalar emocao]
+- **Tecnica:** [cliffhanger / promessa / curiosidade / revelacao parcial]
+
+**Ultimas palavras sugeridas:**
+```
+[Rascunho da ultima frase de transicao]
+```
+
+---
+
+## VOC Quotes (Mapeadas para Este Capitulo)
+
+### Quotes Primarias
+
+| # | Quote | Emocao | Nivel | Uso Neste Capitulo |
+|---|-------|--------|-------|-------------------|
+| 1 | "[quote]" — @user | [emocao] | [1-5] | [linguagem / agitacao / prova / voz do avatar] |
+| 2 | "[quote]" — @user | [emocao] | [1-5] | [uso] |
+| 3 | "[quote]" — @user | [emocao] | [1-5] | [uso] |
+
+### Mapeamento Capitulo-Quote (Referencia)
+
+| Tipo de Capitulo | Quotes Ideais |
+|------------------|---------------|
+| 01 (Hook) | Dor intensa nivel 4-5, curiosidade, "ja tentei tudo" |
+| 02 (Problema) | Sinestesia, vergonha, medo, frustacao detalhada |
+| 03 (Descoberta) | Surpresa, "nao sabia disso", raiva ("me enganaram") |
+| 04 (Solucao) | Esperanca, desejo, "quero isso", resultados |
+| 05 (Oferta) | Valor, "quanto custa", objecoes de preco |
+| 06 (CTA) | Urgencia, medo de perder, consequencia de nao agir |
+
+---
+
+## Patterns Aplicaveis
+
+### Patterns para ESTE Capitulo
+1. **[pattern]:** [como aplicar]
+2. **[pattern]:** [como aplicar]
+
+### Anti-Patterns
+1. **[anti_pattern]:** [evitar porque]
+2. **[anti_pattern]:** [evitar porque]
+
+### Cliches Proibidos (Nicho: [NICHO])
+| Proibido | Substituir Por |
+|----------|---------------|
+| [cliche] | [alternativa especifica] |
+| [cliche] | [alternativa especifica] |
+
+---
+
+## write_chapter MCP Integration
+
+### Pre-Chamada
+- [ ] Contexto HELIX preenchido nesta story
+- [ ] VOC quotes selecionadas
+- [ ] Transicoes definidas (in/out)
+- [ ] Capitulo anterior finalizado e aprovado
+
+### Parametros para write_chapter
+
+```
+capitulo: [numero]
+tipo: [hook/problema/descoberta/solucao/oferta/cta]
+contexto_helix: [resumo do MUP+MUS+DRE para este capitulo]
+voc_quotes: [quotes selecionadas]
+tom: [autoridade/empatico/urgente/casual]
+duracao_target: [segundos]
+transicao_entrada: [frase de conexao com capitulo anterior]
+transicao_saida: [tipo de hook para proximo capitulo]
+```
+
+### Pos-Chamada
+- [ ] Output salvo em `production/vsl/capitulo-[##]-[tipo].md`
+- [ ] Transicoes verificadas
+- [ ] Duracao estimada condiz com target
+
+---
+
+## Acceptance Criteria (Por Capitulo)
+
+### Cross-Capitulo (Todos)
+- [ ] Especificidade Score >= 8
+- [ ] Zero palavras banidas
+- [ ] Linguagem da VOC
+- [ ] Transicao de entrada fluida
+- [ ] Transicao de saida cria ponte
+- [ ] Duracao dentro do target (+/- 15%)
+- [ ] Tom consistente com capitulos adjacentes
+
+### Cap 01 (Hook/Lead)
+- [ ] Primeiros 3 segundos param scroll (pattern interrupt)
+- [ ] Loop aberto criado nos primeiros 30 segundos
+- [ ] Promessa especifica (nao generica)
+- [ ] Qualificador presente ("Se voce [situacao]...")
+- [ ] Ceticismo brevemente endererecado
+- [ ] Credibilidade mencionada (nao detalhada)
+- [ ] NUUPPECC Lead identificavel
+
+### Cap 02 (Problema/Background)
+- [ ] Sinestesia emocional presente (cena vivida)
+- [ ] DRE escalada para nivel 3-4
+- [ ] Vilao externo revelado
+- [ ] Solucoes falsas descartadas
+- [ ] "Nao era culpa sua" implicito ou explicito
+- [ ] Story do spokesperson (se aplicavel)
+
+### Cap 03 (Descoberta/Mecanismo)
+- [ ] MUP nomeado (Sexy Cause)
+- [ ] Reframe do problema claro ("aha moment")
+- [ ] Evidencia/prova do mecanismo
+- [ ] Mudanca de paradigma evidente
+- [ ] Emocao vira de desespero para esperanca
+
+### Cap 04 (Solucao/Produto)
+- [ ] MUS nomeado (Gimmick Name)
+- [ ] Ingrediente Hero apresentado
+- [ ] Authority Hook presente
+- [ ] Origin Story contada
+- [ ] Conexao MUP→MUS logica ("se X e o problema, Y e a solucao")
+- [ ] Produto revelado como consequencia natural
+
+### Cap 05 (Oferta/Stack)
+- [ ] Stack com minimo 5 itens
+- [ ] Valor individual para cada item
+- [ ] Ancoragem de preco efetiva
+- [ ] Bonus tem nomes proprios
+- [ ] Cada item conecta com um beneficio/dor
+
+### Cap 06 (CTA/Close)
+- [ ] CTA claro e repetido (minimo 2x)
+- [ ] Garantia explicita
+- [ ] Urgencia real (nao fabricada)
+- [ ] Consequencia de nao agir (DRE nivel 5)
+- [ ] "Picture" emocional da vida com o produto
+- [ ] Contraste: vida sem vs vida com
+
+---
+
+## Tasks
+
+### Pre-Producao
+- [ ] Ler story do capitulo anterior (continuidade)
+- [ ] Ler CONTEXT.md + mecanismo-unico.yaml
+- [ ] Carregar swipes de VSL do nicho (capitulo equivalente)
+- [ ] Preencher contexto HELIX e VOC nesta story
+- [ ] Definir transicoes de entrada e saida
+
+### Producao
+- [ ] Executar write_chapter (MCP) com parametros definidos
+- [ ] Revisar output vs acceptance criteria
+- [ ] Verificar transicao de entrada
+- [ ] Verificar transicao de saida
+- [ ] Output em: `production/vsl/capitulo-[##]-[tipo].md`
+
+### Pos-Producao (Por Capitulo)
+- [ ] blind_critic (copy_type: "body") — score: ___
+- [ ] Verificar retencao checkpoint
+- [ ] Verificar acceptance criteria do tipo
+
+### Integracao (Apos TODOS os Capitulos)
+- [ ] emotional_stress_test na VSL completa — score: ___
+- [ ] layered_review (3 camadas) na VSL completa
+- [ ] black_validation na VSL completa — score: ___
+- [ ] Arco emocional coerente do cap 01 ao 06
+- [ ] Duracao total dentro do target
+- [ ] Lead reescrito por ULTIMO (Regra Georgi)
+
+---
+
+## Dev Notes
+
+### Decisoes de Copy (Este Capitulo)
+[Registrar: por que este angulo, este tom, estas palavras.
+Ex: "Usei angulo conspiricao no cap 02 porque ads-library-spy mostra que 4 dos TOP 5 escalados usam esse angulo neste nicho"]
+
+### Insights de Sessoes Anteriores
+[Contexto preservado de sessoes passadas]
+
+### Versoes
+| # | Data | Score BC | Duracao | Mudanca Principal |
+|---|------|----------|---------|-------------------|
+| 1 | | | | Primeira versao |
+| 2 | | | | [mudanca] |
+
+---
+
+## QA Results (Por Capitulo)
+
+### blind_critic
+- **Score:** ___/10
+- **Feedback:** [resumo]
+- **Acoes:** [o que mudou]
+
+---
+
+## Rastreabilidade
+
+| Campo | Valor |
+|-------|-------|
+| **Capitulo** | #[XX] de 06 |
+| **Duracao** | [mm:ss] (target: [mm:ss]) |
+| **Arquivo de output** | production/vsl/capitulo-[##]-[tipo].md |
+| **VSL completa em** | production/vsl/[oferta]-vsl-completa.md |
+| **Story do cap anterior** | story-vsl-capitulo-[##].md |
+| **Story do proximo cap** | story-vsl-capitulo-[##].md |
+| **write_chapter usado** | [SIM/NAO] |
+| **Sessoes utilizadas** | [numero] |
+
+---
+
+*story-vsl-capitulo.md v1.0 — Story-Driven VSL Production (por capitulo)*
+*6 capitulos com arco emocional, retencao checkpoints e write_chapter MCP*
+*Ref: rmbc-ii-workflow.md para estrutura RMBC II*

package/framework/templates/swipe-analysis-specs.md

@@ -0,0 +1,270 @@
+---
+template_name: "swipe-analysis-specs"
+template_version: "1.0.0"
+template_type: "methodology"
+description: "Especificacoes e criterios para analise estruturada de swipe files"
+phase: "research"
+output_format: "markdown"
+---
+
+# Template: Swipe Analysis RAG Specs
+
+> Especificações técnicas para análise de swipe files com RAG
+> Fonte: Pesquisa Externa 05.md - Swipe Analysis State of the Art
+
+---
+
+## Stack Recomendado
+
+### Embeddings
+
+| Provider | Modelo | Custo | Uso |
+|----------|--------|-------|-----|
+| **Voyage AI** | voyage-4 | $0.06/1M tokens | Recomendado |
+| Voyage AI | voyage-finance-2 | $0.12/1M tokens | Dados financeiros |
+| Voyage AI | voyage-large-2-instruct | $0.12/1M tokens | Tasks específicas |
+| OpenAI | text-embedding-3-large | $0.13/1M tokens | Alternativa |
+
+> **Voyage AI** é recomendação oficial da Anthropic.
+
+### Vector Database
+
+| Database | Tipo | Uso |
+|----------|------|-----|
+| **LanceDB** | Local | Projetos locais, prototipagem |
+| **Pinecone** | Cloud | Produção, escala |
+| Qdrant | Híbrido | Open-source, self-hosted |
+| Chroma | Local | Desenvolvimento |
+
+---
+
+## Chunking Strategy
+
+### Parâmetros Recomendados
+
+| Parâmetro | Valor | Notas |
+|-----------|-------|-------|
+| **Tamanho do chunk** | 400-600 tokens | Optimal para copy |
+| **Overlap** | 15-20% (60-120 tokens) | Preserva contexto |
+| **Separadores** | `\n\n`, `\n`, `. ` | Ordem de prioridade |
+
+### Por Tipo de Documento
+
+| Tipo | Chunk Size | Overlap | Notas |
+|------|------------|---------|-------|
+| VSL Script | 500 tokens | 20% | Manter seções intactas |
+| Landing Page | 400 tokens | 15% | Blocos menores |
+| Email | 300 tokens | 10% | Emails são curtos |
+| Swipe Longo | 600 tokens | 20% | Mais contexto |
+
+---
+
+## Contextual Retrieval (Anthropic)
+
+> Reduz falhas de retrieval em **49-67%** quando combinado com reranking.
+
+### Como Funciona
+
+1. Para cada chunk, Claude gera contexto situacional
+2. Contexto é prepended ao chunk antes de embedding
+3. Chunks carregam "memória" do documento completo
+
+### Prompt de Contextualização
+
+```
+<document>
+{{WHOLE_DOCUMENT}}
+</document>
+
+Aqui está o chunk que queremos situar dentro do documento inteiro:
+
+<chunk>
+{{CHUNK_CONTENT}}
+</chunk>
+
+Por favor, dê um contexto curto e sucinto para situar este chunk
+dentro do documento geral para melhorar a busca do chunk.
+Responda apenas com o contexto sucinto e nada mais.
+```
+
+### Formato Final do Chunk
+
+```
+[CONTEXTO]: Este chunk é do VSL "Método X" de Stefan Georgi,
+especificamente a seção de UMP onde explica por que dietas falham.
+
+[CONTEÚDO ORIGINAL]: {chunk original}
+```
+
+---
+
+## Schema de Metadados
+
+### Campos Obrigatórios
+
+| Campo | Tipo | Exemplo |
+|-------|------|---------|
+| `source` | string | "swipe-stefan-georgi-vsl-001" |
+| `type` | enum | "vsl", "lp", "email", "ad" |
+| `section` | string | "lead", "ump", "ums", "close" |
+| `niche` | string | "saude", "concursos", "riqueza" |
+| `date_added` | datetime | "2026-01-30" |
+
+### Campos Opcionais
+
+| Campo | Tipo | Uso |
+|-------|------|-----|
+| `author` | string | Copywriter original |
+| `performance` | enum | "proven", "untested" |
+| `emotional_trigger` | array | ["fear", "greed", "curiosity"] |
+| `technique` | array | ["open_loop", "future_pace"] |
+
+---
+
+## Emotional Trigger Schema
+
+### Triggers Primários
+
+| Trigger | Descrição | Exemplo |
+|---------|-----------|---------|
+| `fear` | Medo de perda, consequências | "Se você não agir agora..." |
+| `greed` | Desejo de ganho rápido | "Dobrar seu investimento em..." |
+| `curiosity` | Lacuna de conhecimento | "O segredo que médicos escondem" |
+| `urgency` | Escassez temporal | "Apenas nas próximas 24 horas" |
+| `social_proof` | Validação social | "Mais de 10.000 já usaram" |
+| `authority` | Credibilidade | "Dr. fulano descobriu..." |
+
+### Triggers Secundários
+
+| Trigger | Descrição |
+|---------|-----------|
+| `exclusivity` | Sentir-se especial |
+| `reciprocity` | Retribuir favor |
+| `commitment` | Consistência com ações passadas |
+| `liking` | Afinidade com o vendedor |
+| `scarcity` | Quantidade limitada |
+
+---
+
+## Query Patterns
+
+### Para Hooks
+
+```
+Encontre hooks de VSL no nicho de [NICHO] que usam o trigger [TRIGGER].
+Priorize swipes com performance comprovada.
+```
+
+### Para Estrutura
+
+```
+Encontre exemplos de seção [SEÇÃO] em VSLs de alta conversão.
+Inclua o contexto da seção anterior e posterior.
+```
+
+### Para Técnicas
+
+```
+Encontre exemplos da técnica [TÉCNICA] em copy de resposta direta.
+Mostre como é implementada em diferentes nichos.
+```
+
+---
+
+## Pipeline de Ingestão
+
+```
+1. UPLOAD
+   └── Documento bruto (PDF, MD, TXT)
+
+2. PARSE
+   ├── Extrair texto
+   ├── Identificar tipo (VSL, LP, email)
+   └── Detectar seções (lead, body, close)
+
+3. CHUNK
+   ├── Dividir em chunks (400-600 tokens)
+   ├── Aplicar overlap (15-20%)
+   └── Manter seções intactas quando possível
+
+4. CONTEXTUALIZE
+   ├── Gerar contexto situacional
+   └── Prepend ao chunk
+
+5. EMBED
+   ├── Voyage AI voyage-4
+   └── Gerar vetor 1536-dim
+
+6. STORE
+   ├── Vetor + metadados
+   └── Index por tipo, nicho, section
+```
+
+---
+
+## Custo Estimado
+
+### Para 100 Swipes (~500K tokens)
+
+| Componente | Custo |
+|------------|-------|
+| Embeddings (Voyage) | $0.03 |
+| Contextualização (Claude) | ~$0.50 |
+| Storage (Pinecone) | ~$0.10/mês |
+| **Total setup** | ~$0.63 |
+| **Total mensal** | ~$0.10 |
+
+### Para 1000 Swipes (~5M tokens)
+
+| Componente | Custo |
+|------------|-------|
+| Embeddings | $0.30 |
+| Contextualização | ~$5.00 |
+| Storage | ~$1.00/mês |
+| **Total setup** | ~$6.30 |
+| **Total mensal** | ~$1.00 |
+
+---
+
+## Anti-Patterns
+
+| Anti-Pattern | Problema | Solução |
+|--------------|----------|---------|
+| Chunks muito grandes | Perda de precisão | Usar 400-600 tokens |
+| Sem overlap | Perda de contexto | Usar 15-20% overlap |
+| Sem contextualização | Retrieval impreciso | Usar Contextual Retrieval |
+| Metadados pobres | Filtros ineficazes | Schema completo |
+| Embedding genérico | Performance ruim | Voyage AI especializado |
+
+---
+
+## MCP Servers para RAG Local
+
+| Server | Função | Instalação |
+|--------|--------|------------|
+| `mcp-local-rag` | RAG local com LanceDB | `npx -y mcp-local-rag` |
+| `claude-context` | Busca semântica via Milvus | `npx @zilliz/claude-context-mcp@latest` |
+| `qdrant-mcp-server` | Vector search com Qdrant | Oficial Qdrant |
+
+### Configuração Exemplo
+
+```json
+{
+  "mcpServers": {
+    "swipe-rag": {
+      "command": "npx",
+      "args": ["-y", "mcp-local-rag"],
+      "env": {
+        "BASE_DIR": "~/.claude/swipes",
+        "CHUNK_SIZE": "500",
+        "CHUNK_OVERLAP": "100"
+      }
+    }
+  }
+}
+```
+
+---
+
+*Baseado em Anthropic Contextual Retrieval + Voyage AI Best Practices*
+*Pesquisa Externa 05.md - January 2026*