@lucapimenta/copy-chief-black 1.0.0

package/framework/reference/epistemic-protocol.md

@@ -0,0 +1,214 @@
+# Epistemic Protocol (v1.0)
+
+> Fonte: mega-brain Epistemic Protocol — Adaptado para Copy Chief BLACK
+> Principio: Toda afirmacao tem tipo (FATO vs RECOMENDACAO) e confianca declarada.
+> Aplica-se: TODAS as afirmacoes em briefings/ e production/
+> Criado: 2026-03-01 (Sprint S42)
+
+---
+
+## REGRA CARDINAL
+
+> **"Nao afirmar como fato o que e inferencia. Nao afirmar sem fonte."**
+> FATO sem fonte = alucinacao operacional.
+> RECOMENDACAO sem confianca = conselho cego.
+
+---
+
+## Tipos de Afirmacao
+
+| Tipo | Definicao | Marcador | Quando Usar |
+|------|-----------|----------|-------------|
+| **FATO** | Verificavel em fonte externa | `[FATO]` | VOC quote, estudo citado, dado mensuravel |
+| **RECOMENDACAO** | Inferencia ou julgamento profissional | `[REC]` | Angulo de copy, MUP candidato, estrategia |
+
+### Exemplos
+
+```
+[FATO] Avatar usa "ja tentei de tudo" — VOC YouTube, 847 likes.
+[FATO] CoQ10 melhora funcao mitocondrial — Journal Neuroscience 2024.
+
+[REC] MUP "Cristais de Otolitos" tem maior potencial de paradigm shift.
+[REC] Abertura com DRE Nivel 4 (relacional) antes de revelar mecanismo.
+```
+
+**Misturar sem marcador = PROIBIDO.** Copy que afirma "estudos mostram" sem citar = [FATO] sem fonte = REFAZER.
+
+---
+
+## 4 Niveis de Confianca
+
+| Nivel | Criterio | Declaracao |
+|-------|----------|------------|
+| **ALTA** | 3+ fontes independentes ou MCP validado | `[CONFIANCA: ALTA]` |
+| **MEDIA** | 1-2 fontes ou 1 validacao MCP | `[CONFIANCA: MEDIA]` |
+| **BAIXA** | Inferencia logica sem fonte direta | `[CONFIANCA: BAIXA]` |
+| **NAO SEI** | Sem dados disponíveis | `[CONFIANCA: NAO SEI]` |
+
+### Regras por Nivel
+
+**ALTA** → afirmar diretamente na copy.
+**MEDIA** → afirmar com qualificador leve ("dados sugerem", "evidencia aponta").
+**BAIXA** → apresentar como hipotese. Nunca como fato na copy final.
+**NAO SEI** → nao incluir na copy. Pesquisar ou excluir.
+
+---
+
+## Formato de Citacao de Fonte
+
+```
+[FONTE: {path}:{line}]
+[FONTE: research/voc/summary.md:47]
+[FONTE: research/mechanism/summary.md:112]
+[FONTE: briefings/phases/fase05-problema-vilao-mup.md:23]
+```
+
+Para fontes externas (estudos, VOC de plataforma):
+```
+[FONTE: Journal Neuroscience 2024, DOI:10.xxxx]
+[FONTE: VOC YouTube "canal X", comment ID: abc123, 847 likes]
+```
+
+**Regra:** Toda afirmacao [FATO] DEVE ter [FONTE]. Ausencia de [FONTE] = downgrade automatico para [REC].
+
+---
+
+## Penalidades de Confianca
+
+Aplicadas sobre o score de confianca declarado quando evidencias estao ausentes:
+
+| Ausencia | Penalidade | Justificativa |
+|----------|------------|---------------|
+| VOC ausente (afirmacoes sobre avatar) | -15% | Avatar sem dados = suposicao |
+| Mecanismo nao definido (producao sem MUP/MUS) | -20% | Core da oferta indefinido |
+| blind_critic nao executado | -25% | Qualidade de copy nao validada |
+| emotional_stress_test nao executado | -15% | Impacto emocional nao verificado |
+| Logo Test nao aplicado | -10% | Especificidade nao verificada |
+
+### Calculo
+
+```
+Confianca Final = Confianca Declarada - Sum(Penalidades)
+
+Exemplo:
+  Declarado: ALTA (90%)
+  Ausencias: VOC (-15%) + blind_critic (-25%)
+  Final: 90% - 40% = 50% → downgrade para MEDIA
+```
+
+**Se confianca final < 50% → BAIXA, independente do declarado.**
+**Se confianca final < 30% → NAO SEI, bloquear avanco de fase.**
+
+---
+
+## Circuit Breaker
+
+Maximo de iteracoes por operacao antes de escalar para humano:
+
+| Operacao | Max Iteracoes | Acao ao Atingir |
+|----------|---------------|-----------------|
+| Refinar MUP/MUS | 3 | Escalar: problema e estrategico |
+| Corrigir blind_critic < 8 | 3 | Escalar: copy precisa de nova direcao |
+| Corrigir EST < 8 | 3 | Escalar: DRE ou avatar podem estar errados |
+| Ajustar angulo criativo | 5 | Escalar: angulo pode estar errado |
+| Debug de gate BLOCKED | 2 | Escalar: dados de research incompletos |
+
+**Ao atingir limite:** documentar em findings.md as 3 tentativas + hipoteses testadas + por que nenhuma resolveu. NAO tentar iteracao 4+ sem aprovacao humana.
+
+```
+CIRCUIT BREAKER ATIVADO: [operacao]
+Tentativas: [N]/[Max]
+H1 testada: [descricao] — resultado: [X]
+H2 testada: [descricao] — resultado: [X]
+H3 testada: [descricao] — resultado: [X]
+Escalando para humano: [pergunta especifica]
+```
+
+---
+
+## Cabecalho Epistêmico em Deliverables
+
+Todo arquivo em briefings/ e production/ DEVE incluir o cabecalho epistêmico:
+
+```yaml
+---
+epistemic:
+  confidence_level: "ALTA|MEDIA|BAIXA|NAO SEI"
+  sources:
+    - file: "{path}"
+      line: {N}
+      quote: "{texto exato}"
+  methodology: "{framework — ex: HELIX Fase 5, RMBC-II, VOC Quality Protocol}"
+  unverified_claims: []
+---
+```
+
+**Template:** `~/.claude/templates/partials/epistemic-header.md`
+**Hook:** `~/.claude/hooks/epistemic-check.ts` — warning se ausente em production/*.md
+
+---
+
+## Aplicacao por Tipo de Afirmacao
+
+### Em Briefings (HELIX)
+
+| Fase | O que declarar | Nivel Esperado |
+|------|----------------|----------------|
+| Fases 1-4 (Avatar, Consciencia) | [FATO] com [FONTE: VOC] | ALTA (baseado em VOC) |
+| Fase 5 (MUP) | [REC] com confianca | MEDIA (consenso + blind_critic) |
+| Fase 6 (MUS) | [REC] com confianca | MEDIA (blind_critic + EST) |
+| Fases 7-10 (Oferta, Leads) | [REC] com confianca | MEDIA |
+
+### Em Production
+
+| Elemento | Tipo | Fonte Obrigatoria |
+|----------|------|-------------------|
+| Claims sobre avatar | [FATO] | VOC summary |
+| Dados numericos | [FATO] | research/mechanism/ ou fonte externa |
+| Mecanismo (MUP/MUS) | [FATO] para o problema, [REC] para o nome | mecanismo-unico.yaml |
+| Angulo de abordagem | [REC] | briefing + swipes |
+| Eficacia de ingrediente | [FATO] | estudo citado |
+
+---
+
+## Anti-Patterns
+
+| Anti-Pattern | Consequencia | Fix |
+|--------------|-------------|-----|
+| "Estudos mostram que..." sem [FONTE] | [FATO] sem fonte = REFAZER | Citar estudo especifico |
+| "Avatar sofre de X" sem VOC | Confianca downgrade -15% | Adicionar quote VOC |
+| [REC] apresentada como [FATO] na copy | Credibilidade comprometida | Qualificar com fonte ou reformular |
+| Sem cabecalho epistêmico em production/ | Warning do hook | Adicionar antes de entregar |
+| Iteracao 4+ sem escalar | Waste de tokens + frustracao | Ativar circuit breaker |
+
+---
+
+## Integracao com blind_critic
+
+O `blind_critic` e um MCP externo (`mcp__copywriting__blind_critic`) — nao podemos modificar seu codigo. A integracao epistemica acontece em COMO chamamos a ferramenta:
+
+**Ao submeter copy para blind_critic:**
+1. Incluir marcadores `[FATO]`/`[REC]` no `copy_text` avaliado — o critic ve os marcadores e considera rigor epistêmico como parte da avaliacao de credibilidade.
+2. No campo de contexto/prompt, incluir: `"Avalie rigor epistêmico — afirmacoes estao com fontes declaradas? Claims sem [FONTE] devem penalizar o score de credibilidade."`
+3. Score de blind_critic >= 8 implica confianca ALTA (`[CONFIANCA: ALTA]`) para o deliverable avaliado — registrar como evidencia no cabecalho epistêmico.
+
+**Relacao com penalidades:** `blind_critic nao executado` = -25% de confianca (ver tabela de Penalidades acima). Executar blind_critic com marcadores epistemicos elimina essa penalidade E eleva a confianca declarada.
+
+Ref: tool-usage-matrix.md — entrada `blind_critic + EST = evidencia para elevar confianca`.
+
+---
+
+## Integracao com Outros Protocolos
+
+| Protocolo | Conexao |
+|-----------|---------|
+| debugging-hypothesis.md | Circuit breaker complementa 3 hipoteses |
+| voc-research.md | Toda VOC = [FATO] com [FONTE: username + engagement] |
+| anti-homogeneization.md | Specificity Score >= 8 = [CONFIANCA: ALTA] |
+| tool-usage-matrix.md | blind_critic + EST = evidencia para elevar confianca |
+| aios-principles.md #1 | Evidencia fisica = base para [FATO] |
+
+---
+
+*v1.0 — Sprint S42 — mega-brain Epistemic Protocol adaptado*
+*Criado: 2026-03-01*

package/framework/reference/mecanismo-unico.md

@@ -0,0 +1,212 @@
+---
+phases: [BRIEFING]
+priority: HIGH
+tokens: ~1200
+---
+
+# Mecanismo Unico - Framework Ramalho (v1.0)
+
+> **Principio:** O Mecanismo Unico e onde mora a conversao e escala.
+> **Fonte:** Copy Chief BLACK + Framework Ramalho (Puzzle Pieces)
+> **Criado:** 2026-02-02 (BSSF Score 8.6, GBS 90%)
+
+---
+
+## REGRA CARDINAL
+
+> **NENHUMA oferta avanca para production/ sem Mecanismo Unico VALIDATED.**
+> Hook mecanismo-validation.sh bloqueia automaticamente.
+
+---
+
+## Estrutura do Mecanismo Unico (3 Partes)
+
+### PARTE 1: MUP (Mecanismo Unico do Problema)
+
+| Componente | Descricao | Obrigatorio |
+|------------|-----------|-------------|
+| **Nova Causa** | O que REALMENTE causa o problema (nao o que o mercado fala) | SIM |
+| **Sexy Cause** | NOME intrigante para a nova causa | SIM |
+| **Problema Fundamental** | Como a nova causa se aplica TANGIVELMENTE | SIM |
+| **Causa Raiz** | Historia por tras do problema | NAO |
+
+**Criterios de Validacao:**
+- Diferente do que o mercado ja fala?
+- Tira a culpa do avatar?
+- Explica por que outras solucoes falharam?
+
+**Teste da Sexy Cause:** A pessoa vai querer CONTAR para alguem?
+
+### PARTE 2: MUS (Mecanismo Unico da Solucao)
+
+| Componente | Descricao | Obrigatorio |
+|------------|-----------|-------------|
+| **Nova Oportunidade** | INVERSO da nova causa | SIM |
+| **Ingrediente Hero** | Componente PRINCIPAL que resolve | SIM |
+| **Gimmick Name** | Nome chiclete do INGREDIENTE (nao do sistema!) | SIM |
+| **Origin Story** | Historia de COMO foi descoberto | SIM |
+| **Authority Hook** | Validacao via super estrutura | SIM |
+
+**DISTINCAO CRITICA:**
+- **Gimmick Name** = ligado ao INGREDIENTE (ex: "Pink Salt Trick")
+- **Authority Hook** = ligado a SUPER ESTRUTURA (ex: "Monjaro Natural")
+
+**Teste do Gimmick Name:** Gruda E esta ligado ao ingrediente hero?
+
+### PARTE 3: INDUTOR (Metodo/Produto)
+
+| Componente | Descricao | Obrigatorio |
+|------------|-----------|-------------|
+| **Nome Sistema** | Nome proprietario do metodo | SIM |
+| **Componentes** | Partes do metodo (siglas) | NAO |
+| **Ativacao** | Como o cliente usa | NAO |
+
+---
+
+## Formula do Gancho da Solucao (Ramalho)
+
+```
+"Ja ouviu falar desse [GIMMICK NAME] que [ORIGIN STORY] estao usando
+secretamente para [DESEJO]? Ja estao chamando isso de [AUTHORITY HOOK]."
+```
+
+**Exemplo:**
+> "Ja ouviu falar desse Pink Salt Trick que as atrizes de Hollywood estao usando
+> secretamente para secar gordura na barriga em poucos dias?
+> Ja estao chamando isso de Monjaro Natural."
+
+---
+
+## Arquivo Canonico: mecanismo-unico.yaml
+
+Cada oferta DEVE ter na raiz:
+```
+{oferta}/mecanismo-unico.yaml
+```
+
+**Schema:** `~/.claude/schemas/mecanismo-unico.schema.yaml`
+**Template:** `~/.claude/templates/mecanismo-unico-template.md`
+
+### Estados Validos
+
+| Estado | Significado | Permite Production? |
+|--------|-------------|---------------------|
+| UNDEFINED | Nao iniciado | NAO |
+| DRAFT | Em construcao | NAO |
+| PENDING_VALIDATION | Completo, aguardando MCP | NAO |
+| VALIDATED | Validado via MCP | SIM |
+| APPROVED | Humano aprovou | SIM |
+
+---
+
+## Sequencia de Validacao (Fase 5-6 HELIX)
+
+```
+1. Preencher mecanismo-unico.yaml
+      |
+2. consensus (MCP zen) - TOP 3 candidatos MUP
+      |
+3. blind_critic (MCP copywriting) - MUP Statement (score >= 8)
+      |
+4. Definir MUS baseado no MUP
+      |
+5. blind_critic (MCP copywriting) - MUS Statement (score >= 8)
+      |
+6. emotional_stress_test (MCP copywriting) - MUP+MUS (genericidade >= 8)
+      |
+7. Atualizar state: VALIDATED
+      |
+8. HUMANO aprova -> state: APPROVED
+```
+
+### Criterios RMBC (Media >= 7)
+
+| Criterio | Pergunta | Threshold |
+|----------|----------|-----------|
+| Digerivel | Explicavel em 1-2 frases? | >= 7 |
+| Unico | Gera "nunca ouvi isso antes"? | >= 7 |
+| Provavel | Faz sentido intuitivo? | >= 7 |
+| Conectado | Liga com emocao do avatar? | >= 7 |
+
+---
+
+## Enforcement Automatico
+
+### Hook: mecanismo-validation.sh
+
+- **Evento:** PreToolUse (Write/Edit)
+- **Target:** Arquivos em `*/production/*`
+- **Comportamento:**
+  - Verifica se mecanismo-unico.yaml existe
+  - Verifica se state e VALIDATED ou APPROVED
+  - BLOQUEIA se nao atende criterios
+
+### Script de Validacao
+
+```bash
+# Validar uma oferta
+~/copywriting-ecosystem/scripts/validate-mecanismo.sh path/to/offer
+
+# Validar todas as ofertas
+~/copywriting-ecosystem/scripts/validate-mecanismo.sh --all
+```
+
+**Exit codes:**
+- 0 = VALIDATED ou APPROVED
+- 1 = DRAFT ou UNDEFINED
+- 2 = PENDING_VALIDATION
+- 3 = File not found
+
+---
+
+## Adaptacao por Nicho
+
+### O que e "Ingrediente Hero"?
+
+| Nicho | Ingrediente Hero = | Exemplo |
+|-------|-------------------|---------|
+| Suplemento | Substancia principal | Pink Salt |
+| Educacao/Concursos | Tecnica core | Tecnica Ovelha Negra |
+| Relacionamento | Protocolo principal | Tecnica do Espelho |
+| Riqueza | Estrategia principal | Metodo dos 3 Potes |
+
+### Biblioteca de Sexy Causes
+
+| Nicho | Problema | Sexy Cause |
+|-------|----------|------------|
+| Emagrecimento | Come demais | "Hungry Brain Syndrome" |
+| Concursos | Estuda errado | "Ilusao de Aprendizado" |
+| Concursos | Nao memoriza | "Ponto Cego de Leitura" |
+| ED | Bloqueio | "Sindrome de Dessensibilizacao" |
+
+---
+
+## Ofertas Migradas
+
+| Oferta | State | MUP | MUS |
+|--------|-------|-----|-----|
+| Hacker do Concurso | APPROVED | Ovelha Negra | Tecnica Ovelha Negra |
+| Gabaritando Lei Seca | APPROVED | Buraco da Lei Seca | Metodo Gabaritando |
+| GPT dos Aprovados | APPROVED | Desalinhamento de Contexto | Sistema de 3 Etapas |
+| Gabaritando Portugues | DRAFT | Ponto Cego de Leitura | (pendente) |
+
+---
+
+## Checklist Nova Oferta
+
+- [ ] Criar `mecanismo-unico.yaml` a partir do schema
+- [ ] Preencher MUP (nova causa, sexy cause, problema fundamental)
+- [ ] Validar MUP via consensus + blind_critic (>= 8)
+- [ ] Preencher MUS (ingrediente hero, gimmick name, origin story, authority hook)
+- [ ] Validar MUS via blind_critic (>= 8)
+- [ ] Validar MUP+MUS via emotional_stress_test (>= 8)
+- [ ] Preencher RMBC scores
+- [ ] Atualizar state para VALIDATED
+- [ ] HUMANO aprova -> APPROVED
+- [ ] Rodar `validate-mecanismo.sh` para confirmar
+
+---
+
+*v1.0 - BSSF Score 8.6, GBS 90%*
+*Baseado em Framework Ramalho (Puzzle Pieces)*
+*Criado: 2026-02-02*

package/framework/reference/micro-unidades.md

@@ -0,0 +1,144 @@
+# Micro-Unidades Interpretativas (v1.0)
+
+> Fonte: AIOS Framework — Extracao de padroes LINGUISTICOS (nao so quotes) do avatar
+> Principio: VOC extrai O QUE o avatar diz. Micro-Unidades extraem COMO ele diz.
+> Ref: aios-principles.md, voc-research.md
+> Criado: 2026-02-27
+
+---
+
+## REGRA CARDINAL
+
+> **Copy que usa palavras do avatar mas nao soa como o avatar = falhou.**
+> Quotes sao materia-prima. Micro-Unidades sao o MOLDE da voz.
+> Sem molde, a copy e ventriloquismo — palavras certas, tom errado.
+
+---
+
+## 6 Dimensoes Linguisticas do Avatar
+
+| # | Dimensao | O que Extrair | Exemplo |
+|---|----------|---------------|---------|
+| 1 | **Padroes de Argumentacao** | Como conecta causa→efeito | "Porque..." / "O problema e que..." / "Ai que..." |
+| 2 | **Vocabulario Preferencial** | Palavras que ESCOLHE (nao tecnicas) | "Acabou comigo" vs "Me prejudicou" |
+| 3 | **Estruturas Frasais** | Como constroi frases tipicas | Curtas, fragmentadas, "tipo..." |
+| 4 | **Ritmo Cognitivo** | Pausas, aceleracoes, digressoes | "Sei la... mas tipo assim..." |
+| 5 | **Metaforas Nativas** | Como traduz abstrato em concreto | "Parece uma panela de pressao" |
+| 6 | **Nivel de Sofisticacao** | Complexidade linguistica natural | Coloquial / Tecnico / Misto |
+
+---
+
+## Detalhamento por Dimensao
+
+### 1. Padroes de Argumentacao
+
+**O que observar:**
+- Como o avatar explica CAUSA de problemas ("e porque...", "o problema e que...", "o que acontece e...")
+- Como justifica decisoes ("ai eu pensei...", "fui la e...", "nao tinha outra opcao")
+- Como contra-argumenta ("sim, mas...", "ta, so que...", "eu sei, mas...")
+
+**Extracao:** Listar os 5-10 conectores mais usados e a logica que seguem.
+
+**Impacto na Copy:** Copy que usa "porque" quando avatar diz "ai que" soa artificial.
+
+### 2. Vocabulario Preferencial
+
+**O que observar:**
+- Palavras ESCOLHIDAS (nao tecnicas) para descrever problema
+- Intensificadores naturais ("demais", "pra caramba", "muito", "absurdo")
+- Diminutivos/aumentativos habituais ("probleminha", "dorzinha", "barrigao")
+
+**Extracao:** Mapa de sinonimos — palavra tecnica → palavra que o avatar USA.
+
+**Impacto na Copy:** "Disturbio gastrointestinal" vs "barriga presa" — mesma coisa, som completamente diferente.
+
+### 3. Estruturas Frasais
+
+**O que observar:**
+- Comprimento medio de frase (curta/media/longa)
+- Fragmentos vs frases completas
+- Uso de parenteticos e apartes ("sabe como e ne", "enfim")
+- Pontuacao implicita (onde faria pausas, onde acelera)
+
+**Extracao:** 3-5 estruturas frasais tipicas com exemplos.
+
+**Impacto na Copy:** Avatar que fala em fragmentos + copy em frases longas e formais = desconexao.
+
+### 4. Ritmo Cognitivo
+
+**O que observar:**
+- Onde faz PAUSAS (hesitacao, reflexao, emocao)
+- Onde ACELERA (entusiasmo, raiva, medo)
+- Digressoes naturais ("ah, e outra coisa...", "voltando...")
+- Repeticoes por enfase ("nada, NADA funciona")
+
+**Extracao:** Mapa de ritmo — momentos de pausa vs aceleracao.
+
+**Impacto na Copy:** Copy sem ritmo = texto corrido. Copy com ritmo do avatar = conversa natural.
+
+### 5. Metaforas Nativas
+
+**O que observar:**
+- Como transforma abstrato em concreto ("e como se fosse...", "parece...")
+- Analogias do cotidiano ("panela de pressao", "bomba-relogio", "formiga carregando elefante")
+- Comparacoes com experiencias conhecidas
+
+**Extracao:** Listar metaforas encontradas na VOC. Categorizar por tema.
+
+**Impacto na Copy:** Metafora inventada pela IA vs metafora que o avatar JA USA. A segunda conecta, a primeira soa forçada.
+
+### 6. Nivel de Sofisticacao
+
+**O que observar:**
+- Vocabulario simples vs elaborado
+- Uso de girias, regionalismos
+- Capacidade de articulacao (expressa bem vs "nao sei explicar")
+- Mistura coloquial + tecnico (aprendeu termos do problema)
+
+**Extracao:** Classificar em escala: Coloquial / Coloquial-Tecnico / Misto / Tecnico.
+
+**Impacto na Copy:** Copy muito sofisticada para avatar coloquial = credibilidade zero.
+
+---
+
+## Voice Sample
+
+**Definicao:** 2-3 frases que capturam a VOZ do avatar perfeitamente.
+
+**Como construir:**
+1. Ler 50+ quotes do avatar
+2. Identificar padroes das 6 dimensoes
+3. Compor 2-3 frases FICTÍCIAS que SOAM como o avatar
+4. Validar: "Se misturar com quotes reais, e impossivel distinguir?"
+
+**Uso:** Voice Sample e o calibrador de tom para toda producao. Blade lê antes de escrever cada capitulo/bloco.
+
+---
+
+## Integracao com Pipeline
+
+| Fase | Acao com Micro-Unidades |
+|------|------------------------|
+| Research | Extrair 6 dimensoes durante coleta VOC |
+| Briefing | Voice Sample informa tom do briefing (Fase 3 HELIX) |
+| Production | Blade carrega `linguistic-patterns.md` no pre-flight |
+| Review | Hawk verifica: "Copy soa como avatar?" via dimensoes |
+
+---
+
+## Anti-Patterns
+
+| Anti-Pattern | Correto |
+|--------------|---------|
+| Usar quotes do avatar mas em tom formal | Aplicar Estrutura Frasal + Ritmo Cognitivo do avatar |
+| Inventar metaforas "melhores" | Usar metaforas que o avatar JA usa (Dimensao 5) |
+| Copy sofisticada para avatar coloquial | Calibrar Nivel de Sofisticacao (Dimensao 6) |
+| Fragmentos onde avatar fala corrido | Respeitar Estrutura Frasal real (Dimensao 3) |
+| Ignorar ritmo (texto corrido sem pausas) | Mapear Ritmo Cognitivo com pausas e aceleracoes |
+
+---
+
+*v1.0 — AIOS Micro-Unidades Interpretativas para Copy Chief BLACK*
+*6 dimensoes linguisticas para extracao VOC avancada*
+*Ref: voc-research.md, anti-homogeneization.md*
+*Criado: 2026-02-27*

package/framework/reference/offers/concursa-ai.md

@@ -0,0 +1,66 @@
+# Concursa.AI - Contexto da Oferta (v5.0)
+
+> **STATUS: STANDBY** — Luca saiu da Ursao Digital (2026-02-26). Oferta pausada. NAO produzir.
+
+## Produto
+- **Tipo:** SaaS Core (Subscription)
+- **Nicho:** Concursos Publicos
+- **Pricing:** R$52,46/mes (trimestral)
+- **Core Value:** Plataforma com IA especializada em bancas brasileiras
+- **Expert:** Rafael Mendes (6 anos dev interno de bancas) + CONCURSA.AI
+
+## Business Context
+- Core business do ecossistema (SaaS)
+- Front-ends: Hacker do Concurso, Gabaritando Lei Seca, GPT dos Aprovados
+- Fluxo: Front-ends adquirem leads -> upsell para SaaS
+- Cash Engine: URSAO DIGITAL (infoprodutos low-ticket)
+
+## MUP
+**"Padrao de Eliminacao das Bancas"**
+> Cada banca examinadora tem padroes recorrentes de eliminacao — armadilhas que se repetem prova apos prova e derrubam candidatos que SABEM o conteudo. CEBRASPE usa absolutizantes em 34% (78% ERRADO). FGV cobra doutrina em 41%. FCC troca numeros em 19%.
+
+## MUS
+**"DNA da Banca"**
+> O CONCURSA.AI decodifica o Padrao de Eliminacao da sua banca com uma IA 100x mais potente que o GPT para concursos, treinada em 500K+ questoes reais.
+
+## INDUTOR (Puzzle Pieces 4 Camadas)
+**CONCURSA.AI — IA 100x mais potente que GPT para concursos**
+- **Ingrediente Hero:** IA especializada treinada em 500K+ questoes reais
+- **Gimmick Name:** DNA da Banca
+- **Origin Story:** Rafael Mendes — 6 anos como dev interno de bancas
+- **Authority Hook:** "IA 100x mais potente que GPT para concursos"
+
+| # | Componente | Feature | Funcao |
+|---|------------|---------|--------|
+| 1 | Detector de Armadilhas | Hacker de Banca | Identifica padroes de eliminacao por banca |
+| 2 | Tradutor de Enunciado | Tutor IA | Decodifica o que a banca realmente quer |
+| 3 | Mapa de Progresso | Dashboard | Mostra onde VOCE cai |
+| 4 | Pareto por Banca | Meu Plano | Foca nos 20% que fazem passar |
+| 5 | Simulador Calibrado | Simulados | Treina no padrao EXATO |
+
+## Hierarquia de Vilao
+- **VILAO PRINCIPAL (MUP):** Padrao de Eliminacao das Bancas (armadilhas recorrentes)
+- **SOLUCAO FALHA #1:** Cursinhos Tradicionais (material generico)
+- **SOLUCAO FALHA #2:** IA Generica/ChatGPT (nao conhece bancas brasileiras)
+- **INDUTOR:** CONCURSA.AI (IA 100x mais potente que GPT)
+
+## One Belief v5.0
+> "Cada banca elimina com padroes recorrentes que ninguem te ensina. Decodificar esses padroes e a diferenca entre passar em meses e estudar anos. Isso so e possivel com o DNA da Banca do CONCURSA.AI."
+
+## Promessa Central v5.0
+> "A plataforma com IA 100x mais potente que o GPT para concursos — treinada nas 500 mil questoes que as bancas ja usaram para te eliminar."
+
+## Estado Atual
+- Research Gate: PASSED (90% confidence)
+- HELIX: 10/10 fases completas (fases 05 e 06 reescritas v5.0)
+- Proximo: Landing Page, Feature Pages, Pricing Page
+- Producao pendente: Onboarding, Retention, Upgrade sequences
+
+## Arquivos-Chave (ler nesta ordem)
+1. `concursos/concursa-ai/CONTEXT.md` (fonte da verdade v5.0)
+2. `concursos/concursa-ai/briefings/phases/fase05-problema-vilao-mup.md`
+3. `concursos/concursa-ai/briefings/phases/fase06-solucao-mus.md`
+4. `concursos/concursa-ai/research/synthesis.md`
+
+## Referencia
+- Biblioteca do nicho: `concursos/biblioteca_nicho_concursos_CONSOLIDADA.md`

package/framework/reference/offers/gabaritando-portugues.md

@@ -0,0 +1,53 @@
+# Gabaritando Portugues - Contexto da Oferta
+
+> **STATUS: STANDBY** — Luca saiu da Ursao Digital (2026-02-26). Oferta pausada. NAO produzir.
+
+## Produto
+- **Tipo:** TSL (Landing Page)
+- **Nicho:** Concursos Publicos (sub-nicho: Lingua Portuguesa)
+- **Ticket:** A definir
+- **Funil:** TSL -> Checkout
+- **Expert:** A definir
+- **Status:** Aguardando Fase 1 (Analise de Inputs)
+
+## Business Context
+- Cash Engine: URSAO DIGITAL (infoprodutos low-ticket)
+- Core Business: CONCURSA.AI (SaaS)
+- Descricao: Metodo para dominar Portugues em concursos
+
+## Hipotese de Posicionamento
+- **Problema:** Portugues e subestimado mas elimina candidatos
+- **Promessa:** A definir na Fase 1
+- **Diferencial:** A definir na Fase 1
+
+## MUP
+A ser definido apos Fase 1
+
+## MUS
+A ser definido apos Fase 1
+
+## Avatar Primario (Hipotese)
+- Concurseiro que sofre com Portugues
+- Perde pontos em interpretacao/gramatica
+- Considera a disciplina dificil
+- Nao entende seus erros
+
+## Quality Gates
+| Gate | Status |
+|------|--------|
+| Inputs | PENDING (Fase 1) |
+| Research | NOT_STARTED |
+| Briefing | NOT_STARTED |
+| Production | NOT_STARTED |
+
+## Estado Atual
+- Fase 1: PENDENTE
+- Proximo: Invocar audience-research-agent
+
+## Arquivos-Chave
+1. `concursos/gabaritando-portugues/CONTEXT.md`
+2. `concursos/gabaritando-portugues/research/fase-01-inputs.md` (a criar)
+
+## Referencia
+- Biblioteca do nicho: `concursos/biblioteca_nicho_concursos_CONSOLIDADA.md`
+- Ofertas similares: gabaritando-lei-seca, hacker, gpt-dos-aprovados