@lucapimenta/copy-chief-black 1.0.0

package/framework/skills/audience-research-agent/references/ref_platform_tiktok.md

@@ -0,0 +1,227 @@
+# Extração de VOC - TikTok
+
+> **Tipo de insight:** Linguagem geracional, dores não-filtradas, trends
+> **Prioridade Brasil:** Alta
+> **Linguagem:** Ultra-informal, gírias, humor, vulnerabilidade crua
+
+---
+
+## Por Que TikTok é Poderoso
+
+- Linguagem MAIS CRUA de todas as plataformas
+- Público mais jovem = menos filtro social
+- "Storytime" revela experiências reais detalhadas
+- Comentários brutalmente honestos
+- Trends revelam dores/desejos coletivos
+- Algoritmo surfacea conteúdo viral = validação massiva
+
+---
+
+## Queries de Busca (web_search)
+
+### Estrutura Base
+```
+[tema] tiktok brasil
+[problema] storytime tiktok
+[nicho] viral tiktok
+[termo do nicho] tiktok
+```
+
+### Por Tipo de Insight
+
+**Para encontrar DORES CRUAS:**
+```
+[problema] storytime tiktok
+[problema] a real tiktok
+[problema] desabafo tiktok
+"o que ninguém fala sobre" [tema] tiktok
+```
+
+**Para encontrar LINGUAGEM GERACIONAL:**
+```
+[nicho] tiktok viral brasil
+[termo popular do nicho] tiktok
+[gíria do nicho] tiktok
+```
+
+**Para encontrar TRENDS/DESEJOS:**
+```
+[resultado desejado] tiktok trend
+[nicho] antes depois tiktok
+[transformação] tiktok viral
+```
+
+### Exemplos por Nicho
+
+**Emagrecimento:**
+```
+emagrecer storytime tiktok
+dieta a real tiktok
+ozempic tiktok brasil
+"não consigo emagrecer" tiktok
+```
+
+**Finanças (público jovem):**
+```
+dívida storytime tiktok
+primeiro salário tiktok
+renda extra tiktok brasil
+"estou quebrado" tiktok
+```
+
+**Relacionamento:**
+```
+término storytime tiktok
+red flag relacionamento tiktok
+"meu ex" tiktok viral
+dating app tiktok brasil
+```
+
+**Saúde Mental:**
+```
+ansiedade storytime tiktok
+burnout tiktok brasil
+terapia tiktok
+```
+
+**Carreira:**
+```
+demissão storytime tiktok
+primeiro emprego tiktok
+"odeio meu trabalho" tiktok
+entrevista de emprego tiktok
+```
+
+---
+
+## O Que Extrair dos Resultados
+
+### 1. Identificar Vídeos Relevantes
+Priorize:
+- Vídeos com milhões de views (validação massiva)
+- Storytimes detalhados
+- Vídeos com milhares de comentários
+- Trends específicos do nicho
+- Conteúdo de creators BR
+
+### 2. Usar web_fetch
+Extraia:
+
+**Dos VÍDEOS:**
+- Narrativa/história contada
+- Ganchos usados (primeiros 3 segundos)
+- Linguagem e gírias específicas
+- Emoção dominante
+
+**Dos COMENTÁRIOS:**
+- "Eu também" (validação de dor comum)
+- Histórias adicionais nos comentários
+- Perguntas e objeções
+- Humor autodepreciativo (revela dor real)
+
+### 3. Template de Captura
+
+```yaml
+fonte: TikTok
+video_descricao: "[descrição breve]"
+video_url: "[URL se disponível]"
+views: [número]
+creator: "@[username]"
+
+quote: "[texto exato com gírias]"
+tipo: [dor|desejo|humor|validação|pergunta]
+contexto: [storytime|comentário|trend]
+linguagem_geracional: [gírias específicas usadas]
+emoção: [desespero|humor_negro|esperança|raiva]
+confidence: [alto|médio|baixo]
+```
+
+---
+
+## Padrões de Linguagem TikTok (BR)
+
+### Gírias e Expressões Comuns
+- "surto" = momento de crise/frustração
+- "eu literalmente" = ênfase emocional
+- "não tanko" = não aguento
+- "é sobre isso" = identificação
+- "gente???" = incredulidade/desespero
+- "chorando" = afetado emocionalmente (positivo ou negativo)
+- "ok mas" = objeção vindo
+- "pov:" = point of view, experiência pessoal
+
+### Indicadores de Dor Real
+- "storytime de quando..."
+- "a real sobre..."
+- "o que ninguém te conta..."
+- "eu achando que era só comigo"
+- "gente eu não aguento mais"
+- Humor autodepreciativo sobre o problema
+
+### Indicadores de Desejo
+- "quando eu finalmente..."
+- "minha era de..."
+- "esse vai ser meu ano de..."
+- "manifestando..."
+- "eu PRECISO"
+
+### Indicadores de Objeção/Ceticismo
+- "mas tipo..."
+- "tá mas e quem..."
+- "gente será que funciona?"
+- "eu caí nessa uma vez"
+
+---
+
+## Tipos de Conteúdo para Priorizar
+
+### 1. Storytimes
+Vídeos narrativos contando experiências pessoais
+- **VOC:** Histórias detalhadas, linguagem emocional, contexto completo
+
+### 2. "A Real Sobre..."
+Conteúdo que desmistifica ou revela verdades incômodas
+- **VOC:** Frustrações com soluções existentes, objeções
+
+### 3. Trends de Identificação
+Trends onde pessoas mostram situações do dia-a-dia
+- **VOC:** Dores normalizadas, linguagem natural
+
+### 4. Antes/Depois e Transformações
+- **VOC:** Desejos, resultados esperados, timeline
+
+### 5. Comentários em Vídeos Virais
+Às vezes mais valiosos que o próprio vídeo
+- **VOC:** Validação massiva de dores/desejos
+
+---
+
+## Diferenças Demográficas no TikTok
+
+### Gen Z (18-25)
+- Mais humor autodepreciativo
+- Gírias mais intensas
+- Vulnerabilidade como norma
+- Foco em saúde mental
+
+### Millennials (26-40)
+- Storytimes mais estruturados
+- Foco em carreira/finanças
+- Tom mais reflexivo
+- Comparação com expectativas
+
+### Pais no TikTok
+- Conteúdo sobre maternidade/paternidade real
+- Vulnerabilidade sobre dificuldades
+- Menos filtro que Instagram
+
+---
+
+## Checklist TikTok
+
+- [ ] Trends atuais do nicho identificados
+- [ ] Mínimo 5 vídeos virais analisados
+- [ ] Mínimo 10 quotes verbatim extraídos
+- [ ] Gírias/linguagem geracional catalogadas
+- [ ] Storytimes relevantes mapeados
+- [ ] Padrões de humor/vulnerabilidade identificados

