Menos contexto

Quando um agente erra, é fácil tentar resolver com mais contexto. Você adiciona outro documento, mais um exemplo, outra instrução. Às vezes ajuda. Muitas vezes só deixa a tarefa mais confusa.

Engenharia de contexto começa pela seleção. O agente precisa receber o material que ajuda naquela tarefa, não tudo que pode ter alguma relação com ela.

Quando o excesso atrapalha#

Um modelo não avalia o contexto com o mesmo julgamento que uma pessoa. Se você manda o repositório inteiro, regras antigas, exemplos e documentação entram na mesma janela. A instrução importante passa a disputar atenção com todo o resto.

Alguns problemas aparecem com frequência:

• Diluição: cada novo item ocupa espaço e reduz o destaque do que realmente importa.
• Contradição: uma documentação antiga pode dizer uma coisa enquanto a regra atual diz outra. O modelo precisa adivinhar qual delas vale.
• Lost in the middle: em contextos longos, o conteúdo que fica no meio tende a ser recuperado com menos consistência.

Antes de adicionar algo, vale conferir se aquilo ajuda o agente a decidir ou se só dá mais material para ele separar.

Corte o que a tarefa não precisa#

Na prática, um escopo curto costuma funcionar melhor. Mande o arquivo relevante em vez do repositório inteiro, a função envolvida em vez de todo o módulo e a regra que vale agora em vez de um manual completo.

Isso não significa esconder informação importante. Significa deixar de fora o que não ajuda na próxima decisão. Se outra peça for necessária, ela pode entrar depois.

Use subagentes para buscas grandes#

Algumas tarefas exigem uma varredura ampla, como localizar um padrão em dezenas de arquivos ou entender uma convenção espalhada pelo projeto. Colocar todo esse material no contexto principal custa caro e ajuda pouco, porque quase tudo será descartado depois da busca.

Nesses casos, eu delego a varredura a um subagente e peço uma resposta curta: arquivos relevantes, linhas e uma conclusão. O agente principal recebe o resultado sem carregar todo o caminho usado para chegar nele.

Assim, a busca usa uma janela separada e o contexto principal fica reservado para a decisão e a implementação.

O que vale guardar#

Regras que continuam válidas pertencem ao arquivo de contexto ou à memória do projeto. Elas entram uma vez e ficam disponíveis para as próximas tarefas.

Detalhes de uma tarefa específica podem sair quando ela termina. Se todo detalhe vira memória permanente, o ruído volta nas conversas seguintes e o arquivo de contexto deixa de ser útil.

Contexto tem limite#

Cada item ocupa parte da janela e compete por atenção. Por isso também vale resumir conversas longas. Guarde as decisões, o estado atual e os próximos passos. O raciocínio que já cumpriu seu papel pode sair.

Antes de mandar mais material, eu tento resumir a tarefa e retirar o que já não serve. Na maioria das vezes, essa limpeza ajuda mais do que outro documento.