---
name: raio-x:enriquecer-agentes
description: |
  Transforma o diagnóstico do Raio-X do Negócio em contexto operacional — gera o
  `PERFIL-DO-NEGOCIO.md` (o destilado consultável do negócio) e, se houver agentes de IA
  instalados, personaliza os que mudam de comportamento com esse contexto: copy, comercial,
  tráfego pago, financeiro, produto e posicionamento.
  Use quando alguém disser: "personaliza meus agentes", "faz os agentes conhecerem meu negócio",
  "gera o perfil do meu negócio", "quero que a IA pare de me perguntar o que a empresa faz",
  "meus agentes não sabem nada da minha empresa", "atualiza o perfil depois do diagnóstico",
  "rodei o canvas de novo, atualiza tudo".
  Funciona sem nenhum agente instalado — nesse caso entrega só o perfil, como arquivo solto.
metadata:
  version: 1.0.0
---

# Enriquecer agentes com o contexto real do negócio

O problema que isto resolve: um pack de agentes instalado por questionário de terminal sabe
*"dono de empresa, 30–50 anos"* e nada mais. Toda conversa começa com o dono explicando o
negócio de novo. O diagnóstico do canvas já tem persona real, diferencial validado, margem,
break-even, os pecados e o que foi decidido eliminar. Esta sub-skill leva esse contexto até
onde ele muda decisão.

**Você vai mexer em arquivo de configuração da pessoa.** A postura é conservadora: mostrar
antes, pedir confirmação, fazer backup, usar marcador que permite desfazer e substituir sem
duplicar. Nada aqui é editado em silêncio.

---

## Pré-requisito

Leia `.canvas/respostas.md` e `.canvas/estado.md` antes de qualquer coisa.

- **Não existe `.canvas/`** → esta sub-skill não tem matéria-prima. Diga isso e proponha
  `raio-x:diagnostico` primeiro. Não invente perfil a partir de conversa solta.
- **Existe, mas faltam movimentos** → gere o perfil com o que existe e marque cada bloco vazio
  como `⚠️ não levantado — rodar :movimento`. Campo vazio declarado vale mais que campo
  preenchido por estimativa: o agente que ler sabe que ali ele deve perguntar, não assumir.

---

## Passo 1 — Detecção (roda antes de tudo, sem editar nada)

```bash
ls ~/.claude/agents/*.md 2>/dev/null | wc -l      # agentes globais
ls ./.claude/agents/*.md 2>/dev/null | wc -l      # agentes do projeto atual
ls ~/.claude/CLAUDE.md ./CLAUDE.md 2>/dev/null    # onde vive o ponteiro
```

**Onde o perfil é gravado:** se o diretório atual tem `.claude/` ou `CLAUDE.md` próprio, o
negócio é daquele projeto → grave em `./PERFIL-DO-NEGOCIO.md`. Caso contrário →
`~/.claude/PERFIL-DO-NEGOCIO.md`. Na dúvida, pergunte — é uma pergunta, não um palpite.

### Caso A — Existem agentes
Diga quantos encontrou, onde, e as três camadas que propõe: **1)** gerar o perfil,
**2)** adicionar UMA seção no `CLAUDE.md` apontando pra ele, **3)** injetar contexto em ~8
agentes onde isso muda comportamento — os demais ficam intactos. Pergunte se pode mostrar o
texto exato antes de escrever.

Avance **camada por camada**, com um "sim" explícito para cada. Não peça autorização
guarda-chuva para as três.

**Ignore duplicatas de cópia** (`aquiles 2.md`, `momos 2.md` e afins). São artefatos de
sincronização; editar os dois lados duplica contexto e cria divergência silenciosa.

### Caso B — Não existem agentes
Gere **só** o `PERFIL-DO-NEGOCIO.md` e entregue assim:

> *"Gerei o `PERFIL-DO-NEGOCIO.md`. Ele é feito pra ser colado: joga no começo de qualquer*
> *conversa com IA — ChatGPT, Claude, Gemini — e ela para de te perguntar o que a empresa faz.*
> *(Se um dia você instalar um pack de agentes de IA no Claude Code, esse mesmo arquivo é lido*
> *automaticamente por eles.)"*

Uma linha sobre o pack. Sem pitch, sem link, sem repetir depois.

