📏 A Regra das 200 Linhas
CLAUDE.md e lido toda sessao, o que significa que cada linha consome tokens. Um CLAUDE.md de 500 linhas desperdicea tokens e pode ate confundir o Claude com informacoes demais. A regra pratica: mantenha abaixo de 200 linhas.
🎯 Conceito Principal
- •Custo de tokens: Cada linha do CLAUDE.md consome tokens do seu limite mensal
- •Atencao do modelo: Quanto mais texto, mais diluida a atencao do Claude em cada instrucao
- •200 linhas = sweet spot: Cobre stack, comandos, convencoes e regras sem excesso
- •Excesso = ruido: Um CLAUDE.md de 500 linhas tem informacoes que o Claude provavelmente ignora
💡 Dica Pratica
Conte as linhas do seu CLAUDE.md agora. Se passou de 200, e hora de cortar. Cada linha removida e um token economizado em TODA sessao. Em 100 sessoes, a economia e significativa.
✂️ O que Incluir e o que Cortar
A arte do CLAUDE.md eficiente e saber o que e essencial vs nice-to-have. Inclua o que muda o comportamento do Claude. Corte o que ele ja sabe ou pode descobrir sozinho.
🎯 Conceito Principal
- •Incluir: Stack, package manager, comandos de build/test/lint, convencoes unicas do projeto
- •Incluir: Things To Avoid - regras negativas que previnem erros recorrentes
- •Cortar: Informacoes que o Claude descobre lendo o codigo (ex: quais dependencias tem)
- •Cortar: Convencoes gerais da linguagem (ex: 'use camelCase em JavaScript')
💡 Dica Pratica
Regra de ouro: se voce pode remover uma linha e o Claude ainda faz a coisa certa, remova. O CLAUDE.md deve conter apenas o que o Claude erraria sem a instrucao.
📑 Usando Marcadores e Secoes Claras
A formatacao do CLAUDE.md importa tanto quanto o conteudo. Headers claros, bullets consistentes e secoes bem definidas ajudam o Claude a processar as informacoes mais eficientemente.
🎯 Conceito Principal
- •Use Markdown headers (##): Secoes claras com ## Project Overview, ## Commands, etc.
- •Bullets para listas: Use - para cada item. Evite paragrafos longos
- •Negrito para enfase: Use **Never** e **Always** para regras criticas
- •Codigo inline: Use backticks para comandos: `pnpm dev`, `npm test`
💡 Dica Pratica
O Claude processa Markdown muito bem. Headers ajudam na hierarquia de informacao, bullets na clareza, e codigo inline na precisao. Nao escreva paragrafos longos - use bullets curtos e diretos.
🔄 Atualizando com Frequencia
Um CLAUDE.md desatualizado e pior que nenhum CLAUDE.md. Se as instrucoes nao refletem o estado atual do projeto, o Claude vai seguir regras erradas e produzir codigo inconsistente.
🎯 Conceito Principal
- •Atualize a cada mudanca de stack: Migrou de npm para pnpm? Atualize imediatamente
- •Atualize apos refactoring: Mudou patterns? O CLAUDE.md precisa refletir isso
- •Review mensal: Reserve 10 minutos por mes para revisar e atualizar
- •PR trigger: Se um PR muda convencoes, o PR deve incluir update do CLAUDE.md
💡 Dica Pratica
Adicione 'Atualizar CLAUDE.md' no checklist de toda migracacao de stack ou refactoring grande. E o tipo de coisa que leva 5 minutos mas economiza horas de frustacao com respostas desalinhadas.
🔎 Auditoria do CLAUDE.md
Periodicamente, faca uma auditoria estruturada do seu CLAUDE.md. Use um checklist para verificar se ele esta completo, correto e conciso.
🎯 Conceito Principal
- •Checklist de auditoria: Project Overview presente? Stack atual? Comandos funcionam? Convencoes refletem a realidade?
- •Teste pratico: Peca ao Claude para resumir o que sabe sobre o projeto. As respostas batem?
- •Contagem de linhas: Esta abaixo de 200 linhas? Se nao, o que pode ser cortado?
- •Relevancia: Cada secao e relevante? Tem informacao duplicada?
💡 Dica Pratica
Faca a auditoria com outro membro do time. Dois pares de olhos pegam inconsistencias que um sozinho nao ve. Bonus: o colega pode nao conhecer alguma convencao, e isso mostra que a documentacao precisa ser mais clara.
🚫 Anti-patterns Comuns
Saber o que NAO fazer no CLAUDE.md e tao importante quanto saber o que fazer. Estes sao os erros mais comuns que degradam a eficacia do arquivo.
🎯 Conceito Principal
- •CLAUDE.md gigante (500+ linhas): Informacao demais dilui a atencao e desperdicea tokens
- •Copiar o README inteiro: README e para humanos, CLAUDE.md e para o Claude. Propositos diferentes
- •Nunca atualizar: CLAUDE.md desatualizado gera codigo com padroes antigos
- •Instrucoes vagas: 'Escreva bom codigo' nao ajuda. 'Use named exports, never any type' ajuda
- •Duplicar informacao: Se esta no CLAUDE.md e tambem em rules/, remova de um dos dois
💡 Dica Pratica
O anti-pattern mais destrutivo e o CLAUDE.md desatualizado. Ele faz o Claude seguir convencoes que nao existem mais. Se voce nao vai manter atualizado, e melhor nao ter. Um CLAUDE.md errado e pior que nenhum CLAUDE.md.
Exercicio Pratico
Exercicio: Auditar e Otimizar um CLAUDE.md para Menos de 200 Linhas
Tempo estimado: 15-20 minutos
Conte as linhas
Abra seu CLAUDE.md atual e conte quantas linhas ele tem. Se nao tem um, crie usando o template do modulo 2.2.
Identifique o excesso
Marque cada secao como 'essencial', 'util' ou 'dispensavel'. Remova os dispensaveis.
Verifique informacoes duplicadas
Compare com .claude/rules/ e remova duplicatas do CLAUDE.md.
Teste com o Claude
Abra Claude Code e peca para criar algo. O resultado segue as convencoes? Se nao, a regra esta mal escrita.
Meta: menos de 200 linhas
Itere ate ficar abaixo de 200 linhas mantendo todas as informacoes essenciais.
📋 Resumo do Modulo
Proximo Modulo:
Trilha 3 - Workflows