---
name: raio-x:documento
description: |
  Gera o entregável final do Raio-X do Negócio — um HTML autocontido de 17 seções que o dono do
  negócio abre com duplo clique, imprime em PDF e usa de verdade: proposta de valor, calculadora
  interativa do custo invisível, portfólio, matriz ERRC, DQMP, ambiente competitivo, o canvas com
  os 8 gatilhos e os 3 pecados, promessas com prova, composição de valor, pitch em 3 tempos,
  variantes, objeções, stress test, hooks, mapa de IA, SWOT cruzada com plano de ação e os gaps.
  Use quando as respostas já foram coletadas e é hora de entregar: "gera o documento", "monta o
  canvas final", "quero o PDF", "fecha o entregável", "manda o HTML", "termina o canvas".
  Também use para regerar o documento depois que uma resposta mudou.
metadata:
  version: 1.0.0
---

# Documento final — o entregável

Você está gerando a peça que a pessoa vai abrir amanhã, semana que vem e daqui a três meses.
Não é um resumo da conversa. É um documento de trabalho.

---

## A regra que governa esta sub-skill

**Metade do documento é conteúdo que a pessoa não disse.**

O empresário responde os campos. O documento tem dados de mercado com fonte, tabelas de ativação,
calendário editorial e scripts — **isso não vem dele, vem da pesquisa e da derivação.**

Uma geração que só formatasse as respostas produziria um documento do tamanho do formulário. Esse
é exatamente o fracasso a evitar: a pessoa lê, reconhece as próprias frases e não encontra nada
que ela já não soubesse.

**O teste é este, e não uma razão de tamanho:** percorra as 17 seções e pergunte, uma a uma,
*"o que aqui a pessoa não sabia antes de sentar?"*. Seção que só reorganiza o que ela disse não
está pronta — falta a camada de fora (dado de mercado, derivação, cruzamento). Contar palavras
não pega esse erro: um documento pode ser longo e não dizer nada novo.

Por isso esta sub-skill tem **três fases, nesta ordem**:

| Fase | O que acontece | Sem ela |
|---|---|---|
| **1. Enriquecimento** | Pesquisar dados de mercado do setor · derivar os 8 gatilhos em profundidade · derivar as 7 seções de copy · montar tabelas · derivar o calendário e o script | Documento raso, do tamanho do formulário |
| **2. Geração seção a seção** | Cada seção vira um fragmento HTML gravado em `.canvas/secoes/` **antes de começar a próxima** | As últimas seções saem finas, e uma sessão interrompida perde tudo |
| **3. Montagem** | Encaixar os 17 fragmentos no esqueleto de `references/documento-final.md` | Conteúdo bom sem forma de entregável |

Não pule a fase 1 porque "as respostas já estão prontas". As respostas são a matéria-prima,
não o produto.

**E não tente gerar as 17 seções numa tacada.** É a falha mais provável desta sub-skill: as
primeiras seções saem densas, as últimas saem com três bullets, e ninguém percebe porque o
documento *parece* completo. A fase 2 existe exatamente para impedir isso.

---

## Fase 1 — Enriquecimento

### 1.1 Levantar dados de mercado do setor
Pesquise (WebSearch) de **5 a 8 estatísticas** do setor e do perfil de cliente da pessoa. Use as
melhores: 6 vão para a faixa da página 1, o resto alimenta a tabela da página 2 e os pecados da
página 3.

Cada dado precisa de **fonte nomeada + ano**. SEBRAE 2024, IBGE, ABESO, Fiocruz, YouGov 2023,
associação setorial, relatório de mercado. **Sem fonte, o dado não entra** — não existe "cerca de
70% das empresas". Se você não consegue confirmar de onde veio, corte e busque outro.

Prefira dados que:
- dimensionam o mercado dela (quantos clientes potenciais existem)
- quantificam a dor do cliente dela (quantos sofrem do problema que ela resolve)
- justificam urgência (o que piora se não resolver)

Descarte dados que só decoram. Todo número na página 1 precisa ter uso na copy — a coluna
"Como usar no copy" da tabela da página 2 é o teste: se você não consegue preencher, o dado sai.

### 1.2 Derivar os 8 gatilhos em profundidade
As respostas dão o esqueleto. Você escreve a carne: para cada gatilho, uma headline de uma linha,
um corpo de 40–60 palavras explicando **por que esse gatilho funciona nesse cliente específico**,
e uma copy entre aspas pronta para colar.

Os 8: Segurança · Curiosidade · Liberdade · Recompensa · Amor/Identidade · Diversão ·
Pertencimento · 7 Pecados.

