brain-e-contratoslisted
Install: claude install-skill well-prado/claude-skills
# Brain e contratos
Dois instrumentos que se completam:
- **O Brain** responde *o que existe*: cada rota com quem pode chamá-la e qual guarda confere antes de gravar, cada
tela, cada server action, cada tabela com o RLS e as políticas, quem importa quem, os ciclos, e as checagens que
acusam sozinhas o que parece perigoso. É lido do código (análise estática), roda **só local** e nunca toca no banco
de verdade nem na produção.
- **Os contratos** respondem *o que tem de continuar verdade*: cada regra de negócio com um ID (`PED-004`), onde mora,
os testes que a provam, os casos de borda e a situação (✅ ⚠️ ❌ ❔). Correção cita o ID, teste novo leva o ID no
nome, e o CI reprova contrato que aponta para código que sumiu.
Juntos, deixam qualquer pessoa (ou agente) mexer num sistema grande sabendo onde pisa. Nasceram em dois projetos reais
(um Hono + Drizzle, um Next.js App Router + Supabase com ~370 contratos) e viraram molde.
## Como usar esta skill
1. Leia [references/01-o-que-e-o-brain.md](references/01-o-que-e-o-brain.md) (o desenho e as regras de ouro).
2. **Instale o Brain inicial** de `assets/brain/` em `tools/brain/` do projeto (passo a passo abaixo) e faça-o
funcionar com o `brain.config.ts` do projeto. Ele já entende Next.js App Router, Hono/Express e migrações SQL.
Stack diferente: escreva um coletor ([references/construir-o-gerador.md](references/construir-o-gerador.md)).
3. **Escreva os contratos** com o método de [references/02-escrever-os-contratos.