Zum Inhalt springen

Wissensbasis

Agent-Instruktionen (CLAUDE.md, AGENTS.md)

Aktualisiert:

Agent-Instruktionen sind die Markdown-Dateien, die ein Coding-Agent zu Beginn jeder Sitzung aus dem Repository lädt. Sie liegen im Root, manchmal auch in Unterordnern. Darin steht, was der Agent sonst raten müsste:

  • wie man baut und testet,
  • welche Konventionen gelten,
  • welche Befehle tabu sind.

Claude Code liest CLAUDE.md. AGENTS.md ist ein offenes Format, das viele Coding-Agenten lesen. Seit Version 2.1.277 liest Claude Code es auch, sofern ein Projekt keine CLAUDE.md hat.

Was gehört in die Datei?

Nur was für jede Aufgabe gilt, denn die Datei steht in jeder Sitzung im Kontextfenster. Eine lange Instruktionsdatei kostet bei jedem Lauf Kontext. Außerdem verwässert sie die Regeln, auf die es ankommt. Wissen für einzelne Aufgaben gehört in einen Skill oder einen Priming-Befehl, der dieses Wissen bei Bedarf lädt. Mehr dazu unter Context Engineering.

Wer verantwortet sie?

Die Instruktionen sind eine Entscheidung des Teams, also brauchen sie einen Owner und eine Datei. Arbeitet jede:r Entwickler:in mit einem anderen Agenten, entsteht oft eine Datei pro Tool. Jede Datei pflegen die Entwickler:innen, die das jeweilige Tool nutzen. Die Dateien laufen auseinander, und zwei Agenten bauen dasselbe Feature auf zwei Arten. Führt sie zu einer AGENTS.md zusammen und benennt ihren Owner. Schickt Änderungen durch dasselbe Review und dieselben Checks wie Code.

Verwandte Seiten

Quellen

Dokumentation

Schulung zum Thema: Agentic Engineering for Developers and QA