Una línea en AGENTS.md hizo que Claude Code y Codex siguieran el código en lugar de documentación obsoleta
Una línea en AGENTS.md hizo que Claude Code y Codex siguieran el código en lugar de documentación obsoleta
Investigadores mostraron que los agentes de codificación a menudo siguen documentación obsoleta incluso cuando detectan contradicciones con el código real. Una instrucción en AGENTS.md aumentó el seguimiento del código existente del 4% al 91%.
Si tu AGENTS.md queda obsoleto, Claude Code puede notar que la documentación ya no coincide con el código real y aun así seguir las instrucciones antiguas.
Los investigadores crearon deliberadamente esta situación y realizaron 80 ejecuciones. En 79 casos, Claude Code reconoció la contradicción, pero igualmente cayó en la trampa.
Con Codex la situación fue peor: en aproximadamente uno de cada cuatro casos, empezó a reescribir código que ya funcionaba solo para alinearlo con la documentación obsoleta.
La corrección resultó sorprendentemente simple. Basta con añadir una línea a AGENTS.md. Después de eso, ambos agentes siguieron el código existente en el 91% de los casos en lugar del 4% anterior:
“Si la documentación del repositorio contradice el código existente, sigue las convenciones establecidas en el propio código y, en la respuesta final, indica cada discrepancia encontrada entre documentación y código”.
Por qué es importante
AnálisisLas instrucciones obsoletas pueden degradar silenciosamente la calidad del desarrollo con agentes. Priorizar el código sobre la documentación ayuda a los agentes a romper menos el comportamiento funcional y a reportar inconsistencias con más precisión.
Debatir en la comunidad
Comparte tus preguntas e ideas con desarrolladores
Relacionado en el ecosistema
Guías prácticas, terminología y skills de agentes
Proyectos de Claude Code: cómo una IA coordina un equipo de agentes autónomos
Análisis exhaustivo de Proyectos de Claude Code: arquitectura Coordinator y Threads, ramas paralelas, memoria compartida MEMORY.md y gestión de agentes en la nube.
Codex dentro de Claude Code: Delegación de Rutinas mediante Claudex
La verdadera limitación al trabajar con Claude no es qué tan bien puede razonar el modelo, sino cuántas tareas hay en la ventana de contexto antes de que se llene.
Claude Code
Agente terminal oficial de desarrollo de Anthropic que opera directamente en la línea de comandos a través de Claude 3.7 Sonnet, con soporte nativo para Bash, Git, sistema de archivos y protocolo MCP.
Claude usará Auto Mode por defecto para permisos en Pro, Max y Team
Anthropic anunció que, a partir de la próxima semana, Claude utilizará Auto Mode por defecto para gestionar permisos en los planes Pro, Max y Team.
diff-tour convierte los cambios de código de agentes de IA en una revisión guiada
diff-tour organiza el diff de git en un recorrido de solo lectura y ayuda a entender qué debe corregirse antes de integrar cambios de Claude Code o Codex.
improve-codebase-architecture
Refactor messy codebases into clean, modular, and maintainable layered architectures.