Estrutura de Código do Claude que Sobreviveu a Múltiplos Projetos Reais

O que Funcionou Após Múltiplos Projetos

Um desenvolvedor no r/ClaudeAI compartilhou sua estrutura do Claude Code que não quebrou após implementá-la em 2-3 projetos reais. Essa configuração se manteve uma vez que eles adicionaram múltiplas habilidades, servidores MCP e agentes, indo além de demonstrações simples.

Decisões Estruturais Principais

• Use CLAUDE MD: Ignorar o CLAUDE MD no início levou a resultados inconsistentes. Uma vez que eles definiram convenções, regras de teste e padrões de nomenclatura, as saídas se tornaram mais previsíveis.
• Divida habilidades por intenção: Organizar habilidades como code-review/, security-audit/, text-writer/ funcionou melhor do que despejar lógica em um só lugar. Isso tornou a ativação mais limpa.
• Implemente hooks: Não usar hooks inicialmente foi um erro. Hooks PreToolUse e PostToolUse ajudaram a capturar comandos ruins e saídas confusas, e foram úteis para pequenas automações.
• Separe agentes: A abordagem de agente único não escalou bem. Ter agentes dedicados para revisão, escrita e auditoria provou ser mais previsível.
• Gerencie o uso de contexto: Quando o uso de contexto fica muito alto, a qualidade cai. Mantê-lo abaixo de aproximadamente 60% fez uma diferença notável.
• Separe preocupações: Misturar configuração, habilidades e lógica de execução tornou a depuração dolorosa. Manter esses elementos separados tornou tudo mais fácil de entender.

Integração MCP

A integração MCP (Model Context Protocol) com GitHub, Postgres e acesso ao sistema de arquivos mudou completamente como o Claude se comporta. De acordo com o desenvolvedor, é aqui que a configuração parou de parecer um brinquedo e começou a se comportar mais como um assistente de desenvolvimento, em vez de apenas prompt → saída.

O desenvolvedor observa que ainda está descobrindo a maneira mais limpa de estruturar agentes, mas essa configuração atualmente está funcionando bem para projetos que crescem além de demonstrações simples.