# INTEGRAÇÃO — 11 Skills Consumidoras + Hook de Leitura

A skill `voz-de-marca-builder` é a fonte canônica de voz de marca da mentorada. Toda skill de copy do ecossistema Tata Gonçalves passa a LER o JSON gerado por essa skill ANTES de gerar qualquer texto.

Esse documento mapeia QUAIS skills consomem, COMO consomem, e o HOOK conceitual de leitura.

---

## Hook universal de leitura (todas as skills aplicam)

```
1. Skill de copy é invocada com pedido de gerar texto pra mentorada [X]
       ↓
2. Skill checa: ~/imperio/mentoradas/[X]/03-voz-de-marca.json existe?
       ├── NÃO existe → para a execução, mensagem:
       │     "Mentorada [X] não tem voz capturada ainda.
       │      Antes de gerar copy, rode /voz-de-marca-builder pra
       │      capturar a voz. Sem voz capturada, copy gerada sai com
       │      voz neutra de IA e a mentorada não se reconhece."
       │     STOP.
       │
       └── SIM existe → continua
       ↓
3. Carrega JSON e extrai os campos relevantes pra essa skill específica
       (cada skill consome subset diferente — tabela abaixo)
       ↓
4. Injeta voz no prompt de geração:
       - Tom principal e secundários como instrução de tom
       - Palavras-âncora como vocabulário a privilegiar
       - Palavras-banidas como vocabulário a EVITAR (regra dura)
       - Ritmo como instrução de comprimento de frase
       - Aberturas/fechamentos como modelos a aplicar onde couber
       - Exemplos canônicos como amostra de calibragem (few-shot)
       ↓
5. Gera texto na voz da mentorada
       ↓
6. (opcional) Roda /voz-humana-br --voz=mentorada como validação final
       ↓
7. Entrega texto + diff de qualidade ("usei 4 das 12 âncoras, 0 banidas, ritmo bate em 92%")
```

---

## Tabela completa — 11 skills consumidoras

| # | Skill consumidora | Campos do JSON que LÊ | Como aplica |
|---|-------------------|-----------------------|-------------|
| 1 | `briefing-copy-360` | `tom_principal`, `tons_secundarios`, `palavras_ancora`, `abertura_padrao`, `frase_de_voz` | Preenche Nível 2.2 (Criador/Autoridade) com tom + palavras-âncora. Substitui pergunta "qual seu tom de voz natural?" pela leitura direta. |
| 2 | `headline-imperatriz` | `palavras_banidas`, `palavras_ancora`, `tom_principal`, `abertura_padrao` | Filtra cada variação de headline gerada contra `palavras_banidas` (rejeita). Privilegia `palavras_ancora`. Aplica `abertura_padrao` quando tipo de headline é "abertura de copy". |
| 3 | `voz-humana-br` | TUDO — em modo `--voz=mentorada` | Modo `--voz=mentorada` lê o JSON e usa como guia de reescrita. `palavras_ancora` viram preferência lexical, `palavras_banidas` entram na lista vermelha junto com lista padrão de IA, `ritmo.padrao` calibra desvio padrão alvo, `tiques_deliberados` autoriza quebra de regra. |
| 4 | `copy-conversacional-dm` | `girias_ok`, `como_chama_audiencia`, `abertura_padrao`, `fechamento_padrao`, `tom_principal` | Mensagens de DM aplicam apelido de audiência da mentorada, gírias autorizadas, abertura e fechamento. Tom calibra agressividade vs acolhimento da sequência. |
| 5 | `criativos-dor-beneficio` | `palavras_ancora`, `palavras_banidas`, `ritmo`, `tom_principal` | Headline + corpo do criativo são gerados com vocabulário da mentorada. Ritmo de frase calibrado pelo `ritmo.padrao`. Banidas são regra dura. |
| 6 | `criativos-urgencia` | `palavras_banidas`, `fechamento_padrao` (CTA), `tom_principal` | Urgência é gerada no tom da mentorada — Tata pode ser "imperatriz não pede licença", Renata pode ser "decisão é sua, prazo está aí". CTA puxa do `fechamento_padrao` tipo `cta-vendas`. |
| 7 | `criativos-retargeting` | `abertura_padrao`, `palavras_ancora`, `tom_principal` | Reabertura aplica fórmula de abertura da mentorada ("Mentorada, …" / "Amada, …" / "Olá, [Nome]") + retoma com palavra-âncora. |
| 8 | `criativos-qa-instagram` | `palavras_banidas`, `como_chama_audiencia`, `tom_principal`, `girias_ok` | Pergunta da caixinha + resposta saem na voz dela. Bane do output palavras banidas. Tratamento de audiência consistente. |
| 9 | `skill-pagina-vendas` | TODOS os 8 blocos | Hero, sub-hero, blocos de copy, CTA, FAQ, garantia — tudo na voz da mentorada. Exemplos canônicos do JSON viram few-shot na geração. |
| 10 | `skill-copy-builder` | TODOS os 8 blocos | Estrutura do builder e calibragem das perguntas se ajustam à voz. Output final reflete cada bloco capturado. |
| 11 | `lara-builder` | `tom_principal`, `palavras_ancora`, `palavras_banidas`, `como_chama_audiencia`, `abertura_padrao`, `fechamento_padrao` | Lara (vendedora IA) fala com voz da mentorada — apelido de audiência, abertura, fechamento, vocabulário. Banidas viram regra dura no system prompt da Lara. |

