@lucapimenta/copy-chief-black 1.0.0

package/framework/templates/voc-linguistic-patterns.md

@@ -0,0 +1,148 @@
+---
+template_name: "voc-linguistic-patterns"
+template_version: "1.0.0"
+template_type: "research"
+description: "Template para extracao de padroes linguisticos e micro-unidades interpretativas do avatar"
+phase: "research"
+deliverable_type: "voc-extraction"
+output_format: "markdown"
+---
+
+# Padroes Linguisticos — [OFERTA]
+
+> **Template usado:** voc-linguistic-patterns.md
+> **Versao:** 2026-02-27
+> **Ref:** micro-unidades.md (framework de 6 dimensoes)
+> **Fonte:** research/voc/ (quotes extraidas)
+
+---
+
+## 1. Padroes de Argumentacao
+
+### Conectores Dominantes
+
+| Conector | Frequencia | Contexto | Exemplo de Quote |
+|----------|------------|----------|------------------|
+| [conector] | [alta/media/baixa] | [quando usa] | "[quote]" |
+| [conector] | [alta/media/baixa] | [quando usa] | "[quote]" |
+
+### Logica de Causa-Efeito
+- Como explica causa do problema: [padrao]
+- Como justifica decisoes: [padrao]
+- Como contra-argumenta: [padrao]
+
+---
+
+## 2. Vocabulario Preferencial
+
+### Mapa de Sinonimos (Tecnico → Avatar)
+
+| Termo Tecnico | Palavra do Avatar | Frequencia | Exemplo |
+|---------------|-------------------|------------|---------|
+| [termo] | [palavra] | [N ocorrencias] | "[quote]" |
+| [termo] | [palavra] | [N ocorrencias] | "[quote]" |
+
+### Intensificadores Naturais
+- [lista dos mais usados, com frequencia]
+
+### Diminutivos/Aumentativos
+- [lista com contexto de uso]
+
+---
+
+## 3. Estruturas Frasais
+
+### Comprimento Medio
+- [ ] Curtas (< 10 palavras)
+- [ ] Medias (10-20 palavras)
+- [ ] Longas (> 20 palavras)
+- [ ] Mistas
+
+### Estruturas Tipicas (TOP 5)
+
+1. **[Nome do padrao]:** "[exemplo]"
+2. **[Nome do padrao]:** "[exemplo]"
+3. **[Nome do padrao]:** "[exemplo]"
+4. **[Nome do padrao]:** "[exemplo]"
+5. **[Nome do padrao]:** "[exemplo]"
+
+### Parenteticos e Apartes
+- [lista de expressoes usadas como aparte]
+
+---
+
+## 4. Ritmo Cognitivo
+
+### Momentos de Pausa
+- [quando hesita: contexto + expressao usada]
+
+### Momentos de Aceleracao
+- [quando acelera: contexto + padrao]
+
+### Digressoes Naturais
+- [como muda de assunto e volta]
+
+### Repeticoes por Enfase
+- [padroes de repeticao identificados]
+
+---
+
+## 5. Metaforas Nativas
+
+### Metaforas Encontradas na VOC
+
+| Metafora | Tema | Frequencia | Quote Original |
+|----------|------|------------|----------------|
+| "[metafora]" | [problema/solucao/emocao] | [N] | "[quote]" |
+| "[metafora]" | [problema/solucao/emocao] | [N] | "[quote]" |
+
+### Analogias do Cotidiano
+- [lista de comparacoes que o avatar faz naturalmente]
+
+---
+
+## 6. Nivel de Sofisticacao
+
+### Classificacao
+- [ ] Coloquial puro
+- [ ] Coloquial com termos tecnicos aprendidos
+- [ ] Misto (alterna conforme contexto)
+- [ ] Tecnico
+
+### Girias e Regionalismos
+- [lista identificada]
+
+### Articulacao
+- [ ] Expressa bem o que sente
+- [ ] Dificuldade para articular ("nao sei explicar")
+- [ ] Misto (articula bem para algumas coisas)
+
+---
+
+## Voice Sample
+
+> 2-3 frases FICTICIAS que SOAM exatamente como o avatar.
+> Teste: misturar com quotes reais — impossivel distinguir.
+
+**Frase 1:** "[frase que captura o TOM do avatar]"
+
+**Frase 2:** "[frase que captura a ESTRUTURA do avatar]"
+
+**Frase 3:** "[frase que captura o RITMO do avatar]"
+
+---
+
+## Instrucoes para Producao
+
+Ao produzir copy para esta oferta:
+1. Ler este Voice Sample ANTES de escrever
+2. Calibrar tom pela Dimensao 6 (Nivel de Sofisticacao)
+3. Usar conectores da Dimensao 1 (nao os seus)
+4. Respeitar estrutura frasal da Dimensao 3
+5. Incorporar metaforas da Dimensao 5 (nao inventar novas)
+6. Manter ritmo da Dimensao 4 (pausas e aceleracoes)
+
+---
+
+*Template: voc-linguistic-patterns.md v1.0*
+*Ref: micro-unidades.md para framework de 6 dimensoes*