---

## Passo 2 — Camada 1: o perfil

Um arquivo. Fonte única. Tudo que vier depois só aponta para cá.

**Regras de preenchimento:** todo número vem do `:numeros` com a marca de origem — `[declarado]`
quando a pessoa sabia, `[calculado]` quando saiu de conta, `[não sabe]` quando não saiu. Nunca
apague um `[não sabe]` com estimativa. Frases da pessoa entram entre aspas, na voz dela.

### Template completo — `PERFIL-DO-NEGOCIO.md`

```markdown
# Perfil do Negócio — {Nome da Empresa}

> Gerado por `raio-x:enriquecer-agentes` · **versão 1** · 11/08/2026
> Fonte: `.canvas/respostas.md` · Próxima reavaliação sugerida: 11/11/2026
>
> **Se você é um agente de IA lendo isto:** este é o contexto real deste negócio, levantado em
> diagnóstico com o dono. Use-o antes de opinar, sugerir ou escrever qualquer coisa sobre a
> empresa. Onde estiver `[não sabe]`, **pergunte — não preencha**.

## 1. Identificação
- **Empresa:** Auto Center Silva · **Dono:** Marcos Silva · **Desde:** 2018
- **O que faz:** manutenção e revisão de carros de passeio, oficina própria em Ribeirão Preto
- **Modelo:** serviços avulsos e plano de manutenção anual · **Onde vende:** WhatsApp e indicação
- **Fase de maturidade:** organização (fatura, mas depende inteiramente do dono)
- **Tipo de planejamento vigente:** organizar antes de crescer

## 2. Persona — pra quem se fala
- **Quem é:** dono de carro com 5+ anos de uso, 35–55 anos, mora ou trabalha perto da oficina,
  já foi cobrado por peça que não precisava em outro lugar
- **O dia dele:** o carro começa a fazer um barulho estranho, ele adia porque tem medo de pagar
  caro por peça desnecessária, só leva quando o carro para de vez
- **O que ele já tentou:** trocar de oficina 2–3 vezes, pedir orçamento em vários lugares antes
  de fechar, tentar resolver sozinho com tutorial de internet
- **Como ele chega:** indicação de vizinho ou colega de trabalho, ou busca "oficina perto de mim"
- **O que ele teme:** ser cobrado por peça que não precisava, ficar sem carro por dias
- **Objeções reais que ele verbaliza:** "vou pegar outro orçamento antes" · "deixa eu ver se
  resolve sozinho" · "não confio em oficina que eu não conheço"

## 3. Experiência central
> A cena que o cliente vive e que nenhum concorrente entrega igual.

"Ele deixa o carro de manhã e recebe um vídeo do mecânico mostrando a peça gasta antes de
qualquer troca. Em 40 minutos o orçamento chega no WhatsApp com foto — e é a primeira vez que
alguém mostra o problema antes de cobrar por ele."

## 4. Diferencial validado
- **Declarado:** "atendimento honesto" → ❌ rejeitado, é obrigação
- **Validado:** manda vídeo da peça gasta antes de trocar, sem exceção (nenhuma oficina da
  região faz isso)
- **Prova:** 310 orçamentos aprovados com vídeo em 2025; taxa de aprovação subiu de 40% para 78%

## 5. Credo — o que esta empresa se recusa a fazer
- Não troca peça sem mostrar o desgaste para o cliente primeiro
- Não atende mais de 8 carros por dia — "prefiro faturar menos que devolver carro com problema"
- Não cobra hora de diagnóstico à parte

## 6. Decisões de posicionamento (matriz EREC)
| | O quê | Por quê |
|---|---|---|
| **Eliminar** | lavagem de cortesia | consumia tempo de box e ninguém decidia por causa disso |
| **Reduzir** | atendimento aos sábados | 4 carros/sábado, quebrava a folga do dono |
| **Elevar** | orçamento em vídeo (só em casos difíceis → em todo carro) | é onde o cliente decide confiar |
| **Criar** | aviso automático da próxima revisão por WhatsApp | ninguém no bairro faz |

## 7. Os 3 pecados dominantes
> Governam TODO o copy. Se uma peça não ativa um destes três, não é desta empresa.

| # | Pecado | Como se manifesta nesta persona | Mecanismo de ativação |
|---|---|---|---|
| 1 | **Medo** | medo de pagar por peça trocada sem necessidade | nomear o mecanismo: "você só paga pela peça depois de ver o desgaste no vídeo" |
| 2 | **Ira** | raiva de ter pago caro numa oficina antes e o problema ter voltado em 1 mês | reposicionar a culpa: o problema foi a oficina anterior, não ele |
| 3 | **Preguiça** | não quer perder o dia acompanhando o conserto | reenquadrar como sobrecarga: "o vídeo chega até você — você não precisa ficar esperando no local" |

## 8. Os 8 gatilhos — resumo operacional
> Cada linha responde: **por que domina aqui · com que prova · em que canal**.
> Copie os nomes exatamente como saíram do `:canvas`. Se um gatilho não foi trabalhado,
> escreva `⚠️ não levantado` — não invente.

| Gatilho | Por que pega nesta persona | Prova que sustenta | Onde usar |
|---|---|---|---|
| **Segurança** | ele já foi cobrado por peça que não precisava | 310 orçamentos com vídeo, aprovação subiu de 40% pra 78% | primeira mensagem no WhatsApp |
| **Curiosidade** | R$ 6.700/mês de leads não respondidos | cálculo do custo invisível | remarketing, follow-up |
| **Pertencimento** | "dono de carro que não aceita mais orçamento sem explicação" | o credo | conteúdo orgânico |
| **Liberdade** | não precisa ficar esperando no local nem ligar pra saber status | vídeo + atualização por WhatsApp | página de vendas |
| ... | *demais gatilhos conforme `:canvas`* | | |

## 9. Números-chave
| Indicador | Valor | Origem |
|---|---|---|
| Leads/mês | 70 | [declarado] |
| Respondidos em até 30 min | 28% | [declarado] |
| Ticket médio | R$ 850 (revisão + peça) | [declarado] |
| Faturamento/mês | R$ 29.750 (35 serviços) | [declarado] |
| Custo fixo/mês | R$ 18.000 | [calculado] |
| Custo variável por serviço | R$ 382,50 (45% do ticket — peças, insumos, comissão) | [calculado] |
| Margem de contribuição | 55% | [calculado] |
| Ponto de equilíbrio | R$ 32.730/mês — 39 serviços | [calculado] |
| Margem líquida | **-5,5% (prejuízo de R$ 1.637,50/mês)** | [calculado] |
| **Custo invisível** | **R$ 6.700/mês** em leads não respondidos a tempo | [calculado] |
| Base de clientes cadastrados | 420 (260 sem retorno há 6+ meses) | [declarado] |
| Verba de tráfego | R$ 700/mês | [declarado] |
| CAC | [não sabe] | ⚠️ levantar |
| Método de precificação hoje | "olho o que o concorrente cobra e desconto um pouco" | ⚠️ risco: preço sem custo |

## 10. Escada de valor
| Degrau | Oferta | Preço | Status |
|---|---|---|---|
| Entrada | diagnóstico com vídeo | R$ 120 | ativo |
| Principal | revisão preventiva completa | R$ 850 | ativo |
| Topo | plano de manutenção anual (revisões trimestrais + prioridade de agenda) | R$ 2.400/ano | a criar |

## 11. Notas do diagnóstico — 11/08/2026
| Dimensão | Nota (0–10) | Leitura |
|---|---|---|
| 💰 Financeiro | 2 | fatura, mas não sabe que está no prejuízo |
| 🎯 Comercial | 4 | sem follow-up, 72% dos leads sem resposta rápida |
| ⚙️ Processos | 6 | tudo depende do dono e de um mecânico sênior |
| 👥 Pessoas | 5 | 2 mecânicos e 1 recepção, sem descrição de função |
| 🏛️ Cultura | 7 | credo claro (vídeo antes de trocar peça), equipe nova ainda internalizando |
| 🚀 Tecnologia | 3 | agenda no caderno, orçamento por WhatsApp manual |
| **Total** | **27/60** | ordem de trabalho: Financeiro → Tecnologia → Comercial |

## 12. Contradições confrontadas
| Contradição | Como foi resolvida |
|---|---|
| "diferencial é atendimento honesto" × 72% dos leads sem resposta rápida | diferencial reescrito para o vídeo da peça antes da troca; velocidade de resposta virou item 1 do plano |
| "acha que está indo bem porque fatura R$ 29.750" × margem líquida negativa | decidido: descobrir o preço real de cada serviço antes de tentar vender mais |

## 13. Como falar deste negócio
- **Tom:** direto, sem economês, sem intimidar quem não entende de carro
- **Nunca usar:** "menor preço da cidade", prazo que não pode cumprir, comparação agressiva com concorrente nomeado
- **Sempre usar:** "vídeo antes de trocar", prazo real de entrega, nome da peça em português simples (não código de peça)
- **Posicionamento em uma frase:** "A única oficina de Ribeirão Preto que manda vídeo da peça gasta antes de cobrar por ela."
```

