So verhindern Sie CLAUDE.md-Verfall: Behandeln Sie Regeln wie Code

Nachdem Claude Code 18 Monate lang in Produktionsprojekten eingesetzt wurde, identifizierte u/mm_cm_m_km den häufigsten Fehlerpunkt: Die CLAUDE.md-Datei verrottet. Nicht, weil Claude sie ignoriert, sondern weil Entwickler ständig Regeln hinzufügen, ohne sie jemals aufzuräumen. Das Ergebnis ist eine aufgeblähte 500-Zeilen-Datei, die bei jedem Durchlauf Tokens kostet und nicht mehr mit der tatsächlichen Codebasis synchron ist.

1. CLAUDE.md als Index, nicht als Handbuch

Halten Sie CLAUDE.md auf 30–50 Zeilen. Es sollte als Inhaltsverzeichnis dienen, das auf bestimmte Dateien für bestimmte Belange verweist – nicht als Wand all Ihrer jemals gesetzten Präferenzen. Claude liest die Datei bei jedem Durchlauf erneut; kurze Dateien sind günstig, lange Dateien verschwenden Tokens und Aufmerksamkeit.

2. Jeder Abschnitt beantwortet eine von zwei Fragen

• Welches Verhalten wünschen Sie? (die Regel) – gehört in CLAUDE.md.
• Wo finden Sie die aktuelle Wahrheit? (die Quelle) – gehört als abrufbare URL oder Dateipfad, die Claude zur Aufgabenzeit erneut lesen kann.

Das Vermischen von Regeln und Quellen führt dazu, dass Dateien unbegrenzt wachsen. Halten Sie die Regel kurz, die Quelle extern.

3. Prüfung vor dem Merge, nicht danach

Regeln treiben leise ab, wenn Sie Dinge umbenennen, Hooks umstrukturieren oder Funktionen entfernen. Die Lösung ist nicht „vorsichtiger sein“ – es ist ein CI-Schritt. Der Autor hat eine GitHub-App namens agentlint (agentlint.net) entwickelt, die bei jedem PR die Regeloberfläche prüft: Widersprüche zwischen Dateien, Verweise auf gelöschte Pfade, Regeln, die Funktionen beschreiben, die Ihre Version nicht unterstützt.

4. Mehr löschen als hinzufügen

Fast jede CLAUDE.md erhält eine neue Regel pro Woche und löscht keine. Nach sechs Monaten haben Sie ein Frankenstein. Die Disziplin: Für jede neue Regel eine zum Löschen finden. So blieb die Datei des Autors unter 100 Zeilen.

Das Kernmuster: Behandeln Sie Ihre Regeloberfläche wie Code. Code hat Tests, Reviews und Drift-Erkennung. Regeln brauchen dasselbe.