---

## Detalhamento por skill

### 1. `briefing-copy-360`

**O que muda no fluxo da skill consumidora:**

A skill `briefing-copy-360` tem o Nível 2.2 — Criador/Autoridade, que pergunta "tom de voz natural" como dado de entrada. Com `voz-de-marca-builder` rodada antes, esse dado é PRÉ-PREENCHIDO.

**Pseudo-hook:**

```
def passo_2_2_criador():
    voz = carregar_voz_marca(mentorada_slug)
    if voz:
        autopreencher({
            "tom_voz": voz["tom_principal"],
            "tons_secundarios": voz["tons_secundarios"],
            "frase_descritiva": voz["frase_de_voz"]
        })
        confirmar_com_usuario(autopreenchido)
    else:
        perguntar_manualmente()
```

**Benefício:** mentorada não responde duas vezes a mesma pergunta. Briefing fica consistente com voz capturada.

---

### 2. `headline-imperatriz`

**Como aplica:**

Cada variação de headline gerada pela `headline-imperatriz` passa por filtro:

1. **Filtro de banidas (regra dura):** se a headline contém qualquer palavra de `palavras_banidas`, a variação é DESCARTADA antes de scoring.
2. **Booster de âncoras:** headlines que usam 1-2 palavras de `palavras_ancora` ganham +5 no scoring Bencivenga (palavra-âncora aumenta reconhecibilidade).
3. **Calibragem de tom:** o gerador escolhe vocabulário compatível com `tom_principal` + `tons_secundarios`. Tom íntimo-empoderador puxa palavras como "você", "sua", "comigo"; tom técnico-formal puxa "operação", "sistema", "decisão".
4. **Abertura padrão como template:** quando a headline é tipo "abertura de copy" (lead, hook), aplica uma das fórmulas de `abertura_padrao` adequada ao canal.

**Output enriquecido:** cada headline vem com tag `[voz: X% âncoras / 0 banidas / tom bate]`.

---

### 3. `voz-humana-br` em modo `--voz=mentorada`

**Como aplica:**

A `voz-humana-br` já tem o modo `--voz=mentorada` previsto. Antes desta skill existir, ela pedia 1 parágrafo manual da mentorada. Com `voz-de-marca-builder` rodada, o modo `--voz=mentorada` lê o JSON automaticamente:

1. Carrega `palavras_banidas` → mescla com lista vermelha padrão de IA (rejeita ambas)
2. Carrega `palavras_ancora` → marca como preferência lexical (substitui sinônimos genéricos pelas âncoras quando faz sentido)
3. Carrega `ritmo.tamanho_medio_frase` e `desvio_padrao_frase` → ajusta régua quantitativa de reescrita pra bater com perfil da mentorada
4. Carrega `pontuacao_caracteristica` → libera essas marcas no output (ex: se travessão é característico, libera; se não, mantém banimento)
5. Carrega `tiques_deliberados` → autoriza quebra de regra específica (começar com "E", frase sem verbo)
6. Carrega `exemplos_canonicos` → usa como few-shot de calibragem na reescrita
7. Carrega `como_chama_audiencia` e `abertura_padrao` → ajusta tratamento e abertura

