📜 O que Sao Regras Modulares
Regras modulares sao arquivos individuais dentro do diretorio .claude/rules/ que contem instrucoes especificas para o Claude. Em vez de um unico CLAUDE.md gigante, voce pode dividir as regras em arquivos tematicos.
🎯 Conceito Principal
- •Diretorio .claude/rules/: Cada arquivo .md neste diretorio e carregado como regra adicional
- •Modularidade: Uma regra por arquivo facilita organizacao, revisao e manutencao
- •Carregamento automatico: Todos os arquivos no diretorio sao lidos automaticamente ao iniciar sessao
- •Complementa CLAUDE.md: Funciona junto com CLAUDE.md, nao substitui
💡 Dica Pratica
Pense em .claude/rules/ como um 'diretorio de configuracao' para o Claude. Assim como .eslintrc, .prettierrc definem regras para ferramentas, .claude/rules/ define regras para o Claude.
🔄 Diferenca entre CLAUDE.md e rules/
CLAUDE.md e rules/ coexistem, mas servem propositos diferentes. Entender quando usar cada um e chave para uma organizacao eficiente.
🎯 Conceito Principal
- •CLAUDE.md: Visao geral do projeto: stack, comandos, convencoes gerais. O 'resumo executivo'
- •rules/: Regras detalhadas e especificas: por tipo de arquivo, por contexto, por area do codigo
- •Analogia: CLAUDE.md e o manual do funcionario. rules/ sao os procedimentos operacionais detalhados
- •Regra pratica: Se cabe em 3 linhas, coloque no CLAUDE.md. Se precisa de mais detalhe, crie um arquivo em rules/
💡 Dica Pratica
Use CLAUDE.md para o que todo mundo precisa saber em 30 segundos. Use rules/ para detalhes que so importam em contextos especificos. Nao duplique informacao entre os dois.
📝 Criando seu Primeiro Arquivo de Regra
Criar um arquivo de regra e simples: basta criar um arquivo .md dentro de .claude/rules/. O nome do arquivo descreve o tema da regra.
🎯 Conceito Principal
- •Estrutura: Crie o diretorio .claude/rules/ e adicione arquivos .md dentro
- •Nomenclatura: Use nomes descritivos: testing.md, api-patterns.md, frontend-rules.md
- •Formato: Markdown simples com bullets, headers e exemplos de codigo
- •Versionamento: Adicione .claude/rules/ ao git para compartilhar com o time
💡 Dica Pratica
Comece com um unico arquivo de regra para a area que mais te incomoda. Se o Claude sempre erra nos testes, crie .claude/rules/testing.md com suas regras de teste. Depois expanda.
📄 Regras por Tipo de Arquivo
Uma das aplicacoes mais poderosas de rules/ e criar regras por tipo de arquivo. Regras para arquivos .test.ts, regras para .py, regras para .css. Cada tipo de arquivo tem suas proprias convencoes.
🎯 Conceito Principal
- •testing.md: Convencoes de teste: framework, patterns, mocks, assertions, cobertura minima
- •components.md: Regras para componentes React: props typing, hooks usage, styling approach
- •api-routes.md: Padroes de API: validation, error responses, authentication, pagination
- •styles.md: Convencoes de CSS/Tailwind: utility classes, custom themes, responsive breakpoints
💡 Dica Pratica
O poder real aparece quando voce tem regras especificas para testes. Crie .claude/rules/testing.md dizendo: 'Use describe/it pattern, mock com vi.fn(), assertions com expect().toBe(), nunca use any em types de teste'. O Claude vai gerar testes que se encaixam perfeitamente.
🛠 Regras por Contexto
Alem de tipo de arquivo, voce pode criar regras por contexto de trabalho: frontend, backend, infraestrutura, CI/CD. Cada contexto tem suas proprias necessidades e restricoes.
🎯 Conceito Principal
- •frontend.md: Regras para codigo frontend: components, hooks, state management, routing
- •backend.md: Regras para backend: API design, database queries, error handling, logging
- •infra.md: Regras de infraestrutura: Docker, CI/CD, deploy, environment variables
- •security.md: Regras de seguranca: input validation, auth patterns, secret management
💡 Dica Pratica
Em um monorepo, regras por contexto sao essenciais. O frontend pode usar React com Tailwind enquanto o backend usa Express com SQL. Cada contexto merece seu arquivo de regras para evitar que o Claude misture convencoes.
📚 Boas Praticas de Organizacao de Regras
A organizacao de .claude/rules/ pode se tornar complexa se nao seguir boas praticas. Mantenha simples, mantenha claro, mantenha atualizado.
🎯 Conceito Principal
- •Poucos arquivos grandes > muitos arquivos pequenos: 5-10 arquivos bem organizados e melhor que 50 micro-arquivos
- •Nomes descritivos: testing.md e melhor que rules-01.md. O nome deve dizer o conteudo
- •Review periodico: A cada sprint, revise se as regras ainda fazem sentido
- •Git e PR review: Trate mudancas em rules/ como mudancas de codigo. Review em PRs
💡 Dica Pratica
Crie um README.md dentro de .claude/rules/ listando o proposito de cada arquivo. Isso ajuda novos membros do time a entender a organizacao e saber onde adicionar novas regras.
Exercicio Pratico
Exercicio: Criar 3 Arquivos de Regras Modulares
Tempo estimado: 15-20 minutos
Criar o diretorio
No seu projeto, crie o diretorio .claude/rules/ se ainda nao existir.
Criar regra de testes
Crie .claude/rules/testing.md com convencoes de teste: framework, patterns, assertions, coverage.
Criar regra de API
Crie .claude/rules/api-patterns.md com padroes de API: validation, error responses, auth.
Criar regra de estilo
Crie .claude/rules/code-style.md com convencoes de estilo que nao estao no CLAUDE.md.
Testar
Abra Claude Code e peca para criar um teste e uma rota de API. Verifique se as regras estao sendo seguidas.
📋 Resumo do Modulo
Proximo Modulo:
2.5 - Auto-Memory e Persistencia