Mantener la documentación con IA

Hacer que se escriba la documentación — y revisarla

La IA es buena generando documentación: secciones de README, comentarios de funciones, descripciones de API. La documentación de Claude Code describe para esto un proceso sencillo: hacer que se localicen los puntos sin documentar, generar la documentación, y luego revisar y afinar. Este último paso es obligatorio: la documentación generada siempre suena convincente — aunque sea incorrecta. Léela antes de comitearla.

Documentación para agentes: CLAUDE.md y AGENTS.md

Hoy la documentación tiene dos públicos: personas y agentes. CLAUDE.md es un archivo que Claude Code lee al principio de cada sesión — con comandos de build, reglas de estilo y particularidades del proyecto. AGENTS.md es un formato abierto y transversal a herramientas con la misma idea: un «README para agentes», que leen más de 20 herramientas de codificación (a fecha de julio de 2026).

Evitar que la documentación se desactualice

La documentación queda obsoleta cuando el código cambia y nadie la toca. Una documentación incorrecta es peor que ninguna — sobre todo para los agentes, que confían en ella. Regla práctica: actualiza la documentación en el mismo paquete de cambios que el código, y pregunta a la IA con regularidad: «¿El README sigue correspondiendo al estado actual?»

llms.txt para lectores de IA

Si tu documentación es un sitio web, ayuda un archivo /llms.txt: un resumen en markdown con enlaces, para que los sistemas de IA encuentren el contenido sin tener que abrirse paso por HTML lleno de navegación y publicidad.