package/framework/templates/voc-squad-consolidation.md

@@ -0,0 +1,268 @@
+---
+template_name: "voc-squad-consolidation"
+template_version: "1.0.0"
+template_type: "research"
+description: "Template para consolidacao de resultados do VOC Squad (5 analistas paralelos)"
+phase: "research"
+deliverable_type: "voc-extraction"
+output_format: "markdown"
+---
+
+# VOC Squad Consolidation Template
+
+> **Propósito:** Consolidar resultados dos 5 analistas do VOC Squad
+> **Input:** Outputs dos 5 analistas (YouTube, Instagram, TikTok, Reddit, Amazon)
+> **Output:** VOC consolidado com triangulação cross-platform
+> **Sprint:** AIOS Upgrade Plan v4.0 § S6.9
+
+---
+
+## Metadata
+
+```yaml
+offer: "{offer_name}"
+niche: "{niche}"
+consolidation_date: "{date}"
+analysts_reporting:
+  - youtube: {quotes_count}
+  - instagram: {quotes_count}
+  - tiktok: {quotes_count}
+  - reddit: {quotes_count}
+  - amazon: {quotes_count}
+total_quotes: {sum}
+triangulation_rate: "{percentage}%"
+```
+
+---
+
+## 1. Por Plataforma (Sumário)
+
+### YouTube
+
+**Quotes Extraídos:** {count}
+**DRE Médio:** {1-5}
+**Padrão Linguístico Dominante:** {descrição}
+
+Top 3 Quotes:
+1. "{quote}" — {engagement}, DRE {level}
+2. "{quote}" — {engagement}, DRE {level}
+3. "{quote}" — {engagement}, DRE {level}
+
+Insight Principal: {insight}
+
+---
+
+### Instagram
+
+**Quotes Extraídos:** {count}
+**DRE Médio:** {1-5}
+**Padrão Linguístico Dominante:** {descrição}
+
+Top 3 Quotes:
+1. "{quote}" — {engagement}, DRE {level}
+2. "{quote}" — {engagement}, DRE {level}
+3. "{quote}" — {engagement}, DRE {level}
+
+Insight Principal: {insight}
+
+---
+
+### TikTok
+
+**Quotes Extraídos:** {count}
+**DRE Médio:** {1-5}
+**Padrão Linguístico Dominante:** {descrição}
+
+Top 3 Quotes:
+1. "{quote}" — {engagement}, DRE {level}
+2. "{quote}" — {engagement}, DRE {level}
+3. "{quote}" — {engagement}, DRE {level}
+
+Insight Principal: {insight}
+
+---
+
+### Reddit
+
+**Quotes Extraídos:** {count}
+**DRE Médio:** {1-5}
+**Padrão Linguístico Dominante:** {descrição}
+
+Top 3 Quotes:
+1. "{quote}" — {engagement}, DRE {level}
+2. "{quote}" — {engagement}, DRE {level}
+3. "{quote}" — {engagement}, DRE {level}
+
+Insight Principal: {insight}
+
+---
+
+### Amazon/Reviews
+
+**Quotes Extraídos:** {count}
+**DRE Médio:** {1-5}
+**Padrão Linguístico Dominante:** {descrição}
+
+Top 3 Quotes:
+1. "{quote}" — {engagement}, DRE {level}
+2. "{quote}" — {engagement}, DRE {level}
+3. "{quote}" — {engagement}, DRE {level}
+
+Insight Principal: {insight}
+
+---
+
+## 2. Triangulação Cross-Platform
+
+> **Triangulação:** Padrões que aparecem em 3+ plataformas são validados como universais.
+
+### Dores Trianguladas (3+ plataformas)
+
+| Dor | YouTube | Instagram | TikTok | Reddit | Amazon | DRE Médio |
+|-----|---------|-----------|--------|--------|--------|-----------|
+| {dor_1} | ✅ | ✅ | ✅ | ✅ | ✅ | {level} |
+| {dor_2} | ✅ | ✅ | ✅ | ❌ | ✅ | {level} |
+| {dor_3} | ✅ | ❌ | ✅ | ✅ | ✅ | {level} |
+
+### Desejos Triangulados (3+ plataformas)
+
+| Desejo | YouTube | Instagram | TikTok | Reddit | Amazon | DRE Médio |
+|--------|---------|-----------|--------|--------|--------|-----------|
+| {desejo_1} | ✅ | ✅ | ✅ | ✅ | ✅ | {level} |
+| {desejo_2} | ✅ | ✅ | ✅ | ❌ | ❌ | {level} |
+
+### Objeções Trianguladas
+
+| Objeção | Plataformas | Frequência | Tipo |
+|---------|-------------|------------|------|
+| {objecao_1} | YT, IG, Reddit | Alta | Preço |
+| {objecao_2} | TT, Reddit, Amazon | Média | Eficácia |
+
+---
+
+## 3. Padrões Linguísticos Consolidados
+
+### Universais (todas plataformas)
+
+| Padrão | Exemplo | Uso Recomendado |
+|--------|---------|-----------------|
+| {padrão_1} | "{exemplo}" | Lead, Hook |
+| {padrão_2} | "{exemplo}" | Problema, Agitação |
+
+### Plataforma-Específicos
+
+| Plataforma | Padrão Único | Exemplo | Nota |
+|------------|--------------|---------|------|
+| YouTube | {padrão} | "{exemplo}" | Tom confessional |
+| TikTok | {padrão} | "{exemplo}" | Ultra-curto, gírias |
+| Reddit | {padrão} | "{exemplo}" | Cru, sem filtro |
+
+### Vocabulário VOC Consolidado
+
+```markdown
+## Palavras de DOR (usar em copy)
+- "{palavra_1}"
+- "{palavra_2}"
+- "{palavra_3}"
+
+## Palavras de DESEJO (usar em copy)
+- "{palavra_1}"
+- "{palavra_2}"
+- "{palavra_3}"
+
+## Expressões de FRUSTRAÇÃO
+- "{expressão_1}"
+- "{expressão_2}"
+
+## Expressões de ESPERANÇA
+- "{expressão_1}"
+- "{expressão_2}"
+```
+
+---
+
+## 4. DRE por Plataforma
+
+| Plataforma | DRE Mínimo | DRE Máximo | DRE Médio | Pico Emocional |
+|------------|------------|------------|-----------|----------------|
+| YouTube | {min} | {max} | {avg} | {descrição} |
+| Instagram | {min} | {max} | {avg} | {descrição} |
+| TikTok | {min} | {max} | {avg} | {descrição} |
+| Reddit | {min} | {max} | {avg} | {descrição} |
+| Amazon | {min} | {max} | {avg} | {descrição} |
+| **CONSOLIDADO** | {min} | {max} | {avg} | {descrição} |
+
+---
+
+## 5. Recomendações de Formato
+
+> Baseado nos padrões observados, recomendações para produção de copy:
+
+### Hook/Lead
+
+**Tom recomendado:** {tom baseado em padrões}
+**Linguagem:** {formal/informal/ultra-casual}
+**Comprimento:** {curto/médio/longo}
+
+Quotes para inspiração:
+1. "{quote mais impactante para hook}"
+2. "{quote alternativo}"
+
+### Problema/Agitação
+
+**DRE alvo:** {level baseado em DRE médio}
+**Emoções a ativar:** {lista de emoções dominantes}
+
+Quotes para usar literalmente:
+1. "{quote de dor mais intensa}"
+2. "{quote de frustração}"
+3. "{quote de desespero}"
+
+### Solução/Transformação
+
+**Linguagem de desejo:** {padrões de 5 estrelas}
+**Prova social:** {tipo de prova mais presente}
+
+Quotes para inspiração:
+1. "{quote de transformação}"
+2. "{quote de satisfação}"
+
+---
+
+## 6. Gaps e Limitações
+
+### Plataformas com Dados Insuficientes
+
+| Plataforma | Quotes | Status | Ação Recomendada |
+|------------|--------|--------|------------------|
+| {plataforma} | {count} | ⚠️ Insuficiente | Re-executar com keywords diferentes |
+
+### Triangulação Incompleta
+
+| Insight | Plataformas | Gap |
+|---------|-------------|-----|
+| {insight} | YT, IG | Falta TikTok, Reddit, Amazon |
+
+### Próximos Passos
+
+- [ ] {ação_1}
+- [ ] {ação_2}
+- [ ] {ação_3}
+
+---
+
+## 7. Métricas de Qualidade
+
+| Métrica | Valor | Status |
+|---------|-------|--------|
+| Plataformas com dados | {X}/5 | {✅ ou ⚠️} |
+| Quotes totais | {count} | {✅ >= 80 ou ⚠️ < 80} |
+| Taxa de triangulação | {%} | {✅ >= 30% ou ⚠️ < 30%} |
+| DRE médio consolidado | {level} | {✅ >= 3 ou ⚠️ < 3} |
+| Padrões identificados | {count} | {✅ >= 10 ou ⚠️ < 10} |
+
+---
+
+*VOC Squad Consolidation — Template v1.0*
+*AIOS Upgrade Plan v4.0 § S6.9*
+*Criado: 2026-02-27*