### 1.3 Derivar as sete seções de copy
**Sete das 17 seções não custam uma pergunta a mais** — elas derivam do que já foi respondido:
UVP (01), promessas com prova (08), pitch em 3 tempos (10), variantes (11), objeções (12),
stress test (13) e hooks (14).

**O método de cada uma está em `references/derivacoes-copy.md`** — de quais campos ela se
alimenta, como transformar, o formato de saída e o par ❌/✅. Leia antes de escrever qualquer uma
das sete. Sem esse arquivo você improvisa, e a qualidade oscila entre uma sessão e outra.

A mais importante é o **stress test**: `.canvas/contradicoes.md` já contém o trabalho inteiro —
cada tensão confrontada durante a condução e como a pessoa respondeu. A seção só traduz aquilo em
risco → gatilho → blindagem. E vale a regra que está lá: **`contradicoes.md` vazio não é negócio
sem risco, é sinal de que as checagens não rodaram.** Não invente riscos genéricos para preencher.

### 1.4 Derivar tabelas, calendário e script
Nada disso é perguntado à pessoa. Tudo é derivado do que ela já disse:
- tabela de dados (página 2) — número + como usar + fonte
- tabela de ativação (página 3) — pecado × gatilho × canal × momento × copy de 1 linha
- calendário semanal (página 4) — 7 dias, cada um com gatilho e copy pronta do post
- 6 regras de copy com exemplo ❌/✅ — **específicas do negócio dela**
- script de venda numerado
- posicionamento em uma frase + por que ela funciona

### 1.5 Derivar o plano de ação
Organizado pelas 6 dimensões do diagnóstico, priorizando as de menor nota. Toda lacuna registrada
como "não medido" durante a coleta vira item aqui. É assim que um "não sei meu ticket médio"
deixa de ser buraco e vira primeira tarefa.

---

## Fase 2 — Estrutura do documento (capa + 17 seções)

**Scroll único com nav sticky por âncoras** — não são páginas que trocam por aba. A capa abre o
documento; as 17 seções vêm em sequência; na impressão cada uma começa em folha nova.

O esqueleto HTML completo, o CSS das 17 seções e um componente de exemplo de cada uma estão em
`references/documento-final.md`. **Copie o esqueleto, troque o conteúdo, não redesenhe o padrão.**

| # | Seção | `id` | De onde vem |
|---|---|---|---|
| — | **Capa** | — | `:diagnostico` (nota + dimensões críticas) + nome e negócio da abertura |
| 01 | Proposta única de valor | `uvp` | derivada — `derivacoes-copy.md` |
| 02 | Calculadora do custo invisível | `calc` | `:numeros` — **interativa**, sliders recalculam |
| 03 | Portfólio de serviços | `servicos` | `:portfolio` |
| 04 | Matriz ERRC | `errc` | `:posicionamento` |
| 05 | DQMP | `dqmp` | `:dqmp` |
| 06 | Ambiente competitivo | `concorrencia` | `:posicionamento` |
| 07 | O canvas | `canvas` | `:canvas` — persona, 8 gatilhos, 3 pecados, regras de copy |
| 08 | Promessas com prova | `promessas` | derivada — `derivacoes-copy.md` |
| 09 | Composição de valor + ancoragem | `valor` | `:valor` |
| 10 | Pitch em 3 tempos | `pitch` | derivada — `derivacoes-copy.md` |
| 11 | Variantes por perfil | `variantes` | derivada — `derivacoes-copy.md` |
| 12 | Tratamento de objeção | `objecoes` | derivada — `derivacoes-copy.md` |
| 13 | Stress test | `stress` | **`.canvas/contradicoes.md`** — o trabalho já está feito |
| 14 | Hooks de venda | `hooks` | derivada — `derivacoes-copy.md` |
| 15 | Onde a IA entra primeiro | `mapa-ia` | `:mapa-ia` — **uma** prioridade, não uma lista |
| 16 | SWOT cruzada + plano de ação | `planejamento` | `:posicionamento` + `:diagnostico` |
| 17 | Gaps abertos | `gaps` | tudo que foi registrado como "não sabe" |

**A seção 07 continua sendo o coração do documento** — o grid de 5 colunas com o círculo central
branco. O círculo carrega **a promessa formulada como frase de venda**, não o nome da empresa:
"Conserto que não trava sua semana", nunca "Oficina do Zé Ltda".

**Na seção 16, "até quando" é data no calendário** — 05/09, 30/09. Nunca "quando der", "assim que
possível" ou "após contratar". Condição não é prazo; condição é como plano morre.

