Agentes de código não precisam de janelas maiores — precisam de um compilador de contexto

Agentes de código não precisam de janelas de contexto maiores — precisam de um compilador de contexto

A maioria dos agentes de programação desperdiça cerca de 70% da janela de contexto com código irrelevante. Um compilador jamais faria isso. Ele resolve dependências, descarta código inalcançável e mantém apenas as interfaces onde a implementação não é necessária. Agentes de código fazem o oposto — e pagam caro por isso justamente quando o orçamento de contexto está encolhendo.

Em 18 de julho, a OpenAI reduziu silenciosamente a janela de contexto padrão dos modelos Codex de 372 mil para 272 mil tokens. Correção de cobrança ou ajuste de capacidade, o sinal é claro: janelas de contexto não vão continuar crescendo indefinidamente. Para desenvolvedores que usam agentes como Codex CLI, Cursor, Copilot ou Claude Code, isso significa que cada token desperdiçado com código irrelevante compete diretamente com o código que realmente importa.

O problema da compactação no meio da tarefa

Quando a janela de contexto estoura, o agente entra em modo de compactação: ele resume o próprio contexto para abrir espaço. Parece uma limpeza de rotina, até acontecer no meio de uma tarefa complexa. O agente cria um resumo com perdas do próprio histórico e passa os próximos turnos tentando reconstruir detalhes de implementação a partir de um resumo degradado de um resumo anterior. Metade das vezes em que um agente “esquece” algo, é o próprio gerenciamento de memória degradando sua capacidade de recordação.

A abordagem do compilador de contexto

O desenvolvedor Emmanuel M. (Emmimal) construiu um Context Compiler — um pipeline de três passagens escrito inteiramente com a biblioteca padrão do Python. Em vez de simplesmente juntar mais arquivos e torcer para o modelo dar conta, o compilador:

1. Resolve o que o arquivo-alvo realmente alcança — rastreia importações e chamadas de função a partir do ponto de entrada
2. Reduz as dependências a interfaces puras — mantém assinaturas e docstrings, remove corpos de implementação desnecessários
3. Descarta tudo que é inalcançável — código morto, funções não referenciadas e imports não utilizados são eliminados

O resultado testado em dois repositórios reais de Python: redução de 69% a 74% no tamanho do prompt, com tempo de compilação abaixo de 75 milissegundos. Quando o compilador não consegue determinar algo com certeza, ele marca explicitamente em vez de adivinhar — transparência que falta na maioria dos agentes.

Por que isso importa agora

O ecossistema de agentes de código está em plena expansão. Ferramentas como Cursor, Copilot, Codex CLI e Claude Code já fazem parte do fluxo de trabalho de milhões de desenvolvedores. Mas a qualidade dessas ferramentas depende diretamente da qualidade do contexto que recebem. Enviar arquivos inteiros quando apenas interfaces bastam é como carregar a biblioteca inteira para consultar um verbete.

Para times brasileiros que adotam essas ferramentas em bases de código grandes — sistemas legados Java, monorepositórios Node.js, APIs Django com centenas de endpoints — a diferença entre 69% de redução de contexto e zero redução pode ser a diferença entre o agente completar a tarefa ou entrar em colapso na compactação.

Limitações e próximos passos

O Context Compiler é um experimento, não um produto. Ele funciona com Python puro, não cobre chamadas dinâmicas complexas (reflection, getattr, imports condicionais), e exige que o código seja razoavelmente bem estruturado. Mas o princípio é sólido: a disciplina de um compilador — resolver, reduzir, descartar — é exatamente o que falta na engenharia de prompts para agentes de código.

À medida que mais provedores ajustam suas janelas de contexto para baixo, ferramentas de pré-processamento como esta deixam de ser otimização e passam a ser necessidade.