@lucapimenta/copy-chief-black 1.0.0

package/framework/templates/checklists/vsl-acceptance.yaml

@@ -0,0 +1,91 @@
+# VSL Acceptance Checklist v1.0
+# Segue: checklist-definition.schema.yaml
+# Fontes: tool-usage-matrix.md, copy-squad-constitution.md, constraint-progressivo.md
+# Criado: 2026-02-27
+
+id: vsl-acceptance
+name: "Criterios de Aceitacao — VSL"
+applies_to: vsl
+gate: production
+
+tasks:
+  - id: vsl-write-chapters
+    name: "Escrever 6 capitulos da VSL"
+    owner: "@vsl"
+    tools: [write_chapter]
+    order: 1
+
+  - id: vsl-bc-per-chapter
+    name: "Rodar blind_critic apos cada capitulo"
+    owner: "@critic"
+    tools: [blind_critic]
+    depends_on: [vsl-write-chapters]
+    order: 2
+
+  - id: vsl-est-complete
+    name: "Rodar emotional_stress_test na VSL completa"
+    owner: "@critic"
+    tools: [emotional_stress_test]
+    depends_on: [vsl-bc-per-chapter]
+    order: 3
+
+  - id: vsl-layered-review
+    name: "Aplicar layered_review em 3 camadas (Cortar, Visceralidade, Voz Alta)"
+    owner: "@critic"
+    tools: [layered_review]
+    depends_on: [vsl-est-complete]
+    order: 4
+
+  - id: vsl-black-validation
+    name: "Rodar black_validation como gate final"
+    owner: "@gatekeeper"
+    tools: [black_validation]
+    depends_on: [vsl-layered-review]
+    order: 5
+
+  - id: vsl-human-mup
+    name: "Submeter MUP para aprovacao humana antes de produzir"
+    owner: "@chief"
+    tools: []
+    order: 0  # Pre-condicao
+
+criteria:
+  - id: bc-score-chapter
+    criterion: "blind_critic score >= 8 em cada capitulo"
+    type: score
+    tool: blind_critic
+    threshold: 8
+    operator: ">="
+    blocking: true
+    weight: 1.0
+
+  - id: est-genericidade
+    criterion: "emotional_stress_test genericidade >= 8 na VSL completa"
+    type: score
+    tool: emotional_stress_test
+    threshold: 8
+    operator: ">="
+    blocking: true
+    weight: 1.0
+
+  - id: bv-final
+    criterion: "black_validation score >= 8"
+    type: score
+    tool: black_validation
+    threshold: 8
+    operator: ">="
+    blocking: true
+    weight: 1.0
+
+  - id: human-mup-approval
+    criterion: "Humano aprova MUP antes de iniciar producao"
+    type: human
+    blocking: true
+    weight: 1.0
+
+metadata:
+  version: "1.0.0"
+  sources:
+    - "tool-usage-matrix.md § Tasks por Deliverable / VSL"
+    - "copy-squad-constitution.md § Checklist de Saida — Blade"
+    - "constraint-progressivo.md § Iteracao 4"

package/framework/templates/context-hierarchy-template.md

