Strukturierung von Claude-Code-Agenten mit CLAUDE.md und .claude/-Verzeichnismustern

Agenten-Verzeichnisstruktur

Das Setup umfasst die Erstellung separater Verzeichnisse für jeden Agenten unter ~/Documents/. Das Beispiel zeigt fünf Agenten: Planner (exekutive Funktion, Routing, Verantwortlichkeit), Content (Content-Pipeline), YouTube (YouTube-Produktion), Life (persönliche Bereiche) und Control-Center (Dashboard, Datenbank, API).

Jeder Agent folgt dieser Vorlagenstruktur:

agentenname/
├── CLAUDE.md # Identität + Mission + Fähigkeiten
├── .claude/
│   ├── rules/ # Automatisch geladener Kontext (dauerhaft aktiv)
│   └── skills/ # Bedarfsgesteuerte Workflows
├── inbox/ # Eingaben von anderen Agenten
├── outputs/ # Generierte Ausgaben
└── archive/ # Nichts wird ohne Archivierung gelöscht

Unterschied zwischen Regeln und Fähigkeiten

Die .claude/rules/-Dateien werden automatisch zu Beginn jeder Sitzung geladen. Claude liest sie als Teil seines Kontextfensters. Hier platziert man Dinge, die der Agent immer wissen muss – seinen Umfang, Geschäftskontext, wie er sich verhalten sollte.

Die .claude/skills/-Dateien sind bedarfsgesteuert. Sie laden nur, wenn man sie mit /skill-name aufruft. Hier platziert man spezifische Workflows wie mehrstufige Prozesse, Vorlagen, strukturierte Routinen.

Regeldateien werden zu Sitzungsbeginn in Ihr Kontextfenster geladen und bleiben dort. Claude Code verwendet Prompt-Caching, sodass wiederholte Inhalte nicht bei jeder Runde zum vollen Preis abgerechnet werden, aber große Regeldateien erhöhen dennoch den Kontextdruck und können zu Antwortverschlechterung führen. Bei Fähigkeiten leben standardmäßig nur Name und Beschreibung im Kontext; der vollständige Workflow wird bedarfsgesteuert geladen, entweder wenn man ihn aufruft oder wenn Claude entscheidet, dass er relevant ist.

Faustregel

• Regeln (dauerhaft aktiv): Umfangsgrenzen, Geschäftskontext, Routing-Logik, Namenskonventionen – Dinge, die jede Entscheidung beeinflussen
• Fähigkeiten (bedarfsgesteuert): Schritt-für-Schritt-Workflows, Vorlagen, Batch-Operationen. Dinge, die man gelegentlich tut (Hinweis: Fähigkeitsbeschreibungen sind immer im Kontext, damit Claude weiß, was verfügbar ist; nur der vollständige Inhalt ist bedarfsgesteuert)

CLAUDE.md-Inhalt

Die CLAUDE.md-Datei sollte unter 120 Zeilen bleiben und umfasst:

• Identität (2-3 Zeilen): wer dieser Agent ist und was er tut
• Aktuelle Phase (2-3 Zeilen): woran wir gerade arbeiten
• Kernfähigkeiten (10-15 Zeilen): welche Fähigkeiten verfügbar sind, was er tun kann
• Wichtige Orte (10-15 Zeilen): Dateipfade, auf die er verweisen muss
• Was gebaut wurde (10-20 Zeilen): Historie abgeschlossener Arbeiten
• Was als Nächstes kommt (5-10 Zeilen): unmittelbare Prioritäten
• Prinzipien (5-10 Zeilen): Verhaltensleitplanken

Beispiel-Regelstruktur

Für einen Planungs-Agenten enthält das .claude/rules/-Verzeichnis nummerierte Dateien, die die Ladereihenfolge steuern:

.claude/rules/
├── 01-business-context.md # Umsatzmodell, Positionierung, Zielkunden
├── 02-agent-ecosystem.md # Alle Agenten, ihre Missionen, wie sie verbunden sind
├── 03-roadmap.md # Aktuelle Phase, Meilensteine, Exit-Kriterien
├── 04-content-architecture.md # Content-Kanäle, Säulen, Workflow
├── 05-daily-routine.md # Zeitplan, Ideenfilterung, Anti-Ablenkungsregeln
├── 07-godin-strategy.md # Marketing-Prinzipien, Meilensteinverfolgung
├── 08-control-center.md # CLI-Tools-Referenz, DB-Schema
├── 98-end-of-session.md # Ritual: Roadmap aktualisieren, Wissen erfassen
└── 99-content-capture.md # Automatische Extraktion von Content-Signalen aus jeder Sitzung

Agenten-Kommunikation

Die Agenten rufen sich nicht direkt gegenseitig auf. Sie koordinieren über:

• SQLite-Datenbank: Single Source of Truth für Aufgaben, Content-Pipeline-Status, Sitzungen, Metriken
• Inbox-Dateien: Wenn ein Agent Kontext an einen anderen übergeben muss, legt er eine Markdown-Datei im inbox/-Ordner des Ziels ab
• API-Endpunkte: Dashboard-Lesevorgänge