Melhores Práticas de CLAUDE.md para Qualquer Projeto

CLAUDE.md é um arquivo markdown que você coloca na raiz do seu projeto. O Claude Code o lê no início de cada sessão — antes de você digitar qualquer coisa. Pense nele como um documento de briefing: diz ao Claude o que é o seu projeto, como está estruturado, quais convenções você segue e o que evitar.

# Contexto do Projeto

Este é um app Next.js 14 com TypeScript, Tailwind CSS e Prisma.
Banco de dados: PostgreSQL. Auth: NextAuth.js.

## Comandos
- `npm run dev` — iniciar servidor de desenvolvimento
- `npm run test` — rodar testes Jest
- `npm run db:migrate` — rodar migrações Prisma

## Convenções
- Use server components por padrão
- Componentes client vão em /components/client/
- Todas as rotas API usam Zod para validação
- Nunca use `any` no TypeScript

## Não faça
- Modificar a pasta /legacy
- Alterar a configuração de auth

As seções mais úteis são:

+Stack técnica — framework, linguagem, banco de dados, auth+Comandos — como rodar, testar e fazer deploy+Convenções — nomenclatura, estrutura de arquivos, estilo de código+Restrições — o que o Claude nunca deve tocar

Não escreva um romance. O Claude Code lê esse arquivo inteiro a cada sessão — mantenha abaixo de 200 linhas. Priorize coisas que fariam um desenvolvedor inteligente novo na sua base de código tropeçar.