AGENTS.md

OpenAI hat AGENTS.md im August 2025 lanciert und übertrug das Format am 9. Dezember 2025 an die Agentic AI Foundation, einen von der Linux Foundation geleiteten Fund, den OpenAI zusammen mit Anthropic und Block mitgegründet hat. Zu diesem Zeitpunkt hatten bereits mehr als 60.000 Open-Source-Projekte das Format übernommen, ebenso Agenten-Frameworks wie Cursor, Devin, GitHub Copilot, Gemini CLI und VS Code. Geregelt wird eine Markdown-Datei mit projektspezifischen Anweisungen: Codekonventionen, Build-Schritte, Testanforderungen.

Jude Gao bei Vercel hat gemessen, was diese Datei bringt. Next.js-16-APIs, die in den Trainingsdaten des Modells fehlten, führten in 47% der Fälle zu fehlerhaftem Code. skills, die dasselbe Wissen verpackten, blieben in 56% der Eval-Durchläufe ungenutzt, sodass die Erfolgsquote bei der Baseline von 53% verharrte, und erreichten erst 79%, sobald Anweisungen den Trigger erzwangen. Eine statische AGENTS.md, die bei jeder Runde in den System-Prompt eingespeist wurde, erzielte 100% bei Build, Lint und Tests. Vercel komprimierte anschließend 40 KB Dokumentation zu einem 8-KB-Index mit Pipe-Trennzeichen, ohne dass dieser Wert sank, denn passiver Kontext beansprucht bei jeder Interaktion Fenster.

Addy Osmani versteht die Datei als Rationierungsproblem. Nach dem Ratchet-Prinzip muss jede Zeile auf einen konkreten vergangenen Fehler zurückzuführen sein; die Obergrenze bei HumanLayer liegt unter 60 Zeilen, eher eine Pilotencheckliste als ein Style Guide.

Bill Staples von GitLab unterscheidet die Markdown-Datei vom governance-fähigen Datensatz. Context, Identity, Policy, Provenance und organisatorisches Gedächtnis müssen über Modelle und Agenten hinweg bestehen bleiben, was aus seiner Sicht eher auf eine Control Plane verweist als auf eine Datei im Repository.