package/framework/skills/audience-research-agent/references/ref_platform_youtube.md

@@ -0,0 +1,187 @@
+# Extração de VOC - YouTube
+
+> **Tipo de insight:** Dores profundas, objeções, histórias de fracasso
+> **Prioridade Brasil:** Alta
+> **Linguagem:** Informal, emocional, detalhada
+
+---
+
+## Por Que YouTube é Ouro
+
+- Comentários em vídeos de experts atraem público QUALIFICADO
+- Perguntas revelam gaps de conhecimento reais
+- Histórias pessoais aparecem espontaneamente
+- Público brasileiro muito ativo em comentários
+
+---
+
+## Queries de Busca (web_search)
+
+### Estrutura Base
+```
+[nicho] youtube comentários
+[expert do nicho] youtube
+[problema] depoimento youtube
+[solução] funciona youtube
+```
+
+### Por Tipo de Insight
+
+**Para encontrar DORES:**
+```
+[problema] não consigo youtube
+[problema] ajuda youtube
+[problema] desabafo youtube
+minha história [problema] youtube
+```
+
+**Para encontrar OBJEÇÕES:**
+```
+[solução] funciona mesmo youtube
+[solução] vale a pena youtube
+[produto/método] é golpe youtube
+[solução] verdade youtube
+```
+
+**Para encontrar DESEJOS:**
+```
+[solução] resultado youtube
+[solução] antes depois youtube
+consegui [resultado] youtube
+como [resultado] depoimento
+```
+
+### Exemplos por Nicho
+
+**Emagrecimento:**
+```
+emagrecer não consigo youtube
+dieta low carb funciona youtube
+ozempic vale a pena youtube
+perdi 20kg depoimento youtube
+```
+
+**Finanças:**
+```
+sair das dívidas youtube
+day trade funciona youtube
+renda extra 2024 youtube
+investir pouco dinheiro youtube
+```
+
+**Relacionamento:**
+```
+reconquistar ex youtube
+casamento em crise youtube
+terapia de casal funciona youtube
+```
+
+**Saúde Masculina:**
+```
+disfunção erétil tratamento youtube
+testosterona baixa youtube
+calvície tratamento youtube
+```
+
+---
+
+## O Que Extrair dos Resultados
+
+### 1. Identificar Vídeos Relevantes
+Após web_search, priorize vídeos com:
+- Títulos que indicam depoimento/experiência pessoal
+- Alto número de visualizações (validação social)
+- Vídeos de experts reconhecidos no nicho BR
+- Vídeos recentes (últimos 12 meses)
+
+### 2. Usar web_fetch na Página do Vídeo
+Extraia dos comentários:
+
+**Comentários de ALTO VALOR (priorizar):**
+- Comentários longos (investimento emocional)
+- Comentários com muitos likes
+- Comentários que contam histórias pessoais
+- Comentários que fazem perguntas específicas
+- Threads de discussão (controvérsia = dor)
+
+**Sinais de linguagem a capturar:**
+- Frases que começam com "Eu também..."
+- Perguntas tipo "Mas e se..."
+- Desabafos tipo "Já tentei de tudo..."
+- Relatos tipo "Comigo funcionou/não funcionou porque..."
+
+### 3. Template de Captura
+
+```yaml
+fonte: YouTube
+video_titulo: "[título do vídeo]"
+video_url: "[URL]"
+video_views: [número]
+canal: "[nome do canal]"
+
+quote: "[comentário exato, com erros de digitação]"
+likes_comentario: [número se visível]
+tipo: [dor|desejo|objeção|pergunta|história]
+emoção: [frustração|esperança|desespero|raiva|curiosidade]
+contexto_autor: "[o que sabemos sobre quem comentou]"
+confidence: [alto|médio|baixo]
+```
+
+---
+
+## Experts/Canais para Mapear por Nicho
+
+Ao iniciar pesquisa, identifique os 3-5 maiores canais do nicho no BR:
+
+**Como encontrar:**
+```
+web_search("[nicho] canal youtube brasil")
+web_search("[nicho] youtuber brasileiro")
+web_search("melhor canal [nicho] youtube")
+```
+
+**Depois, busque vídeos específicos desses canais:**
+```
+web_search("[nome do canal] [tema específico]")
+```
+
+---
+
+## Padrões de Comentários por Tipo
+
+### Dores (Capturar VERBATIM)
+- "Gente, eu estou desesperada..."
+- "Alguém mais passa por isso?"
+- "Já gastei tanto dinheiro com isso e nada..."
+- "Meu [relacionamento/saúde/etc] está destruído por causa disso"
+- "Tenho vergonha de admitir mas..."
+
+### Objeções (Capturar VERBATIM)
+- "Será que funciona pra quem tem [condição específica]?"
+- "Mas e quem não tem tempo/dinheiro?"
+- "Já vi tanta coisa que não funciona..."
+- "Parece bom demais pra ser verdade"
+- "E os efeitos colaterais?"
+
+### Desejos (Capturar VERBATIM)
+- "Meu sonho é conseguir..."
+- "Se eu conseguisse isso minha vida mudaria"
+- "Queria tanto ter essa disposição/resultado/etc"
+- "Imagina acordar e..."
+
+### Perguntas Reveladoras (Capturar VERBATIM)
+- "Funciona pra quem...?"
+- "Quanto tempo demora pra...?"
+- "Pode fazer junto com...?"
+- "E se eu tiver...?"
+
+---
+
+## Checklist YouTube
+
+- [ ] 3-5 experts/canais do nicho identificados
+- [ ] Mínimo 5 vídeos relevantes analisados
+- [ ] Mínimo 15 quotes verbatim extraídos
+- [ ] Quotes categorizados por tipo
+- [ ] Perguntas frequentes mapeadas
+- [ ] Objeções recorrentes identificadas

