AGENTS.md: el reglamento interno de un proyecto
Qué descubrí al entender el archivo que reúne las reglas generales de un proyecto para trabajar con Codex.
Cuando comencé a construir mi sistema con Codex, le entregué mucho contexto: qué quería hacer, qué materiales tenía, qué archivos debía respetar y cómo debía revisar el resultado.
Más adelante descubrí que parte de esas indicaciones había quedado reunida en un archivo llamado AGENTS.md.
Si tuviera que explicarlo con una imagen, diría que AGENTS.md es como el reglamento interno de una empresa, ese que deben respetar todos sus departamentos.
Contiene las instrucciones generales que deben seguirse al trabajar dentro de un proyecto:
- qué fuentes consultar;
- qué archivos se pueden modificar;
- qué herramientas utilizar;
- qué criterios seguir;
- qué comprobaciones realizar antes de entregar.
En mi caso, podía indicar que para recuperar contenido editable había que consultar primero los archivos .tex, que los PDF servían para revisar el resultado visual y que convenía comprobar el registro antes de reutilizar un ejercicio.
AGENTS.md no explica cómo realizar una tarea específica de principio a fin. Para eso puede existir una skill. Tampoco es el pedido de una tarea puntual, como lo sería un prompt.
Su función es más general: mantener presentes las reglas del proyecto para que Codex no tenga que recibirlas desde cero en cada conversación.
Yo no partí sabiendo que necesitaba un archivo llamado AGENTS.md. Primero expliqué cómo trabajaba y después reconocí el nombre técnico de una pieza que ayudaba a organizar ese contexto.
El propio Codex me fue explicando las piezas del proyecto. A veces me sugería crear una skill; otras veces creaba directamente lo que hacía falta, como ocurrió con AGENTS.md. Entonces yo le preguntaba qué era cada cosa, cuál era su función y por qué resultaba importante.
Ha sido una buena manera de aprender: pedirle a la inteligencia artificial que explique las herramientas y los procedimientos que utiliza para completar una tarea.
Volviendo al tema, AGENTS.md es una forma de convertir las reglas generales de un proyecto en algo explícito, consultable y reutilizable.