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

Wann haben Sie CLAUDE.md zuletzt überarbeitet? Der Build-Befehl des Projekts hat sich geändert, die Art, Tests auszuführen, hat sich geändert, die Verzeichnisstruktur wurde neu organisiert. Konnten Sie bei all diesen Änderungen wirklich immer Schritt halten? Ehrlich gesagt neige ich dazu, das zu vernachlässigen. Und wenn ich es dann bemerke, tritt das klassische Problem auf: Claude Code verlässt sich auf veraltete Informationen und fängt an, völlig falsche Dinge zu tun.

Genau auf dieses Problem gibt das offizielle Anthropic-Plugin claude-md-management eine direkte Antwort. Es ist ein Plugin, das von Anthropic selbst - den Entwicklern von Claude Code - entwickelt und gepflegt wird. Es kombiniert eine Skill-Funktion, die die Qualität Ihrer CLAUDE.md bewertet, mit einem Befehl, der während einer Sitzung gewonnene Erkenntnisse in die CLAUDE.md einfließen lässt. Kurz gesagt ist es ein Plugin, das als „Aufräumhelfer für CLAUDE.md" fungiert.

In diesem Artikel stelle ich Ihnen den Inhalt dieses Plugins, die Installationsmethode, die praktische Verwendung sowie Best Practices zur Pflege Ihrer CLAUDE.md umfassend vor.

Warum die Aktualität von CLAUDE.md wichtig ist

CLAUDE.md ist das „Projekthandbuch", das Claude Code bei jeder Sitzung einliest. Wenn Sie dort Build-Befehle, Architektur, häufige Fallstricke und andere Informationen festhalten, die sich nicht allein aus dem Code erschließen, kann Claude von Anfang an mit einem Verständnis für die „Atmosphäre" des Projekts arbeiten.

Allerdings hat das auch eine Nebenwirkung. Da der Inhalt von CLAUDE.md bei jeder Sitzung als Teil des Prompts übermittelt wird, können veraltete oder redundante Informationen Claude in die Irre führen oder Token verschwenden. Es ist eine häufige Situation, dass der eigentliche Code durch Refactoring kontinuierlich verfeinert wird, während CLAUDE.md im Zustand von vor einigen Monaten stecken bleibt.

claude-md-management ist ein Plugin, das dieses „einmal geschrieben, nie wieder angefasst"-Problem durch einen systematischen Ansatz löst.

Zwei Werkzeuge: Bestandsaufnahme und Aufzeichnung

Dieses Plugin enthält zwei Werkzeuge mit unterschiedlichen Aufgaben. Da sie leicht verwechselt werden können, klären wir das zunächst.

claude-md-improver ist ein Skill, der den gesamten Codebase überblickt und prüft: „Spiegelt diese CLAUDE.md wirklich den aktuellen Code wider?" - eine Art regelmäßiger Gesundheitscheck.

/revise-claude-md hingegen ist alltäglicher: Es ist ein Befehl, um „während der heutigen Sitzung entdeckte Befehle oder Stolpersteine" direkt in die CLAUDE.md einzutragen. Man könnte es als „Aufzeichnungshelfer" bezeichnen.

Beide fordern vor der endgültigen Anwendung von Änderungen eine Bestätigung durch den Benutzer an, sodass keine Sorge besteht, dass CLAUDE.md ohne Ihr Wissen überschrieben wird.

Installation

Der claude-plugins-official-Marktplatz ist automatisch aktiv, sobald Sie Claude Code starten, sodass keine zusätzliche Vorbereitung erforderlich ist. Sie können das Plugin direkt in Claude Code mit folgendem Befehl installieren:

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

Wenn Sie lieber stöbern und aus einem Katalog auswählen möchten, geben Sie /plugin ein und öffnen Sie den Tab Discover, um Plugins zu suchen und zu installieren.

Vergessen Sie nach der Installation nicht, /reload-plugins auszuführen. Damit werden der Skill und der Befehl in der aktuellen Sitzung verfügbar.

Verwendung 1: Bestandsaufnahme mit claude-md-improver

Da claude-md-improver ein Skill ist, müssen Sie keinen festen Slash-Befehl auswendig lernen. Es genügt, Claude in natürlicher Sprache darum zu bitten.

CLAUDE.md を監査してください
check if my CLAUDE.md is up to date

Ein solcher einfacher Satz reicht aus. Wenn der Skill aktiviert wird, läuft folgender Workflow ab:

1. Alle CLAUDE.md- und CLAUDE.local.md-Dateien im Repository werden gesucht
2. Jede wird nach sechs Kriterien bewertet und erhält eine Note von A bis F
3. Ein Bericht wird präsentiert und konkrete Verbesserungsvorschläge werden aufgelistet
4. Nach Ihrer Bestätigung werden die Änderungen tatsächlich angewendet

Übrigens: Wenn ich /claude-md eingebe, erscheint claude-md-improver als Vorschlag, und wenn ich dann Tab drücke, wird daraus /claude-md-management:claude-md-improver, das ich dann ausführe.

Die sechs Bewertungskriterien

Die Bewertung basiert auf einem klar definierten Rubrik-System. Die Gesamtpunktzahl beträgt 100.

Interessant ist, dass Conciseness (Prägnanz) tatsächlich Punkte einbringt. „Schreib einfach alles rein" führt also zu Punktabzug. Da CLAUDE.md bei jeder Sitzung als Teil des Prompts eingelesen wird, ist mehr Volumen nicht unbedingt besser.

Die Bewertungsergebnisse werden in fünf Stufen von A (90-100) bis F (0-29) angezeigt. Auch wenn ich diesen Skill aktiviere, erhalte ich überraschend oft B oder C, was mir schmerzhaft bewusst macht, wie schlecht die Qualität meiner CLAUDE.md war - und gleichzeitig, wie wertvoll dieses Plugin ist.

