## 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](https://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](/kb/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](https://shopify.dev/docs/storefronts/themes/architecture/templates/llms-txt-liquid) — **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](/kb/mcp) y tu [especificación OpenAPI](/kb/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](/kb/agents-txt) (una propuesta de política de acceso) ni con [robots.txt](/kb/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.

## Relacionado

- [llms.txt — la guía completa](/kb/llms-txt)
- [¿Funciona realmente llms.txt?](/kb/does-llms-txt-work)
- [agents.txt](/kb/agents-txt)