---

## Passo 3 — Camada 2: o ponteiro no `CLAUDE.md`

Uma edição, não 56. **Anexe ao final do arquivo** — nunca reescreva o `CLAUDE.md` existente,
nunca reordene o que já está lá. Texto exato a inserir:

```markdown
<!-- perfil-negocio:início -->
## Contexto do negócio — leitura obrigatória

O diagnóstico estratégico completo deste negócio está em **`PERFIL-DO-NEGOCIO.md`**
(mesma pasta deste arquivo). Ele tem persona real, diferencial validado, os 3 pecados que
governam o copy, margem, ponto de equilíbrio, custo invisível, escada de valor e o credo.

**Antes de opinar, sugerir, escrever copy, propor campanha, calcular preço ou desenhar
qualquer coisa que envolva este negócio: leia esse arquivo.** Vale para você e para qualquer
subagente que você acionar — passe o conteúdo relevante no prompt do subagente, ele não herda
esta conversa.

Três regras que não se contornam:
1. **Onde o perfil diz `[não sabe]`, pergunte.** Não estime, não preencha com média de mercado.
2. **Os 3 pecados governam todo o copy.** Peça que não ativa nenhum dos três está fora da voz
   desta empresa, por melhor que esteja escrita.
3. **O que está em "Eliminar" foi decidido fora.** Não proponha de volta sem dizer
   explicitamente que está revertendo uma decisão do dono.

Perfil desatualizado é pior que perfil ausente. Se a data no topo dele tiver mais de 3 meses,
avise e ofereça rodar `raio-x:diagnostico` de novo.
<!-- perfil-negocio:fim -->
```

