Sistema de engenharia portátil para Claude Code com ganchos, agentes especializados e autoaperfeiçoamento

Um desenvolvedor frustrado com a repetição de instruções para o Claude Code criou um sistema de engenharia portátil que reside em ~/.claude/ e se aplica automaticamente a todos os projetos. O sistema aborda dois problemas principais: o ciclo de repetição em que o Claude Code encontrava o mesmo bug dias depois e o resolvia do zero, e a desconexão entre projetos onde regras refinadas em um projeto não existiam em outro.

Componentes do sistema

O sistema inclui vários componentes-chave:

• Uma constituição (CLAUDE.md) – 650 linhas de regras com uma hierarquia de valores, limites de decisão e três modos de execução dependendo da complexidade da tarefa
• Ganchos que aplicam regras deterministicamente – Não são sugestões que a IA pode ignorar, mas scripts bash que bloqueiam fisicamente comandos perigosos como pushes forçados, uso incorreto do gerenciador de pacotes ou rm -rf
• Três agentes especializados – Um orquestrador que delega mas nunca codifica, construtores que trabalham em cópias isoladas do repositório e um revisor somente leitura que não pode corrigir coisas (apenas relata)
• Um pipeline de habilidades – Do planejamento à construção, envio e produção, principalmente autônomo com um único portão não negociável: a implantação em produção sempre pergunta
• Um sistema imunológico – Cada erro é registrado com a causa raiz E as abordagens que falharam. O mesmo bug em 2+ projetos se torna uma regra permanente, desenvolvendo anticorpos
• Verificação Anti-Goodhart – Cinco perguntas que todo agente deve responder antes de declarar "concluído", porque "todos os testes passam" não significa que o aplicativo funciona

Abordagem de engenharia composta

O sistema é construído sobre Engenharia Composta: Planejar → Trabalhar → Revisar → Compor. Esse quarto passo é onde o sistema se aprimora. O desenvolvedor menciona regras específicas que anteriormente precisava repetir diariamente: "use pnpm não npm", "não exclua testes que passam" e "execute testes antes de fazer commit".

O projeto é de código aberto em https://github.com/vinicius91carvalho/.claude com um passo a passo completo de todas as 15 partes disponível em https://tail-f-thoughts.hashnode.dev/self-improving-engineering-system-claude-code.