@lucapimenta/copy-chief-black 1.0.0

package/framework/reference/signal-translation.md

@@ -0,0 +1,256 @@
+# Signal Translation & Irritation Prevention (v2.0)
+
+> Fonte: AIOS Framework (Alan Nicolas) — Principios #21 e #22 (10.000+ sessoes)
+> Adaptado: Copy Chief BLACK — Copywriting Direct Response
+> Criado: 2026-02-26
+> Substitui: signal-translation.md v1.0
+
+---
+
+## REGRA CARDINAL
+
+> **O usuario diz uma coisa, significa outra. Traduzir ANTES de agir.**
+> Interpretar literalmente = erro mais comum. Mapear sinal → significado → acao.
+
+---
+
+## PARTE I: TABELA DE TRADUCAO DE SINAIS (20 Sinais)
+
+### Sinais Gerais de Workflow
+
+| # | Sinal do Usuario | Significado Real | Acao Correta |
+|---|-------------------|-----------------|--------------|
+| 1 | Repetiu instrucao 2x | Claude nao entendeu ou nao obedeceu | PARE. Releia pedido ORIGINAL. Faca EXATAMENTE o que foi pedido. NAO justifique. (Regra 2x) |
+| 2 | "Quando fica pronto?" | Impaciencia — nao ve progresso | Reportar progresso com % claro: "3/6 capitulos prontos, proximo: Capitulo 4 (Solucao)" |
+| 3 | "Ja temos isso" | Nao verificou existente antes de criar | Rodar Discovery (ls, find, glob) ANTES de qualquer criacao. Apresentar findings. |
+| 4 | Silencio apos entrega | Avaliando OU insatisfeito | Perguntar: "Atende o objetivo ou quer ajuste em algum ponto?" |
+| 5 | "OK" (seco, sem elaboracao) | Aprovacao minima, nao entusiasmado | Seguir para proxima etapa. NAO interpretar como "excelente". |
+| 6 | "Perfeito!" (entusiastico) | Genuinamente satisfeito | Registrar o que funcionou para replicar o padrao. |
+| 7 | "Continua" ou "Segue" | Quer que avance sem pausa | NAO parar para explicar. NAO pedir confirmacao. Executar proximo passo. |
+| 8 | "Para" ou "Espera" | Algo errado, precisa repensar | PARAR imediatamente. Aguardar nova instrucao. NAO continuar "so mais um passo". |
+| 9 | Mandou link/arquivo | Quer que LEIA | Ler ANTES de responder. NAO pedir resumo do que contem. |
+| 10 | Tom mais curto | Irritacao crescendo | Simplificar. Ir direto ao ponto. Zero justificativa. |
+
+### Sinais Especificos de Copy
+
+| # | Sinal do Usuario | Significado Real | Acao Correta |
+|---|-------------------|-----------------|--------------|
+| 11 | "Ta generico" | Logo Test FALHOU. Concorrente usaria. | Aplicar Specificity Score >= 8 (Face 1: Dados + Face 2: Narrativa). Ref: anti-homogeneization.md |
+| 12 | "Fraco" | Impacto emocional insuficiente | Verificar: DRE presente? Escalada emocional nivel 4-5? Cena vivida? EST score? |
+| 13 | "Nao e isso" | Desalinhamento com briefing/visao | PARAR producao. Reler CONTEXT.md + synthesis.md. Perguntar: "O que especificamente nao esta alinhado?" |
+| 14 | "Pode melhorar?" | Quer revisao, nao rewrite | Rodar layered_review (3 camadas). NAO refazer do zero. |
+| 15 | "Mais agressivo" | Quer escalada emocional maior | Subir nivel de DRE (4→5). Adicionar urgencia. Amplificar consequencias. |
+| 16 | "Mais suave" | Tom esta assustando, nao persuadindo | Reduzir nivel de DRE (5→3). Manter emocao, reduzir intensidade. |
+| 17 | "Parece IA" | IA-speak detectado. Palavras banidas usadas. | Checar lista de palavras banidas (anti-homogeneization.md). Substituir CADA uma por linguagem VOC. |
+| 18 | "Falta prova" | Afirmacoes sem evidencia | Adicionar: numeros especificos, nomes, estudo, depoimento, mecanismo cientifico. |
+| 19 | "Ta comprido" | Copy arrastada, sem edicao | Cortar: repeticoes, transicoes fracas, paragrafos que nao avancem persuasao. |
+| 20 | "Usa VOC" | Copy nao soa como avatar | Voltar a research/voc/summary.md. Extrair expressoes EXATAS. Substituir linguagem propria por linguagem do avatar. |
+
+### Sinais de Score/Validacao
+
+| # | Sinal | Significado | Acao |
+|---|-------|-------------|------|
+| 21 | blind_critic retornou < 8 | Copy nao atingiu threshold | Debugging por Hipotese (ref: debugging-hypothesis.md). NAO refazer as cegas. |
+| 22 | EST retornou < 8 | Copy generica ou desconectada emocionalmente | Verificar DRE, especificidade, Logo Test. Tratar como "ta generico". |
+| 23 | BC alto + EST baixo | Copy tecnicamente boa mas emocionalmente fraca | Pattern 37.5% — adicionar DRE visceral, cenas vividas, escalada nivel 4-5. |
+| 24 | black_validation < 8 | Deliverable completo abaixo do padrao | Identificar QUAIS dimensoes falharam. Tratar cada uma individualmente. |
+
+---
+
+## PARTE II: GATILHOS DE IRRITACAO (12 Triggers)
+
+### Tabela de Prevencao
+
+| # | Gatilho | Causa Raiz | Prevencao | Se Ja Aconteceu |
+|---|---------|-----------|-----------|-----------------|
+| 1 | **Copy generica** | Nao usou VOC, nao aplicou anti-homogeneizacao | Logo Test + Specificity >= 8 ANTES de entregar | Refazer com quotes VOC + Specificity checklist |
+| 2 | **Score baixo sem explicacao** | Entregou numero sem contexto | Sempre: "Score X porque [dimensao Y falhou]" | Rodar Debugging por Hipotese, explicar causa |
+| 3 | **Producao sem VOC** | Pulou research, produziu do nada | Hooks de enforcement bloqueiam automaticamente | Pausar producao, voltar a research |
+| 4 | **Deliverable incompleto** | Nao seguiu checklist do tipo | Checklist obrigatorio por deliverable (tool-usage-matrix.md) | Completar itens faltantes |
+| 5 | **Feature nao solicitada** | Over-engineering, "bonus" | Regra #12 AIOS (So o que Foi Pedido) | Remover feature extra, pedir desculpa pela tangente |
+| 6 | **Copy no terminal** | Output em chat em vez de arquivo | SEMPRE Write tool para production/ | Mover para arquivo imediatamente |
+| 7 | **Explicacao excessiva** | Claude justifica em vez de executar | Executar primeiro, explicar BREVEMENTE depois | Cortar explicacao, mostrar resultado |
+| 8 | **Pergunta ja respondida** | Nao leu contexto disponivel | Ler CONTEXT.md + synthesis.md ANTES de perguntar | Pedir desculpa, ler agora |
+| 9 | **Tangente academica** | Explicou teoria em vez de produzir | Producao > Teoria. Fazer, nao ensinar. | Voltar ao deliverable pedido |
+| 10 | **Repetir erro corrigido** | Nao aprendeu com feedback anterior | Registrar correcao em findings.md | Reler feedback anterior, aplicar |
+| 11 | **Ignorar restricao explicita** | Nao seguiu regra do CLAUDE.md ou rules/ | Rules sao OBRIGATORIAS, nao sugestoes | Aplicar restricao imediatamente |
+| 12 | **"Quer que eu continue?"** | Pedir confirmacao desnecessaria apos aprovacao | Se usuario aprovou, CONTINUAR silenciosamente | Continuar executando |
+
+---
+
+## PARTE III: ARVORE DE DECISAO PARA SINAIS AMBIGUOS
+
+### Quando o Sinal Nao e Claro
+
+```
+SINAL AMBIGUO RECEBIDO
+        |
+        v
+1. E a SEGUNDA vez que o usuario diz algo similar?
+   |
+   SIM → Regra 2x: PARE, faca EXATAMENTE o pedido
+   |
+   NAO → Continua ↓
+        |
+        v
+2. O sinal e sobre QUALIDADE da copy?
+   |
+   SIM → Diagnosticar:
+   |     - "generico/fraco/IA" → anti-homogeneizacao + VOC
+   |     - "nao e isso" → reler briefing
+   |     - "pode melhorar" → layered_review
+   |
+   NAO → Continua ↓
+        |
+        v
+3. O sinal e sobre PROCESSO/VELOCIDADE?
+   |
+   SIM → Diagnosticar:
+   |     - "quando fica pronto" → reportar % progresso
+   |     - "continua/segue" → executar sem pausar
+   |     - "para/espera" → parar imediatamente
+   |
+   NAO → Continua ↓
+        |
+        v
+4. O sinal e sobre ESCOPO?
+   |
+   SIM → Diagnosticar:
+   |     - "tambem preciso de X" → confirmar escopo expandido
+   |     - "so quero X" → reduzir escopo
+   |     - "ja temos isso" → verificar existente
+   |
+   NAO → Continua ↓
+        |
+        v
+5. GENUINAMENTE AMBIGUO
+   → Perguntar UMA pergunta especifica:
+     "Entendi [interpretacao]. E isso ou prefere [alternativa]?"
+   → NAO fazer 3 perguntas. UMA.
+```
+
+### Regras para Perguntar
+
+| Situacao | Perguntar? | Como |
+|----------|-----------|------|
+| Sinal claro | NAO — executar | - |
+| Sinal ambiguo, baixo risco | NAO — melhor interpretacao | Agir + "Se nao for isso, me diga" |
+| Sinal ambiguo, alto risco | SIM — 1 pergunta | "Entendi X. Confirma?" |
+| Sinal contradiz briefing | SIM — confirmar intencao | "Briefing diz Y, mas voce pediu X. Qual prevalece?" |
+
+**Anti-Pattern:** Fazer 3+ perguntas antes de agir = paralisia. O usuario quer RESULTADO, nao questionario.
+
+---
+
+## PARTE IV: PADROES DE FEEDBACK EM SESSAO
+
+### Feedback Loop Positivo (Sinal: Tudo Indo Bem)
+
+```
+Usuario aprova deliverable
+        |
+        v
+Registrar O QUE funcionou:
+- Qual angulo?
+- Qual nivel de DRE?
+- Qual estrutura?
+- Quanta VOC usou?
+        |
+        v
+Replicar padrao nos proximos deliverables
+```
+
+### Feedback Loop Negativo (Sinal: Algo Errado)
+
+```
+Usuario rejeita ou critica
+        |
+        v
+1. NAO defender a copy
+2. NAO explicar por que fez assim
+3. PERGUNTAR: "O que especificamente nao funciona?"
+4. OUVIR a resposta (ler com atencao)
+5. CONFIRMAR entendimento: "Entendi: [problema]"
+6. CORRIGIR seguindo o feedback exato
+7. VALIDAR: "Isso atende?"
+```
+
+**NUNCA defender copy rejeitada. O usuario tem razao. Ajustar.**
+
+### Escalada de Insatisfacao (3 Niveis)
+
+| Nivel | Sinal | Acao |
+|-------|-------|------|
+| 1 — Leve | "Pode melhorar" | layered_review, ajustes pontuais |
+| 2 — Moderado | "Nao e isso", "Ta generico" | Reler briefing, refazer com constraints |
+| 3 — Severo | Repetiu 2x, tom irritado | PARE TUDO. Regra 2x. Faca exato. |
+
+**Nunca deixar chegar no nivel 3. Resolver no nivel 1.**
+
+---
+
+## PARTE V: SINAIS CONTEXTUAIS (Copy-Specific)
+
+### Sinais de Nicho
+
+| Nicho | Sinal Comum | Significado |
+|-------|-------------|-------------|
+| Concursos | "Parece cursinho" | Copy generica, sem Mecanismo Unico |
+| Saude | "Parece propaganda" | Falta credibilidade, excesso de hype |
+| Relacionamento | "Ta piegas" | Emocao sem substancia, cliche relacional |
+| Riqueza | "Ta golpista" | Promessa excessiva sem prova |
+
+### Sinais por Fase
+
+| Fase | Sinal | Significado |
+|------|-------|-------------|
+| Research | "Falta profundidade" | VOC superficial, precisa mais plataformas |
+| Briefing | "Nao convence" | MUP fraco, Sexy Cause nao intriga |
+| Production | "Nao compra" | Copy nao move para acao, falta urgencia |
+| Review | "Quase" | 1-2 ajustes pontuais, nao rewrite |
+
+---
+
+## PARTE VI: REGRA DO 2x (Expandida)
+
+> **Se o usuario repetiu algo 2 vezes → PARE e faca EXATAMENTE o que pediu.**
+
+### Por que Acontece
+
+| Causa da Repeticao | Como Evitar |
+|--------------------|----|
+| Claude interpretou "criativamente" | Ler LITERAL, nao "melhorar" o pedido |
+| Claude adicionou coisas nao pedidas | Regra #12 (So o que Foi Pedido) |
+| Claude priorizou "qualidade" sobre instrucao | Instrucao > julgamento proprio |
+| Claude nao leu o pedido completo | Ler TODO o pedido antes de agir |
+
+### Corolario
+
+Se corrigiu o MESMO TIPO de erro 2x na mesma sessao, falta uma regra ou constraint:
+1. Identificar o padrao do erro
+2. Documentar em findings.md
+3. Aplicar constraint explicito para o resto da sessao
+
+---
+
+## ENFORCEMENT
+
+### Integracao com Outros Rules
+
+| Sinal | Rule de Referencia |
+|-------|--------------------|
+| "Generico" | anti-homogeneization.md (Logo Test, Specificity Score) |
+| Score baixo | debugging-hypothesis.md (3 hipoteses ordenadas) |
+| "Parece IA" | anti-homogeneization.md (Palavras Banidas) |
+| "Falta VOC" | voc-research.md (VOC Quality Protocol) |
+| "Nao e isso" | aios-principles.md (#1 Evidencia Fisica) |
+| Feature extra | aios-principles.md (#12 So o que Foi Pedido) |
+| Deliverable incompleto | tool-usage-matrix.md (Checklist por Deliverable) |
+| Mecanismo fraco | mecanismo-unico.md (Framework Ramalho) |
+
+---
+
+*v2.0 — Reescrito com base em AIOS Framework (Alan Nicolas, 10.000+ sessoes)*
+*Expande v1.0: 20 sinais (era 10), 12 triggers (era 10), arvore de decisao, feedback loops*
+*Contexto: Copy Chief BLACK — Copywriting Direct Response*
+*Criado: 2026-02-26*

package/framework/reference/structured-exploration.md

@@ -0,0 +1,361 @@
+# Structured Exploration Protocol (v1.0)
+
+> Fonte: AIOS Framework (Alan Nicolas) — Principio #24 (10.000+ sessoes)
+> Adaptado: Copy Chief BLACK — Copywriting Direct Response
+> Principio: 3 passadas com perspectivas diferentes antes de agir.
+> Criado: 2026-02-26
+
+---
+
+## REGRA CARDINAL
+
+> **Nunca comece a produzir sem explorar primeiro.**
+> Exploracao estruturada em 3 passadas evita retrabalho, gaps e suposicoes falsas.
+> Cada passada tem perspectiva, foco e output diferentes.
+
+---
+
+## PROTOCOLO DE 3 PASSADAS
+
+### Visao Geral
+
+| Pass | Perspectiva | Mentalidade | Pergunta Central |
+|------|-------------|-------------|------------------|
+| 1 | **Topologia** (Arquiteto) | "Como esta organizado?" | Qual e a estrutura? |
+| 2 | **Contratos** (Revisor) | "Como as partes se conectam?" | Quais sao as dependencias? |
+| 3 | **Fragilidades** (Adversarial) | "Onde pode quebrar?" | Quais sao os riscos? |
+
+### Tempo por Passada
+
+| Contexto | Pass 1 | Pass 2 | Pass 3 | Total |
+|----------|--------|--------|--------|-------|
+| Nova oferta | 5-10 min | 5-10 min | 5-10 min | 15-30 min |
+| Codebase desconhecido | 10-15 min | 10-15 min | 5-10 min | 25-40 min |
+| Analise de concorrente | 5 min | 5 min | 10 min | 20 min |
+| Analise de swipe | 5 min | 5 min | 5 min | 15 min |
+
+---
+
+## PASS 1: TOPOLOGIA (Perspectiva do Arquiteto)
+
+### Mentalidade
+
+"Estou vendo pela primeira vez. Nao julgo, apenas MAPEIO."
+
+### Acoes Obrigatorias
+
+```
+1. MAPEAR estrutura de diretorios
+   → ls -la {oferta}/
+   → ls -la {oferta}/research/
+   → ls -la {oferta}/briefings/
+   → ls -la {oferta}/production/
+
+2. IDENTIFICAR 5 arquivos mais importantes
+   → CONTEXT.md (fonte de verdade da oferta)
+   → mecanismo-unico.yaml (estado do mecanismo)
+   → helix-state.yaml (estado do workflow)
+   → research/synthesis.md (inteligencia consolidada)
+   → project_state.yaml (tracking)
+
+3. MAPEAR fluxo de dados
+   → De onde vem a informacao? (VOC → Briefing → Production)
+   → Onde esta o estado? (helix-state.yaml, project_state.yaml)
+   → O que ja foi produzido? (production/)
+
+4. REGISTRAR volume
+   → Quantos arquivos de research existem?
+   → Quantas fases HELIX estao completas?
+   → Quantos deliverables de production existem?
+```
+
+### Output do Pass 1
+
+```markdown
+## TOPOLOGIA: [Nome da Oferta]
+
+### Estrutura
+- research/: [X] arquivos ([tipos])
+- briefings/: [X] fases de [10]
+- production/: [X] deliverables ([tipos])
+- swipes/: [X] referencias
+
+### Arquivos-Chave
+1. [arquivo] — [conteudo/proposito]
+2. [arquivo] — [conteudo/proposito]
+3. [arquivo] — [conteudo/proposito]
+4. [arquivo] — [conteudo/proposito]
+5. [arquivo] — [conteudo/proposito]
+
+### Fluxo de Dados
+[VOC] → [Synthesis] → [HELIX Phases] → [Production]
+Estado atual: [fase]
+
+### Volume
+- Research: [completa/parcial/ausente]
+- Briefing: [X/10 fases]
+- Production: [X deliverables]
+```
+
+---
+
+## PASS 2: CONTRATOS (Perspectiva do Revisor)
+
+### Mentalidade
+
+"Quais sao as INTERFACES entre componentes? O que depende de que?"
+
+### Acoes Obrigatorias
+
+```
+1. LISTAR interfaces entre componentes
+   → VOC ↔ Briefing: Quais dados da VOC alimentam quais fases?
+   → Briefing ↔ Production: Quais fases sao pre-requisito para quais deliverables?
+   → Mecanismo ↔ Tudo: MUP/MUS como eixo central
+
+2. MAPEAR dependencias
+   → Quais gates existem? (Research Gate, Briefing Gate, Production Gate)
+   → Quais MCPs sao obrigatorios em cada fase?
+   → Quais templates devem ser usados?
+
+3. IDENTIFICAR inputs do usuario
+   → O que precisa de aprovacao humana?
+   → Onde o usuario ja deu input?
+   → Onde falta input do usuario?
+
+4. VERIFICAR consistencia
+   → CONTEXT.md alinhado com helix-state.yaml?
+   → mecanismo-unico.yaml alinhado com briefing?
+   → project_state.yaml atualizado?
+```
+
+### Output do Pass 2
+
+```markdown
+## CONTRATOS: [Nome da Oferta]
+
+### Interfaces
+| De | Para | Dados que Fluem |
+|----|------|-----------------|
+| VOC | HELIX Fase 1-4 | Quotes, DRE, avatar |
+| VOC | HELIX Fase 5-6 | Linguagem para MUP/MUS |
+| HELIX | Production | Briefing completo |
+| Mecanismo | Tudo | MUP, MUS, Indutor |
+
+### Dependencias (Gates)
+| Gate | Status | Bloqueante Para |
+|------|--------|-----------------|
+| Research | [PASSED/PENDING] | briefings/ |
+| Briefing | [PASSED/PENDING] | production/ |
+| Mecanismo | [STATE] | production/ |
+
+### Inputs do Usuario
+| Input | Status | Impacto |
+|-------|--------|---------|
+| [input] | [recebido/pendente] | [o que bloqueia] |
+
+### Consistencia
+- [ ] CONTEXT.md ↔ helix-state.yaml: [alinhado/desalinhado]
+- [ ] mecanismo-unico.yaml ↔ briefing: [alinhado/desalinhado]
+- [ ] project_state.yaml: [atualizado/desatualizado]
+```
+
+---
+
+## PASS 3: FRAGILIDADES (Perspectiva Adversarial)
+
+### Mentalidade
+
+"Sou um adversario tentando fazer esta oferta FALHAR. Onde esta fraca?"
+
+### Acoes Obrigatorias
+
+```
+1. IDENTIFICAR pontos de falha
+   → Onde falta evidencia? (afirmacoes sem VOC)
+   → Onde falta validacao? (copy sem blind_critic)
+   → Onde ha inconsistencia? (MUP diz X, copy diz Y)
+
+2. VERIFICAR gates faltantes
+   → Research Gate foi rodado?
+   → Ferramentas obrigatorias foram usadas?
+   → Mecanismo esta VALIDATED?
+
+3. TESTAR premissas
+   → MUP e realmente diferente do mercado?
+   → Avatar e baseado em VOC ou suposicao?
+   → DRE esta confirmada ou assumida?
+
+4. BUSCAR gaps de enforcement
+   → Hooks estao ativos?
+   → Templates foram seguidos?
+   → Anti-homogeneizacao foi aplicada?
+```
+
+### Output do Pass 3
+
+```markdown
+## FRAGILIDADES: [Nome da Oferta]
+
+### Pontos de Falha
+| # | Fragilidade | Severidade | Mitigacao |
+|---|-------------|------------|-----------|
+| 1 | [descricao] | CRITICA/ALTA/MEDIA | [acao] |
+| 2 | [descricao] | CRITICA/ALTA/MEDIA | [acao] |
+| 3 | [descricao] | CRITICA/ALTA/MEDIA | [acao] |
+
+### Gates Faltantes
+| Gate | Esperado | Atual | Acao |
+|------|----------|-------|------|
+| [gate] | [status esperado] | [status real] | [correcao] |
+
+### Premissas Nao Verificadas
+| Premissa | Evidencia | Risco se Falsa |
+|----------|-----------|----------------|
+| [premissa] | [tem/nao tem] | [impacto] |
+
+### Gaps de Enforcement
+| Gap | Impacto | Fix |
+|-----|---------|-----|
+| [gap] | [o que pode acontecer] | [como resolver] |
+```
+
+---
+
+## APLICACOES COPY-SPECIFIC
+
+### 1. Nova Oferta (Onboarding)
+
+| Pass | Foco Especifico |
+|------|-----------------|
+| 1 — Topologia | Estrutura de diretorios criada? CONTEXT.md existe? Nicho identificado? |
+| 2 — Contratos | Biblioteca de nicho existe? Templates mapeados? Gates configurados? |
+| 3 — Fragilidades | Avatar e hipotese ou VOC? Mecanismo e original? Nicho saturado? |
+
+**Checklist Nova Oferta:**
+- [ ] Pass 1: Estrutura mapeada
+- [ ] Pass 2: Dependencias identificadas
+- [ ] Pass 3: Riscos documentados
+- [ ] CONTEXT.md criado/atualizado
+- [ ] mecanismo-unico.yaml criado (state: UNDEFINED)
+- [ ] helix-state.yaml criado
+- [ ] Proximo passo definido
+
+### 2. Analise de Concorrente
+
+| Pass | Foco Especifico |
+|------|-----------------|
+| 1 — Topologia | Quais funis? Quais canais? Quais produtos? Volume de ads? |
+| 2 — Contratos | Qual MUP? Qual MUS? Qual avatar? Qual DRE? |
+| 3 — Fragilidades | Onde e fraco? Que gaps deixa? Que angulos ignora? Onde podemos diferenciar? |
+
+**Output:** Mapa de oportunidades para diferenciacao.
+
+### 3. Analise de Swipe (Copy de Referencia)
+
+| Pass | Foco Especifico |
+|------|-----------------|
+| 1 — Topologia | Estrutura da copy: lead, problema, solucao, oferta, CTA. Proporcoes. |
+| 2 — Contratos | Qual mecanismo? Qual DRE? Qual escalada emocional? Quais provas? |
+| 3 — Fragilidades | Logo Test: esta generico? Especificidade: onde falta? Cliches: quais usa? |
+
+**Output:** Elementos reutilizaveis (adaptados, nao copiados) + gaps a evitar.
+
+### 4. Retomada de Oferta (Apos Pausa)
+
+| Pass | Foco Especifico |
+|------|-----------------|
+| 1 — Topologia | O que existe? O que mudou desde ultima sessao? Volume atual. |
+| 2 — Contratos | Onde parou? Quais gates passaram? O que esta pendente? |
+| 3 — Fragilidades | O que pode ter ficado inconsistente? States desatualizados? |
+
+**Checklist Retomada:**
+- [ ] Pass 1: Estado atual mapeado
+- [ ] Pass 2: Ponto de retomada identificado
+- [ ] Pass 3: Inconsistencias corrigidas
+- [ ] project_state.yaml verificado
+- [ ] CONTEXT.md relido
+- [ ] Proximo passo definido
+
+### 5. Debug de Oferta (Algo Nao Funciona)
+
+| Pass | Foco Especifico |
+|------|-----------------|
+| 1 — Topologia | Todos os arquivos esperados existem? Estrutura esta correta? |
+| 2 — Contratos | Dados fluem corretamente? Gates foram passados na ordem? |
+| 3 — Fragilidades | Qual gate falhou? Qual ferramenta nao foi usada? Qual threshold nao atingido? |
+
+> Ref: debugging-hypothesis.md para protocolo de debug com 3 hipoteses.
+
+---
+
+## REGRAS DE EXECUCAO
+
+### Regra 1: Todas as 3 Passadas Sao Obrigatorias
+
+Nao pular nenhuma passada. Cada uma revela informacao que as outras nao capturam:
+- Pass 1 sem Pass 3 = otimismo excessivo (nao ve riscos)
+- Pass 3 sem Pass 1 = paranoia sem contexto (nao sabe o que existe)
+- Pass 2 sem Pass 1 = contratos sem mapa (nao sabe a estrutura)
+
+### Regra 2: Ordem Importa
+
+Sempre 1 → 2 → 3. Nunca comecar por fragilidades sem antes mapear topologia e contratos.
+
+### Regra 3: Output Antes de Acao
+
+Completar os 3 outputs ANTES de propor qualquer acao. O output informa a proposta.
+
+### Regra 4: Compartilhar Findings
+
+Apresentar findings das 3 passadas ao usuario ANTES de propor plano de acao:
+
+```
+"Fiz a exploracao estruturada. Resumo:
+- TOPOLOGIA: [estado geral]
+- CONTRATOS: [dependencias criticas]
+- FRAGILIDADES: [riscos identificados]
+
+Com base nisso, proponho: [acao]"
+```
+
+> Ref: aios-principles.md #6 (Discovery Antes de Implementacao) e #7 (Opcoes Antes de Implementacao).
+
+### Regra 5: Profundidade Proporcional ao Risco
+
+| Risco | Profundidade da Exploracao |
+|-------|---------------------------|
+| Baixo (ajuste pontual) | Pass rapido (2 min cada) |
+| Medio (novo deliverable) | Pass normal (5 min cada) |
+| Alto (nova oferta, pivoting) | Pass profundo (10 min cada) |
+
+---
+
+## INTEGRACAO COM WORKFLOW
+
+### Quando Rodar Exploracao Completa
+
+| Situacao | 3 Passadas? | Justificativa |
+|----------|-------------|---------------|
+| Nova oferta | SIM | Mapeamento completo necessario |
+| Retomada apos pausa | SIM | Estado pode ter mudado |
+| Novo deliverable | RAPIDA (2 min cada) | Verificar pre-requisitos |
+| Ajuste em copy existente | NAO | Contexto ja conhecido |
+| Bug/erro pontual | NAO | Ir direto ao debug |
+
+### Conexao com Outros Protocolos
+
+| Protocolo | Como se Conecta |
+|-----------|-----------------|
+| aios-principles.md #6 | Discovery Antes de Implementacao = Pass 1 |
+| aios-principles.md #24 | Este arquivo E o principio #24 expandido |
+| debugging-hypothesis.md | Pass 3 alimenta hipoteses de debug |
+| context-management.md | Pass 1 identifica o que e HOT/WARM/COLD |
+| tool-usage-matrix.md | Pass 2 identifica ferramentas obrigatorias por fase |
+
+---
+
+*v1.0 — Adaptado de AIOS Framework (Alan Nicolas, Principio #24)*
+*Contexto: Copy Chief BLACK — Copywriting Direct Response*
+*5 aplicacoes copy-specific: Nova Oferta, Concorrente, Swipe, Retomada, Debug*
+*Criado: 2026-02-26*