package/framework/templates/voc-viral-extraction-template.md

@@ -0,0 +1,174 @@
+---
+template_name: "voc-viral-extraction-template"
+template_version: "1.0.0"
+template_type: "research"
+description: "Template para extracao de VOC via conteudos virais em plataformas sociais"
+phase: "research"
+required_inputs: []
+output_format: "markdown"
+deliverable_type: "voc-extraction"
+validation_tools: ["validate_gate"]
+---
+
+# [PLATAFORMA] Viral VOC Extraction
+**Oferta:** [NOME_DA_OFERTA]
+**Data:** [DATA_ISO]
+**Metodo:** Apify [ACTOR_USADO]
+
+---
+
+## Conteudos Virais Identificados (Top 10)
+
+| # | URL | Titulo | Views | Comments | Formato | Hook |
+|---|-----|--------|-------|----------|---------|------|
+| 1 | | | | | | |
+| 2 | | | | | | |
+| 3 | | | | | | |
+| 4 | | | | | | |
+| 5 | | | | | | |
+| 6 | | | | | | |
+| 7 | | | | | | |
+| 8 | | | | | | |
+| 9 | | | | | | |
+| 10 | | | | | | |
+
+**Criterios de selecao:**
+- YouTube: 10K+ views OU 500+ comments
+- Instagram: 5K+ likes OU 200+ comments
+- TikTok: 50K+ views OU 1K+ comments
+
+---
+
+## Comentarios Extraidos (Target: 50)
+
+### Quote #1
+- **Texto:** ""
+- **Username:** @
+- **Likes:**
+- **Replies:**
+- **Contexto:** (video/post de origem)
+- **Categoria:** INCAPACIDADE/METODOS/VOLUME/CONSTANCIA/DESISTENCIA/BURNOUT
+- **Intensidade:** /5
+- **Gatilho Reptiliano:** Controle/Sobrevivencia/Aceitacao/Seguranca
+
+### Quote #2
+- **Texto:** ""
+- **Username:** @
+- **Likes:**
+- **Replies:**
+- **Contexto:**
+- **Categoria:**
+- **Intensidade:** /5
+- **Gatilho Reptiliano:**
+
+[... continuar ate 50 quotes ...]
+
+---
+
+## Analise de Formato (OBRIGATORIO)
+
+### Padroes Identificados
+
+**Formato dominante:**
+-
+
+**Duracao/tamanho medio:**
+-
+
+**Hooks que funcionam:**
+1.
+2.
+3.
+
+**Estilo visual:**
+-
+
+**Som/musica trending (se TikTok):**
+-
+
+---
+
+## Tendencias de Conteudo
+
+**Tema mais consumido:**
+-
+
+**Angulo emocional dominante:**
+-
+
+**Call-to-action implicito do publico:**
+-
+
+---
+
+## Micro-Unidades Linguisticas (6 Dimensoes)
+
+> Ref: micro-unidades.md para framework completo.
+> Extrair COMO o avatar fala, nao so O QUE fala.
+
+### 1. Padroes de Argumentacao
+- Conectores dominantes: [ex: "porque...", "ai que...", "o problema e que..."]
+- Logica causa-efeito: [como explica o problema]
+
+### 2. Vocabulario Preferencial
+- Palavras escolhidas (nao tecnicas): [ex: "acabou comigo" vs "me prejudicou"]
+- Intensificadores: [ex: "demais", "pra caramba", "absurdo"]
+
+### 3. Estruturas Frasais
+- Comprimento tipico: [curtas / medias / longas / mistas]
+- Estrutura dominante: [fragmentos, frases completas, parenteticos]
+
+### 4. Ritmo Cognitivo
+- Pausas/hesitacoes: [quando e como hesita]
+- Aceleracoes: [quando acelera, em que contexto]
+
+### 5. Metaforas Nativas
+- Metaforas identificadas: [analogias que o avatar JA usa]
+- Tema principal: [problema / solucao / emocao]
+
+### 6. Nivel de Sofisticacao
+- Classificacao: [coloquial / coloquial-tecnico / misto / tecnico]
+- Girias/regionalismos: [lista]
+
+### Voice Sample (3 Frases)
+
+> Frases FICTICIAS que SOAM exatamente como o avatar.
+> Teste: misturar com quotes reais — impossivel distinguir.
+
+1. **Tom:** "[frase que captura o TOM]"
+2. **Estrutura:** "[frase que captura a ESTRUTURA]"
+3. **Ritmo:** "[frase que captura o RITMO]"
+
+---
+
+## Metricas de Qualidade
+
+| Metrica | Valor |
+|---------|-------|
+| Total quotes extraidos | /50 |
+| Intensidade media | /5 |
+| % com engagement (likes/replies) | % |
+| Quotes triangulados (aparecem em outras plataformas) | |
+| Conteudos virais analisados | /10 |
+
+---
+
+## Notas Metodologicas
+
+**Ferramenta primaria usada:**
+-
+
+**Fallbacks necessarios:**
+-
+
+**Limitacoes encontradas:**
+-
+
+---
+
+---
+
+*Last updated: 2026-01-26*
+*Template version: v1.0*
+*Ecosystem: v4.9.6*
+*Extraido via voc-research-agent - Viral-First Strategy*