Claude Code lê AGENTS.md apenas quando a telemetria está ativada [corrigido]

Artigo original ↗ Discussão no Hacker News ↗

Um bug na ferramenta Claude Code da Anthropic fez com que ela só lesse o novo arquivo de configuração `AGENTS.md` quando a telemetria estava ativada, gerando preocupações de que um comportamento local básico estivesse sendo condicionado à coleta de dados. A empresa depois explicou isso como um “artefato de rollout” não intencional, causado pelo uso de feature flags remotas como kill switch, e lançou rapidamente uma correção, mas muitos usuários criticaram a decisão de ligar a leitura de arquivos a flags remotas e a crescente complexidade da base de código. O episódio alimentou preocupações mais amplas sobre ferramentas de IA opacas e proprietárias que podem alterar seu comportamento remotamente, o uso excessivo de feature flags em software cliente e a influência de código e documentação gerados por IA na qualidade do software.

Comportamento de AGENTS.md com bloqueio por telemetria

  • Usuários descobriram que o Claude Code só lia AGENTS.md quando a telemetria estava ativada, apesar de as notas de lançamento sugerirem suporte universal.
  • Alguns relataram que isso vinha acontecendo há meses, bloqueando lançamentos graduais sempre que a telemetria estava desativada.

Explicação e correção da Anthropic

  • Um comentarista da equipe chamou isso de um “artefato de rollout”: o suporte a AGENTS.md estava atrás de uma feature flag remota, ligada pelo mesmo caminho da telemetria.
  • Com a telemetria desligada, as feature flags não podiam ser alternadas, então AGENTS.md nunca era ativado.
  • Eles classificaram como erro humano, pediram desculpas e disseram que uma nova versão remove a dependência.

Debate: bug vs. intenção

  • Alguns viram isso como um bug óbvio ou uma falha de rollout.
  • Outros suspeitaram que fosse intencional, para incentivar a ativação da telemetria.
  • Alguns argumentaram que estava “funcionando como projetado” dada a arquitetura das flags, mas que o próprio projeto era falho.

Críticas ao design e à arquitetura

  • Muitos argumentaram que ler um arquivo local nunca deveria depender de estado remoto ou telemetria, especialmente sem qualquer aviso visível.
  • Vários chamaram o design de “indefensável”, mesmo que o comportamento específico tenha sido acidental.
  • Outros minimizaram o impacto, observando que usuários sem telemetria simplesmente recebiam o recurso um pouco depois.

Feature flags, telemetria e controle remoto

  • Alguns defenderam feature flags e kill-switches como padrão para rollouts seguros, especialmente em grande escala.
  • Outros se incomodaram com o fato de uma ferramenta de desktop poder ter seu comportamento alternado remotamente, enquadrando isso como “controle remoto” da própria máquina.
  • Surgiu um debate sobre se feature flags precisam estar acopladas à telemetria ou se poderiam ser apenas pull-based e preservar a privacidade.

Mods/sistema de plugins e complexidade

  • O suporte a AGENTS.md foi implementado por meio de um novo sistema de extensibilidade “Mods” e hooks de função.
  • Muitos viram isso como um enorme excesso de engenharia para algo que externamente parece “leia CLAUDE.md ou, se não existir, leia AGENTS.md”.
  • Outros responderam que é uma forma de baixo risco de exercitar um novo sistema de plugins.

Harness aberto vs. fechado e expectativas de configuração

  • Houve confusão sobre os repositórios no GitHub: apenas mods/plugins são de código disponível; o harness principal é proprietário.
  • Alguns criticaram isso como enganoso e defenderam o uso de harnesses abertos.
  • Vários perguntaram por que o tratamento de nomes de arquivo não é simplesmente configurável, ou ao menos não está rigidamente preso a feature flags.

Workarounds e notas práticas

  • Usuários descreveram soluções alternativas: symlinks, CLAUDE.md que apenas referencia @AGENTS.md, diretórios .agents/skills compartilhados.
  • Observação: por padrão, se CLAUDE.md existir, AGENTS.md é ignorado a menos que uma configuração específica “claude-md-and-agents-md” esteja habilitada.