# ¿Qué es AGENTS.md?

URL: https://agentvera.dev/es/glossary/agents-md/

AGENTS.md es un archivo Markdown abierto y sencillo dentro de un repositorio que explica a los agentes de programación con IA cómo trabajar en el proyecto: cómo compilarlo y probarlo, qué convenciones seguir y qué evitar. Piensa en él como un README para agentes que leen muchas herramientas distintas.

**Qué agentes lo leen.** El formato se describe en agents.md, que enumera más de 20 herramientas compatibles. El soporte varía en los detalles, así que consulta también la documentación de tu agente.

- Lo leen Codex, Cursor, el agente de programación de GitHub Copilot, opencode, Amp, Aider, goose, Zed, Warp, Junie y Jules, entre otros.
- Gemini CLI lee GEMINI.md por defecto; si añades AGENTS.md al ajuste context.fileName de settings.json, también lo lee.
- Claude Code lee CLAUDE.md y, desde la versión 2.1.277, lee AGENTS.md cuando el repositorio no tiene CLAUDE.md. También puedes importarlo en CLAUDE.md con @AGENTS.md.

**AGENTS.md, CLAUDE.md y GEMINI.md.** CLAUDE.md y GEMINI.md son los archivos propios de Claude Code y Gemini CLI; AGENTS.md es el compartido. Los tres contienen el mismo tipo de información. Una configuración habitual guarda las reglas comunes en AGENTS.md y hace que los archivos de cada herramienta apunten a él, añadiendo solo lo específico, para que las instrucciones no se desincronicen. Si existen ambos, Claude Code lee por defecto solo CLAUDE.md, así que importa AGENTS.md desde él o cambia el ajuste Project instructions.

**Qué poner en él.** Escribe lo que necesitaría saber un compañero nuevo el primer día y lo que, si no, repetirías en cada prompt. Mantenlo breve: los agentes lo cargan en su contexto al empezar una sesión.

- Comandos de instalación, compilación y pruebas, tal como se ejecutan.
- Estilo de código y convenciones que el linter no comprueba.
- Estructura del proyecto: dónde está cada cosa y qué carpetas se generan.
- Reglas para commits y pull requests.
- Lo que nunca debe hacerse, como editar archivos generados o subir secretos.

**Un ejemplo breve.** Un AGENTS.md mínimo para un proyecto en TypeScript podría ser así. En un monorepo cada paquete puede tener su propio AGENTS.md, y los agentes usan el más cercano al archivo que editan.

- ## Comandos: pnpm install; ejecuta pnpm test antes de cada commit y pnpm lint después de mover archivos.
- ## Estilo: TypeScript en modo strict, comillas simples, sin punto y coma.
- ## Estructura: código de la app en src/; el cliente de la API en src/gen/ se genera, no lo edites a mano.
- ## Pull requests: título como “[paquete] Resumen corto”; lint y pruebas deben pasar.

**Dónde encaja AgentVera.** AgentVera inicia la propia CLI de cada agente en la carpeta del proyecto, así que AGENTS.md y los archivos de cada herramienta se aplican como siempre; el campo de rol e instrucciones de un agente añade instrucciones permanentes encima, y las CLI sin una opción para instrucciones extra (por ejemplo Cursor, Gemini CLI y Amp) se apoyan en el AGENTS.md o los archivos de reglas del proyecto.

- **¿AGENTS.md es un estándar formal?** Es un formato abierto sin campos obligatorios ni esquema: Markdown sencillo con los encabezados que te sirvan. Su sitio es agents.md.
- **¿Necesito CLAUDE.md y AGENTS.md a la vez?** No necesariamente. Las versiones recientes de Claude Code leen AGENTS.md cuando no hay CLAUDE.md. Si quieres reglas propias de Claude, mantén un CLAUDE.md corto que importe AGENTS.md con @AGENTS.md.
- **¿Dónde va el archivo?** En la raíz del repositorio. Los repositorios grandes pueden añadir más en subcarpetas; manda el más cercano al código que se edita, y una instrucción directa en el chat está por encima de todos.
- **¿Qué longitud debería tener?** Lo más corto posible sin dejar de ser útil. Ocupa contexto en cada sesión, y una regla enterrada en un archivo largo se le escapa más fácilmente a un agente.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/