Se os marcadores já existirem, **substitua o bloco inteiro entre eles** — nunca acrescente um
segundo. Se existir uma seção parecida escrita pela pessoa, sem marcador: não toque. Mostre a
ela e pergunte se substitui.

---

## Passo 4 — Camada 3: injeção cirúrgica

Só onde o contexto **muda o comportamento**. Injetar em todos os agentes instalados é ruído:
aumenta custo de token em toda chamada, e agente que recebe informação que não usa aprende a
ignorar o bloco inteiro.

**Antes de escrever, confira os nomes reais** com `ls ~/.claude/agents/`. O mapa abaixo usa os
nomes do pack padrão; se um arquivo não existir, pule e diga qual pulou.

| Agente (arquivo) | Papel | O que injetar |
|---|---|---|
| `cyrus.md` | Copy Master | os 3 pecados com mecanismo · posicionamento em uma frase · vocabulário proibido e obrigatório (§13) |
| `apolo.md` | Conteúdo e social | os 3 pecados · o credo · persona · vocabulário proibido |
| `odisseu.md` | Scripts e objeções | persona completa · objeções reais verbalizadas · experiência central · ticket e escada |
| `heracles.md` | Direção comercial | leads/mês · taxa de resposta · custo invisível · base inativa · ticket · nota da dimensão Comercial |
| `cronos.md` | Tráfego pago | leads/mês · ticket · verba atual · margem (define ROAS mínimo) · custo invisível · persona · onde ela busca |
| `plutos.md` | Financeiro / CFO | custos fixos e variáveis · margem · break-even · método de precificação atual · `[não sabe]` do CAC |
| `metis.md` | Produto | escada de valor · o que foi eliminado e por quê · fase de maturidade |
| `proteu.md` | Marketing e posicionamento | posicionamento em uma frase · subnicho · credo · diferencial validado |

