Auto-otimização: Um Plugin de Código Claude para Otimização Autônoma de Desempenho

auto-optimize é um plugin do Claude Code que automatiza o ciclo de otimização de desempenho: perfilamento, identificação de gargalos, escrita de correções, benchmark e repetição. O desenvolvedor, um engenheiro de desempenho trabalhando em uma tabela de hash Java de alta performance, o criou para eliminar o trabalho manual de otimização.

Como Funciona

O plugin executa um loop autônomo por experimento com estas etapas:

• Perfilamento — executa async-profiler e analisa a saída do flamegraph
• Planejamento — raciocínio estruturado antes de tocar no código, incluindo Step-Back (identificar o tipo de gargalo de forma abstrata), Chain-of-Thought (enumerar estratégias com análise de trade-offs) e Pre-mortem (assumir que o plano já falhou para identificar problemas potenciais)
• Implementação — escreve e aplica a alteração
• Benchmark — executa JMH e compara com a linha de base
• Reflexão — escreve reflexion.md documentando o que foi surpreendente, o que falhou e o que tentar a seguir

Cada experimento subsequente lê reflexion.md antes do perfilamento para evitar repropor experimentos previamente descartados. Sem isso, o agente "reproporia o mesmo experimento descartado duas iterações depois com um raciocínio igualmente confiante — ele não tinha como saber o que já havia aprendido."

Arquitetura de Sub-agentes

Cada experimento é executado em um sub-agente dedicado. A saída bruta do perfilamento, desmontagem, diffs e logs de benchmark nunca tocam o contexto principal. O orquestrador vê apenas valores de retorno estruturados: o que mudou, o que os números mostraram e o que tentar a seguir.

Esta arquitetura evita a poluição do contexto: "Quando o contexto principal fica cheio, o comportamento do agente se degrada de maneiras sutis — as saídas ainda parecem coerentes, mas ele começa a raciocinar sobre o problema errado. Mover tudo para sub-agentes mantém o orquestrador limpo indefinidamente."

Instalação e Uso

Instale com:

claude plugin marketplace add bluuewhale/auto-optimize
claude plugin install auto-optimize@auto-optimize

Em seguida, execute: /auto-optimize

Você fornece um objetivo, um comando de benchmark e um limite de sucesso. Em um caso, o desenvolvedor instruiu o plugin uma vez e obteve uma tabela de hash 27% mais rápida em todos os cenários de benchmark em aproximadamente 3 horas.