Vishal Punia
KI Agenten Club

Guide zum Short · CLAUDE.md · Okt 2026

Nicht löschen, sondern prüfen.

Boris Cherny, der Claude Code gebaut hat, hat bei Y Combinator gesagt: alle sechs Monate die CLAUDE.md löschen, die Skills löschen. Machen wir nicht. Stattdessen prüft dieser Prompt alles gegen die aktuellen Vorgaben von Anthropic und sagt dir pro Punkt: ändern oder bleibt.

Zum Guide
Video auf YouTube ansehen ↗

Der Guide · zum Umsetzen

Alles aus dem Video, kurz zum Nachmachen.

  1. 01

    Nach Anthropics Doku

    Was der Audit prüft

    Jede Regel im Prompt kommt aus der offiziellen Doku:

    • CLAUDE.md: unter 200 Zeilen, konkrete und prüfbare Anweisungen, Überschriften und Stichpunkte statt Textblöcke, keine Widersprüche.
    • Skills: Name höchstens 64 Zeichen in Kleinbuchstaben, Zahlen und Bindestrichen. Beschreibung sagt, was der Skill macht und wann er greift. SKILL.md unter 500 Zeilen, Details in eigene Dateien.
    • Hooks: laufen mit deinen vollen Benutzerrechten. Deshalb prüft der Audit jeden Befehl darauf, was er löschen oder verändern kann.
    • Ton: kein „KRITISCH“ oder „DU MUSST“ mehr. Laut Anthropic reagieren neuere Modelle darauf zu stark.
  2. 02

    Zum Kopieren

    Der Audit-Prompt

    Starte Claude Code im Ordner deines Projekts und schick diesen Prompt. Er ändert nichts, er schreibt nur den Bericht.

    Mach einen Audit meiner Claude-Code-Konfiguration. Ändere dabei keine
Datei, schreib nur den Bericht.

Prüfe:
- CLAUDE.md und CLAUDE.local.md in diesem Projekt und ~/.claude/CLAUDE.md
- alle Dateien in .claude/rules/ und ~/.claude/rules/
- alle Skills in .claude/skills/ und ~/.claude/skills/
- alle Hooks in .claude/settings.json, .claude/settings.local.json und
  ~/.claude/settings.json

Lies vorher die aktuelle offizielle Doku von Anthropic, damit du nach dem
heutigen Stand prüfst:
- https://code.claude.com/docs/en/memory
- https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices
- https://code.claude.com/docs/en/hooks
- https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices

Achte besonders auf:
1. CLAUDE.md: Länge (Ziel unter 200 Zeilen), vage statt prüfbare
   Anweisungen, Widersprüche zwischen Dateien, veraltete Pfade, Befehle
   oder Dateien, die es nicht mehr gibt, Abläufe mit vielen Schritten,
   die besser ein Skill wären.
2. Anweisungen für ältere Modelle: Großbuchstaben-Drohungen, doppelte
   Wiederholungen, "nicht X" ohne zu sagen, was stattdessen.
3. Regeln, die immer gelten müssen und nur als Text dastehen. Wenn etwas
   sicher verhindert werden muss, schlag einen Hook vor.
4. Skills: name und description nach den Vorgaben, Beschreibung sagt
   was und wann, SKILL.md unter 500 Zeilen, keine doppelten Skills.
5. Hooks: Event-Namen gültig, Befehle verständlich, nichts, was ohne
   Rückfrage löscht oder Daten nach außen schickt.

Ausgabe als Tabelle mit den Spalten:
Datei | Stelle | Urteil (ändern / bleibt) | Grund mit Doku-Bezug | Vorschlag

Danach die drei wichtigsten Änderungen zuerst. Frag mich, bevor du
irgendetwas umsetzt.
  3. 03

    Schritt für Schritt

    So setzt du den Bericht um

    Der Bericht ist eine Liste, keine Pflicht. So gehst du vor:

    • Vorher sichern: Wenn dein Ordner in Git liegt, einmal committen. Sonst eine Kopie anlegen.
    • Mit den drei wichtigsten Änderungen anfangen und Claude jeweils nur die eine umsetzen lassen.
    • Alles mit „bleibt“ lässt du in Ruhe. Was funktioniert, wird nicht angefasst.
    • Nach den Änderungen ein, zwei normale Aufgaben machen und schauen, ob Claude sich wie gewünscht verhält.
  4. 04

    /doctor prompt-audit

    Bonus: der eingebaute Check

    Claude Code hat seit Version 2.1.283 einen eingebauten Audit. Er sucht nach Anweisungen für ältere Modelle, nach Verweisen auf Dateien oder Befehle, die es nicht gibt, und nach Widersprüchen. Auch er ändert nichts, bis du es sagst. Mein Prompt geht zusätzlich auf deine Hooks und das Urteil „ändern oder bleibt“ ein.

    /doctor prompt-audit

# nur eine Datei oder einen Ordner prüfen:
/doctor prompt-audit .claude/skills/mein-skill

Das Video dazu

Im Video zeige ich dir alles einmal live. Schau es dir an, wenn du einen Schritt genauer sehen willst.

Auf YouTube ansehen

KI Agenten Club

Eine saubere CLAUDE.md ist das Fundament. Im KI Agenten Club zeige ich dir mein Setup, von der CLAUDE.md über Skills und Hooks bis zu Agenten, und wie ich es aktuell halte.

Zum KI Agenten Club

KI Agenten Club

Vom Guide zum kompletten Setup.

Richtig Zeit sparst du, wenn Skills, Agenten, MCP-Server und deine CLAUDE.md zusammenspielen. Im KI Agenten Club zeigen wir dir das an unserem eigenen Setup, damit du es für deine Arbeit nachbauen kannst.

Vishal Punia · KI Agenten Club

Setup zum Übernehmen

Die Skills, MCP-Server und Vorlagen aus unserem Alltag, bald auch Orbit. Monatlich oder jährlich, direkt in Skool.

Zum KI Agenten Club