Ecosistema de Herramientas

Compatibilidad

AGENTS.md es soportado nativamente (o via workaround) por mas de 25 herramientas. Aqui las mas relevantes.

Soporte nativo

Estas herramientas leen AGENTS.md automaticamente sin configuracion:

OpenAI Codex

Codex fue uno de los impulsores del estandar. Lee AGENTS.md con soporte completo:

• Descubrimiento automatico en raiz y subdirectorios
• Soporte para AGENTS.override.md
• Config global en ~/.codex/AGENTS.md
• Limite: 32 KiB combinado (configurable via project_doc_max_bytes)
• Verificar: codex --ask-for-approval never "Summarize current instructions"

GitHub Copilot

Copilot (en VS Code y GitHub.com) lee AGENTS.md como parte de su sistema de instrucciones:

• Busca en la raiz del repositorio
• Lo combina con .github/copilot-instructions.md si existe
• Prioridad: instrucciones del usuario > AGENTS.md > instrucciones de copilot

Google Jules

El agente de Google tiene soporte nativo:

• Lee AGENTS.md al iniciar una sesion
• Soporta jerarquia para monorepos
• Se combina con la configuracion de Gemini

Cursor

Cursor lee AGENTS.md ademas de su formato nativo .cursorrules:

• AGENTS.md tiene prioridad sobre .cursorrules si ambos existen
• Soporta archivos anidados en subdirectorios

AMP

Inicialmente uso AGENT.md (singular), pero migro al estandar:

• Soporte completo para AGENTS.md
• Backward compatible con AGENT.md
• Recomiendan oficialmente AGENTS.md

JetBrains Junie

El agente de JetBrains tiene soporte nativo para AGENTS.md:

• Lee AGENTS.md al iniciar sesion
• Integrado con IDEs de JetBrains (IntelliJ, WebStorm, PyCharm, etc.)

Augment Code

Augment Code CLI soporta AGENTS.md nativamente:

• Descubrimiento automatico en raiz y subdirectorios
• Documentacion: https://docs.augmentcode.com/cli/overview

Otros con soporte nativo

Herramienta	Notas
Windsurf	Lee AGENTS.md + .windsurfrules
Continue.dev	Busca AGENTS.md primero
Aider	Soporte completo
goose	Soporte completo
OpenHands	Soporte completo
Roo Code	Soporte agregado en julio 2025
Factory	Documentacion dedicada para AGENTS.md
Zed AI	Soporte via assistant panel
UiPath / Autopilot	Soporte via Coded Agents

Soporte via workaround

Claude Code

No lee AGENTS.md nativamente. Workarounds:

# CLAUDE.md
@AGENTS.md

O symlink: ln -s AGENTS.md CLAUDE.md

Ver Capitulo 7 para detalles completos.

Gemini CLI

Gemini CLI ahora soporta referenciar archivos externos via settings.json:

{
  "context": {
    "fileName": "AGENTS.md"
  }
}

Como alternativa, el symlink clasico sigue funcionando: ln -s AGENTS.md GEMINI.md

Estrategia multi-herramienta

Si tu equipo usa diferentes herramientas, la estrategia recomendada:

proyecto/
├── AGENTS.md              # Fuente de verdad
├── CLAUDE.md              # @AGENTS.md + extensiones Claude
├── .cursorrules           # Symlink a AGENTS.md (o file propio)
└── .github/
    └── copilot-instructions.md  # Puede referenciar AGENTS.md

Reglas

1. AGENTS.md es la fuente de verdad: toda instruccion universal va aqui
2. Archivos especificos son bridges: solo agregan extensiones de la herramienta
3. Symlinks para herramientas sin extensiones: si no necesitas nada extra, symlink
4. No duplicar: nunca copies contenido de AGENTS.md a otro archivo

Tabla de archivos por herramienta

Herramienta	Archivo nativo	Lee AGENTS.md	Workaround
Codex	AGENTS.md	Nativo	-
Claude Code	CLAUDE.md	No	@AGENTS.md en CLAUDE.md
Copilot	copilot-instructions.md	Nativo	-
Cursor	.cursorrules	Nativo	-
AMP	AGENT.md	Nativo	-
Windsurf	.windsurfrules	Nativo	-
Gemini CLI	GEMINI.md	Nativo	context.fileName en settings.json
Junie	AGENTS.md	Nativo	-
Augment Code	AGENTS.md	Nativo	-
Aider	AGENTS.md	Nativo	-
goose	AGENTS.md	Nativo	-
Roo Code	AGENTS.md	Nativo	-
UiPath	AGENTS.md	Nativo	-

Migracion desde archivos propietarios

Si ya tienes un .cursorrules o CLAUDE.md y quieres migrar a AGENTS.md:

Paso 1: Extraer instrucciones universales

Revisa tu archivo actual. Separa:

• Universal (comandos, stack, convenciones) → va a AGENTS.md
• Especifico de herramienta (skills, MCP, sub-agentes) → queda en el archivo original

Paso 2: Crear AGENTS.md

Mueve las instrucciones universales al nuevo archivo.

Paso 3: Convertir archivo original en bridge

# CLAUDE.md
@AGENTS.md

## Claude-specific extensions
[Solo lo especifico de Claude Code]

Paso 4: Verificar

Prueba con cada herramienta que las instrucciones se cargan correctamente.

Resumen

• 28+ herramientas soportan AGENTS.md (nativo o via workaround)
• Codex, Copilot, Cursor, AMP, Jules, Junie, Augment Code, goose: soporte nativo
• Claude Code: requiere bridge pattern (@AGENTS.md en CLAUDE.md)
• Estrategia multi-herramienta: AGENTS.md como fuente de verdad + bridges especificos
• Migracion: extraer instrucciones universales → AGENTS.md, dejar extensiones en archivo original

---

← Capitulo 8: AGENTS.md con OpenSpec | Capitulo 10: Mejores Practicas y Antipatrones →