AGENTS.md löst ein sehr konkretes Problem: KI-Coding-Agents brauchen operativen Kontext – wie Abhängigkeiten installiert, der Dev-Server gestartet und Tests ausgeführt werden und welche Konventionen gelten –, doch steckt man all das in die README, wird sie für menschliche Beitragende unhandlich. AGENTS.md lagert diese Hinweise in eine eigene Datei aus, geschrieben in reinem Markdown ohne Pflichtschema, damit Agents sie zuverlässig finden und die README kurz und lesbar bleibt.
Da es nur Markdown ist, gibt es nichts zu installieren und keine proprietären Tools zu übernehmen. Man legt eine AGENTS.md im Repository-Stamm ab, listet die relevanten Abschnitte auf, und unterstützte Agents lesen sie automatisch. In großen Monorepos können zusätzliche AGENTS.md-Dateien in Unterpaketen liegen; Agents lesen die nächstgelegene Datei im Verzeichnisbaum, sodass die nächste gewinnt und jedes Paket passende Anweisungen erhält.
Das Format entstand aus der Zusammenarbeit im KI-Entwickler-Ökosystem – darunter OpenAI Codex, Amp, Googles Jules, Cursor und Factory – und wird heute von der Agentic AI Foundation unter der Linux Foundation verwaltet. Es wird von über 60.000 Open-Source-Projekten genutzt und von zahlreichen Agents unterstützt, darunter Codex, Jules, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Amp, Cursor, RooCode, Gemini CLI, Kilo Code und GitHub Copilot.