@lucapimenta/copy-chief-black 1.0.0

package/framework/templates/mup-consensus-validation.md

@@ -0,0 +1,154 @@
+---
+template_name: "mup-consensus-validation"
+template_version: "1.0.0"
+template_type: "methodology"
+description: "Protocolo de validacao multi-modelo para selecao de MUP via consensus"
+phase: "briefing"
+output_format: "markdown"
+---
+
+# Template: Validação de MUP com Consensus Multi-Modelo
+
+> **Objetivo:** Validar MUP com 3 modelos diferentes para eliminar viés
+> **Quando usar:** APÓS selecionar TOP 3 MUPs, ANTES de definir MUP final
+> **Ferramenta:** `mcp__zen__consensus`
+> **Criado:** 2026-02-02 | v6.9
+
+---
+
+## Por que Usar Consensus?
+
+| Problema | Solução |
+|----------|---------|
+| Claude valida o que Claude criou | Modelos externos questionam |
+| Viés de confirmação | Debate adversarial |
+| 1 perspectiva | 3+ perspectivas |
+
+---
+
+## Como Usar
+
+### Passo 1: Preparar os 3 MUPs candidatos
+
+```markdown
+MUP 1: [descrição completa]
+MUP 2: [descrição completa]
+MUP 3: [descrição completa]
+```
+
+### Passo 2: Executar Consensus
+
+```javascript
+mcp__zen__consensus({
+  step: `Avalie qual destes 3 MUPs tem maior potencial de conversão para [NICHO]:
+
+MUP 1: [descrição]
+MUP 2: [descrição]
+MUP 3: [descrição]
+
+CONTEXTO DO AVATAR: [breve descrição]
+
+CRITÉRIOS DE AVALIAÇÃO:
+1. UNICIDADE - Nenhum concorrente pode usar sem alterar?
+2. CREDIBILIDADE - Avatar acredita sem questionar?
+3. EMOÇÃO - Ativa medo/desejo visceral?
+4. MEMORABILIDADE - Fica na cabeça após fechar página?
+
+RESPONDA:
+- Ranking dos 3 MUPs (1º, 2º, 3º)
+- Justificativa para cada posição
+- Fraquezas críticas de cada um
+- Recomendação final`,
+
+  models: [
+    { model: "gemini-2.5-pro", stance: "for" },
+    { model: "gemini-2.5-flash", stance: "against" },
+    { model: "gemini-2.0-flash", stance: "neutral" }
+  ],
+
+  step_number: 1,
+  total_steps: 4,
+  next_step_required: true,
+  findings: "Iniciando validação multi-modelo de MUP"
+})
+```
+
+### Passo 3: Analisar Respostas
+
+| Modelo | Stance | Peso |
+|--------|--------|------|
+| gemini-2.5-pro | FOR | Alto (defende) |
+| gemini-2.5-flash | AGAINST | Alto (ataca) |
+| gemini-2.0-flash | NEUTRAL | Médio (arbitra) |
+
+### Passo 4: Sintetizar e Decidir
+
+```markdown
+## Resultado do Consensus
+
+### Rankings por Modelo
+| Modelo | 1º | 2º | 3º |
+|--------|----|----|-----|
+| Pro (for) | MUP X | MUP Y | MUP Z |
+| Flash (against) | MUP Y | MUP X | MUP Z |
+| Flash-2.0 (neutral) | MUP X | MUP Z | MUP Y |
+
+### Consenso Final
+- **MUP Vencedor:** [X]
+- **Confidence:** [%]
+- **Fraquezas a Corrigir:** [lista]
+
+### Decisão Humana
+☐ Aceitar MUP X
+☐ Aceitar MUP Y
+☐ Aceitar MUP Z
+☐ Iterar todos
+```
+
+---
+
+## Critérios de Aprovação
+
+| Cenário | Decisão |
+|---------|---------|
+| 3/3 modelos concordam no ranking | ✅ Alta confiança |
+| 2/3 modelos concordam | ⚠️ Investigar objeções do 3º |
+| 0/3 concordam | ❌ MUPs fracos, gerar mais |
+
+---
+
+## Output Esperado
+
+Salvar em: `briefings/{oferta}/validations/mup-consensus-{date}.md`
+
+```yaml
+---
+type: mup-consensus
+offer: [nome]
+date: YYYY-MM-DD
+models_used: [gemini-2.5-pro, gemini-2.5-flash, gemini-2.0-flash]
+mup_winner: [MUP X]
+confidence: X%
+human_approved: true|false
+---
+```
+
+---
+
+## Integração no Workflow
+
+```
+HELIX Fase 5: Gerar 8 MUPs (Divergent)
+         ↓
+Ranquear TOP 3 (RMBC)
+         ↓
+[consensus] ← ESTE TEMPLATE
+         ↓
+HUMANO seleciona MUP final
+         ↓
+HELIX Fase 6: MUS
+```
+
+---
+
+*Template v6.9 - Tool Enforcement System*

