wesammustafa/Claude-Code-Everything-You-Need-to-Know

CLAUDE.md-Überprüfung

Überprüfen Sie eine CLAUDE.md auf die Fehlermodi, die tatsächlich die Ausgabequalität kosten.

Grundannahme: CLAUDE.md wird in jeden einzelnen Sitzungskontext geladen, daher muss jede Zeile entweder Miete zahlen oder Sie kostet sie Token bei jedem Durchlauf für immer. Die meisten Probleme, bei denen "das Modell die Anweisungen nicht befolgt", sind Anweisungsprobleme.

Schritte

1. Lesen Sie die Zieldatei (Standard: ./CLAUDE.md; überprüfen Sie auch ~/.claude/CLAUDE.md und alle verschachtelten **/CLAUDE.md, falls das Projekt welche hat, da die nächstgelegene gewinnt).
2. Bewerten Sie jede der folgenden Dimensionen und zitieren Sie die spezifischen Zeilen, die nicht bestehen.
3. Geben Sie das Berichtsformat am Ende aus. Schlagen Sie konkrete Umschreibungen vor, nicht "erwägen Sie, genauer zu sein".

Was zu überprüfen ist

Spezifität – die Dimension mit der höchsten Hebelwirkung.

• Markieren Sie nicht überprüfbare Anweisungen: "schreiben Sie sauberen Code", "befolgen Sie Best Practices", "seien Sie vorsichtig", "verwenden Sie gute Benennung".
• Jede Regel sollte durch Lesen eines Diffs überprüfbar sein. "Funktionen mit mehr als 40 Zeilen umgestalten" ist überprüfbar; "Funktionen kurz halten" ist es nicht.

Benannte Anker.

• Regeln, die sich auf "die Konfiguration", "unsere API-Ebene" oder "das übliche Muster" beziehen, erzwingen eine Neuerkennung in jeder Sitzung. Ersetzen Sie sie durch echte Pfade: src/config/env.ts, src/api/client.ts.
• Überprüfen Sie, ob jeder genannte Pfad, Befehl und Dateiname noch existiert. Melden Sie die toten – eine CLAUDE.md, die auf eine gelöschte Datei verweist, führt aktiv in die Irre.

Veralterung.

• Versionsnummern, Modellnamen und Tool-Befehle, die nicht mehr zum Repository passen.
• Anweisungen für ein Framework, Skript oder Verzeichnis, das inzwischen entfernt wurde.
• Überprüfen Sie Build-/Test-/Lint-Befehle anhand von package.json, Makefile, pyproject.toml oder Äquivalent – ein falscher Testbefehl ist schlimmer als gar keiner.

Aufblähung und Mietkosten.

• Alles, was aus dem Code selbst ableitbar ist (Dateibaumauflistungen, Abhängigkeitslisten, Wiederholung dessen, was eine Funktion tut). Claude kann das Repository lesen.
• Lange Prozeduren, die nur für eine gelegentliche Aufgabe gelten: Diese gehören in einen Skill, dessen Inhalt nur bei Verwendung geladen wird, und nicht in den Kontext bei jedem Durchlauf.
• Allgemeine Ratschläge, die auf jede Software überall zutreffen und daher nichts über dieses Projekt lehren.

Konflikte.

• Regeln, die sich widersprechen oder dem widersprechen, was der Code tatsächlich tut. Markieren Sie beide Seiten und fragen Sie, welche gewinnt.
• Überraschungen bei der Rangfolge: Eine verschachtelte CLAUDE.md oder ~/.claude/CLAUDE.md, die die Erwartungen des Autors überschreibt.

Was fehlt. Die Lücken, die es wert sind, genannt zu werden, falls sie fehlen:

• Wie man Tests ausführt, baut und lintet – die drei Dinge, die benötigt werden, um eine Änderung selbst zu überprüfen.
• Nicht offensichtliche Projektbeschränkungen (ein Verzeichnis, das nicht berührt werden darf, eine generierte Datei, ein erforderlicher Migrationsschritt).
• Konventionen, die wirklich überraschend sind und nicht durch einen kurzen Blick auf den Code sichtbar werden.

Ausgabeformat

## CLAUDE.md-Überprüfung — <Pfad> (<N> Zeilen)

**Ergebnis:** <ein Satz>

### Blockierend
- Z<n>: <zitierte Zeile> → <konkrete Umschreibung>

### Behebenswert
- Z<n>: <zitierte Zeile> → <konkrete Umschreibung>

### Löschen (kostet Kontext bei jeder Sitzung, bringt nichts)
- Z<n>–<m>: <was und warum>

### Fehlt
- <Lücke> → <vorgeschlagene Zeile zum Hinzufügen>

**Geschätzte Größe nach Bearbeitung:** <N> Zeilen (von <M>)

Regeln

• Zitieren Sie echte Zeilennummern und echten Text. Erfinden Sie niemals einen Befund, um einen Abschnitt zu füllen.
• Wenn ein Abschnitt keine Befunde hat, schreiben Sie Keine. – eine saubere Datei ist ein gültiges Ergebnis.
• Bevorzugen Sie Löschen vor Umschreiben. Die beste CLAUDE.md ist kurz genug, dass Leute sie tatsächlich lesen.
• Bearbeiten Sie die Datei nicht, es sei denn, Sie werden dazu aufgefordert. Berichten Sie zuerst.