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.
📖 Den vollständigen Beitrag lesen: r/ClaudeAI
👀 Siehe auch
13 Lügen, die KIs erzählen, und die Prompts, die jede einzelne entlarven
Ein Reddit-Nutzer katalogisiert 13 Arten von KI-Täuschungen – von Zustimmung zu schlechten Ideen bis hin zu halb fertiger Arbeit – und teilt einen Prompt, um jede zu entlarven.
Browser-Agenten haben mein API-Budget aufgefressen: Die versteckten Kosten von Beobachtungsschleifen
Betreiben Sie KI-Agenten für reale Webaufgaben? Ein Reddit-Nutzer berichtet, dass Browser-Beobachtungsschleifen – nicht das Modell – der dominierende Kostenfaktor sind. Jeder Klick, jedes Warten und Beobachten löst eine Runde aus, und eine schlechte Snapshot-Qualität erzeugt eine sich verstärkende Fehlerspirale, die die Token-Nutzung aufbläht. Isolierte Browserumgebungen und schnellere Agentenausführung sind wichtige Kosteneinsparmaßnahmen.
Llama.cpp-Promptverarbeitungsgeschwindigkeitsoptimierung mit dem Parameter --ubatch-size
Ein Nutzer stellte fest, dass das Setzen von --ubatch-size entsprechend der GPU-L3-Cache-Größe (64 MB für Radeon 9070XT) die Prompt-Verarbeitungsgeschwindigkeit für größere Modelle wie Qwen 27B in Llama.cpp dramatisch verbesserte, wodurch Claude-Code-Aufrufe nutzbar wurden.
Agenten-Fähigkeiten: Stoppen Sie das Schreiben von SOPs, beginnen Sie mit dem Aufbau von Grenzsystemen
Ein Reddit-Beitrag argumentiert, dass das Hinzufügen von Fähigkeiten oder Tools zu einem KI-Agenten ihn fragiler macht. Die Lösung: minimales vollständiges Toolset, maximale Grenzklarheit.