AGENTS.md y los agentes de código: el nuevo herramental del desarrollador
En 2026, los agentes de código pasan del autocompletado al compañero de equipo. El archivo AGENTS.md se ha impuesto como el estándar abierto para darles el contexto de un proyecto. Por qué importa.
Del autocompletado al agente
En apenas unos años, la asistencia al código ha cambiado de naturaleza: de la sugerencia línea a línea, hemos pasado a agentes capaces de leer una base entera, lanzar tests, abrir una pull request. El problema ya no es «generar código», sino darle al agente el contexto adecuado — comandos de build, convenciones, arquitectura.
AGENTS.md: un estándar abierto, en Markdown
Es exactamente lo que resuelve AGENTS.md: un simple archivo Markdown, en la raíz del proyecto, que explica a cualquier agente cómo trabajar aquí — comandos de build y de test, estilo de código, frameworks, decisiones de arquitectura. Sin esquema impuesto, sin herramienta que instalar: todo agente que lo lee se beneficia de inmediato.
El formato se formalizó en agosto de 2025 y luego se donó a la Agentic AI Foundation de la Linux Foundation en diciembre de 2025. A finales de 2025, más de 60 000 proyectos open source lo habían adoptado, y más de veinte herramientas lo soportan — GitHub Copilot (soporte nativo desde agosto de 2025), OpenAI Codex, Cursor, Gemini y Jules, Windsurf, Zed, y otras. Señal de los tiempos: Next.js 16.2 genera ahora un AGENTS.md en create-next-app.
Por qué es más que una moda
Un agente sin contexto redescubre el proyecto cada vez: adivina los comandos, ignora tus convenciones, produce código que hay que retrabajar. Un AGENTS.md bien escrito elimina esa fase de descubrimiento: el código generado respeta tus estándares desde el principio, y las idas y vueltas de revisión disminuyen.
Es, en el fondo, la misma idea que una buena documentación de onboarding — salvo que aquí el recién llegado es una máquina que lee rápido y no olvida nada.
Mi postura
Lo digo a menudo: la IA forma parte de mis herramientas, no de mis cimientos. Un agente bien equipado acelera la investigación, el prototipado, las tareas mecánicas. Pero es el desarrollador quien escribe el AGENTS.md, quien decide la arquitectura, quien revisa y valida. La herramienta no sustituye al juicio: lo amplifica.
Un agente vale lo que vale el contexto que le das. AGENTS.md es ese contexto, versionado con el código.