Lass uns CLAUDE.md mit dem offiziellen claude-md-management-Plugin von Anthropic pflegen.

Wann haben Sie das letzte Mal einen Blick in Ihre CLAUDE.md geworfen? Die Build-Befehle des Projekts haben sich geändert, die Art und Weise, wie Tests ausgeführt werden, ist neu, oder die Verzeichnisstruktur wurde aufgeräumt. Konnten Sie diese Änderungen jedes Mal konsequent nachpflegen? Ehrlich gesagt, neigt man dazu, das zu vernachlässigen. Und ehe man es merkt, tritt das typische Problem auf: Claude Code verlässt sich auf veraltete Informationen und fängt an, Dinge zu tun, die völlig am Ziel vorbeigehen.

Genau dieses Problem adressiert das offizielle claude-md-management Plugin von Anthropic. Es handelt sich um ein Plugin, das von Anthropic selbst – den Machern von Claude Code – entwickelt und gewartet wird. Es kombiniert einen Skill, der die Qualität Ihrer CLAUDE.md bewertet, mit einem Befehl, um während einer Sitzung gewonnene Erkenntnisse direkt in die CLAUDE.md zu übernehmen. Man könnte es als eine Art „Aufräumhilfe für die CLAUDE.md“ bezeichnen.

In diesem Artikel stelle ich Ihnen den Inhalt dieses Plugins, die Installation, die praktische Anwendung sowie Best Practices für die Pflege Ihrer CLAUDE.md vor.

Warum die Aktualität der CLAUDE.md so wichtig ist

Die CLAUDE.md ist die „Bedienungsanleitung des Projekts“, die Claude Code bei jeder Sitzung einliest. Wenn Sie hier Informationen wie Build-Befehle, Architekturdetails oder häufige Stolperfallen hinterlegen, die allein aus dem Code schwer ersichtlich sind, kann Claude die Arbeit mit einem grundlegenden Verständnis für den „Vibe“ des Projekts beginnen.

Dies hat jedoch auch eine Kehrseite. Da der Inhalt der CLAUDE.md bei jeder Anfrage als Teil des Prompts gesendet wird, führen veraltete oder redundante Informationen dazu, dass Claude in die Irre geführt wird oder unnötig Token verbraucht. Es ist ein bekanntes Phänomen, dass der eigentliche Code durch Refactoring ständig verbessert wird, während die CLAUDE.md auf dem Stand von vor mehreren Monaten stehen bleibt.

claude-md-management ist ein Plugin, das dieses Problem der „einmal geschriebenen und dann vergessenen Dokumentation“ systematisch löst.

Zwei Werkzeuge: Inventur und Mitschrift

Dieses Plugin enthält zwei Werkzeuge mit unterschiedlichen Rollen. Da man sie leicht verwechseln kann, lassen Sie uns diese zunächst ordnen.

claude-md-improver ist ein Skill, der die gesamte Codebase scannt und prüft: „Spiegelt diese CLAUDE.md wirklich den aktuellen Code wider?“ Es ist wie ein regelmäßiger Gesundheitscheck.

/revise-claude-md hingegen ist eher für den Alltag gedacht. Es ist ein Befehl, um Befehle oder Problemlösungen, die man während der heutigen Sitzung entdeckt hat, sofort in die CLAUDE.md zu übertragen. Man könnte es als „Protokollanten“ bezeichnen.

In beiden Fällen bittet das Tool um die Zustimmung des Benutzers, bevor Änderungen tatsächlich angewendet werden. Sie müssen also keine Angst haben, dass Ihre CLAUDE.md ungefragt überschrieben wird.

Installation

Da der claude-plugins-official Marketplace beim Start von Claude Code automatisch aktiviert ist, ist keine zusätzliche Vorbereitung erforderlich. Sie können das Plugin einfach durch Ausführen des folgenden Befehls innerhalb von Claude Code installieren:

/plugin install claude-md-management@claude-plugins-official

Wenn Sie lieber durch die verfügbaren Plugins stöbern möchten, geben Sie /plugin ein und öffnen Sie den Tab Discover. Dort können Sie im Katalog suchen und installieren.

Vergessen Sie nicht, nach der Installation /reload-plugins auszuführen. Dadurch werden die Skills und Befehle in der aktuellen Sitzung verfügbar.

Nutzung 1: Inventur mit claude-md-improver

Da claude-md-improver ein Skill ist, müssen Sie sich keinen speziellen Slash-Befehl merken. Es reicht aus, Claude in natürlicher Sprache darum zu bitten.

Auditieren Sie die CLAUDE.md
check if my CLAUDE.md is up to date

Ein solcher Satz genügt. Sobald der Skill aktiv wird, läuft folgender Workflow ab:

1. Suche nach allen CLAUDE.md und CLAUDE.local.md im Repository.
2. Bewertung jeder Datei anhand von sechs Kriterien mit Noten von A bis F.
3. Präsentation eines Berichts mit konkreten Verbesserungsvorschlägen.
4. Anwendung der Änderungen nach Einholung der Zustimmung.

Übrigens: Wenn ich /claude-md tippe, wird claude-md-improver als Vorschlag angezeigt. Ich drücke dann die Tab-Taste, was den Befehl zu /claude-md-management:claude-md-improver vervollständigt, und führe diesen aus.

Die sechs Bewertungskriterien

Die Bewertung basiert auf einer fundierten Rubrik. Insgesamt können 100 Punkte erreicht werden.

Interessant ist, dass Conciseness (Prägnanz) explizit bewertet wird. „Einfach alles aufschreiben“ führt also zu Punktabzug. Da die CLAUDE.md bei jeder Anfrage geladen wird, ist mehr Inhalt nicht automatisch besser.

