Anweisungsdatei für Agenten (AGENTS.md)
Eine Anweisungsdatei für Agenten ist eine Markdown-Datei in einem Code-Repository, etwa AGENTS.md oder CLAUDE.md, die ein Coding-Agent zu Beginn einer Sitzung liest, um Befehle, Konventionen und Regeln des Projekts zu lernen.
Auch: AGENTS.md, CLAUDE.md, .cursorrules, rules file
Von Divya Sharma · Geprüft am 15. Nov. 2026 · So testen wir
Ein Coding-Agent beginnt jede Sitzung, ohne etwas über dein Projekt zu wissen. Ohne Hilfe rät er, wie die Tests laufen, welchem Stil er folgen soll und welche Ordner er in Ruhe lassen soll. Eine Anweisungsdatei beantwortet diese Fragen einmal, an einem Ort, den der Agent immer liest.
Die gängigen Formate
AGENTS.md ist ein offenes Format, das werkzeugübergreifend funktionieren soll, und wird von OpenAI Codex und vielen anderen gelesen. Claude Code liest CLAUDE.md und kann auch AGENTS.md nutzen. Cursor hat eigene Regeldateien, darunter das ältere .cursorrules. Der Inhalt ist überall ähnlich: Build- und Testbefehle, Codestil, Hinweise zur Architektur und Dinge, die zu unterlassen sind.
So funktioniert es
Der Agent lädt die Datei zu Beginn einer Sitzung in seinen Kontext, sie wirkt also wie ein System-Prompt auf Projektebene. Dateien lassen sich verschachteln: Ein Monorepo kann eine im Wurzelverzeichnis und eine weitere in jedem Paket haben. Laut AGENTS.md-Vorgabe gilt die Datei, die dem bearbeiteten Code am nächsten liegt, während im Chat getippte Anweisungen alle übersteuern. Eine persönliche Datei in deinem Home-Ordner kann Regeln enthalten, die für jedes Projekt gelten.
Grenzen
Die Datei ist Kontext, keine Durchsetzung. Der Agent folgt ihr meist, kann sie aber ignorieren oder vergessen, besonders nach einer Kontextverdichtung. Regeln, die immer gelten müssen, etwa nie eine Produktionskonfiguration anzufassen, gehören in Agent-Hooks oder Berechtigungseinstellungen. Halte die Datei kurz und konkret; lange Dateien kosten in jeder Sitzung Tokens und verwässern die Regeln, auf die es ankommt. Wiederverwendbare Abläufe passen besser in Agent Skills.
Verwandte Begriffe
- Coding-Agent
- Ein Coding-Agent ist ein KI-Agent, der direkt an Software arbeitet: Er liest eine Codebasis, bearbeitet Dateien, führt Befehle und Tests aus und wiederholt das, bis eine Änderung funktioniert, statt nur Code vorzuschlagen, den ein Mensch einfügt.
- Context Engineering
- Context Engineering (Kontextgestaltung) ist die Praxis, alles auszuwählen und zu pflegen, was während einer Aufgabe in das Kontextfenster eines Sprachmodells gelangt: Anweisungen, abgerufene Dokumente, Tool-Definitionen, Tool-Ergebnisse und Gesprächsverlauf.
- Agent Skills
- Agent Skills (Agenten-Fähigkeiten) sind Ordner mit Anweisungen, Skripten und Referenzdateien, jeweils beschrieben durch eine SKILL.md-Datei, die ein KI-Agent entdecken und erst dann laden kann, wenn eine Aufgabe sie braucht.
- Agent-Hooks
- Agent-Hooks sind benutzerdefinierte Befehle oder Skripte, die ein Coding-Agent an festgelegten Punkten seiner Arbeit automatisch ausführt, etwa vor einem Tool-Aufruf oder nach einer Dateiänderung, um sein Handeln zu prüfen, zu blockieren oder zu erweitern.
- System-Prompt
- Ein System-Prompt ist der Block von Anweisungen, den eine Anwendung vor den Nachrichten des Nutzers an ein Sprachmodell schickt. Er legt Rolle, Regeln, Ton und Ausgabeformat des Modells für die ganze Unterhaltung fest.
- Slash-Befehl
- Ein Slash-Befehl (Slash Command) ist eine Anweisung, die mit einem vorangestellten Schrägstrich eingegeben wird, etwa /compact oder /review, und einem KI-Tool sagt, eine eingebaute Aktion oder einen gespeicherten Prompt auszuführen, statt den Text als normale Nachricht zu behandeln.