**Opcionais, só se a pessoa pedir:** `zeus.md` (visão geral + notas do diagnóstico),
`traffic-chief.md` (mesmo bloco do Cronos), `hestia.md` (base inativa e motivo de churn),
`nike.md` (objeções + gatilhos para páginas).

### Onde e como inserir

Sempre **no fim do arquivo do agente**, precedido de uma linha em branco, delimitado assim:

```markdown
<!-- perfil-negocio:início -->
## Contexto deste negócio

> Injetado por `raio-x:enriquecer-agentes` em 11/08/2026 (perfil v1).
> Fonte completa: `PERFIL-DO-NEGOCIO.md`. Em conflito, o perfil vence este resumo.

{apenas os blocos da linha da tabela acima — nada além}
<!-- perfil-negocio:fim -->
```

**Nunca injete dentro do frontmatter YAML.** Uma linha fora do lugar ali quebra o parse e o
agente some do catálogo sem erro nenhum — a falha mais cara e mais silenciosa que existe neste
sistema. Depois de editar, confirme que o arquivo ainda abre com `---` na primeira linha e que
o segundo `---` continua onde estava.

### Protocolo por agente
1. Monte o bloco.
2. **Mostre à pessoa**: nome do agente, o que ele faz, e o texto exato que vai entrar.
3. Espere o "sim".
4. Faça o backup (Passo 5).
5. Se já houver marcadores no arquivo: substitua o miolo. Se não: anexe ao fim.
6. Confirme: caminho do arquivo, linhas adicionadas, backup onde ficou.

---

## Passo 5 — Segurança e reversibilidade

**Backup antes de qualquer escrita.** Mesma convenção do instalador do pack, para não criar um
segundo padrão:

```bash
STAMP=$(date +%Y%m%d_%H%M%S)
mkdir -p ~/.claude/agents_backup_$STAMP
cp ~/.claude/agents/cyrus.md ~/.claude/agents_backup_$STAMP/     # só os que serão tocados
cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE_backup_$STAMP.md
```

Diga o caminho do backup em voz alta ao terminar. E diga como desfazer: apagar o bloco entre
os marcadores, ou copiar o arquivo de volta do backup.

**As cinco linhas que não se cruzam:**
1. Nenhuma escrita sem confirmação explícita, por camada.
2. Nenhuma escrita sem backup.
3. Nada fora dos marcadores é editado, reordenado ou reescrito — nem para "melhorar".
4. Nunca dois blocos com o mesmo marcador no mesmo arquivo.
5. Se o arquivo tem conteúdo que a pessoa claramente escreveu à mão sobre o mesmo assunto,
   pare e pergunte. Contexto duplicado e divergente é pior que contexto ausente.

---

## Passo 6 — Versionamento

O diagnóstico é uma medida, não uma foto. Só vira medida se der pra comparar.

**Ao gerar:** grave a cópia carimbada em `.canvas/perfil/PERFIL-v{N}-{AAAA-MM-DD}.md` além do
`PERFIL-DO-NEGOCIO.md` ativo. O ativo é o que os agentes leem; o histórico é o que permite
comparar.

**Ao rodar de novo:** leia a versão anterior mais recente em `.canvas/perfil/` e abra com o
comparativo, antes de reescrever qualquer coisa:

| Dimensão | v1 (11/08) | v2 (11/11) | Δ |
|---|---|---|---|
| 🎯 Comercial | 4 | 6 | **+2** — follow-up implantado, resposta em 30 min: 28% → 65% |
| 🚀 Tecnologia | 3 | 3 | — agenda ainda no caderno |
| **Total** | **27** | **33** | **+6** |

Depois da tabela, três frases: **o que melhorou e por quê · o que não se mexeu · qual é a nova
dimensão mais fraca.** Se o custo invisível caiu, diga o valor em reais recuperado por mês —
é o número que faz a pessoa voltar a rodar o diagnóstico.

Só então incremente a versão no topo do perfil, regrave e re-injete. Os marcadores fazem a
substituição ser limpa: nenhum agente acumula duas versões do mesmo contexto.

---

## Encerramento

Feche em linguagem de dono de negócio, com três coisas: **onde o perfil ficou**, **quais
agentes foram tocados e quais não foram**, e **onde está o backup** (com a frase de como
desfazer). Sem jargão de arquivo. Fecha oferecendo a reavaliação em 3 meses.