AGENTS.md vs. llms.txt
Zwei Dateien, zwei Jobs
Beide liegen in deinem Root, beide richten sich an Agenten, und sie beantworten verschiedene Fragen:
| llms.txt | AGENTS.md | |
|---|---|---|
| Beantwortet | „Was gibt es hier?“ | „Wie sollst du dich hier verhalten?“ |
| Form | Markdown-Link-Index mit Einzeiler-Zusammenfassungen | Freies Markdown mit Anweisungen |
| Entstanden in | Dokumentations-Websites (llmstxt.org) | Code-Repositories, für Coding-Agenten |
| Gelesen von | Agenten, die sich auf einer Website orientieren | Agenten, die in einem Kontext gleich arbeiten werden |
| Analogie | Eine Sitemap für Maschinen | Ein README, adressiert an die Maschine |
llms.txt ist ein kuratierter Index: zentrale URLs mit Einzeiler-Beschreibungen, damit ein Agent deine Oberfläche mit einem Abruf kennt. AGENTS.md sind Prosa-Anweisungen: Konventionen, Dos and Don'ts, wie man Dinge ausführt — die Datei, nach der Coding-Agenten in einem Repository suchen, bevor sie es anfassen, und die sich inzwischen über Repos hinaus verbreitet.
Warum Storefronts plötzlich AGENTS.md haben
Shopify hat die Konvention im Storefront-Web zum Mainstream gemacht: Jeder Shopify-Store liefert inzwischen ein Default-/agents.md aus, und — laut Shopifys eigener Theme-Doku — verwaltet Shopify /llms.txt, indem es den Inhalt von /agents.md spiegelt, mit /llms-full.txt auf demselben Weg. Händler überschreiben jede der drei Dateien mit Liquid-Templates (templates/agents.md.liquid, templates/llms.txt.liquid, templates/llms-full.txt.liquid). Eine Anweisungsdatei, drei Türen.
Diese Designentscheidung ist aufschlussreich: Gezwungen, eine einzige Source of Truth zu wählen, hat Shopify die Anweisungs-Datei gewählt und den Index daraus generiert.
Welche solltest du ausliefern?
- Du hast Dokumentation oder eine API → zuerst llms.txt. Indexiere deine Schlüsselseiten und verweise auf deinen MCP-Endpunkt und deine OpenAPI-Spezifikation.
- Agenten führen Transaktionen aus oder agieren auf deiner Website (Checkout, Buchung, Support-Flows) → ergänze AGENTS.md mit Verhaltensanweisungen: was Agenten tun dürfen, welche Raten erwartet werden, wo die maschinenlesbaren Pfade liegen.
- Beide sind der sichere Default. Sie verweisen sauber aufeinander: llms.txt verlinkt AGENTS.md als „Verhaltensanweisungen“, AGENTS.md verlinkt llms.txt als „den Index“.
Verwechsle keine der beiden mit agents.txt (einem Access-Policy-Vorschlag) oder robots.txt (Crawl-Berechtigungen). Vier Root-Dateien, vier Jobs: Berechtigung, Policy, Index, Anweisungen.
Häufig gestellte Fragen
Ist AGENTS.md ein Standard?
Es ist eine Konvention, keine Spezifikation — es steht kein formales Gremium dahinter. Ihre Stärke ist die Verbreitung: Coding-Agenten suchen danach in Repositories, und Shopify liefert sie standardmäßig für jede Storefront aus.
Ersetzt AGENTS.md llms.txt?
Nein — sie beantworten verschiedene Fragen, und Shopifys Spiegel-Design zeigt, wie sie koexistieren: Anweisungen als Quelle, Index als Sicht darauf. Eine Website mit nur AGENTS.md verliert den Ein-Abruf-Link-Index; eine Website mit nur llms.txt gibt Agenten keine Verhaltensleitplanken.
Prüft AgentGrade AGENTS.md?
Die Discovery-Checks des Scanners drehen sich um llms.txt, das für den „Was gibt es hier“-Job die breitere Konvention bleibt — und darum, ob es auf deine anderen Maschinendateien verweist. Scanne deine Website, um zu sehen, was deine Root-Dateien einem Agenten aktuell mitteilen.