Ein System für Claude Code, um Ihr Projekt im Laufe der Zeit kennenzulernen

Ein Entwickler auf r/ClaudeAI teilte ein System, um das Fehlen von persistentem Kontext zwischen den Sitzungen von Claude Code zu beheben. Anstatt jedes Mal bei Null anzufangen, hilft dieses Setup Claude, die Konventionen, Architektur und früheren Fehler Ihres Projekts zu lernen.

Das Problem und die Lösung

Bei der Verwendung von Claude Code geht in jeder neuen Sitzung der gesamte vorherige Kontext verloren. Claude liest Dateien erneut, die es bereits verstanden hat, wiederholt korrigierte Fehler und ignoriert etablierte Muster, was ständige Neu-Erklärungen erfordert.

Die Lösung besteht darin, ein paar Dateien zu jedem Repository hinzuzufügen:

• CLAUDE.md - Eine kurze Reihe von Regeln, die Claude mitteilen, wie es sich verhalten soll. Beispiele sind "fragen Sie, bevor Sie fortfahren, wenn etwas unklar ist" und "führen Sie Tests nicht selbst durch, sondern sagen Sie mir, was ich ausführen soll" (was Geld spart, indem Token-Verschwendung durch Fehlersuche vermieden wird).
• docs/-Ordner - Enthält kurze Dateien (jeweils 5-10 Zeilen), die Projektkonventionen, Muster und Architektur erfassen, in Unterordnern organisiert. Eine Indexdatei (docs/README.md) hilft Claude, schnell das richtige Dokument zu finden, anstatt zu raten.

Drei Schlüssel-Prompts

• bootstrap - Einmal eingefügt, wenn eine bestehende Codebasis übernommen wird. Claude liest Ihren Code und schreibt die anfängliche Dokumentation.
• refine - Am Ende einer Sitzung eingefügt. Claude reflektiert über das Geschehene und aktualisiert die Dokumentation mit neuen Erkenntnissen.
• factory - Eingefügt, wenn Claude etwas tut, das Sie wiederholen möchten. Es erfasst das Muster als wiederverwendbaren Prompt.

Der Workflow-Zyklus

Der Prozess schafft einen kontinuierlichen Lernzyklus: Sie programmieren mit Claude → die Sitzung endet → Sie fügen den refine-Prompt ein → Claude aktualisiert die Dokumentation → Sie committen → die nächste Sitzung startet schlauer. Da die Dokumentation in Git lebt, profitiert jeder in Ihrem Team davon, und es funktioniert mit jedem Tech-Stack.

Praktische Tipps aus der Implementierung

• Sagen Sie Claude explizit, dass es keine Build-/Test-Befehle ausführen soll, um Token-Verschwendung durch Fehlersuche zu vermeiden. Lassen Sie es stattdessen sagen, welche Befehle Sie ausführen sollen.
• Verwenden Sie spezifische Zahlen in Regeln (z.B. "pausieren, wenn 3+ Dateien geändert werden") anstatt vager Begriffe wie "pausieren für komplexe Aufgaben", da Claude Zeit damit verschwendet, Mehrdeutigkeiten zu interpretieren.
• Eine Indexdatei für Ihren docs-Ordner zahlt sich sofort aus, indem sie verhindert, dass Claude zufällige Dateien öffnet, in der Hoffnung, relevante Informationen zu finden.

Das System ist kostenlos und Open Source, verfügbar bei saas-vibe.