AGENTS.md: cuando el framework le dice al agente que su memoria está desfasada.

Next.js 16.3 no solo genera AGENTS.md: Vercel elimina skills que existían para «traer las docs al agente». Los benchmarks internos del ecosistema favorecen documentación siempre disponible y alineada con el paquete frente a recuperar conocimiento bajo demanda desde fuentes que pueden estar desactualizadas.

En lenguaje llano: el agente deja de buscar en internet cómo funciona Next.js y lee el manual que viaja dentro de tu node_modules —la carpeta donde npm instala las dependencias—, de la versión exacta que tienes instalada. Eso reduce las «alucinaciones» —código que parece correcto pero usa APIs que ya no existen—.

El ciclo inspect-edit-verify se cierra con agent-browser (introspección de React DevTools) y skills de flujo como next-dev-loop. El agente no solo escribe JSX; comprueba el runtime. Piénsalo como un mecánico que no solo cambia la pieza: enciende el motor y escucha si ronronea bien.

Si mantienes una librería o un producto interno, el playbook es exportable: docs versionadas en el paquete, errores con páginas de arreglo y un fichero de agentes que el modelo lee primero. En Ambigram lo aplicamos a convenciones de cada cliente —cómo nombrar rutas, dónde van los tests, qué no tocar sin OK— no a un manual universal.

Un AGENTS.md útil incluye: versión del stack, comandos para arrancar y testear, ramas protegidas, secretos que nunca van al chat y ejemplos de cambios buenos y malos. En otras palabras: es el documento que le darías a un desarrollador nuevo el primer día, pero escrito para que también lo entienda la IA.

La documentación que el agente no puede ignorar no es un prompt largo en el chat. Es un archivo en el repositorio, versionado con el código, revisado en pull request como cualquier otra pieza crítica. Cuando eso existe, humanos y agentes comparten el mismo contrato.