Archivo de instrucciones para agentes (AGENTS.md)
Un archivo de instrucciones para agentes es un archivo Markdown en un repositorio de código, como AGENTS.md o CLAUDE.md, que un agente de programación lee al inicio de una sesión para conocer los comandos, las convenciones y las reglas del proyecto.
También llamado: AGENTS.md, CLAUDE.md, .cursorrules, rules file
Por Divya Sharma · Comprobado el 15 nov 2026 · Cómo hacemos las reseñas
Un agente de programación empieza cada sesión sin saber nada de tu proyecto. Sin ayuda, adivina cómo ejecutar las pruebas, qué estilo seguir y qué carpetas no tocar. Un archivo de instrucciones responde a esas preguntas una sola vez, en un sitio que el agente siempre lee.
Los formatos habituales
AGENTS.md es un formato abierto pensado para funcionar en distintas herramientas, y lo leen OpenAI Codex y muchas otras. Claude Code lee CLAUDE.md y también puede usar AGENTS.md. Cursor tiene sus propios archivos de reglas, incluido el antiguo .cursorrules. El contenido es parecido en todos: comandos de compilación y de pruebas, estilo de código, notas de arquitectura y cosas que no hay que hacer.
Cómo funciona
El agente carga el archivo en su contexto al inicio de una sesión, así que actúa como un system prompt a nivel de proyecto. Los archivos se pueden anidar: un monorepo puede tener uno en la raíz y otro en cada paquete, y la pauta de AGENTS.md es que gana el archivo más cercano al código que se edita, mientras que las instrucciones escritas en el chat prevalecen sobre todos ellos. Un archivo personal en tu carpeta de usuario puede contener reglas que se aplican a todos los proyectos.
Límites
El archivo es contexto, no una imposición. El agente suele seguirlo, pero puede ignorarlo u olvidarlo, sobre todo tras una compactación del contexto. Las reglas que deben cumplirse siempre, como no tocar nunca una configuración de producción, van en hooks de agente o en la configuración de permisos. Mantén el archivo corto y concreto; los archivos largos cuestan tokens en cada sesión y diluyen las reglas que importan. Los procedimientos reutilizables encajan mejor en skills de agente.
Términos relacionados
- Agente de programación
- Un agente de programación (coding agent) es un agente de IA que trabaja directamente sobre el software: lee un código, edita archivos, ejecuta comandos y pruebas, y repite hasta que un cambio funciona, en lugar de limitarse a sugerir código para que una persona lo pegue.
- Context engineering
- El context engineering (ingeniería de contexto) es la práctica de elegir y mantener todo lo que entra en la ventana de contexto de un modelo de lenguaje durante una tarea: instrucciones, documentos recuperados, definiciones de herramientas, resultados de herramientas e historial de la conversación.
- Skills de agente
- Las skills de agente (habilidades) son carpetas de instrucciones, scripts y archivos de referencia, cada una descrita por un archivo SKILL.md, que un agente de IA puede descubrir y cargar solo cuando una tarea las necesita.
- Hooks de agente
- Los hooks de agente (ganchos) son comandos o scripts definidos por el usuario que un agente de programación ejecuta automáticamente en puntos fijos de su trabajo, como antes de una llamada a una herramienta o después de editar un archivo, para comprobar, bloquear o ampliar lo que hace.
- System prompt
- El system prompt (prompt del sistema) es el bloque de instrucciones que una aplicación envía a un modelo de lenguaje antes de los mensajes del usuario. Fija el rol, las reglas, el tono y el formato de salida del modelo para toda la conversación.
- Comando de barra
- Un comando de barra (slash command) es una instrucción escrita con una barra inicial, como /compact o /review, que indica a una herramienta de IA que ejecute una acción integrada o un prompt guardado en lugar de tratar el texto como un mensaje normal.