Umstellung von CLAUDE.md-Regeln auf infrastrukturelle Durchsetzung mit Citadel

Das Problem mit der Regelanhäufung

Wenn Claude Anweisungen ignorierte, war der Instinkt, mehr Regeln zu CLAUDE.md hinzuzufügen. Von 45 Zeilen ausgehend wuchs es über drei Monate auf 190 Zeilen an, doch die Compliance verschlechterte sich. Anweisungen nach Zeile 100 wurden zunehmend als Vorschläge statt als Regeln behandelt. Eine forensische Prüfung ergab 40 % Redundanz – Regeln, die dasselbe in anderen Worten sagten, Regeln, die sich widersprachen, und veraltete Regeln. Ein Kürzen auf 123 Zeilen verbesserte die Compliance sofort.

Die Infrastrukturverschiebung

Die eigentliche Lösung bestand darin, CLAUDE.md als Eingangspunkt für die Orientierung (Projektkonventionen, Tech-Stack, Schlüsselprioritäten) zu erkennen, nicht als dauerhaften Ort für alle Regeln. Alles andere sollte nur bei Bedarf geladen werden. Der entscheidende Schritt: Die Durchsetzung von Anweisungen in die Umgebung zu verlagern.

Zum Beispiel: Statt einer Regel, die besagt "führe immer eine Typüberprüfung nach dem Bearbeiten einer Datei durch", der Claude inkonsistent folgte, führt ein Lebenszyklus-Hook-Skript automatisch bei jedem Dateispeichern eine Typüberprüfung durch. Dies stellt sicher, dass die Typüberprüfung ohne Wahl des Agenten erfolgt und Fehler sofort anstatt 20 Bearbeitungen später aufzeigt. Dies verkürzte die Überprüfungszeit erheblich und ermöglichte es, sich auf Absicht und Design zu konzentrieren, anstatt Typfehlern hinterherzujagen.

Das Fortschrittssystem

Der Autor skizziert ein fünfstufiges Fortschrittssystem:

• Stufe 1: Rohes Prompting (nichts bleibt bestehen, dieselben Fehler wiederholen sich)
• Stufe 2: CLAUDE.md (Regeln helfen, stoßen aber bei etwa 100 Zeilen an eine Grenze)
• Stufe 3: Skills (modulares Fachwissen, das bei Bedarf geladen wird, null Tokens bei Inaktivität)
• Stufe 4: Hooks (die Umgebung erzwingt Qualität, nicht Anweisungen)
• Stufe 5: Orchestrierung (parallele Agenten, persistente Kampagnen, koordinierte Wellen)

Die meisten Projekte kommen mit Stufe 2 oder 3 gut zurecht. Die entscheidende Erkenntnis: Wenn CLAUDE.md nicht mehr funktioniert, ist die Antwort nicht mehr Regeln – sondern die Verlagerung der Durchsetzung in die Infrastruktur.

Spezifische Implementierungen

Der Autor implementierte drei Schlüsselsysteme:

• Skills: Markdown-Dateien, die Muster, Einschränkungen und Beispiele für bestimmte Domänen kodieren. Der Agent lädt relevante Skills für die aktuelle Aufgabe und vermeidet so Token-Verschwendung auf irrelevante Kontexte.
• Kampagnendateien: Strukturierte Dokumente, die verfolgen, was gebaut wurde, welche Entscheidungen getroffen wurden und was noch bleibt. Diese bleiben über Sitzungen hinweg bestehen und eliminieren tägliche Wiedererklärungen.
• Automatisierte Hooks: Typüberprüfung bei jeder Bearbeitung, Anti-Pattern-Scanning am Sitzungsende, eine Sicherung, die den Agenten nach 3 wiederholten Fehlern bei demselben Problem beendet, und Komprimierungsschutz, der den Zustand speichert, bevor Claude den Kontext komprimiert.

Citadel: Das Open-Source-System

Das vollständige System, genannt Citadel, wurde unter https://github.com/SethGammon/Citadel als Open-Source veröffentlicht. Es umfasst das Skill-System, Hooks, Kampagnenpersistenz und einen /do-Befehl, der Aufgaben automatisch auf die richtige Orchestrierungsebene weiterleitet. Basierend auf 27 dokumentierten Fehlern über 198 Agenten in einer 668K-Zeilen-Codebasis lässt sich jede Regel auf etwas zurückführen, das kaputtging.