package/framework/templates/mup-human-test.md

@@ -0,0 +1,176 @@
+---
+template_name: "mup-human-test"
+template_version: "1.0.0"
+template_type: "methodology"
+description: "Protocolo de teste humano para validacao de MUP com criterios RMBC"
+phase: "briefing"
+output_format: "markdown"
+---
+
+# Template: Teste Humano de MUP
+
+> **Objetivo:** Validar MUP com avatares REAIS antes de produzir VSL
+> **Quando usar:** APÓS validação por IA, ANTES de produzir VSL
+> **Investimento evitado:** R$5K-50K em VSL que não converte
+> **Criado:** 2026-02-02 | v6.9
+
+---
+
+## Por que Testar com Humanos?
+
+| Problema | Consequência |
+|----------|--------------|
+| IA valida IA | Viés confirmado |
+| MUP parece bom no papel | Não ressoa com avatar real |
+| Produz VSL caro | Descobre que não funciona após gastar |
+
+**Regra:** 30 minutos de teste humano > 30 horas de retrabalho.
+
+---
+
+## Processo de Teste
+
+### Passo 1: Recrutar Avatares (3-5 pessoas)
+
+**Onde encontrar:**
+- Grupo de WhatsApp do nicho
+- Comunidade no Facebook
+- Lista de leads existente
+- Conhecidos que se encaixam no avatar
+
+**Critérios de seleção:**
+- [ ] Está no público-alvo (idade, situação, problema)
+- [ ] NÃO conhece sua oferta ainda
+- [ ] Disposto a dar feedback honesto
+
+### Passo 2: Preparar o Teste
+
+**O que mostrar:** APENAS o MUP (sem copy, sem oferta)
+
+**Script de apresentação:**
+```
+"Descobri uma informação interessante e queria sua opinião sincera.
+
+[LER O MUP]
+
+O que você acha? Isso faz sentido pra você?"
+```
+
+**NÃO fazer:**
+- Explicar contexto demais
+- Defender se questionarem
+- Dar mais informações
+
+### Passo 3: Coletar Reações
+
+**Observar:**
+
+| Reação | O que significa |
+|--------|-----------------|
+| Olhos arregalados | Interesse genuíno ✅ |
+| "Conta mais!" | Curiosidade ativada ✅ |
+| "Interessante..." (vago) | Educado mas não convencido ⚠️ |
+| "Não sei, será?" | Cético ⚠️ |
+| Muda de assunto | Não ressoou ❌ |
+
+**Perguntas de follow-up:**
+1. "O que você achou mais interessante?"
+2. "Alguma coisa não fez sentido?"
+3. "Você contaria isso pra alguém?"
+4. "Isso muda como você pensa sobre [problema]?"
+
+### Passo 4: Documentar Resultados
+
+```markdown
+## Teste Humano de MUP: [Nome da Oferta]
+
+### MUP Testado
+[Descrição completa do MUP]
+
+### Avatares Testados
+
+| # | Perfil | Reação Inicial | Perguntas que Fez | Score |
+|---|--------|----------------|-------------------|-------|
+| 1 | [idade, situação] | [reação] | [perguntas] | 1-5 |
+| 2 | ... | ... | ... | ... |
+| 3 | ... | ... | ... | ... |
+
+### Análise
+
+**Pontos fortes identificados:**
+- [o que ressoou]
+
+**Objeções levantadas:**
+- [o que questionaram]
+
+**Ajustes necessários:**
+- [o que precisa mudar]
+
+### Veredicto
+
+| Score Médio | Decisão |
+|-------------|---------|
+| 4-5 | ✅ APROVADO - Prosseguir para VSL |
+| 2-3 | ⚠️ REVISAR - Ajustar MUP |
+| 1 | ❌ TROCAR - MUP não funciona |
+```
+
+---
+
+## Critérios de Aprovação
+
+| Reações | Resultado |
+|---------|-----------|
+| 4-5 de 5 interessados | ✅ **APROVADO** |
+| 2-3 de 5 interessados | ⚠️ **REVISAR MUP** |
+| 0-1 de 5 interessados | ❌ **TROCAR MUP** |
+
+---
+
+## Gate no Workflow
+
+```
+MUP validado por IA (consensus)
+         ↓
+[TESTE HUMANO] ← ESTE TEMPLATE
+         ↓
+Teste passou?
+    │
+    ├── SIM → Produzir VSL
+    │
+    └── NÃO → Voltar para Fase 5 (gerar mais MUPs)
+```
+
+---
+
+## Output Esperado
+
+Salvar em: `briefings/{oferta}/validations/mup-human-test-{date}.md`
+
+```yaml
+---
+type: mup-human-test
+offer: [nome]
+date: YYYY-MM-DD
+avatars_tested: 5
+approval_rate: X%
+verdict: APPROVED | REVISE | REJECT
+---
+```
+
+---
+
+## Integração com production-agent
+
+**REGRA:** SE `mup-human-test.md` NÃO EXISTE:
+→ production-agent AVISA antes de produzir VSL
+
+```
+⚠️ WARNING: MUP não foi testado com humanos.
+Recomendação: Executar teste humano antes de investir em VSL.
+Continuar mesmo assim? (risco de retrabalho)
+```
+
+---
+
+*Template v6.9 - Tool Enforcement System*

