Estrutura de Autorrefinamento Recursivo para Agentes de Codificação de IA Usando Claude Code

Um desenvolvedor disponibilizou como código aberto um framework que permite que agentes de codificação de IA melhorem-se recursivamente usando Claude Code. O sistema foi desenvolvido após meses de pesquisa sobre como os provedores de modelos implementam a otimização recursiva de agentes.

Como Funciona

O framework fornece uma abordagem estruturada para a melhoria do agente:

• Adicione rastreamento ao seu agente com 2 linhas de código (ou pule para a etapa 3 se já tiver rastros)
• Execute seu agente várias vezes para coletar rastros de execução
• Execute /recursive-improve no Claude Code
• O sistema analisa os rastros, encontra padrões de falha, planeja correções e as apresenta para aprovação
• Aplique as correções, execute o agente novamente e verifique a melhoria com /benchmark em relação à linha de base
• Repita os ciclos para continuar a melhoria

Opção Autônoma

Para operação totalmente autônoma (semelhante ao autoresearch de Karpathy):

• Execute /ratchet para executar todo o ciclo de melhoria automaticamente
• O sistema melhora, avalia e mantém ou reverte as alterações
• Apenas as melhorias sobrevivem
• Pode ser executado durante a noite para acordar com um agente melhor

Resultados de Desempenho

Testado em um benchmark de agente empresarial do mundo real (tau2) com a habilidade executando totalmente no piloto automático:

• Aumento de 25% no desempenho após um único ciclo de melhoria

Contexto Técnico

A pesquisa original envolveu a construção de uma arquitetura de modelo de linguagem recursiva com REPL isolado para análise de rastros em escala, pipelines multiagente e outros componentes. O desenvolvedor descobriu que a maioria das pessoas que constroem agentes não precisa dessa complexidade e que o Claude Code fornece capacidade suficiente para a autoaperfeiçoamento recursivo.

O framework diz ao seu agente de codificação: aqui estão os rastros, aqui está como analisá-los, aqui está como priorizar correções e aqui está como verificá-las.

Repositório de código aberto: https://github.com/kayba-ai/recursive-improve