Ejemplos de AGENTS.md
Instrucciones del repositorio
AGENTS.md reúne instrucciones del proyecto para un agente de programación. Incluye datos que se repiten en varias tareas, como el comando de pruebas, las carpetas del código y las reglas sobre archivos generados. Describe un fallo concreto en la petición de la tarea para que no se convierta en una instrucción permanente.
En una aplicación ficticia de envíos, podrías escribir: “La lógica de pedidos está en src/orders. Ejecuta sus pruebas después de modificarla. Conserva los campos de la respuesta pública. Nunca copies registros de clientes en una petición al modelo”. Cada frase resuelve una decisión que el agente tendría que tomar por su cuenta.
Alcance y permisos
Codex busca archivos de instrucciones desde la raíz del repositorio hasta su directorio de trabajo. La guía oficial de AGENTS.md explica las excepciones y los límites de tamaño. Comprobamos estas convenciones el 14 de noviembre de 2026. Otros productos pueden cargar el mismo archivo de forma distinta.
Una instrucción escrita no impide que un proceso lea un secreto o acceda a la red. Acompáñala de controles de acceso. Practica los límites de permisos y compara el ejemplo de CLAUDE.md.