AGENTS.md: Tutorial Completo
AGENTS.md: Tutorial Completo
Estado: AGENTS.md es un estandar abierto respaldado por la Agentic AI Foundation (Linux Foundation). Adoptado por mas de 60,000 repositorios open-source.
Que es este tutorial
AGENTS.md es un formato simple y abierto para guiar agentes de codigo IA. Piensa en el como un README para agentes: un lugar dedicado donde proporcionas el contexto e instrucciones que los agentes necesitan para trabajar en tu proyecto.
Mientras que README.md esta dirigido a humanos (quick starts, descripciones), AGENTS.md contiene lo que los agentes necesitan: comandos de build, tests, convenciones de codigo y restricciones.
Este tutorial cubre desde la creacion basica hasta patrones avanzados, integracion con Claude Code y combinacion con OpenSpec.
Capitulos
Fundamentos (Capitulos 1-3)
- Introduccion y Motivacion - Que problema resuelve, por que un archivo separado, quien lo respalda
- Tu Primer AGENTS.md - Crear, estructurar y probar tu primer archivo
- Secciones Esenciales - Las 6 areas que todo AGENTS.md debe cubrir
Uso Avanzado (Capitulos 4-6)
- Monorepos y Jerarquias - Archivos anidados, resolucion de conflictos, progressive disclosure
- Sistema de Boundaries - Always do, Ask first, Never do: protege tu codebase
- Optimizacion de Tokens - Mantener el archivo conciso, presupuesto de instrucciones, metricas
Integraciones (Capitulos 7-9)
- AGENTS.md con Claude Code - Workarounds, bridge pattern CLAUDE.md ↔ AGENTS.md, configuracion
- AGENTS.md con OpenSpec - Combinar SDD con instrucciones de agente, flujos complementarios
- Ecosistema de Herramientas - Codex, Cursor, Copilot, Amp y 20+ herramientas compatibles
Patrones y Mejores Practicas (Capitulos 10-11)
- Mejores Practicas y Antipatrones - Lecciones de 2,500+ repositorios, errores comunes, checklist final
- Genera tu AGENTS.md (para agentes IA) - Capitulo especial: dale esta URL a tu agente IA y generara un AGENTS.md para tu proyecto
Requisitos previos
- Un proyecto con repositorio Git
- Un agente de codigo IA (Claude Code, Cursor, Codex, Copilot, etc.)
- Conocimientos basicos de Markdown
Recursos
Siguiente -> Capitulo 1: Introduccion y Motivacion