CLAUDE.md / AGENTS.md: Gedächtnis & Regeln für deinen Agenten

Eine CLAUDE.md-Datei ist eine Art Spickzettel, den dein Coding-Agent bei jeder Aufgabe automatisch liest.

Das Problem ohne Gedächtnis

Ein KI-Agent startet bei jeder neuen Session bei null. Er weiß nicht, welche Coding-Regeln dein Team hat, welche Befehle zum Testen genutzt werden, oder dass ihr niemals direkt auf den main-Branch pusht – außer du sagst es ihm jedes Mal neu.

Die Lösung: eine Regel-Datei

CLAUDE.md (bei manchen Tools AGENTS.md genannt) ist eine einfache Markdown-Datei im Hauptverzeichnis deines Projekts. Der Agent liest sie automatisch zu Beginn jeder Session und behandelt ihren Inhalt als feste Anweisung – wie ein Gedächtnis, das über einzelne Chats hinweg besteht.

Was gehört rein?

Projekt-Kontext ("Dies ist ein React-Frontend mit Express-Backend")
Befehle ("Tests laufen mit npm test")
Regeln ("Nie direkt auf main pushen", "Immer Tests vor Commit ausführen")
Code-Style-Vorgaben
Bekannte Stolperfallen im Projekt

Warum das wirkt

Ohne diese Datei musst du bei jeder neuen Session dieselben Regeln wiederholen. Mit ihr sind die Grundregeln immer präsent – der Agent verhält sich konsistenter und macht weniger vermeidbare Fehler.