@@ -0,0 +1,314 @@
+---
+template_name: "context-hierarchy-template"
+template_version: "1.0.0"
+template_type: "methodology"
+description: "Template para hierarquia de contexto 3-Tier (HOT/WARM/COLD) por sessao"
+phase: "any"
+output_format: "markdown"
+---
+
+# Context Hierarchy Template v6.0
+
+> Template para gerenciamento de contexto em sessões de produção.
+> Baseado em Pesquisa 9 (Context Management).
+
+---
+
+## QUANDO USAR
+
+Usar este template:
+- [ ] Ao iniciar sessão de produção longa
+- [ ] Quando contexto passar de 50%
+- [ ] Antes de tarefas que exigem múltiplos arquivos
+- [ ] Para planejar carregamento progressivo
+
+---
+
+## 3-TIER MEMORY ARCHITECTURE
+
+### Definição dos Tiers
+
+| Tier | Conteúdo | Regra | Tokens |
+|------|----------|-------|--------|
+| **HOT** | CONTEXT.md, synthesis.md, briefing atual | Sempre carregado | ~5K |
+| **WARM** | references/, swipes/, fases HELIX | Sob demanda | ~20K |
+| **COLD** | raw/, dados brutos, histórico | NUNCA no contexto | N/A |
+
+### Mapeamento da Oferta
+
+**Oferta:** [nome]
+
+#### Tier HOT (Sempre Carregado)
+
+| Arquivo | Tokens (~) | Status |
+|---------|------------|--------|
+| `CONTEXT.md` | ~500 | [ ] Carregado |
+| `research/synthesis.md` | ~2K | [ ] Carregado |
+| `briefings/phases/fase[X].md` (atual) | ~2K | [ ] Carregado |
+
+**Total HOT:** ~5K tokens
+
+#### Tier WARM (Carregar Quando Necessário)
+
+| Arquivo | Tokens (~) | Quando Carregar |
+|---------|------------|-----------------|
+| `briefings/phases/fase05-mup.md` | ~2K | Produzindo VSL/LP |
+| `briefings/phases/fase06-mus.md` | ~2K | Produzindo VSL/LP |
+| `briefings/phases/fase09-nuuppecc.md` | ~1.5K | Produzindo criativos |
+| `research/voc/summary.md` | ~1K | Validando linguagem |
+| `research/competitors/ads-library-spy.md` | ~3K | Pesquisando padrões |
+| `swipes/[nicho]/*.md` | ~2K cada | Produzindo copy |
+
+**Total WARM disponível:** ~15-25K tokens
+
+#### Tier COLD (Nunca Carregar)
+
+| Arquivo/Pasta | Por quê não carregar |
+|---------------|---------------------|
+| `research/voc/raw/` | Dados brutos, já sintetizados |
+| `research/competitors/raw/` | Dados brutos, já sintetizados |
+| Histórico de versões | Não relevante para produção |
+| Screenshots/imagens | Alto custo, baixo valor textual |
+
+---
+
+## PROGRESSIVE LOADING SEQUENCE
+
+### Ordem de Carregamento
+
+```
+1. CONTEXT.md (visão geral)
+   ↓ ~500 tokens
+2. synthesis.md (decisões-chave)
+   ↓ ~2K tokens
+3. Fase específica sendo trabalhada
+   ↓ ~2K tokens
+4. Swipes/references APENAS quando produzindo
+   ↓ sob demanda
+```
+
+### Por Tipo de Tarefa
+
+#### Produzindo VSL
+
+| Ordem | Arquivo | Tokens |
+|-------|---------|--------|
+| 1 | CONTEXT.md | ~500 |
+| 2 | synthesis.md | ~2K |
+| 3 | fase05-mup.md | ~2K |
+| 4 | fase06-mus.md | ~2K |
+| 5 | fase07-one-belief.md | ~1K |
+| 6 | vsl-template.md | ~2K |
+| **TOTAL** | | ~10K |
+
+#### Produzindo Criativos
+
+| Ordem | Arquivo | Tokens |
+|-------|---------|--------|
+| 1 | CONTEXT.md | ~500 |
+| 2 | synthesis.md | ~2K |
+| 3 | fase09-nuuppecc.md | ~1.5K |
+| 4 | ads-library-spy.md | ~3K |
+| 5 | criativos-template.md | ~1.5K |
+| 6 | swipes/[nicho]/[1-2 relevantes] | ~2K |
+| **TOTAL** | | ~11K |
+
+#### Validando Copy (CRITIC)
+
+| Ordem | Arquivo | Tokens |
+|-------|---------|--------|
+| 1 | copy-validation-checklist.md | ~3K |
+| 2 | CONTEXT.md | ~500 |
+| 3 | fase05-mup.md | ~2K |
+| 4 | fase06-mus.md | ~2K |
+| 5 | voc/summary.md | ~1K |
+| **TOTAL** | | ~9K |
+
+---
+
+## REGRA DOS 75%
+
+### Limites de Contexto
+
+| Capacidade | Tokens (~) | Ação |
+|------------|------------|------|
+| 0-50% | 0-100K | Operação normal |
+| 50-60% | 100-120K | Considerar `/compact` |
+| 60-75% | 120-150K | **Executar `/compact`** |
+| >75% | >150K | ⚠️ Qualidade degradada |
+
+### Sinais de Contexto Cheio
+
+Observar estes sinais para executar `/compact`:
+
+- [ ] Respostas mais genéricas que o normal
+- [ ] Esquecimento de instruções anteriores
+- [ ] Repetição de perguntas já respondidas
+- [ ] Inconsistências com decisões anteriores
+- [ ] Demora maior nas respostas
+
+---
+
+## SESSION MANAGEMENT
+
+### Início de Sessão
+
+```
+1. [ ] Verificar qual oferta está ativa
+2. [ ] Carregar CONTEXT.md da oferta
+3. [ ] Verificar estado no synthesis.md
+4. [ ] Identificar próxima ação no task_plan.md
+5. [ ] Estimar tokens necessários para a tarefa
+```
+
+### Durante a Sessão
+
+```
+1. [ ] Monitorar uso de contexto (aproximado)
+2. [ ] Executar `/compact` se >60%
+3. [ ] Salvar outputs em arquivo (não só no contexto)
+4. [ ] Atualizar findings.md com descobertas
+```
+
+### Fim de Sessão
+
+```
+1. [ ] Salvar estado em project_state.yaml
+2. [ ] Documentar próxima ação clara
+3. [ ] Commitar alterações se relevante
+4. [ ] Não deixar trabalho "no ar"
+```
+
+---
+
+## SUBAGENT PATTERNS
+
+### Quando Usar Subagents
+
+| Situação | Usar Subagent? | Motivo |
+|----------|----------------|--------|
+| Contexto >60% | ✅ | Reset com 200K fresh |
+| Tarefa isolada | ✅ | Contexto focado |
+| Produção em lote | ✅ | Paralelização |
+| Continuação de trabalho | ❌ | Usar sessão atual |
+| Decisão estratégica | ❌ | Manter contexto completo |
+
+### Tipos de Subagent
+
+| Type | Uso | Tools Disponíveis |
+|------|-----|-------------------|
+| `researcher` | VOC, competitors, mechanism, avatar | Read, WebSearch, MCPs |
+| `copywriter` | VSL, LP, creatives, emails | Read, Write |
+| `reviewer` | Validation, QA, quality gates | Read, Write |
+| `synthesizer` | Merge parallel outputs | Read, Write, Grep |
+
+### Exemplo de Chamada
+
+```
+Task tool com:
+- subagent_type: "copywriter"
+- prompt: "Produzir VSL para [oferta]. Ler CONTEXT.md e synthesis.md primeiro. Seguir vsl-template.md."
+```
+
+---
+
+## CHUNKED PROCESSING (TTT Pattern)
+
+### Princípio
+
+> Dividir tarefa longa em chunks é mais eficiente que contexto monolítico.
+
+### Speedup Esperado
+
+| Abordagem | Performance |
+|-----------|-------------|
+| Contexto monolítico | 1x (baseline) |
+| Chunked processing | 2.7x - 35x |
+
+### Divisão por Deliverable
+
+| Deliverable | Chunks Recomendados |
+|-------------|---------------------|
+| VSL | Hook → Problema → Vilão → Mecanismo → Prova → Oferta → CTA |
+| Landing Page | Bloco a bloco (14 blocos) |
+| Criativos | Um por vez com contexto focado |
+| Email Sequence | Email por email |
+
+### Exemplo Prático
+
+**VSL em 7 chunks:**
+
+| Chunk | Contexto Necessário | Output |
+|-------|---------------------|--------|
+| 1. Hook | fase09-nuuppecc.md | Hook + 3 variações |
+| 2. Problema | fase03-avatar.md | Seção problema |
+| 3. Vilão | fase05-mup.md | Seção vilão |
+| 4. Mecanismo | fase05-mup.md | Seção mecanismo |
+| 5. Prova | synthesis.md | Seção prova |
+| 6. Oferta | fase08-cro.md | Stack + preço |
+| 7. CTA | fase08-cro.md | Fechamento |
+
+---
+
+## PROMPT STRUCTURE
+
+### Organização Ideal
+
+```
+[INÍCIO DO CONTEXTO - Dados extensos]
+├── Briefing relevante
+├── VOC/Exemplos necessários
+├── References específicas
+└── Contexto do projeto
+
+[FIM DO CONTEXTO]
+
+[INSTRUÇÃO ESPECÍFICA / QUERY]
+```
+
+> "Putting longform data at top, queries at end improves quality by 30%"
+
+### Anti-Pattern
+
+**ERRADO:**
+```
+"Leia todos os 10 briefings + toda a research + todos os swipes e depois produza o criativo"
+```
+
+**CERTO:**
+```
+"Leia CONTEXT.md primeiro.
+Depois synthesis.md.
+Depois fase09-nuuppecc.md que vamos usar.
+Agora produza o criativo seguindo criativos-template.md."
+```
+
+---
+
+## CHECKLIST PRÉ-TAREFA
+
+### Higiene de Contexto
+
+- [ ] CONTEXT.md carregado (não briefing completo)
+- [ ] synthesis.md revisado
+- [ ] Contexto <60%
+- [ ] Próxima ação clara
+- [ ] Swipes necessários identificados (não carregados ainda)
+- [ ] Template relevante identificado
+
+### Estimativa de Tokens
+
+| Elemento | Tokens |
+|----------|--------|
+| Tier HOT | ~5K |
+| Arquivos WARM necessários | ~[X]K |
+| Template | ~2K |
+| Margem para output | ~10K |
+| **TOTAL ESTIMADO** | ~[X]K |
+
+**Cabe no contexto?** [ ] Sim [ ] Não → usar subagent
+
+---
+
+*Template v6.0 - Baseado em Context Management (Pesquisa 9)*
+*Criado em 2026-01-30*

