Was ist AGENTS.md?

Kurz gesagt

AGENTS.md ist eine offene, einfache Markdown-Datei im Repository, die KI-Coding-Agenten erklärt, wie sie am Projekt arbeiten sollen: wie man es baut und testet, welche Konventionen gelten und was zu vermeiden ist. Stell sie dir als README für Agenten vor, die viele verschiedene Tools lesen.

Welche Agenten sie lesen

Das Format ist auf agents.md beschrieben, wo mehr als 20 unterstützende Tools aufgeführt sind. Die Unterstützung unterscheidet sich im Detail, also wirf auch einen Blick in die Doku deines Agenten.

Codex, Cursor, der Coding-Agent von GitHub Copilot, opencode, Amp, Aider, goose, Zed, Warp, Junie und Jules lesen sie, neben anderen.
Gemini CLI liest standardmäßig GEMINI.md; trägst du AGENTS.md in die Einstellung context.fileName in settings.json ein, liest es auch diese Datei.
Claude Code liest CLAUDE.md und seit Version 2.1.277 AGENTS.md, wenn das Repository keine CLAUDE.md hat. Du kannst AGENTS.md auch mit @AGENTS.md in CLAUDE.md importieren.

AGENTS.md, CLAUDE.md und GEMINI.md

CLAUDE.md und GEMINI.md sind die toolspezifischen Dateien von Claude Code und Gemini CLI, AGENTS.md ist die gemeinsame. Alle drei enthalten dieselbe Art von Inhalt. Verbreitet ist, die gemeinsamen Regeln in AGENTS.md zu pflegen und in den Tool-Dateien darauf zu verweisen, ergänzt nur um Toolspezifisches, damit die Anweisungen nicht auseinanderlaufen. Gibt es beide, liest Claude Code standardmäßig nur CLAUDE.md; importiere AGENTS.md also dort oder ändere die Einstellung Project instructions.

Was hineingehört

Schreib auf, was ein neues Teammitglied am ersten Tag wissen müsste und was du sonst in jedem Prompt wiederholen würdest. Halte sie kurz: Agenten laden sie zu Beginn einer Sitzung in ihren Kontext.

Setup-, Build- und Testbefehle, genau so, wie sie ausgeführt werden.
Codestil und Konventionen, die der Linter nicht prüft.
Projektaufbau: wo was liegt und welche Ordner generiert werden.
Regeln für Commits und Pull Requests.
Was nie passieren darf, etwa generierte Dateien bearbeiten oder Secrets committen.

Ein kurzes Beispiel

Eine minimale AGENTS.md für ein TypeScript-Projekt könnte so aussehen. In einem Monorepo kann jedes Paket seine eigene AGENTS.md haben, und Agenten nehmen die, die der bearbeiteten Datei am nächsten liegt.

## Befehle: pnpm install; vor jedem Commit pnpm test, nach dem Verschieben von Dateien pnpm lint ausführen.
## Stil: TypeScript im Strict-Modus, einfache Anführungszeichen, keine Semikolons.
## Aufbau: App-Code in src/; der API-Client in src/gen/ wird generiert, nie von Hand bearbeiten.
## Pull Requests: Titel als „[Paket] Kurze Zusammenfassung“; Lint und Tests müssen durchlaufen.

Wo AgentVera einzuordnen ist

AgentVera startet die eigene CLI jedes Agenten im Projektordner, daher gelten AGENTS.md und die Tool-Dateien wie gewohnt; das Feld Rolle und Anweisungen eines Agenten fügt dauerhafte Anweisungen hinzu, und CLIs ohne Flag für zusätzliche Anweisungen (etwa Cursor, Gemini CLI und Amp) stützen sich stattdessen auf die AGENTS.md oder Regeldateien des Projekts.

FAQ

Ist AGENTS.md ein formaler Standard?

Es ist ein offenes Format ohne Pflichtfelder oder Schema: einfaches Markdown mit den Überschriften, die helfen. Zu Hause ist es auf agents.md.

Brauche ich CLAUDE.md und AGENTS.md?

Nicht unbedingt. Neuere Claude-Code-Versionen lesen AGENTS.md, wenn es keine CLAUDE.md gibt. Für Claude-spezifische Regeln behältst du eine kurze CLAUDE.md, die AGENTS.md mit @AGENTS.md importiert.

Wo liegt die Datei?

Im Wurzelverzeichnis des Repositorys. Große Repositorys können weitere in Unterordnern haben; die Datei, die dem bearbeiteten Code am nächsten liegt, hat Vorrang, und eine direkte Anweisung im Chat geht vor.

Wie lang sollte sie sein?

So kurz wie möglich, solange sie nützlich bleibt. Sie belegt in jeder Sitzung Kontext, und eine Regel, die in einer langen Datei untergeht, übersieht ein Agent leichter.