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

Otros con soporte nativo

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

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

Usa GEMINI.md nativamente. Workaround similar:

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	No	Symlink
Aider	AGENTS.md	Nativo	-
Roo Code	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

• 25+ herramientas soportan AGENTS.md (nativo o via workaround)
• Codex, Copilot, Cursor, AMP, Jules: soporte nativo
• Claude Code, Gemini CLI: requieren bridge pattern o symlink
• 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 →