package/framework/templates/copy-validation-checklist.md

@@ -0,0 +1,296 @@
+---
+template_name: "copy-validation-checklist"
+template_version: "1.0.0"
+template_type: "checklist"
+description: "Checklist de validacao de copy com 5 Lentes e thresholds por deliverable"
+phase: "production"
+output_format: "markdown"
+validation_tools: ["blind_critic", "emotional_stress_test", "black_validation"]
+---
+
+# Copy Validation Checklist v6.0
+
+> Checklist de validação baseado no CRITIC Framework.
+> Baseado em Pesquisa 6 (Copy Validation).
+
+---
+
+## QUANDO USAR
+
+Usar este checklist:
+- [ ] Antes de entregar qualquer copy final
+- [ ] Após produzir VSL, LP, criativos ou emails
+- [ ] Para validar MUP/MUS de briefings
+- [ ] Quando copy-critic retornar REVISE
+
+---
+
+## CRITIC FRAMEWORK
+
+### Processo de Validação
+
+```
+Output inicial
+      ↓
+Interação com tools (checklist, VOC, briefing)
+      ↓
+Avaliação de aspectos ESPECÍFICOS
+      ↓
+Revisão baseada no feedback
+      ↓
+Output melhorado
+```
+
+> **Regra:** Validar com CRITÉRIOS OBJETIVOS, não impressões subjetivas.
+
+---
+
+## 1. GATE DE LEITURA
+
+### Arquivos Obrigatórios Lidos?
+
+| Arquivo | Lido? | Elemento Extraído |
+|---------|-------|-------------------|
+| CONTEXT.md | [ ] | [elemento específico] |
+| synthesis.md | [ ] | [elemento específico] |
+| Fase 03 (Avatar) | [ ] | [sinestesia específica] |
+| Fase 05 (MUP) | [ ] | [nome do MUP] |
+| Fase 06 (MUS) | [ ] | [nome do MUS] |
+| Fase 07 (One Belief) | [ ] | [crença específica] |
+
+### Critério de Aprovação
+
+| Status | Condição |
+|--------|----------|
+| ✅ PASS | Elementos são ESPECÍFICOS (ex: "acordar 3AM sem fome") |
+| ❌ FAIL | Elementos são GENÉRICOS (ex: "li o arquivo") |
+
+---
+
+## 2. VALIDAÇÃO MUP
+
+### Critérios RMBC
+
+| Critério | Pergunta | ✓/✗ | Evidência |
+|----------|----------|-----|-----------|
+| **R**essonância | Avatar se identifica? | | [quote VOC] |
+| **M**emorabilidade | É fácil de lembrar? | | [nome proprietário] |
+| **B**elievability | É crível/plausível? | | [prova/lógica] |
+| **C**ompetitive | Diferente da concorrência? | | [comparação] |
+
+### Score RMBC
+
+| Score | Status |
+|-------|--------|
+| 4/4 | ✅ STAND |
+| 3/4 | 🟡 REVISE (menor) |
+| <3/4 | ❌ REFAZER |
+
+---
+
+## 3. VALIDAÇÃO MUS
+
+### Espelho MUP ↔ MUS
+
+| MUP (Problema) | MUS (Solução) | Espelha? |
+|----------------|---------------|----------|
+| [elemento 1] | [componente 1] | [ ] |
+| [elemento 2] | [componente 2] | [ ] |
+| [elemento 3] | [componente 3] | [ ] |
+
+### Critérios de Validação
+
+| Critério | ✓/✗ | Evidência |
+|----------|-----|-----------|
+| MUS resolve EXATAMENTE o MUP | | |
+| Cada componente tem função clara | | |
+| Nomenclatura é proprietária | | |
+| Complexidade adequada ao ticket | | |
+
+---
+
+## 4. VALIDAÇÃO VOC
+
+### Presença de Linguagem do Avatar
+
+| Elemento | Presente? | Exemplo |
+|----------|-----------|---------|
+| Sinestesia emocional | [ ] | "[sensação específica]" |
+| Expressões literais | [ ] | "[quote exata]" |
+| Palavras-gatilho do nicho | [ ] | "[palavras]" |
+| Tom de voz correto | [ ] | [autoridade/empático/casual] |
+
+### Triangulação
+
+| Quote | Fonte 1 | Fonte 2 | Fonte 3 | Peso |
+|-------|---------|---------|---------|------|
+| "[quote]" | [ ] | [ ] | [ ] | [1-3] |
+
+> Quotes trianguladas (3 fontes) = peso máximo.
+
+---
+
+## 5. VALIDAÇÃO ESTRUTURAL
+
+### Para VSL
+
+| Bloco | Presente? | MUP Aparece? | Linguagem Avatar? |
+|-------|-----------|--------------|-------------------|
+| Hook | [ ] | [ ] | [ ] |
+| Problema | [ ] | [ ] | [ ] |
+| Vilão | [ ] | [ ] | [ ] |
+| Mecanismo | [ ] | [ ] | [ ] |
+| Prova | [ ] | [ ] | [ ] |
+| Oferta | [ ] | [ ] | [ ] |
+| CTA | [ ] | [ ] | [ ] |
+
+### Para LP
+
+| Bloco | Presente? | Função Clara? |
+|-------|-----------|---------------|
+| Headline | [ ] | [ ] |
+| Problema | [ ] | [ ] |
+| Mecanismo | [ ] | [ ] |
+| Solução | [ ] | [ ] |
+| Prova Social | [ ] | [ ] |
+| Stack | [ ] | [ ] |
+| Garantia | [ ] | [ ] |
+| CTA (3x mínimo) | [ ] | [ ] |
+| FAQ | [ ] | [ ] |
+
+### Para Criativos
+
+| Elemento | Presente? | Critério |
+|----------|-----------|----------|
+| Hook (0-3s) | [ ] | Para scroll |
+| Loop aberto | [ ] | Cria curiosidade |
+| Body progressivo | [ ] | Desenvolve interesse |
+| CTA único | [ ] | Ação clara |
+| 3+ variações | [ ] | Para teste |
+
+### Para Emails
+
+| Elemento | Presente? | Critério |
+|----------|-----------|----------|
+| Subject < 50 chars | [ ] | Deliverability |
+| Preview complementar | [ ] | Não repete subject |
+| Gancho na primeira linha | [ ] | Open → Read |
+| CTA único por email | [ ] | Clareza |
+| P.S. com reforço | [ ] | Último argumento |
+
+---
+
+## 6. ANTI-PATTERNS (Rejeitar se presente)
+
+| Anti-Pattern | Detectado? | Correção |
+|--------------|------------|----------|
+| "A copy está boa" (impressão) | [ ] | Usar critérios RMBC |
+| "Li o arquivo" (genérico) | [ ] | Extrair elemento específico |
+| "Parece persuasivo" (vago) | [ ] | Verificar triangulação VOC |
+| Linguagem de marketer | [ ] | Reescrever com VOC |
+| MUP/MUS genéricos | [ ] | Renomear com nomenclatura proprietária |
+| Vilão interno (culpa prospect) | [ ] | Externalizar para vilão |
+
+---
+
+## 7. TWO-MODEL VALIDATION
+
+### Quando Usar
+
+| Situação | Two-Model Obrigatório? |
+|----------|------------------------|
+| MUP/MUS críticos | ✅ Sim |
+| One Belief | ✅ Sim |
+| VSL completa | ✅ Sim |
+| Criativo individual | ❌ Opcional |
+| Email individual | ❌ Opcional |
+
+### Configuração
+
+| Papel | Modelo |
+|-------|--------|
+| **Produção** | Sonnet/Opus |
+| **Crítica** | Opus (se Sonnet produziu) |
+
+> **Regra:** Modelo crítico deve ser DIFERENTE do produtor.
+
+---
+
+## 8. COURTROOM MODEL (Para MUP/MUS)
+
+### Papéis
+
+| Papel | Função | Resultado |
+|-------|--------|-----------|
+| **Advocate** | Defende a proposta | Lista de forças |
+| **Challenger** | Questiona pontos fracos | Lista de fraquezas |
+| **Judge** | Avalia argumentos | STAND ou REVISE |
+
+### Deliberação
+
+**Argumentos do Advocate:**
+1. [força 1]
+2. [força 2]
+3. [força 3]
+
+**Argumentos do Challenger:**
+1. [fraqueza 1]
+2. [fraqueza 2]
+3. [fraqueza 3]
+
+**Veredicto do Judge:**
+- [ ] STAND (forças superam fraquezas)
+- [ ] REVISE (fraquezas críticas identificadas)
+
+**Se REVISE, ações necessárias:**
+1. [correção 1]
+2. [correção 2]
+
+---
+
+## 9. SCORE FINAL
+
+### Cálculo
+
+| Seção | Peso | Score (0-10) | Ponderado |
+|-------|------|--------------|-----------|
+| Gate de Leitura | 20% | | |
+| Validação MUP | 20% | | |
+| Validação MUS | 15% | | |
+| Validação VOC | 20% | | |
+| Estrutural | 15% | | |
+| Anti-Patterns | 10% | | |
+| **TOTAL** | 100% | | **/10** |
+
+### Interpretação
+
+| Score | Status | Ação |
+|-------|--------|------|
+| 8-10 | ✅ STAND | Aprovado para entrega |
+| 6-7.9 | 🟡 REVISE | Correções menores necessárias |
+| <6 | ❌ REFAZER | Voltar ao briefing |
+
+---
+
+## 10. PRÓXIMOS PASSOS
+
+### Se STAND
+- [ ] Documentar validação no arquivo de produção
+- [ ] Marcar como pronto para implementação
+- [ ] Atualizar project_state.yaml
+
+### Se REVISE
+- [ ] Listar correções específicas
+- [ ] Aplicar correções
+- [ ] Rodar checklist novamente
+- [ ] Repetir até STAND
+
+### Se REFAZER
+- [ ] Voltar à fase HELIX correspondente
+- [ ] Revalidar MUP/MUS
+- [ ] Produzir novamente do zero
+
+---
+
+*Checklist v6.0 - Baseado em CRITIC Framework (Pesquisa 6)*
+*Criado em 2026-01-30*