Claude Code lee AGENTS.md solo cuando la telemetría está activada [corregido]

Artículo original ↗ Discusión en Hacker News ↗

Un error en la herramienta Claude Code de Anthropic hacía que solo leyera el nuevo archivo de configuración `AGENTS.md` cuando la telemetría estaba activada, lo que generó preocupaciones de que el comportamiento local básico se estuviera condicionando a la recopilación de datos. Más tarde, la empresa explicó que se trataba de un “artefacto de despliegue” no intencional derivado del uso de feature flags remotos como kill switch, y lanzó rápidamente una corrección, pero muchos usuarios criticaron la decisión de diseño de vincular la lectura de archivos a flags remotos y la creciente complejidad de la base de código. El episodio alimentó preocupaciones más amplias sobre herramientas de IA opacas y propietarias que pueden cambiar remotamente su comportamiento, el uso excesivo de feature flags en software cliente y la influencia del código y la documentación generados por IA en la calidad del software.

Comportamiento de AGENTS.md condicionado por la telemetría

  • Los usuarios descubrieron que Claude Code solo leía AGENTS.md cuando la telemetría estaba activada, a pesar de que las notas de la versión insinuaban compatibilidad universal.
  • Algunos informaron que había funcionado así durante meses, bloqueando despliegues por etapas cuando la telemetría estaba desactivada.

Explicación y corrección de Anthropic

  • Un comentarista del equipo lo llamó un “artefacto de despliegue”: la compatibilidad con AGENTS.md estaba detrás de un flag de función remoto conectado por la misma ruta que la telemetría.
  • Con la telemetría desactivada, los flags de función no podían alternarse, así que AGENTS.md nunca se activaba.
  • Lo calificaron como un error humano, se disculparon y dijeron que una nueva versión elimina la dependencia.

Debate sobre bug vs. intención

  • Algunos lo vieron como un bug obvio o un descuido en el despliegue.
  • Otros sospecharon que era intencional para incentivar activar la telemetría.
  • Unos pocos argumentaron que estaba “funcionando como se diseñó” dada la arquitectura de flags, pero que el diseño en sí era defectuoso.

Críticas al diseño y la arquitectura

  • Muchos sostuvieron que leer un archivo local nunca debería depender del estado remoto o de la telemetría, especialmente sin ninguna advertencia visible.
  • Varios calificaron el diseño de “indefendible”, incluso si el comportamiento concreto fue accidental.
  • Otros minimizaron el impacto, señalando que los usuarios sin telemetría solo obtenían la función un poco más tarde.

Feature flags, telemetría y control remoto

  • Algunos defendieron los feature flags y los kill-switches como algo estándar para despliegues seguros, especialmente a gran escala.
  • A otros les incomodó que una herramienta de escritorio pueda tener su comportamiento alternado remotamente, enmarcándolo como “control remoto” de su máquina.
  • Surgió el debate sobre si los feature flags deben estar acoplados a la telemetría o si podrían ser solo de extracción y respetuosos con la privacidad.

Mods/sistema de plugins y complejidad

  • La compatibilidad con AGENTS.md se implementó mediante un nuevo sistema de extensibilidad “Mods” y hooks de funciones.
  • Muchos vieron esto como una sobreringeniería enorme para lo que externamente parece “leer CLAUDE.md o, si no existe, leer AGENTS.md”.
  • Otros respondieron que es una forma de bajo riesgo de poner a prueba un nuevo sistema de plugins.

Harness abierto vs. cerrado y expectativas de configuración

  • Hubo confusión sobre los repositorios de GitHub: solo los mods/plugins son de código disponible; el harness central es propietario.
  • Algunos criticaron esto por engañoso y pidieron usar harnesses abiertos en su lugar.
  • Varios preguntaron por qué el manejo de nombres de archivo no es simplemente configurable, o al menos no está codificado rígidamente a feature flags.

Soluciones alternativas y notas prácticas

  • Los usuarios describieron soluciones alternativas: symlinks, CLAUDE.md que solo referencia @AGENTS.md, directorios .agents/skills compartidos.
  • Nota: por defecto, si existe CLAUDE.md, se ignora AGENTS.md salvo que esté habilitada una configuración específica “claude-md-and-agents-md”.