package/framework/templates/mup-mus-discovery.md

@@ -0,0 +1,192 @@
+---
+template_name: "mup-mus-discovery"
+template_version: "1.0.0"
+template_type: "methodology"
+description: "Framework de discovery para Mecanismo Unico do Problema e da Solucao"
+phase: "briefing"
+output_format: "markdown"
+---
+
+# Template: MUP/MUS Discovery (CreativeDC)
+
+> Workflow 6-step baseado em pesquisa Divergent-Convergent (63.5% novelty increase)
+> Fonte: Pesquisa Externa 02.md - CreativeDC Framework
+
+---
+
+## FASE 1: Divergente - Geração de MUPs
+
+**Prompt:**
+```
+Gere 15 mecanismos únicos explicando por que [PROBLEMA] acontece.
+
+Categorize em:
+- Científicos (5): mecanismos biológicos, fisiológicos, neurológicos
+- Psicológicos (5): crenças, comportamentos, padrões mentais
+- Externos (5): ambiente, sociedade, indústria, sistema
+
+REGRAS:
+- Cada mecanismo deve ser DIFERENTE em natureza, não variações do mesmo
+- PROIBIDO: [listar 5 clichês conhecidos do nicho]
+- Use linguagem proprietária (nomeie cada mecanismo)
+
+Formato:
+1. [Nome do Mecanismo]: [Descrição em 1-2 frases]
+```
+
+**Output esperado:** 15 MUPs candidatos organizados por categoria
+
+---
+
+## FASE 2: Checagem de Diversidade
+
+**Prompt:**
+```
+Analise os 15 mecanismos gerados.
+
+Identifique:
+1. Quais ângulos NÃO foram explorados?
+2. Há clustering/similaridade entre mecanismos?
+3. Quais categorias estão subrepresentadas?
+
+Gere 5 mecanismos adicionais que explorem esses GAPS específicos.
+```
+
+**Output esperado:** 5 MUPs adicionais cobrindo ângulos não explorados
+
+---
+
+## FASE 3: Convergente - Avaliação de MUPs
+
+**Critérios de Avaliação (1-10):**
+
+| Critério | Pergunta | Peso |
+|----------|----------|------|
+| **Novelty** | Quão diferente dos concorrentes? | 25% |
+| **Credibility** | Sustentável com evidência? | 25% |
+| **Emotional Connection** | Ressoa com dor do avatar? | 20% |
+| **Defensibility** | Difícil de copiar? | 15% |
+| **Differentiation** | Único no mercado? | 15% |
+
+**Prompt:**
+```
+Avalie cada um dos 20 MUPs usando os 5 critérios (1-10).
+
+Calcule score ponderado:
+Score = (Novelty × 0.25) + (Credibility × 0.25) + (Emotional × 0.20) + (Defensibility × 0.15) + (Differentiation × 0.15)
+
+Ordene do maior para menor score.
+Selecione TOP 3 para próxima fase.
+```
+
+**Output esperado:** TOP 3 MUPs com scores e justificativas
+
+---
+
+## FASE 4: Divergente - Geração de MUSs
+
+**Para CADA TOP 3 MUP, executar:**
+
+**Prompt:**
+```
+Para o MUP "[NOME DO MUP]":
+
+Gere 12 mecanismos de SOLUÇÃO únicos.
+
+Categorize em:
+- Comportamentais (4): hábitos, rotinas, práticas diárias
+- Ingredientes/Componentes (4): substâncias, elementos, ferramentas
+- Processos/Sistemas (4): metodologias, frameworks, sequências
+
+REGRAS:
+- Cada MUS deve ser PROPRIETÁRIO e NOMEÁVEL
+- Deve conectar diretamente com o MUP (se MUP = causa, MUS = solução)
+- PROIBIDO: soluções genéricas como "dieta e exercício"
+
+Formato:
+1. [Nome do MUS]: [Descrição] → Conecta com MUP porque [razão]
+```
+
+**Output esperado:** 36 MUSs (12 por MUP) organizados por categoria
+
+---
+
+## FASE 5: Convergente - Seleção de MUS
+
+**Critérios adicionais para MUS:**
+
+| Critério | Pergunta |
+|----------|----------|
+| **Conexão MUP** | A solução resolve diretamente o problema identificado? |
+| **Simplicidade** | O avatar consegue entender em 10 segundos? |
+| **Ação Clara** | O que o avatar precisa FAZER é óbvio? |
+| **Proof Path** | Existe evidência disponível para sustentar? |
+
+**Prompt:**
+```
+Para cada TOP 3 MUP, selecione o MELHOR MUS usando os critérios.
+
+Justifique a seleção com:
+- Por que este MUS e não os outros?
+- Qual evidência pode sustentar?
+- Qual objeção mais forte e como responder?
+```
+
+**Output esperado:** 3 pares MUP-MUS finais com justificativas
+
+---
+
+## FASE 6: Convergência Final
+
+**Para cada par MUP-MUS vencedor:**
+
+**Prompt:**
+```
+Para o par [MUP] + [MUS]:
+
+1. EVIDÊNCIAS (3):
+   - Cite 3 fontes que sustentam este mecanismo
+   - Prefira estudos, dados, cases reais
+
+2. OBJEÇÕES (5):
+   - Liste 5 objeções potenciais do cético
+   - Para cada, forneça resposta de 1 frase
+
+3. HEADLINES (10):
+   - Gere 10 variações de headline usando este MUP-MUS
+   - Varie: curiosidade, medo, promessa, prova social, novidade
+```
+
+**Output esperado:** Pacote completo para briefing HELIX
+
+---
+
+## CHECKLIST DE DIVERSIDADE
+
+**Sinais de Divergência FALHANDO:**
+- [ ] Fraseado similar entre mecanismos
+- [ ] Output genérico, poderia ser qualquer nicho
+- [ ] Sem surpresas ou ângulos inesperados
+- [ ] Clustering em torno de 2-3 ideias
+
+**Sinais de Convergência FALHANDO:**
+- [ ] Selecionando "mais seguro" vs "mais diferenciado"
+- [ ] Ideias indefensáveis com evidência
+- [ ] Ignorando constraints de mercado
+- [ ] Critérios vagos ("esse parece melhor")
+
+---
+
+## ANTI-PADRÕES
+
+| Anti-Padrão | Problema | Solução |
+|-------------|----------|---------|
+| **Artificial Hivemind** | Modelos convergem para outputs similares | Forçar categorias diferentes |
+| **Temperature Myth** | Achar que temperature alta = diversidade | Estrutura > temperature |
+| **Safe Selection** | Escolher o menos controverso | Usar critérios objetivos |
+| **Cliché Creep** | MUPs genéricos do nicho | Lista de proibidos no prompt |
+
+---
+
+*Baseado em CreativeDC Framework (Dezembro 2025)*
+*Pesquisa Externa 02.md - 63.5% novelty increase validado*