package/framework/skills/audience-research-agent/references/ref_readiness_score_5_dimensions.md

@@ -0,0 +1,247 @@
+# Score de Prontidão - Sistema de Avaliação
+
+> **Usar para:** Determinar se a pesquisa está completa o suficiente para passar para o próximo agente
+> **Regra:** Pesquisa só avança com score >= 70/100
+
+---
+
+## Visão Geral
+
+O Score de Prontidão avalia 5 dimensões críticas para garantir que a pesquisa tem substância suficiente para gerar copy de alta conversão.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    SCORE DE PRONTIDÃO                       │
+├─────────────────────────────────────────────────────────────┤
+│  Cobertura de Fontes ............ [__/20]                  │
+│  Profundidade de Dores .......... [__/25]                  │
+│  Clareza de Desejos ............. [__/20]                  │
+│  Mapeamento de Objeções ......... [__/20]                  │
+│  Qualidade da Linguagem ......... [__/15]                  │
+├─────────────────────────────────────────────────────────────┤
+│  TOTAL .......................... [__/100]                 │
+│                                                             │
+│  STATUS: [Insuficiente | Parcial | Pronto]        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Dimensão 1: Cobertura de Fontes (máx 20 pontos)
+
+Avalia diversidade e quantidade de fontes consultadas.
+
+| Critério | Pontos |
+|----------|--------|
+| 1-2 plataformas consultadas | 5 |
+| 3-4 plataformas consultadas | 10 |
+| 5+ plataformas consultadas | 15 |
+| Inclui Reclame Aqui (BR) | +3 |
+| Inclui fonte de conteúdo orgânico (YT/IG/TT) | +2 |
+
+**Máximo:** 20 pontos
+
+**Exemplo de cálculo:**
+- YouTube + Instagram + Reclame Aqui + Mercado Livre = 4 plataformas (10 pts)
+- Inclui Reclame Aqui (+3 pts)
+- Inclui YouTube (+2 pts)
+- **Total dimensão:** 15/20
+
+---
+
+## Dimensão 2: Profundidade de Dores (máx 25 pontos)
+
+Avalia se as dores mapeadas vão além do superficial.
+
+| Critério | Pontos |
+|----------|--------|
+| Dores superficiais identificadas (mín 5) | 5 |
+| Dores intermediárias identificadas (mín 3) | 7 |
+| Dores viscerais identificadas (mín 2) | 10 |
+| Pelo menos 1 dor com intensidade 5 | +3 |
+
+**Checklist de Dor Visceral (precisa ter pelo menos 2):**
+- [ ] O que os mantém acordados às 3 da manhã?
+- [ ] Que problema têm VERGONHA de admitir?
+- [ ] Como afeta seus relacionamentos?
+- [ ] O que secretamente CULPAM pelos fracassos?
+- [ ] Qual narrativa negativa repetem para si mesmos?
+
+**Máximo:** 25 pontos
+
+---
+
+## Dimensão 3: Clareza de Desejos (máx 20 pontos)
+
+Avalia se os desejos estão bem mapeados nos 3 níveis.
+
+| Critério | Pontos |
+|----------|--------|
+| Desejos declarados identificados (mín 3) | 5 |
+| Desejos implícitos identificados (mín 2) | 7 |
+| Desejos secretos identificados (mín 1) | 5 |
+| Desejo conectado a gatilho reptiliano | +3 |
+
+**Checklist de Desejo Secreto (precisa ter pelo menos 1):**
+- [ ] O que querem mas têm MEDO de pedir?
+- [ ] Como seria o "dia perfeito" após resolver?
+- [ ] Que versão de si mesmos querem se tornar?
+- [ ] Que status ou reconhecimento buscam secretamente?
+
+**Máximo:** 20 pontos
+
+---
+
+## Dimensão 4: Mapeamento de Objeções (máx 20 pontos)
+
+Avalia se as objeções estão identificadas e categorizadas.
+
+| Critério | Pontos |
+|----------|--------|
+| Objeções de preço mapeadas | 4 |
+| Objeções de tempo/esforço mapeadas | 4 |
+| Objeções de ceticismo mapeadas | 6 |
+| Objeções de adequação mapeadas | 4 |
+| Pelo menos 1 objeção vinda do Reclame Aqui | +2 |
+
+**Categorias de Objeção (precisa ter pelo menos 3 de 5):**
+- [ ] Preço ("é caro", "não tenho dinheiro")
+- [ ] Tempo ("não tenho tempo", "demora muito")
+- [ ] Esforço ("parece difícil", "não vou conseguir")
+- [ ] Ceticismo ("já tentei", "não funciona", "golpe")
+- [ ] Adequação ("não é pra mim", "meu caso é diferente")
+
+**Máximo:** 20 pontos
+
+---
+
+## Dimensão 5: Qualidade da Linguagem (máx 15 pontos)
+
+Avalia se a linguagem capturada é utilizável em copy.
+
+| Critério | Pontos |
+|----------|--------|
+| Mínimo 30 quotes verbatim | 5 |
+| Quotes com alta carga emocional (intensidade 4-5) | 4 |
+| Metáforas/analogias recorrentes identificadas | 3 |
+| Linguagem validada em múltiplas fontes | 3 |
+
+**Checklist de Linguagem:**
+- [ ] Mínimo 30 quotes verbatim coletados
+- [ ] Pelo menos 10 quotes com intensidade >= 4
+- [ ] Pelo menos 3 metáforas/expressões recorrentes
+- [ ] Pelo menos 50% dos quotes validados em 2+ fontes
+
+**Máximo:** 15 pontos
+
+---
+
+## Tabela de Status
+
+| Score | Status | Significado | Ação |
+|-------|--------|-------------|------|
+| 0-49 | Insuficiente | Pesquisa muito rasa | Voltar para revisão. Voltar à Fase 2. |
+| 50-69 | Parcial | Pesquisa incompleta | Pode avançar com ressalvas. Listar gaps. |
+| 70-84 | Pronto | Pesquisa adequada | Pode avançar para próximo agente. |
+| 85-100 | Excelente | Pesquisa profunda | Avançar com confiança máxima. |
+
+---
+
+## Template de Output do Score
+
+Incluir no final de TODA pesquisa:
+
+```
+═══════════════════════════════════════════════════════════════
+                    SCORE DE PRONTIDÃO
+═══════════════════════════════════════════════════════════════
+
+┌─────────────────────────────────────────────────────────────┐
+│  Cobertura de Fontes .................. [XX/20]            │
+│    • Plataformas: [lista]                                  │
+│    • Inclui RA: [sim/não]                                  │
+│                                                             │
+│  Profundidade de Dores ................ [XX/25]            │
+│    • Superficiais: [X] | Intermediárias: [X] | Viscerais: [X] │
+│    • Intensidade máxima: [X/5]                             │
+│                                                             │
+│  Clareza de Desejos ................... [XX/20]            │
+│    • Declarados: [X] | Implícitos: [X] | Secretos: [X]     │
+│                                                             │
+│  Mapeamento de Objeções ............... [XX/20]            │
+│    • Categorias cobertas: [X/5]                            │
+│    • Objeções de ceticismo: [X]                            │
+│                                                             │
+│  Qualidade da Linguagem ............... [XX/15]            │
+│    • Total quotes: [X]                                     │
+│    • Quotes alta intensidade: [X]                          │
+│    • Validação cruzada: [X%]                               │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  TOTAL: [XX/100]                                           │
+│                                                             │
+│  STATUS: [Insuficiente | Parcial | Pronto]        │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+
+[Se status != PRONTO]
+Atenção: GAPS IDENTIFICADOS:
+• [gap 1]
+• [gap 2]
+• [gap 3]
+
+RECOMENDAÇÃO: [ação sugerida]
+
+[Se status == PRONTO]
+[OK] PESQUISA APROVADA PARA PRÓXIMO AGENTE
+
+Pontos fortes:
+• [ponto forte 1]
+• [ponto forte 2]
+
+Áreas de atenção:
+• [área que poderia ser melhorada se houver tempo]
+
+═══════════════════════════════════════════════════════════════
+```
+
+---
+
+## Regras de Decisão
+
+### Condições para não avançar:
+- Score < 50
+- Zero dores viscerais identificadas
+- Zero objeções de ceticismo mapeadas
+- Menos de 20 quotes verbatim
+
+### Avançar com ressalvas se:
+- Score entre 50-69
+- Falta cobertura em 1-2 dimensões
+- **Recomendado:** Listar gaps específicos para o próximo agente
+
+### Avançar com confiança se:
+- Score >= 70
+- Todas as dimensões com pelo menos 60% dos pontos
+- Dores viscerais E objeções de ceticismo presentes
+
+---
+
+## Integração com Workflow
+
+O Score de Prontidão é calculado automaticamente na **Fase 4** (Output RAG-Otimizado), antes de entregar o documento final.
+
+```
+Fase 1: Análise de Inputs
+    ↓
+Fase 2: Pesquisa Web Ativa
+    ↓
+Fase 3: Síntese Psicográfica
+    ↓
+Fase 4: Output RAG-Otimizado
+    ↓
+[CALCULAR SCORE DE PRONTIDÃO]
+    ↓
+Score >= 70? -> [OK] Entregar pesquisa
+Score < 70?  -> Atenção: Listar gaps, perguntar se continua ou complementa
+```