Guías

¿Qué es AGENTS.md?

Un archivo en la raíz del repo que le dice al agente cómo construir y qué convenciones seguir.

~2 min lectura Revisado el 10 de julio de 2026

Cursor Claude Code GitHub Copilot OpenAI Codex VS Code Antigravity Principiante estándaragents-md

En una línea

AGENTS.md es un markdown en la raíz del proyecto con instrucciones para agentes de IA: build, tests, convenciones y qué evitar.

Para qué sirve

El README explica el proyecto a humanos. AGENTS.md le dice al agente qué comandos correr y cómo escribir código aquí, sin repetirlo en cada chat.

Cuándo tiene sentido

Repo con más de una persona (o agente) tocando el mismo código.
Usas Cursor y Claude Code en el mismo proyecto y quieres una sola fuente de verdad.
Monorepo donde el contexto global evita que el agente se pierda.

Cuándo puedes omitirlo

Proyecto personal pequeño, un solo dev, y ya tienes reglas del editor que cubren lo mismo.

Ejemplo mínimo

# AGENTS.md

## Build
- Instalar: npm install
- Dev: npm run dev
- Tests: npm test

## Convenciones
- TypeScript estricto
- Componentes en PascalCase

Especificación oficial

El estándar completo y la lista de editores compatibles están en agents.md (enlace en la ficha sitio oficial).

No confundir con

Reglas del editor → convenciones que cargan casi siempre. Guía: ¿Qué es una regla?. Catálogo: /rules/.
Skills → flujos para tareas puntuales. Guía: ¿Qué es un skill?. Catálogo: /skills/.
MCP → integraciones externas (browser, docs). Guía: ¿Qué es un MCP?.