Künstlich erzeugtAGENTS.md: die Datei, die der Agent vor dem Code liest
README bleibt für Menschen. Daneben liegt seit August 2025 eine zweite Datei, und seit dem 9. Dezember 2025 gehört sie der Agentic AI Foundation.
AGENTS.md ist eine gewöhnliche Markdown-Datei in der Wurzel eines Repositories. Darin steht, wie dieses Projekt gebaut, getestet und angefasst wird. OpenAI hat sie im August 2025 mit Codex veröffentlicht. Am 9. Dezember 2025 lag sie nach Angabe von OpenAI und der Linux Foundation in mehr als 60.000 Open-Source-Projekten, und OpenAI hat sie an die Agentic AI Foundation gegeben.
Keine Pflichtfelder. Der nächste Agent liest den Text, den du hinlegst.
Eine README erklärt Menschen den Start, den Zweck, wie man mitarbeitet. AGENTS.md ist die Ergänzung für den Fall, dass der nächste Mitarbeiter kein Mensch ist: Build, Tests, Konventionen, die eine README zumüllen würden. Die Seite agents.md sagt, man habe den Namen und das Format absichtlich so gewählt, dass jedes Werkzeug sie nehmen kann. Pflichtfelder gibt es nicht. Überschriften sind frei. Der Agent parst den Text.
Was Teams hineinlegen, wiederholt die Seite als die übliche Liste: Überblick, Build und Tests, Stil, Sicherheit, dazu Commit-Regeln, Fallstricke, große Daten, Deploy. Alles, was du einer neuen Kollegin am ersten Tag sagen würdest. Listest du Testbefehle, versucht der Agent, sie auszuführen und Fehler zu beheben, bevor er die Aufgabe für fertig hält. Eine spätere Änderung der Datei ist vorgesehen. Lebendige Dokumentation, kein Vertrag mit Versionsnummer.
Codex brauchte einen festen Ort. Die anderen Werkzeuge hatten dasselbe Loch.
OpenAI beschreibt den Anfang am 9. Dezember 2025 als ein praktisches Loch in Codex. Der Agent brauchte einen vorhersehbaren Platz für Projektspezifisches: Konventionen, Build, Tests, damit er in einer fremden Codebase arbeitet, ohne jedes Mal neu zu raten. Die Datei sollte neben README.md liegen. Was als interne Lösung begann, sei im Ökosystem hängen geblieben.
Die Seite agents.md nennt die Runde, aus der das Format kam: OpenAI Codex, Amp, Jules von Google, Cursor und Factory. Die Linux Foundation datiert die Veröffentlichung auf August 2025 und listet als Adoptierende Amp, Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules und VS Code. Dieselbe Liste steht bei OpenAI, mit der Zahl: mehr als 60.000 Open-Source-Projekte seit der Veröffentlichung bis zum 9. Dezember 2025.
Nick Cooper übergibt eine Datei, kein Protokoll.
Nick Cooper, Member of the Technical Staff bei OpenAI, steht in der Pressemitteilung der Linux Foundation für die Übergabe. Sein Satz: gemeinsame, von der Community getriebene Protokolle seien nötig für ein gesundes Agenten-Ökosystem, deshalb habe OpenAI Codex CLI, das Agents SDK und nun AGENTS.md offengelegt. Die Datei ist der dritte Gründungsbeitrag der Agentic AI Foundation, neben MCP von Anthropic und goose von Block. Ein Protokoll ist sie nicht. MCP ist ein Draht zu Werkzeugen. A2A ist ein Draht zwischen Agenten. AGENTS.md ist eine Leseregel für ein Repository.
Der Fonds hält sie, damit keine einzelne Firma die Richtung behält, während die Adoption wächst. Die Seite agents.md sagt denselben Satz in der Gegenwart: Steward ist die Agentic AI Foundation unter der Linux Foundation. Pflege und Weiterentwicklung bleiben als offenes Format zugesagt, unabhängig davon, welchen Coding-Agenten du benutzt.
Die nähere Datei schlägt die weiter oben. Dein Satz im Chat schlägt beide.
In einem großen Repo liegt nicht eine Datei, sondern eine je Paket. Der Agent liest die nächste AGENTS.md auf dem Weg von der Datei, die er anfasst, zur Wurzel. Die nähere gewinnt. Ein ausdrücklicher Satz von dir im Chat gewinnt gegen beide. Die Seite nennt als Beispiel das damalige Haupt-Repository von OpenAI: 88 solcher Dateien, zum Zeitpunkt des Texts. Eine alte AGENT.md wird per Umbenennung und Symlink mitgenommen, damit bisherige Werkzeuge nicht ins Leere laufen.
Abb. 01 · Drei Ebenen, eine Regel. Gelb ist die Datei, die für eine Änderung in src zählt. Ein Satz im Chat steht darüber und ist hier nicht gezeichnet.
Bei McGrinsey liegt so eine Datei in der Wurzel des Projektordners. Dieselbe Sorte Text: was der nächste Agent wissen muss, bevor er anfängt. Der Unterschied zur Stiftung ist keiner der Form. Der Unterschied ist, wer die Richtung hält, wenn tausende Repos dieselbe Konvention benutzen. Dafür ist der Fonds da, nicht für den Inhalt deiner Datei.
Datei, Datum, Zahl.
| Aussage | Korb | Woher |
|---|---|---|
| AGENTS.md ist Markdown ohne Pflichtfelder. README bleibt für Menschen. Die nähere Datei gewinnt, der Chat gewinnt gegen die Datei. | Fakt | agents.md, FAQ und Erklärung. |
| Entstanden aus Codex, Amp, Jules, Cursor und Factory. Veröffentlichung August 2025. | Fakt | agents.md (die Runde). Linux Foundation und OpenAI (der Monat). |
| Mehr als 60.000 Open-Source-Projekte bis zum 9. Dezember 2025. Werkzeuge: Amp, Codex, Cursor, Devin, Factory, Gemini CLI, GitHub Copilot, Jules, VS Code. | Fakt, Stand der Übergabe | OpenAI und Linux Foundation, 9. Dezember 2025. |
| OpenAI übergibt die Datei an die AAIF. Nick Cooper zeichnet das Zitat. | Fakt | Pressemitteilung der Linux Foundation, 9. Dezember 2025. |
| 88 AGENTS.md-Dateien im OpenAI-Haupt-Repository. | Fakt, zum Zeitpunkt der Seite | agents.md, zum Zeitpunkt ihres Texts. |
| Steward ist die Agentic AI Foundation unter der Linux Foundation. | Fakt | agents.md, Abschnitt About. |
- agents.mdForm, FAQ, die fünf genannten Werkzeuge am Ursprung, 88 Dateien, der Steward.https://agents.md/
- OpenAI, die Mitgründung9. Dezember 2025. Codex als Anlass, August 2025, 60.000 Projekte.https://openai.com/index/agentic-ai-foundation/
- Linux Foundation9. Dezember 2025. Nick Cooper, dieselbe Zahl, dieselbe Werkzeugliste.https://www.linuxfoundation.org/press/linux-foundation-announces-the-formation-of-the-agentic-ai-foundation
- Die NachbarstückeA2A als Sprache zwischen Agenten. MCP und das Dach der Foundation.https://mcgrinsey.com/magazin/a2a-protocol/
Schnitt: 30. September 2026.
