Claude-Code-Struktur, die mehrere reale Projekte überstanden hat

Was sich nach mehreren Projekten bewährt hat

Ein Entwickler auf r/ClaudeAI teilte seine Claude Code-Struktur, die nicht zusammenbrach, nachdem er sie in 2-3 realen Projekten implementiert hatte. Dieses Setup hielt stand, sobald er mehrere Skills, MCP-Server und Agents hinzufügte und über einfache Demos hinausging.

Wichtige strukturelle Entscheidungen

• CLAUDE MD verwenden: Das frühe Überspringen von CLAUDE MD führte zu inkonsistenten Ergebnissen. Sobald sie Konventionen, Testregeln und Namensstandards definierten, wurden die Ausgaben vorhersehbarer.
• Skills nach Zweck aufteilen: Das Organisieren von Skills als code-review/, security-audit/, text-writer/ funktionierte besser, als die Logik an einem Ort zu bündeln. Dies machte die Aktivierung sauberer.
• Hooks implementieren: Hooks anfangs nicht zu verwenden war ein Fehler. PreToolUse- und PostToolUse-Hooks halfen, schlechte Befehle und unordentliche Ausgaben abzufangen und waren nützlich für kleine Automatisierungen.
• Agents trennen: Der Single-Agent-Ansatz skaliert nicht gut. Dedizierte Reviewer-, Writer- und Auditor-Agents erwiesen sich als vorhersehbarer.
• Kontextnutzung steuern: Wenn die Kontextnutzung zu hoch wird, sinkt die Qualität. Sie unter etwa 60 % zu halten, machte einen merklichen Unterschied.
• Aufgabenbereiche trennen: Das Vermischen von Konfiguration, Skills und Laufzeitlogik machte das Debuggen mühsam. Diese getrennt zu halten, machte alles leichter nachvollziehbar.

MCP-Integration

Die MCP-Integration (Model Context Protocol) mit GitHub, Postgres und Dateisystemzugriff veränderte das Verhalten von Claude komplett. Laut dem Entwickler ist dies der Punkt, an dem das Setup aufhörte, sich wie ein Spielzeug anzufühlen, und begann, sich mehr wie ein Entwicklungsassistent zu verhalten, anstatt nur Eingabe → Ausgabe.

Der Entwickler merkt an, dass er immer noch herausfindet, wie man Agents am saubersten strukturiert, aber dieses Setup funktioniert derzeit gut für Projekte, die über einfache Demos hinauswachsen.