Context engineering: como “CLAUDE.md” gigante pode quebrar testes

Um demo com Claude Code mostrou que colocar “tudo o que existe” em um arquivo como CLAUDE.md pode estourar o contexto e levar a falhas no comportamento do agente. No exemplo, ao adicionar tratamento de erro em um endpoint, o teste esperava 404 para um pedido ausente, mas retornou 500, com um AssertionError.

A conversa destacou que o problema não é só o modelo: o agente envia toda a sessão (chat, prompts e conteúdo anexado) para o LLM a cada interação, o que pode “encher” a janela de contexto. Para contornar isso, os palestrantes defendem substituir o prompt “engordado” por context engineering com skills, carregando documentos apenas quando gatilhos específicos indicam que aquele contexto é necessário.