Verwendung 2: Erkenntnisse mit /revise-claude-md einarbeiten

Haben Sie nach einer Coding-Sitzung schon einmal gedacht: „Diesen Befehl kannte ich heute nicht" oder „Diese Verzeichnisstruktur ist auf den ersten Blick schwer zu verstehen"? Der Befehl /revise-claude-md ist dafür gedacht, dieses Wissen für Claude in der nächsten Sitzung festzuhalten.

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

Alle Plugin-Skills werden mit Namespace aufgerufen. Wenn Sie /claude-md-management: eingeben, funktioniert auch die Tab-Vervollständigung, was es überraschend komfortabel macht.

Wenn Sie diesen Befehl ausführen, blickt Claude auf die aktuelle Sitzung zurück und sucht nach folgenden Aspekten, die dokumentiert werden sollten:

• Verwendete oder entdeckte Bash-Befehle
• Befolgte Code-Style-Muster
• Bewährte Testmethoden
• Eigenheiten der Umgebung oder Konfiguration
• Aufgetretene Fallstricke und Warnungen

Darüber hinaus entscheidet der Befehl, in welche CLAUDE.md die Information gehört: für das Team in CLAUDE.md, für den persönlichen Gebrauch in CLAUDE.md.local.

Vorschläge werden im Diff-Format angezeigt, und die tatsächliche Datei wird erst nach Ihrer Bestätigung geändert. Was Ihnen zu redundant erscheint, können Sie ablehnen, sodass keine Gefahr besteht, zu viel einzuarbeiten.

CLAUDE.md hat vier Speicherorte

Wenn Sie dieses Plugin verwenden, werden Sie feststellen, dass es verschiedene Arten von CLAUDE.md gibt. Lassen Sie uns das klarstellen.

Claude Code liest automatisch auch CLAUDE.md-Dateien aus übergeordneten Verzeichnissen ein und kombiniert sie, sodass es kein Problem ist, in einem Monorepo (einer Konfiguration, bei der mehrere Pakete in einem Repository zusammengefasst sind) pro Paket eine CLAUDE.md zu pflegen. Dieses Plugin prüft jede CLAUDE.md einzeln.

Best Practices: Wie man CLAUDE.md pflegt

Abschließend möchte ich auch die Essenz der „guten CLAUDE.md-Schreibweise" vorstellen, die sich aus der update-guidelines.md dieses Plugins ablesen lässt.

Was hineingehört

• Entdeckte Befehle: Befehle wie npm run build:prod, die Sie erst nachschlagen mussten, sollten für das nächste Mal festgehalten werden
• Nicht offensichtliche Muster: Einschränkungen wie „Tests müssen mit --runInBand sequenziell ausgeführt werden", die sich nicht allein aus dem Code erschließen
• Paketabhängigkeiten: Abhängigkeiten wie „Das auth-Modul muss nach der Initialisierung von crypto importiert werden"
• Bewährte Testmethoden: Etablierte Muster wie „Für API-Tests wird supertest verwendet"
• Konfigurationseigenheiten: Umgebungsspezifische Details wie „Redis-Verbindungen benötigen ?family=0"

Was nicht hineingehört

• Was sich aus dem Code ergibt: Selbstverständliche Erklärungen wie „UserService verwaltet Benutzeroperationen", die sich aus dem Klassennamen erschließen
• Allgemeine Ratschläge: „Schreiben Sie ordentliche Tests" ist keine projektspezifische Information und daher überflüssig
• Einmalige Korrekturen: „Der in Commit abc123 behobene Bug" wird sich nicht wiederholen und ist daher nutzlos zu dokumentieren
• Redundante Erklärungen: Anstatt JWT von Grund auf zu erklären, reicht eine Zeile wie „Auth: JWT HS256, Authorization: Bearer <token>"

Es ist wichtig, sich bewusst zu machen: „CLAUDE.md ist Teil des Prompts." Da das Kontextfenster wertvoll ist, sollte jede einzelne Zeile ihren Platz verdienen.

Wann welches Werkzeug einsetzen

Abschließend noch einmal eine Zusammenfassung, wann welches Werkzeug einzusetzen ist:

• Nach einem größeren Refactoring oder einer Verzeichnisreorganisation → claude-md-improver für eine vollständige Bestandsaufnahme
• Direkt nach der Einführung neuer Tools oder Konfigurationen → claude-md-improver, um vergessene Aktualisierungen zu finden
• Wenn Sie während einer Sitzung denken „Oh, das wusste ich nicht" → /revise-claude-md, um es sofort festzuhalten

Es empfiehlt sich, beide Werkzeuge im Tandem zu nutzen: regelmäßige Gesundheitschecks (improver) und tägliche kleine Aufzeichnungen (revise).

Zusammenfassung

claude-md-management ist ein Plugin, das die Idee verkörpert: „CLAUDE.md ist nicht etwas, das man einmal schreibt und dann vergisst - es ist etwas, das man kontinuierlich pflegt." Da es offiziell von Anthropic herausgegeben wird, ist die Kompatibilität mit Claude Code selbst hervorragend, und der Installationsaufwand ist nahezu null.

Auch ich nutze es aktiv und werde immer wieder überrascht, wie veraltet meine CLAUDE.md geworden war. Wenn Sie Claude Code regelmäßig verwenden, probieren Sie es unbedingt einmal aus. Allein die Überprüfung Ihrer CLAUDE.md wird Ihnen eine neue Perspektive auf Ihr Projekt eröffnen.

Weiterführende Links

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