AGENTS.md

AGENTS.md ist eine Datei im Projektverzeichnis, die Coding-Agenten sagt, wie in diesem Projekt gearbeitet wird: Einrichtungsbefehle, Teststrategie, Regeln für den Code. Beschrieben wird sie als offenes Format und als Gegenstück zur README, die sich an Menschen richtet. AGENTS.md

Anweisungen für Maschinen statt Einführung für Menschen

Die Trennung ist der Kern. Eine README erklärt, worum es geht und wie man einsteigt. Die Agentendatei enthält, was ein Agent beim Arbeiten braucht und was in einer README stören würde: genaue Befehle, Konventionen, Stolperfallen, Grenzen.

Das Format ist nicht an ein Werkzeug gebunden. Verbreitete Agentenwerkzeuge lesen die Datei, teils neben einer eigenen Projektdatei. Claude Docs: Memory

So kannst du dir das vorstellen

Der Zettel an der Werkbank für die Aushilfe: Wo liegt das Werkzeug, womit wird geprüft, was darf auf keinen Fall passieren. Für Besucher gibt es die Hausführung, für die Arbeit den Zettel. Das Bild erklärt die Rollenteilung der Dokumente.

Was es in der Praxis bedeutet

Nützlich sind konkrete, prüfbare Angaben: der genaue Befehl zum Bauen, der Befehl für die Tests, Vorgaben zu Formatierung und Abhängigkeiten, Verzeichnisse, die nicht angefasst werden dürfen. Allgemeine Appelle wie „sauber arbeiten" bringen nichts.

Zweitens gilt sie als Kontext, nicht als Sperre. Was wirklich verhindert werden muss, gehört in Werkzeugrechte oder in technische Kontrollen, nicht in eine Textdatei.

Wo es verwechselt wird

Die Datei ist keine Konfiguration, die etwas erzwingt, sondern eine Anweisung, an die sich ein Agent halten soll. Und sie ersetzt keine Dokumentation für Menschen.

Verwandte Begriffe

CLAUDE.md, Agent Skills, SKILL.md, Context Engineering, Coding Agent.