As instruções para agentes de programação, como orientações emAGENTS.md, habilidades de processo e fluxos de trabalho, tendem a crescer ao longo do tempo. Embora cada nova regra possa ser útil isoladamente, esse acúmulo frequentemente resulta no inchaço de instruções para agentes. As instruções se tornam longas, contraditórias e desatualizadas, especialmente se as equipes praticarem rendição cognitiva a skills de agentes e importarem conjuntos inteiros de instruções externas.
Primeiro, converta todas as instruções possíveis em hooks ou verificações determinísticas. Em seguida,reavalie as instruções a cada novo modelo e exclua aquelas das quais ele não precisa mais — testes de progressão, em vez de testes de regressão. A Anthropic removeu mais de 80% do prompt de sistema do Claude Code em seus modelos mais recentes sem perda mensurável, já que os modelos de fronteira agora seguem instruções de forma mais confiável. A revelação progressiva de contexto mantém as instruções restantes fora do caminho até que sejam necessárias.
Arquivos de contexto como o AGENTS.md e CLAUDE.md tendem a se acumular ao longo do tempo à medida que os times adicionam visões gerais da base de código, explicações arquiteturais, convenções e regras. Embora cada adição seja útil isoladamente, isso frequentemente leva ao inchaço de instruções para agentes. As instruções se tornam longas e às vezes conflitam entre si. Os modelos tendem a prestar menos atenção ao conteúdo enterrado no meio de contextos longos, então orientações profundas em um longo histórico de conversas podem ser perdidas. À medida que as instruções crescem, aumenta a probabilidade de que regras importantes sejam ignoradas. Também vemos muitos times usando IA para gerar arquivos AGENTS.md, mas pesquisas sugerem que versões escritas à mão são frequentemente mais eficazes do que as geradas por LLMs. Ao usar ferramentas baseadas em agentes, seja intencional e seletivo com as instruções. Adicione-as conforme a necessidade e refine-as continuamente em direção a um conjunto mínimo e coerente.
