Portables Ingenieursystem für Claude Code mit Hooks, spezialisierten Agenten und Selbstverbesserung

Ein Entwickler, der frustriert war, Anweisungen an Claude Code ständig zu wiederholen, baute ein portables Engineering-System, das in ~/.claude/ lebt und automatisch auf jedes Projekt angewendet wird. Das System adressiert zwei Kernprobleme: die Wiederholungsschleife, bei der Claude Code denselben Bug Tage später erneut traf und ihn von Grund auf löste, und die projektübergreifende Trennung, bei der Regeln, die in einem Projekt verfeinert wurden, in einem anderen nicht existierten.

Systemkomponenten

Das System umfasst mehrere Schlüsselkomponenten:

• Eine Verfassung (CLAUDE.md) – 650 Zeilen Regeln mit einer Wertehierarchie, Entscheidungsgrenzen und drei Ausführungsmodi je nach Aufgabenkomplexität
• Hooks, die Regeln deterministisch durchsetzen – Keine Vorschläge, die die KI ignorieren könnte, sondern Bash-Skripte, die gefährliche Befehle wie Force-Pushes, falsche Paketmanager-Nutzung oder rm -rf physisch blockieren
• Drei spezialisierte Agenten – Ein Orchestrator, der delegiert, aber nie programmiert, Builder, die in isolierten Kopien des Repos arbeiten, und ein schreibgeschützter Reviewer, der nichts reparieren kann (nur berichtet)
• Eine Fähigkeitspipeline – Von der Planung über den Bau bis zum Versand in die Produktion, größtenteils autonom mit einer nicht verhandelbaren Barriere: Produktions-Deployments fragen immer nach
• Ein Immunsystem – Jeder Fehler wird mit der Ursache UND den gescheiterten Ansätzen protokolliert. Derselbe Bug in 2+ Projekten wird zu einer dauerhaften Regel, die Antikörper entwickelt
• Anti-Goodhart-Verifizierung – Fünf Fragen, die jeder Agent beantworten muss, bevor er "fertig" meldet, denn "alle Tests bestehen" bedeutet nicht, dass die App funktioniert

Compound-Engineering-Ansatz

Das System basiert auf Compound Engineering: Planen → Arbeiten → Überprüfen → Verbinden. Dieser vierte Schritt ist, wo sich das System selbst verbessert. Der Entwickler erwähnt spezifische Regeln, die er zuvor täglich wiederholen musste: "pnpm statt npm verwenden", "bestehende Tests nicht löschen" und "Tests vor dem Commit ausführen".

Das Projekt ist Open Source unter https://github.com/vinicius91carvalho/.claude mit einer vollständigen Übersicht aller 15 Teile verfügbar unter https://tail-f-thoughts.hashnode.dev/self-improving-engineering-system-claude-code.