**Benefício:** voz humana da mentorada vira automatizada, sem precisar de exemplo manual a cada uso.

---

### 4. `copy-conversacional-dm`

**Como aplica:**

A skill gera sequências de DM (WhatsApp, Instagram). Cada mensagem da sequência:

1. **Abertura:** se for primeira mensagem, aplica fórmula de `abertura_padrao` filtrada por `canal: whatsapp-direto` ou `instagram-stories`.
2. **Tratamento:** sempre usa um item de `como_chama_audiencia` (ex: "[Nome]" + "amada" + "mentorada") em rotação.
3. **Vocabulário:** privilegia `palavras_ancora`, bane `palavras_banidas`, libera `girias_ok`.
4. **Tom:** calibra agressividade da sequência pelo eixo `amiga_ou_coach` — coach mais direta, amiga mais carinhosa.
5. **Fechamento:** mensagens de fechamento de venda usam `fechamento_padrao` filtrado por `canal: cta-vendas`.

**Exemplo:** sequência de DM da Tata vs Carla pra mesma oferta vai sair MUITO diferente porque elas têm aberturas, tratamentos, ritmos e fechamentos distintos.

---

### 5-8. Skills de criativos (`dor-beneficio`, `urgencia`, `retargeting`, `qa-instagram`)

**Padrão comum:**

Cada skill de criativo gera texto + visual pra anúncio Meta Ads. A parte de texto:

1. Headline aplica regra de palavras-banidas (rejeita) e palavras-âncora (privilegia).
2. Corpo do criativo aplica ritmo da mentorada (frases curtas vs longas).
3. CTA puxa do `fechamento_padrao` tipo `cta-vendas`.
4. Tratamento de audiência consistente com `como_chama_audiencia`.

**Particularidades:**

- **`criativos-dor-beneficio`** — pivotagem de dor pra benefício respeita tom emocional da mentorada (não vai usar tom agressivo se ela é acolhedora).
- **`criativos-urgencia`** — escassez/prazo na voz dela ("imperatriz não pede licença" vs "decisão é sua").
- **`criativos-retargeting`** — reabertura puxa `abertura_padrao`.
- **`criativos-qa-instagram`** — pergunta da caixinha simulada e resposta saem com vocabulário e tratamento dela.

---

### 9. `skill-pagina-vendas`

**Como aplica:**

A skill de página de vendas usa TODOS os 8 blocos do JSON. Cada bloco da página:

| Bloco da página | Campos do JSON aplicados |
|-----------------|--------------------------|
| Hero (headline + sub-headline + CTA) | `tom_principal`, `palavras_ancora`, `abertura_padrao`, `fechamento_padrao` (CTA) |
| Sub-hero (resumo da oferta) | `tom_principal`, `palavras_ancora`, `ritmo` |
| Blocos de dor/benefício | `palavras_banidas` (rejeita), `palavras_ancora` (privilegia), `tons_secundarios` |
| Sobre a autoridade | `frase_de_voz`, `tom_principal`, exemplos canônicos como amostra |
| Mecanismo único | `palavras_ancora` (nome do mecanismo respeita vocabulário), `tom_principal` |
| Stack de valor | Tom calibrado, banidas evitadas |
| Garantia | Tom calibrado (Tata vai escrever garantia "imperatriz não pede licença"; Carla vai escrever "garantia da casa") |
| FAQ | Voz coerente — perguntas como mentorada faria, respostas como mentorada responderia |
| CTA final | `fechamento_padrao` tipo `cta-vendas` |
| Depoimentos | (não muda — texto do cliente é sagrado, não passa por voz da mentorada) |

**Benefício:** página inteira soa como mentorada escrevendo. Não como página de mercado padronizada.

---

### 10. `skill-copy-builder`

**Como aplica:**

Skill investigativa que conduz construção de copy bloco a bloco. Cada pergunta que ela faz vira mais inteligente com voz capturada — em vez de perguntar "qual seu tom?", já sabe.