### Quando falta matéria-prima para uma seção
**O documento sai assim mesmo.** Seção sem dado não é motivo para segurar o entregável — ela
aparece com a lacuna nomeada e vira item da seção 17. Um documento de 14 seções cheias e 3
marcadas como não medidas é honesto e útil; um documento que nunca sai porque a conversa não
terminou não serve para nada. **Nunca preencha seção vazia com conteúdo plausível.**

---

## Fase 2 — Geração seção a seção

**Uma seção por vez. Cada uma gravada em disco antes de começar a próxima.**

```
.canvas/secoes/
├── 00-capa.html
├── 01-uvp.html
├── 02-calc.html
├── ...
└── 17-gaps.html
```

### O ciclo, por seção
1. Reler em `.canvas/respostas.md` só o que alimenta **esta** seção (a tabela da fase 2 diz o quê).
2. Escrever o fragmento HTML — só o `<section>...</section>`, sem `<html>`, sem `<style>`.
   O componente correspondente está em `references/documento-final.md` §3.
3. **Gravar em `.canvas/secoes/NN-<id>.html` imediatamente.**
4. Só então passar para a próxima.

### Por que gravar antes de continuar
- **Sessão que cai não leva o trabalho junto.** Doze seções gravadas continuam gravadas.
- **Cada seção recebe atenção inteira.** É o que impede a seção 15 de sair com um terço da
  densidade da seção 02 — a degradação silenciosa é o modo de falha mais comum aqui.
- **Dá para regerar uma seção só** quando uma resposta muda, sem refazer o documento inteiro.

### Retomada
Se `.canvas/secoes/` já existe, **liste o que está lá e gere só o que falta.** Nunca regere uma
seção que já está boa — e nunca comece do zero porque "é mais simples". Antes de montar,
confirme que os 18 arquivos existem (capa + 17); os que faltarem entram no documento como seção
com lacuna nomeada, não como seção ausente.

### Quando delegar a agentes isolados
**As 17 seções não fazem nenhuma pergunta ao dono do negócio** — elas leem `.canvas/respostas.md`
e produzem. Isso as torna delegáveis: cada seção pode ser gerada por um agente isolado, em
paralelo, cada um escrevendo o seu próprio arquivo.

Duas regras que tornam isso seguro:
- **Um agente, um arquivo.** Dois agentes nunca escrevem a mesma seção.
- **Só delegue depois da fase 1.** O enriquecimento (dados de mercado, os 8 gatilhos, as sete
  derivações) precisa estar gravado em `.canvas/` antes — senão cada agente pesquisa por conta e
  o documento sai com sete vozes diferentes e dados que não conversam entre si.

O que **nunca** vai para agente isolado é a coleta: um agente não consegue perguntar nada ao dono
do negócio, então ele inventaria a resposta e devolveria um documento de uma empresa fictícia —
com a aparência exata de um documento correto. A condução é sempre da skill, na conversa.

---

## Regras de geração

1. **HTML autocontido, arquivo único, zero dependência externa** — exceto a fonte via Google Fonts.
   Deve abrir com duplo clique e imprimir em PDF. Sem build, sem servidor, sem framework.
2. **Nunca invente dado do negócio da pessoa.** Se ela não sabe o ticket médio, o documento
   escreve **"não medido"** e isso vira item do plano de ação. Preencher com estimativa contamina
   todo cálculo seguinte e destrói a confiança quando ela percebe.
3. **Dado de MERCADO exige fonte e ano.** Sem fonte, não entra. Na dúvida sobre a origem, não use.
4. **Marque o que veio de resposta e o que veio de derivação.** O leitor precisa saber o que ele
   disse e o que foi inferido. Use a marcação `.tag-derivado` do template nos blocos derivados.
5. **Registre o modo.** Resposta dada em modo guiado (a pessoa não sabia e foi conduzida) vale
   diferente de dado declarado. Um "não sei calcular meu break-even" é **achado**, não lacuna —
   registre como achado e leve para o plano de ação.
6. **Bifurque B2B/B2C** conforme o hub:
   - **B2B** → Recompensa vira fórmula de ROI com as variáveis do lead (`R$[X]` de faturamento,
     `[Y]` de perda, `[W]` de custo). Tabela de ativação mapeia gatilho × **etapa de funil**.
   - **B2C** → Recompensa vira linha do tempo de sensações (semana 1 / mês 1 / mês 3). Tabela de
     ativação mapeia gatilho × **canal e evento de vida**.
7. **Um único accent por documento.** Escolha a cor a partir do setor e da marca dela, e use em
   tudo — não misture paletas.
