CLAUDE.MD
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 monorepo, pelas convenções inegociáveis, e pelos atalhos que evitam você apagar produção. Resto vira link.
Exemplo prático
# 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)Esta ficha é parte do Claude Code OS, o blueprint completo das 25 práticas que separam quem segue tutorial de quem usa Claude de verdade.