O que o agente lê antes de pensar.
Como você cuida do contexto da sessão.
Como você opera dentro de uma task.
Como você fala com ele.
Tudo que você empilha em volta dele.
O DNA do projeto, em texto.
É o arquivo que o Claude lê toda vez que abre o projeto. Não é README. README é pro humano que tá clonando. CLAUDE.md é briefing pra agente: o que o projeto É, qual a voz, restrições duras, comandos perigosos, atalhos seguros.
Mantém curto. Sem narração. Aponta pra docs detalhados em vez de duplicar. Se o Claude tá fazendo a mesma besteira repetidas vezes, falta uma linha aqui.
Dica concreta: começa pelo mapa do , pelas convenções inegociáveis, e pelos atalhos que evitam você apagar produção. Resto vira link.
# CLAUDE.md (raiz do repo) ## Stack - Next.js 16 + Convex backend - Monorepo turbo, app principal em apps/sapiens/ ## Don'ts - Nunca rode `npx convex *` no root, só dentro de apps/sapiens/ - Sem em-dash em arquivo .md (hook bloqueia) ## Atalhos seguros - npm run dev (sobe sapiens + aitag + decks) - npm run convex:deploy (deploy prod)