# Workflow de Referências — Ancoragem na Voz da Fernanda

**Severidade:** BLOQUEANTE (de qualidade, não de burocracia)
**Aplicação:** TODOS os agentes do squad (copywriter, brand-director, paid-traffic, web-designer)
**Última atualização:** 2026-06-08 (v2.1 — modelo enxuto + @web-designer)

---

## Princípio fundamental

> **O squad nunca produz no vácuo. Toda peça nasce da voz destilada da Fernanda — que mora dentro do squad — somada às referências que chegam pelo chat na sessão.**

Este squad é enxuto **de propósito**. Ele não carrega gigabytes de PDF, transcrição bruta e copy histórica. O que ele carrega é o **destilado** desse acervo — a voz, o avatar, o compliance, a identidade — em arquivos leves de `expert-intelligence/`. Esse destilado é a fonte de verdade da voz da Fernanda.

Quando uma peça pede referência concreta (uma página histórica específica, um criativo aprovado, um print de campanha que funcionou), **o Anthony ou a equipe cola essa referência no chat da sessão**. O agente usa o que foi colado + o destilado interno. Nada de paths de arquivos pesados embutidos.

**Por que mudou (v2.0):** a versão anterior obrigava cada peça a ler um `source-doc` por path interno e citar 3 arquivos internos, senão rejeitava. Isso transformava cada entrega num ritual de "provar que leu o arquivo" e tornava o squad pesado e travado — a copy boa era rejeitada por falta de citação, e a copy fraca passava se tivesse a citação. O gate de qualidade real (anti-IA + tom da Fernanda + compliance) ficava em segundo plano. Agora o gate volta a ser a **qualidade**.

---

## O que SEMPRE ancora a peça (interno, leve, obrigatório)

Antes de produzir qualquer peça, o agente DEVE ter lido na sessão a inteligência destilada correspondente. Esses arquivos são leves e são a voz canônica:

| Para qualquer copy | `expert-intelligence/linguagem-e-tom.md` · `expert-intelligence/manual-comunicacao-fernanda.md` · `expert-intelligence/voz-snapshots-fernanda.md` · `core/data/voice-dna-fernanda.yaml` |
| Para definir ângulo/avatar | `expert-intelligence/avatar-fernanda.md` · `expert-intelligence/diferenciais-competitivos.md` · `expert-intelligence/posicionamento.md` |
| Para qualquer produto | `expert-intelligence/produtos.md` · `expert-intelligence/perfil-fernanda.md` |
| Para compliance (sempre) | `expert-intelligence/compliance.md` |
| Para peça visual | `expert-intelligence/brandbook-fernanda.md` · `brand-assets/brandbook.html` · `brand-assets/logos/` |
| Para concorrência/posicionamento | `expert-intelligence/concorrentes.md` · `expert-intelligence/players-referencia.md` |

**Regra:** sem a voz destilada carregada (mínimo: `linguagem-e-tom.md` + `manual-comunicacao-fernanda.md` + `compliance.md`), nenhuma copy é escrita. Isso é o QG-000.5.

---

## Referências concretas: chegam pelo chat

Quando a peça se beneficia de uma referência real e específica (uma página de vendas que converteu, um e-mail com boa abertura, um criativo aprovado pela Fernanda, um print do manual visual), o fluxo é:

1. O agente identifica que precisa da referência concreta e **pede ao USER no chat** se ainda não foi colada: *"Pra essa página de vendas de PBE:TCCs, me cola 1-2 páginas históricas que funcionaram, ou sigo só com a voz destilada?"*
2. O USER cola a referência no chat (texto, link ou imagem).
3. O agente **extrai o padrão concreto** da referência colada (estrutura, tom, vocabulário, estética) e aplica.
4. Se o USER não colar nada, o agente produz com a voz destilada interna — **sem bloquear** a entrega por isso.

> Diferença para a v1: a referência concreta deixou de ser pré-requisito bloqueante embutido em path. Ela é um insumo que, quando existe na sessão, é obrigatório usar; quando não existe, o destilado interno sustenta a peça.

---

## Citação na entrega (leve, honesta)

Toda peça entregue ao USER inclui ao final uma seção curta dizendo **o que ancorou a peça**:

```
## O que ancorou esta peça

- expert-intelligence/manual-comunicacao-fernanda.md — tom e aberturas
- expert-intelligence/avatar-fernanda.md — dor primária do avatar de [produto]
- [referência colada no chat, se houve] — [o que foi extraído]
```

Regra realista: **cite o que de fato embasou** — não invente citação pra cumprir cota. Se a peça nasceu da voz destilada + 1 referência do chat, são 2 itens, e está certo. O @orchestrator rejeita citação **fabricada** (arquivo que não foi lido), não a citação curta e verdadeira.

---

## Como usar referência (não basta ler — tem que aplicar)

### Uso correto
- "Da voz destilada (`voz-snapshots-fernanda.md`) peguei o tom de colega-pra-colega e o vocabulário `condução de caso`, `padrão clínico`."
- "Da página histórica que você colou, espelhei a estrutura `Marco temporal → Cenário → Quebra → Caminhos → Comparativo`."
- "Do `avatar-fernanda.md`, ancorei a dor primária do psicólogo em formação."

### Uso incorreto (rejeitado)
- Citar um arquivo que não foi lido (citação fabricada).
- Produzir copy de marqueteiro genérico ignorando a sobriedade do `linguagem-e-tom.md`.
- Dizer "adaptei o estilo da Fernanda" sem demonstrar de onde veio (voz destilada ou referência do chat).

---

## Por que essa regra existe

A Fernanda construiu, ao longo de anos: voz própria, identidade visual, posicionamento técnico e repertório aprovado. O squad só tem valor se operar **dentro do universo dela** — replicando o que funciona, evitando o que ela rejeita, mantendo a sobriedade acadêmica.

O destilado dessa inteligência vive no squad (leve). O acervo bruto vive fora (com o Anthony) e entra pelo chat quando preciso. **Toda peça é uma evolução do universo da Fernanda — nunca uma criação genérica do zero.**

---

## Enforcement

| Quem | O quê |
|---|---|
| `@copywriter` · `@brand-director` · `@paid-traffic` · `@web-designer` | Ancoram na voz destilada interna + usam o que o USER colou no chat; citam honestamente |
| `@orchestrator` | Bloqueia peça que ignora a voz destilada ou inventa citação; pede referência do chat ao USER quando a peça pede |
| `@anti-ia-reviewer` | Julga, independente, se a peça soa como a Fernanda ou como IA/marqueteiro (PASSO 7.1) |
| USER (Anthony/equipe) | Cola referências concretas no chat quando a peça pede |

---
*Workflow de Referências — Squad Fernanda Landeiro v2.1 — © 2026 7D/SECRETS LTDA — Anthony Nichols & André Cia*