package/framework/templates/niche-pack/biblioteca-template.md

@@ -0,0 +1,105 @@
+---
+template_name: "niche-pack-biblioteca"
+template_version: "1.0.0"
+template_type: "niche-pack"
+description: "Template de biblioteca de nicho com VOC consolidada, avatar e linguagem"
+phase: "research"
+output_format: "markdown"
+---
+
+# Biblioteca de Nicho — {{NICHE_DISPLAY}}
+
+> **Criada:** {{DATE}}
+> **Ofertas:** {{OFFER_COUNT}} oferta(s) ativa(s)
+> **Status:** Seed inicial — pendente enriquecimento com VOC real
+
+---
+
+## Avatar Unificado do Nicho
+
+### Perfil Base
+- **Genero predominante:** A definir com VOC
+- **Faixa etaria:** A definir com VOC
+- **Classe:** A definir com VOC
+- **Localizacao:** A definir com VOC
+- **Estado civil/profissional:** A definir com VOC
+
+{{AVATAR_SKELETON}}
+
+### DRE Dominante do Nicho
+**A DEFINIR** — Pendente extracao VOC real.
+
+Emocoes provaveis a investigar:
+- Frustracao ("ja tentei de tudo")
+- Medo (consequencias futuras)
+- Vergonha (julgamento social)
+- Culpa (responsabilidade pessoal)
+- Raiva (injustica, engano)
+
+### Escalada Emocional do Nicho
+| Nivel | Manifestacao |
+|-------|-------------|
+| 1. Fisico | A extrair da VOC |
+| 2. Social | A extrair da VOC |
+| 3. Consequencia | A extrair da VOC |
+| 4. Relacional | A extrair da VOC |
+| 5. Identidade | A extrair da VOC |
+
+---
+
+## Linguagem do Nicho (VOC Consolidada)
+
+### Frases-Chave
+Pendente extracao VOC real. Minimo 50 quotes por plataforma.
+
+### Palavras/Expressoes Frequentes
+Pendente extracao VOC real.
+
+---
+
+## Compliance do Nicho
+
+### Termos a Evitar
+{{COMPLIANCE_NOTES}}
+
+### Angulo Seguro
+A definir com base no nicho e regulamentacao local.
+
+---
+
+## Solucoes Falhas Conhecidas
+1. A identificar na pesquisa
+2. A identificar na pesquisa
+3. A identificar na pesquisa
+
+---
+
+## Cliches Proibidos (Anti-Homogeneizacao)
+
+{{CLICHES_PROIBIDOS}}
+
+---
+
+## Angulos Validados
+Pendente Research. Nenhum angulo validado ainda.
+
+---
+
+## Keywords para Ads Library Spy
+
+### Nivel 1 (Nicho)
+{{KEYWORDS_NIVEL_1}}
+
+### Nivel 2 (Sub-nicho)
+{{KEYWORDS_NIVEL_2}}
+
+### Nivel 3 (Mecanismo)
+A definir apos Research.
+
+### Nivel 4 (Concorrentes)
+A definir apos Ads Library Spy.
+
+---
+
+*Seed v1.0 — Criado via create-niche-pack em {{DATE}}*
+*Enriquecer com VOC real antes de usar como referencia de producao.*

