@lucapimenta/copy-chief-black 1.0.0

package/framework/reference/debugging-hypothesis.md

@@ -0,0 +1,418 @@
+# Debugging by Hypothesis Protocol (v1.0)
+
+> Fonte: AIOS Framework (Alan Nicolas) — Principio #14 (10.000+ sessoes)
+> Adaptado: Copy Chief BLACK — Copywriting Direct Response
+> Principio: Nunca consertar sem confirmar a causa. 3 hipoteses antes de agir.
+> Criado: 2026-02-26
+
+---
+
+## REGRA CARDINAL
+
+> **Consertar sem diagnosticar = band-aid. Band-aid acumula. Acumulo = copy Frankenstein.**
+> SEMPRE: Observar → Hipotetizar → Verificar → ENTAO corrigir.
+
+---
+
+## PROTOCOLO DE 5 PASSOS
+
+### Passo 1: Declarar Observacao
+
+Formato obrigatorio:
+```
+OBSERVACAO:
+  Esperado: [o que deveria ser]
+  Obtido:   [o que foi]
+  Delta:    [diferenca especifica]
+```
+
+Exemplo:
+```
+OBSERVACAO:
+  Esperado: blind_critic score >= 8
+  Obtido:   6.5
+  Delta:    -1.5 pontos (18.75% abaixo)
+```
+
+### Passo 2: Gerar H0 + 3 Hipoteses (Ordenadas por Probabilidade)
+
+```
+HIPOTESES:
+
+H0 (meta-hipotese — verificar PRIMEIRO):
+   "O formato/voz/abordagem fundamental está errado?"
+   Verificar: Comparar OUTPUT vs EXPECTATIVA do usuario/briefing
+   - O deliverable pedido bate com o deliverable gerado?
+   - A voz/POV bate com o criativo/referencia?
+   - O formato (video vs texto vs email) está correto?
+   Se H0 = SIM: PARAR. Nao otimizar na direcao errada.
+                Voltar ao briefing/referencia, identificar gap fundamental.
+
+H1 (mais provavel — ~60%): [causa]
+   Verificar: [metodo especifico]
+   Se confirmada: [acao]
+
+H2 (alternativa — ~25%): [causa]
+   Verificar: [metodo especifico]
+   Se confirmada: [acao]
+
+H3 (menos provavel — ~15%): [causa]
+   Verificar: [metodo especifico]
+   Se confirmada: [acao]
+```
+
+> **REGRA H0:** Antes de H1-H3, perguntar: "Estou otimizando na direcao certa?"
+> Se a resposta for NAO, nenhuma iteracao de H1-H3 vai resolver.
+> Exemplo: Microlead com voz errada → aumentar DRE NAO resolve. Mudar voz resolve.
+
+### Passo 3: Verificar H1 Primeiro
+
+Testar a hipotese mais provavel. Se confirmada, corrigir. Se refutada, testar H2.
+
+### Passo 4: Corrigir com Base na Causa Confirmada
+
+NAO corrigir "tudo um pouco". Corrigir A CAUSA ESPECIFICA identificada.
+
+### Passo 5: Re-validar
+
+Rodar a mesma validacao que falhou para confirmar que a correcao resolveu.
+
+---
+
+## CENARIOS COMUNS DE COPY
+
+### Cenario 1: blind_critic Score Baixo (< 8)
+
+```
+OBSERVACAO:
+  Esperado: blind_critic >= 8
+  Obtido:   [score]
+  Delta:    [diferenca]
+
+HIPOTESES:
+
+H1 (~60%): Copy generica — falta especificidade (Logo Test falharia)
+   Verificar: Rodar Logo Test mental. Concorrente usaria sem alterar?
+   Se confirmada: Aplicar Specificity Score checklist (Face 1 + Face 2)
+                  Adicionar: nomes, numeros nao-redondos, cenas sensoriais
+
+H2 (~25%): Desalinhamento com briefing — copy nao reflete MUP/MUS
+   Verificar: Comparar copy com mecanismo-unico.yaml e fases HELIX 5-6
+   Se confirmada: Reescrever alinhando com MUP/MUS do briefing
+                  Garantir que Sexy Cause e Gimmick Name aparecem
+
+H3 (~15%): Estrutura fraca — falta de progressao persuasiva
+   Verificar: Mapear fluxo RMBC na copy. Ha R→M→B→C claro?
+   Se confirmada: Reestruturar seguindo template adequado
+                  Verificar proporcoes por secao
+```
+
+### Cenario 2: emotional_stress_test Score Baixo (< 8)
+
+```
+OBSERVACAO:
+  Esperado: EST genericidade >= 8
+  Obtido:   [score]
+  Delta:    [diferenca]
+
+HIPOTESES:
+
+H1 (~60%): DRE ausente ou superficial — emocao nao foi explorada
+   Verificar: Buscar DRE na copy. Esta no nivel 1-2 ou 4-5?
+   Se confirmada: Adicionar escalada emocional nivel 4-5
+                  Usar quotes VOC de alta intensidade
+                  Incluir cena vivida (Face 2 da Especificidade)
+
+H2 (~25%): Copy informativa, nao emocional — excesso de dados, falta de narrativa
+   Verificar: Contar ratio dados:narrativa. Mais de 70% dados?
+   Se confirmada: Adicionar cenas sensoriais entre blocos de dados
+                  "Mostrar, nao contar" — transformar afirmacoes em cenas
+
+H3 (~15%): Avatar errado — DRE nao corresponde ao publico real
+   Verificar: Comparar DRE usada com research/avatar/summary.md
+   Se confirmada: Reler VOC summary. Identificar DRE real do avatar.
+                  Reescrever com DRE correta e escalada adequada
+```
+
+### Cenario 3: BC Alto + EST Baixo (Pattern 37.5%)
+
+```
+OBSERVACAO:
+  Esperado: BC >= 8 E EST >= 8
+  Obtido:   BC = [alto] / EST = [baixo]
+  Delta:    Copy tecnicamente boa mas emocionalmente fraca
+  Nota:     Este pattern ocorre em ~37.5% dos casos
+
+HIPOTESES:
+
+H1 (~50%): Copy "correta" mas sem alma — seguiu template sem adicionar DRE
+   Verificar: Template esta preenchido corretamente? Sim.
+              Mas onde esta a EMOCAO? Buscar cenas vividas.
+   Se confirmada: Manter estrutura (BC ja e alto)
+                  ADICIONAR entre blocos:
+                  - Cena vivida do avatar (Face 2)
+                  - Quote VOC nivel 4-5
+                  - Escalada emocional progressiva
+                  NAO mexer na estrutura — so adicionar camada emocional
+
+H2 (~30%): Especificidade so Face 1 (dados) sem Face 2 (narrativa)
+   Verificar: Tem numeros especificos? SIM. Tem cenas vividas? NAO.
+   Se confirmada: Adicionar Face 2:
+                  - Cena de Filme (momento especifico)
+                  - Reacao de terceiros ("O medico olhou e disse...")
+                  - Detalhes sensoriais ("Acordou suando frio")
+
+H3 (~20%): DRE no nivel errado — usando medo nivel 2 quando avatar esta no nivel 4
+   Verificar: Qual nivel de DRE na copy? Qual nivel na VOC?
+   Se confirmada: Escalar DRE para nivel 4-5
+                  Nivel 4 (Relacional): "Parceira vai encontrar outro"
+                  Nivel 5 (Identidade): "Morrer sendo lembrado como..."
+```
+
+### Cenario 4: black_validation Falhando (< 8)
+
+```
+OBSERVACAO:
+  Esperado: black_validation >= 8
+  Obtido:   [score]
+  Delta:    [diferenca]
+  Nota:     black_validation avalia MULTIPLAS dimensoes
+
+HIPOTESES:
+
+H1 (~40%): Uma dimensao especifica puxou score para baixo
+   Verificar: Identificar quais dimensoes falharam no report da BV
+   Se confirmada: Tratar CADA dimensao que falhou individualmente:
+                  - Especificidade baixa → Specificity Score checklist
+                  - Emocao fraca → DRE + escalada
+                  - Estrutura ruim → Reestruturar RMBC
+                  - Credibilidade baixa → Adicionar provas
+
+H2 (~35%): Deliverable incompleto — faltam secoes ou blocos
+   Verificar: Comparar com checklist do deliverable (tool-usage-matrix.md)
+   Se confirmada: Completar blocos faltantes
+                  Cada bloco novo deve passar por blind_critic individual
+
+H3 (~25%): Problema cascateado — niveis inferiores fracos
+   Verificar: Decomposicao atomica (ref: atomic-design-copy.md):
+              Pagina → Organismo → Molecula → Atomo → Token
+   Se confirmada: Identificar QUAL nivel esta fraco
+                  Corrigir de baixo para cima (tokens primeiro)
+                  Re-compor niveis superiores
+```
+
+### Cenario 5: Logo Test Falhando
+
+```
+OBSERVACAO:
+  Esperado: Logo Test PASS (concorrente NAO usaria)
+  Obtido:   Logo Test FAIL (concorrente USARIA sem alterar)
+  Delta:    Copy nao e proprietaria
+
+HIPOTESES:
+
+H1 (~50%): Falta de Mecanismo Unico na copy — MUP/MUS nao aparecem
+   Verificar: Buscar Sexy Cause, Gimmick Name, Authority Hook na copy
+   Se confirmada: Inserir elementos do mecanismo-unico.yaml:
+                  - Sexy Cause no problema
+                  - Gimmick Name na solucao
+                  - Authority Hook na credibilidade
+                  - Origin Story na narrativa
+
+H2 (~30%): Cliches do nicho — usando linguagem saturada
+   Verificar: Checar contra lista de cliches proibidos (anti-homogeneization.md)
+   Se confirmada: Substituir CADA cliche por linguagem proprietaria
+                  Usar vocabulario da VOC (nao inventar)
+                  Verificar palavras banidas
+
+H3 (~20%): Falta de dados especificos — copy poderia ser de qualquer oferta
+   Verificar: Specificity Score (Face 1: Dados)
+              Contar: nomes, numeros, localizacoes, datas
+   Se confirmada: Adicionar pelo menos:
+                  - 3 numeros nao-redondos
+                  - 2 nomes proprios
+                  - 1 localizacao especifica
+                  - 1 data precisa
+```
+
+### Cenario 6: Specificity Score < 8
+
+```
+OBSERVACAO:
+  Esperado: Specificity Score >= 8
+  Obtido:   [score]
+  Delta:    [diferenca]
+
+HIPOTESES:
+
+H1 (~45%): Face 1 (Dados) insuficiente — poucos elementos especificos
+   Verificar: Checar 8 itens da Face 1:
+              Nome, Idade, Localizacao, Profissao, Numero, Data, Resultado, Sensorial
+   Se confirmada: Score Face 1 deve ser >= 6/8
+                  Adicionar itens faltantes usando VOC + Research
+
+H2 (~35%): Face 2 (Narrativa) insuficiente — falta cena vivida
+   Verificar: Checar 5 dimensoes da Face 2:
+              Dados Precisos, Cena Vivida, Reacao Terceiros, Contexto Inesperado, Detalhes Sensoriais
+   Se confirmada: Score Face 2 deve ser >= 3/5
+                  Adicionar pelo menos:
+                  - 1 cena de filme (momento especifico)
+                  - 1 reacao de terceiro ("O medico disse...")
+                  - 1 detalhe sensorial ("Suor frio as 3h")
+
+H3 (~20%): AMBAS as Faces fracas — copy superficial em todos os aspectos
+   Verificar: Se Face 1 < 4 E Face 2 < 2
+   Se confirmada: Copy precisa de rewrite significativo, nao ajuste
+                  Voltar a VOC summary, extrair tokens novos
+                  Reconstruir de baixo para cima (Atomic Design)
+```
+
+---
+
+## REGRAS DE DEBUG
+
+### Regra 1: Nunca Consertar Sem Diagnosticar
+
+| Errado | Correto |
+|--------|---------|
+| Score 6.5 → "Vou melhorar a copy" | Score 6.5 → "H1: especificidade. Verifico com Logo Test." |
+| "Ta fraco" → reescreve tudo | "Ta fraco" → H1: DRE? H2: Narrativa? H3: Avatar? |
+| "Nao passou" → tenta de novo | "Nao passou" → Qual dimensao? Qual hipotese? |
+
+### Regra 2: Uma Variavel por Vez
+
+Ao testar correcao, mudar UMA coisa:
+- Se H1 e especificidade → so adicionar especificidade, nao mudar estrutura
+- Se H2 e DRE → so adicionar emocao, nao mudar dados
+- Se H3 e estrutura → so reestruturar, nao reescrever conteudo
+
+**Por que:** Mudar tudo de uma vez impede saber O QUE resolveu.
+
+### Regra 3: Re-validar Apos Correcao
+
+SEMPRE rodar a mesma ferramenta de validacao apos correcao:
+
+| Falha Original | Correcao | Re-validacao |
+|----------------|----------|-------------|
+| blind_critic < 8 | [correcao aplicada] | blind_critic novamente |
+| EST < 8 | [correcao aplicada] | EST novamente |
+| black_validation < 8 | [correcao aplicada] | black_validation novamente |
+| Logo Test FAIL | [correcao aplicada] | Logo Test novamente |
+
+### Regra 4: Documentar Causa Raiz
+
+Apos resolver, registrar em findings.md:
+
+```markdown
+## Debug: [Data] - [Deliverable]
+
+### Problema
+[Observacao: esperado vs obtido]
+
+### Hipotese Confirmada
+[Qual das 3 hipoteses era correta]
+
+### Correcao Aplicada
+[O que foi feito]
+
+### Resultado
+[Score apos correcao]
+
+### Aprendizado
+[O que fazer diferente na proxima vez para evitar]
+```
+
+### Regra 5: Decomposicao Atomica para Falhas Persistentes
+
+Se a correcao NAO resolveu apos 2 tentativas:
+
+```
+FALHA PERSISTENTE
+        |
+        v
+Decomposicao Atomica (ref: atomic-design-copy.md):
+
+Nivel 6 (Pagina) falhou
+  → Qual Nivel 5 (Template) esta errado?
+    → Qual Nivel 4 (Organismo) esta fraco?
+      → Qual Nivel 3 (Molecula) nao funciona?
+        → Qual Nivel 2 (Atomo) esta generico?
+          → Qual Nivel 1 (Token) esta inventado?
+```
+
+**A causa raiz de falhas persistentes quase sempre esta nos niveis 1-2 (tokens e atomos).**
+
+---
+
+## PADROES RECORRENTES
+
+### Padrao A: "Copy Boa mas Generica"
+
+| Indicador | blind_critic >= 8, EST < 8, Logo Test FAIL |
+|-----------|---------------------------------------------|
+| Causa Usual | Seguiu template sem personalizar. Falta Face 2 da Especificidade. |
+| Fix | Adicionar cenas vividas, DRE nivel 4-5, linguagem VOC real |
+
+### Padrao B: "Copy Emocional mas Desestruturada"
+
+| Indicador | blind_critic < 8, EST >= 8 |
+|-----------|----------------------------|
+| Causa Usual | Escreveu "do coracao" sem seguir RMBC. Emocao sem direcionamento. |
+| Fix | Reestruturar seguindo template. Manter emocao, adicionar progressao logica. |
+
+### Padrao C: "Copy Perfeita que Nao Converte"
+
+| Indicador | Todos os scores altos, mas nao gera acao |
+|-----------|------------------------------------------|
+| Causa Usual | Falta CTA forte, falta urgencia, falta reversao de risco. |
+| Fix | Verificar bloco de oferta, garantia, urgencia. Testar CTAs diferentes. |
+
+### Padrao D: "Score Oscilante" (Sobe e Desce)
+
+| Indicador | Score varia +/- 2 pontos entre revisoes |
+|-----------|------------------------------------------|
+| Causa Usual | Correcao de uma dimensao prejudica outra. Mudando muitas variaveis. |
+| Fix | Uma variavel por vez (Regra 2). Identificar trade-off entre dimensoes. |
+
+### Padrao E: "Funciona em Um Deliverable, Falha em Outro"
+
+| Indicador | VSL score alto, LP score baixo (ou vice-versa) |
+|-----------|--------------------------------------------------|
+| Causa Usual | Template diferente exige adaptacao, nao copy-paste. |
+| Fix | Recompor usando Atomic Design. Atomos reutilizaveis, organismos nao. |
+
+---
+
+## INTEGRACAO COM OUTROS PROTOCOLOS
+
+| Situacao | Protocolo Complementar |
+|----------|------------------------|
+| Score falhou pela 1a vez | Este protocolo (3 hipoteses) |
+| Score falhou pela 3a vez | BSSF (5 solucoes estruturais). Ref: bssf-decision.md |
+| 3 scores consecutivos ±0.3 | Reflection Agent (LOOP). Ref: agents/reflection/AGENT.md |
+| Copy sem keywords MUP/MUS | Reflection Agent (DRIFT). Ref: agents/reflection/AGENT.md |
+| Nao sabe onde o problema esta | Exploracao Estruturada Pass 3. Ref: structured-exploration.md |
+| Problema esta nos tokens | VOC Research Protocol. Ref: voc-research.md |
+| Problema esta na estrutura | Atomic Design decomposicao. Ref: atomic-design-copy.md |
+| Usuario disse "generico" | Signal Translation. Ref: signal-translation.md |
+
+---
+
+## CHECKLIST RAPIDO
+
+Antes de corrigir qualquer falha de score:
+
+- [ ] Declarei OBSERVACAO (esperado vs obtido)?
+- [ ] Gerei 3 hipoteses ordenadas por probabilidade?
+- [ ] Verifiquei H1 antes de tentar H2?
+- [ ] Correcao muda UMA variavel?
+- [ ] Re-validacao esta planejada?
+- [ ] Causa raiz sera documentada em findings.md?
+
+---
+
+*v1.0 — Adaptado de AIOS Framework (Alan Nicolas, Principio #14)*
+*Contexto: Copy Chief BLACK — Copywriting Direct Response*
+*6 cenarios comuns + 5 padroes recorrentes*
+*Ref: atomic-design-copy.md (decomposicao), bssf-decision.md (falhas persistentes)*
+*Criado: 2026-02-26*

package/framework/reference/dual-doc-taxonomy.md

@@ -0,0 +1,62 @@
+# Dual Documentation Taxonomy (v1.0)
+
+> Sprint: S8 — Dual Documentation
+> Principio: Dois publicos, dois formatos. Agent docs ≠ Human docs.
+> Criado: 2026-03-01
+
+---
+
+## REGRA CARDINAL
+
+> **Docs para agentes (rules/) ≠ Docs para humanos (GUIA-LUCA.md).**
+> Agentes precisam de precisao, thresholds, schemas.
+> Humanos precisam de clareza, exemplos, "o que fazer agora".
+> Misturar os dois = nenhum dos dois funciona bem.
+
+---
+
+## Taxonomia
+
+| Tipo | Publico | Localizacao | Formato | Exemplos |
+|------|---------|-------------|---------|----------|
+| **AGENT-DOC** | Claude/Hooks/Scripts | `~/.claude/rules/`, `~/.claude/agents/` | Tecnico: YAML frontmatter, thresholds, schemas, decision trees | tool-usage-matrix.md, agent-personas.md, mecanismo-unico.md |
+| **HUMAN-DOC** | Luca (operador humano) | `~/copywriting-ecosystem/GUIA-LUCA.md`, `~/.claude/COPY-DOCS-INDEX.md` | Operacional: passo-a-passo, exemplos concretos, "quando usar X" | GUIA-LUCA.md, COPY-DOCS-INDEX.md |
+| **SHARED-DOC** | Ambos | `{offer}/CONTEXT.md`, `{offer}/mecanismo-unico.yaml` | Dados: fonte de verdade factual, sem instrucoes de processo | CONTEXT.md, synthesis.md, mecanismo-unico.yaml |
+
+---
+
+## Regras
+
+### AGENT-DOC
+- Contém: thresholds, schemas, decision trees, tool lists, constraints
+- NÃO contém: explicações do "porquê", tutoriais, screenshots
+- Formato: Markdown com YAML frontmatter, tabelas, code blocks
+- Tamanho: O mínimo necessário para mudar comportamento do agente
+
+### HUMAN-DOC
+- Contém: passo-a-passo, exemplos concretos, troubleshooting, "quando usar X"
+- NÃO contém: schemas internos, decision trees para hooks, thresholds detalhados
+- Formato: Markdown conversacional, bullet points, exemplos reais
+- Tamanho: O mínimo necessário para Luca operar sem dúvida
+
+### SHARED-DOC
+- Contém: dados factuais (avatar, MUP, MUS, VOC quotes, scores)
+- NÃO contém: instruções de processo para nenhum dos dois públicos
+- Formato: YAML (dados) ou Markdown (narrativo factual)
+- Tamanho: Determinado pelo conteúdo, não por restrição artificial
+
+---
+
+## Anti-Patterns
+
+| Anti-Pattern | Problema | Correto |
+|--------------|----------|---------|
+| Tutorial em rules/ | Agente não precisa de tutorial | Mover para GUIA-LUCA.md |
+| Thresholds em GUIA-LUCA.md | Humano não precisa saber que BC >= 8 | Manter em tool-usage-matrix.md |
+| CONTEXT.md com instrucoes | Mistura dados com processo | CONTEXT.md = dados. Process = rules/ |
+| Duplicação entre doc types | Drift inevitável | Single source → referência cruzada |
+
+---
+
+*v1.0 — Sprint S8*
+*Criado: 2026-03-01*

package/framework/reference/ecosystem.md

@@ -0,0 +1,219 @@
+---
+phases: [ON_DEMAND]
+priority: LOW
+tokens: ~1800
+---
+
+# Ecosystem Rules (v6.5)
+
+> Regras de design sistêmico, higiene e estrutura do ecossistema.
+> Extraído de CLAUDE.md para modularização.
+> **v6.5:** MCP Enforcement + Template Enforcement + Anti-Bypass
+
+---
+
+## 🔧 Contexto de Uso (v6.4)
+
+> **Este ecossistema opera via Subscription (Claude Max 20x), NAO via API.**
+> CLI (producao primaria) + Web (colaboracao + RAG). Workflow: CLI -> /sync-project -> Web -> Download -> CLI.
+
+---
+
+## REGRA CARDINAL: Design Sistêmico
+
+> **"Todo update deve ser sistêmico, nunca depender de memórias. Todo o ecossistema deve ser sistêmico."**
+
+### Princípios MACRO (OBRIGATÓRIO)
+
+| Padrão | MACRO (CORRETO) | MICRO (PROIBIDO) |
+|--------|-----------------|------------------|
+| **Componentes** | Auto-descoberta via `find`/`glob` | Listas hardcoded de nomes |
+| **Versão** | Single source: `~/.claude/.version` | VERSION em múltiplos arquivos |
+| **Ofertas** | Detectar por estrutura (`task_plan.md`) | Lista fixa de ofertas esperadas |
+| **Configuração** | Ler de arquivo central | Valores inline no código |
+| **Exclusões** | Padrões (`.git/`, `__pycache__/`) | Nomes específicos de arquivos |
+
+### Regra de Ouro: Self-Discovery
+
+```bash
+# MACRO - Descobre automaticamente
+SKILLS=$(find ~/.claude/skills -maxdepth 1 -type d | wc -l)
+OFFERS=$(find ~/copywriting-ecosystem -name "task_plan.md" -type f | wc -l)
+
+# MICRO - Depende de memória/lista (PROIBIDO)
+SKILLS=("skill1" "skill2" "skill3")
+EXPECTED_OFFERS=("hacker" "gabaritando")
+```
+
+### Por que isso importa?
+
+1. **Zero Manutenção**: Novo componente = funciona automaticamente
+2. **Zero Drift**: Não há como ficar desatualizado
+3. **Zero Memória**: Sistema é auto-descritivo
+4. **Escalabilidade**: 10 ou 100 componentes = mesmo código
+
+**Verificacao Anti-MICRO:** Se mudanca quebra com novo componente, exige editar multiplos arquivos, ou tem listas hardcoded -> REFATORAR para MACRO primeiro.
+
+### Single Sources of Truth
+
+| Dado | Fonte Autoritativa |
+|------|-------------------|
+| Versão do ecossistema | `~/.claude/.version` |
+| Skills existentes | `~/.claude/skills/*/` (auto-discover) |
+| Commands existentes | `~/.claude/commands/*.md` (auto-discover) |
+| Ofertas ativas | `*/task_plan.md` exists (auto-discover) |
+| Tipos de research | `~/.claude/.version` → `RESEARCH_TYPES=` |
+| Fases HELIX | `~/.claude/.version` → `HELIX_PHASES=` |
+| **Estado da oferta** | `project_state.yaml` → sincroniza outros |
+
+### Enforcement Automatico de Tracking
+
+`project_state.yaml` (fonte de verdade) -> `python scripts/sync-tracking.py` -> atualiza task_plan.md, progress.md, ecosystem-status.md.
+
+**NUNCA** atualizar tracking manualmente. Atualizar `project_state.yaml` e rodar sync.
+
+---
+
+## Ecosystem Hygiene
+
+| Regra | Descricao |
+|-------|-----------|
+| #1 Diretorio | SEMPRE `cd ~/copywriting-ecosystem && claude`. Nunca abrir de subdiretorio. |
+| #2 ZIP | Extrair fora do ecossistema (`~/Desktop`). NUNCA dentro. |
+| #3 Installer | Manter apenas 1 versao no Desktop. |
+| #4 Hierarquia | `~/.claude/CLAUDE.md` (global) > `~/copywriting-ecosystem/CLAUDE.md` (projeto). Nunca CLAUDE.md por oferta. |
+
+**Checklist Semanal:** Sem duplicados aninhados, git commit, task_plan.md atualizado.
+**Guia Completo:** `~/.claude/GUIA-USO-ECOSSISTEMA.md`
+
+---
+
+## Estrutura de Diretórios
+
+### Hierarquia Niche-First
+```
+~/copywriting-ecosystem/{nicho}/{oferta}/
+```
+
+### Exemplo
+```
+~/copywriting-ecosystem/
+├── concursos/                           ← NICHO
+│   ├── biblioteca_nicho_*.md            ← VOC consolidada do nicho
+│   ├── gabaritando-lei-seca/            ← OFERTA
+│   └── hacker/                          ← OFERTA
+├── saude/                               ← NICHO (futuro)
+└── relacionamento/                      ← NICHO (futuro)
+```
+
+### Dentro de Cada Oferta
+- Research: `research/{type}/` (voc, competitors, mechanism, avatar)
+- Briefing: `briefings/phases/`
+- Production: `production/` (vsl, landing-page, creatives, emails)
+
+### Biblioteca de Nicho
+Arquivo `biblioteca_nicho_{nicho}_CONSOLIDADA.md` na raiz do nicho:
+- VOC consolidada de todas ofertas do nicho
+- Avatar unificado com variações
+- Linguagem e compliance do nicho
+- Ângulos validados cross-oferta
+
+**Uso:** Carregar biblioteca do nicho ANTES de pesquisa específica.
+
+---
+
+## Output Rules
+
+- Raw data → `raw/` (never load to context)
+- Processed → `processed/` (load when needed)
+- Summary → `summary.md` (always load first, ≤500 tokens)
+- Synthesis → `synthesis.md` (≤15K tokens)
+
+---
+
+## Parallel Execution
+
+> Ref: tool-usage-matrix.md § Subagent Tool Access para tipos de subagent e acesso a MCPs.
+
+Use `general-purpose` subagents para tasks que precisam de MCPs. claude-squad para paralelizacao real (tmux + git worktrees).
+
+**Parallel:** Time-critical, multiplas ofertas. **Sequential:** Sem pressa, budget concerns.
+
+---
+
+## Limites Tecnicos do Claude
+
+| Limite | Valor |
+|--------|-------|
+| Leitura por ficheiro | 25.000 tokens (hardcoded) |
+| Output MCP (warning) | 10.000 tokens |
+| Context window | 200K tokens (partilhada) |
+| RAG (Pro/Max/Team) | ~2M tokens (10x) |
+
+> **Regra:** Markdown mais eficiente. Arquivos <100 paginas. `/compact` a 60%.
+
+---
+
+## Context Capacity Management
+
+> Ref: context-management.md para regras completas (3-Tier, Regra 60%, Progressive Loading, Memory Protocol).
+
+**Resumo:** `/compact` a 60%. HOT/WARM/COLD tiers. NUNCA carregar tudo de uma vez.
+
+---
+
+## 🚨 MCP Enforcement (v6.5)
+
+> Ref: tool-usage-matrix.md para matriz completa de ferramentas por fase e enforcement automatico.
+
+**Resumo:** `validate_gate` ANTES de declarar fase. `black_validation` ANTES de entregar. `blind_critic` + `emotional_stress_test` APOS produzir.
+
+---
+
+## 📋 Template Enforcement (v6.5)
+
+> Templates em `~/.claude/templates/`. Todo deliverable DEVE usar o template correspondente.
+
+**Evidencia Obrigatoria** — Todo deliverable DEVE ter no header:
+
+```markdown
+> **Template usado:** [nome-do-template.md]
+> **Versao:** [data ou versao do template]
+```
+
+**SE header ausente -> Deliverable incompleto -> Refazer com template.**
+
+| Deliverable | Template |
+|-------------|----------|
+| VOC Extraction | `voc-viral-extraction-template.md` |
+| Trends Analysis | `trends-analysis-template.md` |
+| Ads Library Spy | `ads-library-spy-template.md` |
+| Research Checklist | `research-deliverables-checklist.md` |
+| MUP/MUS Discovery | `mup-mus-discovery.md` |
+| VSL Structure | `rmbc-ii-workflow.md` |
+| Criativos | `criativos-template.md` |
+| Landing Page | `landing-page-template.md` |
+
+---
+
+## TTT Speedup Pattern (Pesquisa 9)
+
+Para tarefas longas, dividir é mais eficiente:
+
+| Abordagem | Speedup |
+|-----------|---------|
+| Contexto monolítico | 1x (baseline) |
+| Chunked processing | 2.7x - 35x |
+
+**Aplicação para Copy:**
+- VSL: Dividir em hook, problema, solução, CTA
+- LP: Bloco a bloco, não página inteira
+- Criativos: Um por vez com contexto focado
+
+---
+
+*v7.0 - Dedup: MCP Enforcement e Context Management replaced with refs*
+*Ref: tool-usage-matrix.md para matriz completa de ferramentas por fase*
+*Ref: voc-research.md para regras detalhadas de Research*
+*Hooks: tool-enforcement-gate.ts, post-production-validate.ts, pre-compact-save.sh*
+*Atualizado: 2026-02-23*