Das Ergebnis wird in fünf Stufen von A (90–100) bis F (0–29) angezeigt. Wenn ich diesen Skill ausführe, erhalte ich überraschend oft ein B oder C. Das führt mir vor Augen, wie qualitativ minderwertig meine CLAUDE.md oft war, und lässt mich den Wert dieses Plugins erst recht schätzen.

Nutzung 2: Erkenntnisse mit /revise-claude-md übernehmen

Haben Sie nach einer Coding-Session schon einmal gedacht: „Diesen Befehl kannte ich heute noch nicht“ oder „Diese Verzeichnisstruktur ist auf den ersten Blick schwer zu verstehen“? Der Befehl /revise-claude-md dient dazu, genau dieses Gefühl für die nächste Sitzung an Claude zu vererben.

/claude-md-management:revise-claude-md

Plugin-Skills werden immer mit ihrem Namespace aufgerufen. Wenn Sie /claude-md-management: tippen, funktioniert die Tab-Vervollständigung, was die Eingabe erleichtert.

Wenn Sie diesen Befehl ausführen, lässt Claude die aktuelle Sitzung Revue passieren und sucht nach Dingen, die ergänzt werden sollten, wie zum Beispiel:

• Verwendete oder entdeckte Bash-Befehle
• Befolgte Code-Style-Muster
• Erfolgreiche Testmethoden
• Eigenheiten der Umgebung oder Konfiguration
• Aufgetretene Stolperfallen oder Warnungen

Darüber hinaus entscheidet das Tool, in welche CLAUDE.md die Information gehört: In die CLAUDE.md für das Team-Sharing oder in die CLAUDE.local.md für den persönlichen Gebrauch.

Die Vorschläge werden im Diff-Format angezeigt, und die Dateien werden erst nach Ihrer Zustimmung geändert. Wenn Sie finden, dass ein Vorschlag zu redundant ist, können Sie ihn einfach ablehnen.

Die vier Orte für eine CLAUDE.md

Bei der Nutzung dieses Plugins wird deutlich, dass es verschiedene Arten von CLAUDE.md-Dateien gibt. Hier eine Übersicht:

Claude Code findet automatisch auch CLAUDE.md-Dateien in übergeordneten Verzeichnissen und kombiniert diese. Daher funktioniert es auch in Monorepos problemlos, wenn Sie pro Paket eine eigene CLAUDE.md ablegen. Dieses Plugin auditiert jede dieser Dateien individuell.

Best Practices: Wie man sie pflegt

An dieser Stelle möchte ich einige Essenzen für „gute CLAUDE.md-Inhalte“ vorstellen, die sich aus den update-guidelines.md dieses Plugins ableiten lassen.

Was hineingehört

• Entdeckte Befehle: Befehle wie npm run build:prod, die man mühsam herausgesucht hat, für das nächste Mal festhalten.
• Nicht-offensichtliche Muster: Einschränkungen, die man nicht allein durch Lesen des Codes versteht (z. B. „Tests müssen mit --runInBand seriell ausgeführt werden“).
• Beziehungen zwischen Paketen: Abhängigkeiten wie „Das auth-Modul muss nach der Initialisierung von crypto importiert werden“.
• Bewährte Testmethoden: Etablierte Muster wie „Verwenden Sie supertest für API-Tests“.
• Konfigurationseigenheiten: Umgebungspezifische Details wie „Für die Redis-Verbindung muss ?family=0 angehängt werden“.

Was nicht hineingehört

• Dinge, die aus dem Code ersichtlich sind: Offensichtliche Erklärungen wie „Der UserService verarbeitet Benutzeroperationen“.
• Allgemeinplätze: „Schreiben Sie ordentliche Tests“ ist keine projektspezifische Information.
• Einmalige Fixes: „Ein Bug, der in Commit abc123 behoben wurde“ tritt nicht wieder auf und ist daher unnötiger Ballast.
• Redundante Erklärungen: Statt JWT anhand von RFCs zu erklären, reicht eine Zeile: „Auth: JWT HS256, Authorization: Bearer <token>“.

Es ist wichtig, sich bewusst zu machen, dass die CLAUDE.md Teil des Prompts ist. Da das Kontextfenster wertvoll ist, sollte jede Zeile ihren „Platz an Bord“ rechtfertigen.

Wann welches Tool nutzen?

Zum Abschluss noch einmal die Unterscheidung der beiden Werkzeuge:

• Nach großem Refactoring oder Umstrukturierung → claude-md-improver für eine vollständige Inventur.
• Direkt nach Einführung neuer Tools oder Einstellungen → claude-md-improver, um vergessene Aktualisierungen zu finden.
• Wenn man während einer Sitzung denkt: „Ah, das wusste ich noch nicht“ → /revise-claude-md, um es sofort festzuhalten.

Empfehlenswert ist eine Kombination aus regelmäßigen Gesundheitschecks (improver) und täglichen kleinen Notizen (revise).

Fazit

claude-md-management ist ein Plugin, das die Idee verkörpert, dass eine CLAUDE.md nicht einmal geschrieben, sondern kontinuierlich gepflegt werden sollte. Da es offiziell von Anthropic stammt, harmoniert es hervorragend mit Claude Code, und die Hürde für die Einführung ist minimal.

Auch ich stelle bei der Nutzung immer wieder fest, dass meine CLAUDE.md schneller veraltet war, als ich dachte. Wenn Sie Claude Code täglich nutzen, probieren Sie die Installation unbedingt aus. Allein das Audit Ihrer CLAUDE.md kann die Sichtweise auf Ihr eigenes Projekt ein wenig verändern.

Weiterführende Links

• CLAUDE.md Management (Claude Plugins Katalog)
• claude-plugins-official Repository
• Discover and install plugins (Offizielle Dokumentation)