Por que a IA esquece o seu projeto, e o que o AGENTS.md e os projetos do Claude fazem a respeito

A IA esquece o seu projeto porque tudo o que ela sabe sobre ele mora na conversa, e a conversa longa perde qualidade. Em setembro de 2026, 2 mudanças atacaram esse problema. O Claude Code passou a ler o AGENTS.md, o arquivo de instruções que outros agentes já usavam. E a Anthropic redesenhou os projetos do Claude pra trabalhar com uma memória compartilhada.

Este post explica as 2 mudanças e mostra como a gente organiza as instruções dos agentes aqui na DobraLabs. Se você monta agentes pro dia a dia, o post sobre como montar um time de agentes no Claude Code complementa este.

Por que a conversa longa perde qualidade

Numa conversa longa, o contexto enche e as informações do começo perdem peso.

Depois de algumas horas, o agente esquece decisões tomadas no início, repete erros já corrigidos e você precisa explicar o projeto de novo. A saída é guardar o que importa fora da conversa: em arquivos de instruções que o agente lê toda vez e em memórias que sobrevivem entre uma sessão e outra.

O Claude Code passou a ler o AGENTS.md

Desde a versão 2.1.277, lançada em 18 de setembro de 2026, o Claude Code lê o AGENTS.md quando não encontra um CLAUDE.md na pasta.

O AGENTS.md é um arquivo de instruções que fica no projeto e que agentes como o Codex já usavam. O Claude Code, até então, só lia o próprio CLAUDE.md. Quem anunciou a mudança foi o Thariq, do time do Claude Code; em tradução livre: “se não tiver um CLAUDE.md numa pasta, o Claude vai procurar e usar o AGENTS.md. dá pra ligar e desligar esse comportamento no /config”. O post passou de 1,7 milhão de visualizações.

A pressão veio a público semanas antes. Em 25 de agosto, o Tobi Lütke, fundador e CEO da Shopify, escreveu que estava pensando em banir o Claude Code da empresa até ele ler o AGENTS.md. O argumento, em tradução livre: insistir em ler só o CLAUDE.md “às vezes gera problema de cérebro dividido, quando gente diferente do time usa ferramenta diferente”.

Como a gente organiza isso na DobraLabs

No nosso repositório, o AGENTS.md é a fonte de verdade de cada área, e o CLAUDE.md tem uma linha só, que importa o AGENTS.md.

Assim, o mesmo manual serve pro Claude Code, pro Codex e pros outros agentes que o time usa, sem duplicar conteúdo nem deixar 2 versões divergirem. Cada projeto grande tem o próprio AGENTS.md com as regras daquela área, e o da raiz funciona como mapa. Com o Claude Code lendo o AGENTS.md direto, até a linha de importação fica opcional.

Os projetos do Claude ganharam memória compartilhada

Em 17 de setembro de 2026, a Anthropic redesenhou os projetos do Claude, começando pelo Claude Code.

Em tradução livre, o anúncio diz: “você descreve o que precisa ser feito, e o Claude dirige threads paralelas que continuam trabalhando depois que você fecha o notebook”. Um agente coordenador conversa com você e abre threads separadas, cada uma com contexto limpo e na própria cópia do projeto. Cada thread contribui e consulta uma memória compartilhada. O recurso saiu em beta pra parte dos assinantes Pro e Max, roda nas sessões na nuvem, sem acesso aos arquivos locais, e pode consumir o limite do plano mais rápido.

O que fazer com isso

Escreva as instruções do seu projeto num arquivo, em vez de repetir tudo em cada conversa.

Comece com o básico: o que é o projeto, como ele está organizado, que regras o agente precisa seguir e o que ele nunca deve fazer. Se o seu time usa mais de um agente, use o AGENTS.md como fonte única. Nos nossos workshops de IA pra empresas, montar esse tipo de manual pro agente faz parte da trilha das turmas avançadas.

---

Tema dos episódios 31 e 34 do Ratos de IA, nossa curadoria semanal de inteligência artificial, publicado originalmente como carrosséis e reels no Instagram @ratosdeia. Fontes: o post do Thariq sobre o AGENTS.md, o post do Tobi Lütke, o changelog do Claude Code e o post da Anthropic sobre os projetos.