8. **A identidade é da pessoa, não sua.** `{{ACCENT}}` e o par tipográfico saem do setor e da
   marca **que o negócio já tem**. Nunca use a tipografia ou a paleta de quem construiu a skill —
   o documento é do negócio dela. Sem marca definida, fique no default neutro do template.
9. **A calculadora da seção 02 é interativa.** Os inputs vêm pré-preenchidos com os números reais
   declarados em `:numeros`; os sliders deixam a pessoa testar cenário. O veredito diz o que o
   número significa para o negócio dela — **não vende nada, não recomenda ferramenta, não cita
   produto.** É diagnóstico, não anúncio.
10. **O vocabulário interno nunca chega ao leitor.** `:numeros`, `:posicionamento`, `Mov. 3`,
   `EREC`, `DQMP`, `.canvas/` são a linguagem de quem *constrói* o documento. O dono do negócio
   não sabe o que é nenhuma dessas coisas. Isso vale para o texto visível **e para os atributos
   do HTML** (`data-source`, `title`, comentário que aparece na tela) — foi por ali que vazou num
   teste real. Ao citar a origem de um dado, escreva em português: "declarado por você", "calculado
   a partir dos seus números", "estimado".
11. **Todo número derivado precisa de destino.** A fase 1 calcula mais números do que as seções
   consomem — potencial de reativação, ponto de equilíbrio em unidades, margem por serviço. Ao
   fechar a montagem, **liste os números derivados e confira que cada um aparece em alguma
   seção.** O que não achou lugar vai para a seção 16 (plano de ação) ou 17 (gaps) — nunca some
   em silêncio. Num teste real, o potencial de reativação foi calculado corretamente e
   simplesmente não chegou ao documento; ninguém teria percebido.
12. **Data no plano de ação, e o que fazer quando ela não existe.** A regra é data no calendário —
   05/09, 30/09 — nunca "quando der" ou "a combinar". Mas quando a conversa genuinamente não
   produziu a data (depende de terceiro, de contratação, de uma decisão que a pessoa ainda não
   tomou), **a linha não fica sem prazo: ela sai do plano de ação e vira item da seção 17**, com
   o que precisa acontecer antes de virar tarefa. Plano de ação só tem linha com data. Pendência
   honesta tem lugar próprio — e o lugar não é o plano.

---

## Como escrever o conteúdo

Puxe os critérios de `references/calibracao.md` — a régua de aceite da coleta é a mesma régua de
escrita do documento. Se um campo passou como "forte" lá, ele entra aqui com essa densidade.

**Comprimentos:**

| Elemento | Palavras |
|---|---|
| Bullet de célula do canvas (07) | 8–25 |
| Corpo de gatilho (07) | 40–60 |
| Mecânica de pecado (07, 2 parágrafos) | 90–120 |
| Copy entre aspas (qualquer seção) | 15–40 |
| Risco do stress test (13) | 40–80 |

Os comprimentos das sete seções derivadas — UVP, promessas, pitch, variantes, objeções, hooks —
estão em `references/derivacoes-copy.md`, junto com o método de cada uma.

**A copy vem entre aspas, pronta para colar — nunca como instrução.**

❌ "Fale sobre a segurança do método para reduzir o risco percebido."
✅ "Antes de qualquer coisa: não existe alimento proibido aqui. Vou montar um plano que cabe na
sua rotina real — não na rotina que você gostaria de ter."

A primeira é um briefing que a pessoa ainda precisa executar. A segunda ela copia e cola no
Instagram hoje. Só a segunda é entregável.

---

## Antes de entregar

Rode o **checklist de saída** de `references/documento-final.md`. Ele pega os erros que já
aconteceram nos documentos reais — principalmente placeholder não resolvido (`[nome]` num case
sem nome), dado sem fonte e prazo escrito como condição.

Salve o arquivo como `RAIO-X-<nome-do-negocio>.html` no diretório de trabalho, ao lado de
`.canvas/`. Diga à pessoa que ela abre com duplo clique, que a barra do topo navega entre as 17
seções, e que Ctrl/Cmd+P gera o PDF em A4 paisagem.

**Não apague `.canvas/secoes/`.** É o que permite regerar uma seção isolada quando um número
muda, sem refazer as outras dezesseis.

### O teste de densidade — rode antes de entregar
Compare o tamanho dos fragmentos em `.canvas/secoes/`. **Se as últimas seções forem
sistematicamente menores que as primeiras, a geração degradou** — não é que elas tenham menos a
dizer, é que a atenção acabou. Regere as seções finas uma a uma.

É o único jeito de pegar esse erro: um documento degradado não parece quebrado, parece pronto.