package/framework/templates/niche-pack/cliches-template.md

@@ -0,0 +1,64 @@
+---
+template_name: "niche-pack-cliches"
+template_version: "1.0.0"
+template_type: "niche-pack"
+description: "Template de cliches proibidos por nicho para anti-homogeneizacao"
+phase: "production"
+output_format: "markdown"
+---
+
+# Cliches Proibidos — {{NICHE_DISPLAY}}
+
+> **Ref:** anti-homogeneization.md (v7.0)
+> **Criado:** {{DATE}}
+> **Regra Cardinal:** Copy que poderia ser usada por concorrente SEM alteracao = REFAZER
+
+---
+
+## Cliches Especificos do Nicho
+
+{{CLICHES_TABLE}}
+
+---
+
+## Palavras Banidas (Cross-Nicho)
+
+### Adjetivos Vazios
+- revolucionario, inovador, incrivel, inacreditavel
+- unico (sem especificacao), exclusivo (sem prova)
+- simples (sem demonstracao), facil (sem evidencia)
+
+### Substantivos Genericos
+- segredo, metodo, sistema (sem nome proprio)
+- transformacao, jornada, caminho
+- solucao, resposta, chave
+
+### Verbos IA-Speak
+- revolucionar, transformar, elevar, desbloquear
+- empoderar, potencializar, alavancar
+
+### Estruturas Banidas
+- "In today's [adjetivo] world"
+- "Introducing..."
+- "What if I told you..."
+- "The secret to..."
+- "Finally, a solution..."
+- "Imagine..."
+- "X meets Y"
+
+---
+
+## Enforcement
+
+Antes de entregar qualquer copy:
+- [ ] Logo Test: passaria se trocar logo?
+- [ ] Competitor Swap Test: concorrente usaria?
+- [ ] Tem nome proprietario para mecanismo?
+- [ ] Tem numeros especificos (nao round)?
+- [ ] Tem exemplos unicos da oferta?
+- [ ] Linguagem e da VOC (nao generica)?
+- [ ] Zero palavras da lista de banidos?
+
+---
+
+*Criado via create-niche-pack em {{DATE}}*