Claude Code agora lê AGENTS.md se não houver Claude.md

Artigo original ↗ Discussão no Hacker News ↗

O Claude Code adicionou suporte para ler o arquivo AGENTS.md de um projeto quando nenhum CLAUDE.md está presente, alinhando-se a um padrão de fato emergente usado por outras ferramentas de programação com IA. Os desenvolvedores recebem bem a mudança principalmente porque ela reduz o lock-in e a necessidade de symlinks ou arquivos de configuração duplicados, mas muitos criticam a Anthropic por ter demorado tanto e ainda ignorar convenções relacionadas, como `.agents/skills` e configurações de agente em nível de usuário. A troca reflete uma frustração mais ampla com comportamentos proprietários de harnesses, a mudança no poder de mercado entre fornecedores de IA e o surgimento lento e confuso de padrões compartilhados para configuração de agentes.

Escopo da mudança

  • Claude Code agora recorre a AGENTS.md quando nenhum CLAUDE.md está presente.
  • Muitos comentaristas dizem que isso lhes permite حذفar stubs de CLAUDE.md de uma linha ou symlinks que apenas apontavam para AGENTS.md.

Padrões vs. comportamento proprietário

  • AGENTS.md é descrito como um padrão de fato em muitos harnesses; a insistência do Claude em CLAUDE.md foi vista como uma imposição de um fluxo de trabalho e de uma marca proprietários.
  • Alguns argumentam que “já era hora” de o Claude respeitar a convenção compartilhada; outros observam que CLAUDE.md na verdade precedeu AGENTS.md, mas foi rapidamente superado pela adoção do ecossistema.
  • Uma minoria argumenta que prompts devem ser ajustados por modelo e que um AGENTS.md universal pode prejudicar a diversidade de modelos.

Lacunas restantes e alternativas

  • Muitos enfatizam que isso é apenas uma correção parcial: o Claude Code ainda não oferece suporte a .agents/skills (nem a ~/.agents/skills), que a maioria dos outros harnesses oferece.
  • Usuários compartilham alternativas: criar symlinks de .agents/skills para .claude/skills, hooks de Git para automatizar isso, e usar CLAUDE.md como @AGENTS.md mais adições específicas do Claude.
  • Limitações de symlink no Windows/git complicam algumas dessas abordagens.

Confiabilidade em seguir instruções

  • Vários observam que, mesmo com CLAUDE.md/AGENTS.md, o Claude frequentemente ignora instruções (por exemplo, flags de CLI, “não adicionar texto ‘Made with Claude’”).
  • Comentários apontam para o system prompt do harness que rotula esses arquivos como “contexto opcional”, o que pode reduzir a conformidade em comparação com outras ferramentas que tratam AGENTS.md como obrigatório.

Lock-in de fornecedor e escolha de harness

  • Há forte ceticismo em relação a harnesses de código fechado, controlados por fornecedores, e seus incentivos para maximizar o uso de tokens e prender os usuários.
  • Alguns relatam ter migrado para harnesses alternativos e/ou modelos de pesos abertos, citando melhor aderência a AGENTS.md e .agents/skills, portabilidade entre fornecedores e um design mais alinhado ao usuário.

Reações metalinguísticas

  • Muitos veem isso como o mínimo esperado, em vez de algo a ser celebrado, mas ainda assim acolhem a mudança em direção a um padrão compartilhado.
  • A intensidade da discussão sobre uma pequena funcionalidade é tomada como sinal de quão centrais se tornaram a ergonomia e a interoperabilidade dos harnesses de IA.