AGENTS.md vs llms.txt
Dos archivos, dos trabajos
Ambos viven en tu raíz, ambos se dirigen a agentes, y responden preguntas diferentes:
| llms.txt | AGENTS.md | |
|---|---|---|
| Responde | "¿Qué hay aquí?" | "¿Cómo debes comportarte aquí?" |
| Forma | Índice markdown de enlaces con resúmenes de una línea | Instrucciones markdown de formato libre |
| Nació en | Sitios de documentación (llmstxt.org) | Repositorios de código, para agentes de programación |
| Lo leen | Agentes orientándose en un sitio | Agentes a punto de trabajar en un contexto |
| Analogía | Un mapa del sitio para máquinas | Un README dirigido a la máquina |
llms.txt es un índice curado: URLs clave con descripciones de una línea, para que un agente aprenda tu superficie en una sola descarga. AGENTS.md son instrucciones en prosa: convenciones, qué hacer y qué no, cómo ejecutar cosas — el archivo que los agentes de programación buscan en un repositorio antes de tocarlo, y que ahora se extiende más allá de los repos.
Por qué las tiendas de repente tienen AGENTS.md
Shopify llevó la convención al mainstream de la web comercial: cada tienda Shopify sirve ahora un /agents.md por defecto, y — según la documentación de temas de Shopify — Shopify gestiona /llms.txt reflejando el contenido de /agents.md, con /llms-full.txt apuntando igual. Los comerciantes sobrescriben cualquiera de los tres con plantillas Liquid (templates/agents.md.liquid, templates/llms.txt.liquid, templates/llms-full.txt.liquid). Un archivo de instrucciones, tres puertas.
Esa decisión de diseño es reveladora: obligada a elegir una única fuente de verdad, Shopify eligió el archivo de instrucciones y generó el índice a partir de él.
¿Cuál deberías publicar?
- Tienes documentación o una API → llms.txt primero. Indexa tus páginas clave y cruza referencias a tu endpoint MCP y tu especificación OpenAPI.
- Los agentes transaccionan u operan en tu sitio (checkout, reservas, flujos de soporte) → añade AGENTS.md con instrucciones de comportamiento: qué pueden hacer los agentes, expectativas de ritmo, dónde están las rutas legibles por máquina.
- Ambos es el valor por defecto seguro. Se cruzan limpiamente: llms.txt enlaza AGENTS.md como "instrucciones de operación", AGENTS.md enlaza llms.txt como "el índice".
No confundas ninguno con agents.txt (una propuesta de política de acceso) ni con robots.txt (permisos de rastreo). Cuatro archivos raíz, cuatro trabajos: permiso, política, índice, instrucciones.
Preguntas frecuentes
¿Es AGENTS.md un estándar?
Es una convención, no una especificación — no hay un organismo formal detrás. Su fuerza es la adopción: los agentes de programación lo buscan en repositorios, y Shopify lo sirve por defecto en cada tienda.
¿AGENTS.md reemplaza a llms.txt?
No — responden preguntas distintas, y el diseño espejo de Shopify muestra cómo coexisten: instrucciones como fuente, índice como vista. Un sitio con solo AGENTS.md pierde el índice de enlaces de una descarga; un sitio con solo llms.txt no da a los agentes ninguna guía de comportamiento.
¿AgentGrade verifica AGENTS.md?
Las verificaciones de descubrimiento del escáner se centran en llms.txt, que sigue siendo la convención más extendida para el trabajo de "qué hay aquí" — y en si cruza referencias a tus otros archivos de máquina. Escanea tu sitio para ver qué dicen actualmente tus archivos raíz a un agente.