← ClaudeAtlas

brain-e-contratoslisted

Instala num projeto TypeScript/JavaScript o "Brain" — um mapa da aplicação lido do próprio código (rotas e endpoints com quem pode chamar, telas, server actions, tabelas com RLS e políticas, jobs, imports e ciclos, checagens automáticas de segurança) que abre local em 127.0.0.1 e se atualiza a cada arquivo salvo — e os "contratos" de regra de negócio (docs/contratos, com ID por regra, onde mora no código, testes que provam, casos de borda, situação e achados), checados no CI. Use quando a pessoa pedir o brain, um mapa do sistema, documentar as regras de negócio, auditar rotas/ações sem guarda, preparar o projeto para agentes de IA trabalharem com segurança, "as boas práticas de sempre", onboarding de um repositório grande, ou antes de uma refatoração/migração grande em que é preciso saber o que existe e o que tem de continuar verdade.
well-prado/claude-skills · ★ 0 · AI & Automation · score 72
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.