AGENTS.md
AGENTS.md es un archivo Markdown de instrucciones permanentes para agentes de código que estos cargan en su contexto antes de empezar a trabajar.
Codex CLI lo lee antes de trabajar. A septiembre de 2026, toma un archivo global de su directorio personal (~/.codex por defecto) y luego uno por directorio desde la raíz del proyecto hasta el directorio de trabajo. Los une en ese orden, de modo que las instrucciones más cercanas quedan al final y tienen prioridad. AGENTS.override.md sustituye al archivo normal de su directorio, y /init crea uno inicial.
Codex limita lo que carga: deja de añadir archivos al alcanzar project_doc_max_bytes, cuyo valor por defecto es 32 KiB. Las instrucciones posteriores no llegan al modelo. La cadena se prepara al arrancar Codex, así que las ediciones se aplican en la siguiente ejecución.
Claude Code 2.1.277 y posteriores leen AGENTS.md como instrucciones del proyecto si no hay un CLAUDE.md en el directorio de trabajo ni en los superiores. También se puede importar explícitamente con @AGENTS.md desde CLAUDE.md para compartir instrucciones entre herramientas.
Compartir un archivo elimina duplicación, pero no reduce su coste. AGENTS.md forma parte de cada petición de la sesión, y cada agente que lo lee paga sus líneas en cada turno. Conviene dejar ahí lo necesario para todas las tareas y mover el resto a archivos que se carguen solo cuando corresponda.