Output final do builder reflete a voz capturada em cada bloco gerado.

---

### 11. `lara-builder`

**Como aplica:**

Lara é vendedora IA personalizada. Quando a `lara-builder` constrói uma Lara pra mentorada [X], usa a voz dela como base do system prompt da Lara:

```
Você é Lara, vendedora da [Mentorada X].
Você fala COMO a [Mentorada X] fala:
- Tom: [tom_principal] com [tons_secundarios]
- Trate o lead como: [como_chama_audiencia]
- Abra com: [abertura_padrao]
- Use as palavras: [palavras_ancora]
- NUNCA use: [palavras_banidas]
- Ritmo: [ritmo.padrao] — frases médias de [tamanho_medio_frase] palavras
- Pontuação típica: [pontuacao_caracteristica]
- Feche com: [fechamento_padrao]

Exemplos da voz da [Mentorada X]:
[exemplos_canonicos]
```

**Benefício:** Lara da Tata fala como Tata, Lara da Carla fala como Carla. Cliente sente que está conversando com a mentorada (ou com alguém treinada pela voz dela), não com bot genérico.

---

## Hook de leitura — implementação prática (snippet)

```bash
# Função utilitária que toda skill consumidora pode adotar
carregar_voz_marca() {
  local mentorada_slug="$1"
  local arquivo="$HOME/imperio/mentoradas/$mentorada_slug/03-voz-de-marca.json"

  if [ ! -f "$arquivo" ]; then
    echo "ERRO: voz não capturada pra mentorada [$mentorada_slug]." >&2
    echo "Antes de gerar copy, rode /voz-de-marca-builder." >&2
    return 1
  fi

  cat "$arquivo"
}
```

Em pseudo-código de prompt:

```
# Toda skill consumidora começa assim:
voz = carregar_voz_marca(mentorada)
if not voz:
    return error("Voz não capturada. Rode /voz-de-marca-builder primeiro.")

# Injeta no prompt:
prompt += f"""
Voz da mentorada (LEIA E RESPEITE):
{voz}

REGRAS DURAS:
- NUNCA use palavras de palavras_banidas
- Privilegie palavras de palavras_ancora
- Aplique tom_principal e tons_secundarios
- Calibre ritmo pra tamanho_medio_frase ± desvio_padrao_frase
- Comece com uma fórmula de abertura_padrao quando aplicável
- Termine com uma fórmula de fechamento_padrao quando aplicável
- Trate audiência usando termos de como_chama_audiencia
"""
```

---

## Validação cruzada — quem garante consistência?

Toda vez que uma skill consumidora gera texto, **opcionalmente** roda `voz-humana-br --voz=mentorada` como validação final. Se o texto:

- Usa palavra banida → reescreve trecho automaticamente
- Não usa nenhuma palavra-âncora em texto > 200 palavras → adiciona uma onde couber
- Tem ritmo destoante (frase muito longa quando padrão é curto) → quebra
- Não respeita tom (texto agressivo quando perfil é acolhedor) → ajusta

A integração `voz-de-marca-builder → skill-de-copy → voz-humana-br` é o pipeline canônico de qualquer copy do ecossistema Tata.

---

## Roadmap de integração

| Fase | O que acontece |
|------|----------------|
| **Fase 1 (atual)** — Captura | Tata captura voz das 5 primeiras mentoradas com `voz-de-marca-builder`. Gera `03-voz-de-marca.json` em cada pasta. |
| **Fase 2** — Adoção das skills primeiro grau | `voz-humana-br`, `headline-imperatriz`, `briefing-copy-360` passam a ler o JSON automaticamente. |
| **Fase 3** — Adoção das skills de criativos | 4 skills de criativos passam a ler o JSON. |
| **Fase 4** — Adoção das skills de produção pesada | `skill-pagina-vendas`, `skill-copy-builder`, `copy-conversacional-dm`, `lara-builder` passam a ler. |
| **Fase 5** — Auditoria contínua | Skill de auditoria roda a cada 90 dias verificando se voz capturada ainda bate com texto recente da mentorada. Sugere `--versionar` se drift detectado. |

---

**Integração — propriedade intelectual Tata Gonçalves.**
