Claude Code zweites Gehirn: Gedächtnis und Ordnerstruktur aufbauen
MarkdownClaude Code mit Obsidian verbinden: lokale Markdown-Notizen nutzen, über CLAUDE.md verlinken und ein zweites Gehirn mit Ordnerstruktur und Git aufbauen.
Vollständigen Artikel lesen
Wichtigster Punkt
Ein zweites Gehirn für Claude Code ist nicht eine einzelne Datei, sondern eine Struktur aus fünf Ordnern plus Git. CLAUDE.md legt die Regeln und Verweise fest, business/ speichert Wissen über das Projekt, ai-clone/ Informationen über dich als Entscheidungsträger, plans/ technische Pläne und retrospectives/ Erkenntnisse aus vergangenen Sitzungen. Der Agent beginnt mit CLAUDE.md und folgt den Links zum passenden Ordner für die jeweilige Anfrage. Dieser Artikel behandelt die Erinnerungshierarchie in der offiziellen Claude-Code-Dokumentation, eine fünfteilige Struktur und den schrittweisen Aufbau in einer Stunde.
Ailoot-Referenzdokumentation: ailoot.ai/docs/.
Warum braucht Claude Code ein zweites Gehirn, und was ist wesentlich?
Wichtigster Punkt
Eine CLAUDE.md-Datei deckt die Grundregeln ab, aber sie kann kein Geschäftswissen verwalten. Nach einem Monat hast du vergessen, warum du den Preis erhöht hast. Nach drei Monaten hast du vergessen, warum du Ratenzahlungen abgelehnt hast. Wissen steckt gleichzeitig an vier Orten: in deinem Kopf, in Telegram-Chats, in Google-Dokumenten und in den Köpfen der Mitarbeiter. Ein zweites Gehirn sammelt alles in einem Ordner mit Markdown-Dateien neben dem Projekt, und Claude kann selbst darauf zugreifen.
Du öffnest Claude Code am Dienstag. Du erklärst: Das ist das Projekt, das ist die Zielgruppe, tu dies nicht. Ihr arbeitet zusammen. Am Donnerstag ist es ein neuer Chat, und du musst alles noch einmal erklären.
Wenn du eine CLAUDE.md hast, hast du die erste Runde Frust gelöst. Die Grundregeln und die Projektbeschreibung stehen in einer Datei und werden in jede Sitzung geladen. Wie diese Datei funktioniert, habe ich in meinem Leitfaden zu CLAUDE.md erklärt - du kannst ihn zuerst lesen, um die Grundlage zu schaffen.
Doch CLAUDE.md ist ein Handbuch für einen neuen Mitarbeiter. Wie man sich kleidet, welchen Ton man gegenüber Kunden verwendet und welche Befehle man zum Veröffentlichen nutzt. Das reicht nicht aus, um gute Entscheidungen zum Projekt zu treffen. Entscheidungen erfordern Wissen: Was das Produkt ist, wer die Zielgruppe ist, wie die Wirtschaftlichkeit aussieht, was du ausprobiert hast und was nicht funktioniert hat.
Nach der hier beschriebenen Erfahrung des Autors befand sich dieses Wissen früher an vier Orten: in seinem Kopf, in Telegram-Chats, in Google-Dokumenten und in den Köpfen der Mitarbeiter. Einen Monat nach einer Entscheidung erinnerte sich niemand mehr daran, warum sie getroffen worden war. Eine neue Person verbrachte eine Stunde damit, dem Team Fragen zu stellen, um sich einzuarbeiten. Claude war überhaupt nicht Teil dieses Kontexts.
Vor dem zweiten Gehirn bedeutete in der vom Autor beschriebenen Erfahrung jede Sitzung, erneut zu erklären, wer der Kunde war, wie das Angebot aufgebaut war und welcher Anbieter die Zahlungen abwickelte. Mit business/ öffne ich einen Chat und sage: „Aktualisiere das Angebot für den neuen Tarif“ - Claude ruft selbst business/company/legal.md auf, liest die Anforderungen und öffnet dann business/products/pricing.md, sieht den neuen Tarif und schlägt in einem Durchgang eine Änderung vor. Die Aufwärmphase entfällt; der Kontext wird automatisch geladen.
Hinweis
Das ist kein Problem mit Claudes Gedächtnis. Es ist eine Frage der Architektur. Das Kontextfenster eines Agenten ist sein Arbeitsgedächtnis. Es lädt nur, worauf du ausdrücklich verweist. Alles andere liegt außerhalb des Fensters und wird bei Bedarf geladen. Ein zweites Gehirn speichert dieses „alles andere“ strukturiert, damit Claude sich darin zurechtfindet.
Anthropic nennt dieses Problem in seinem Engineering-Blog „context rot“:
Je mehr Tokens sich im Kontextfenster befinden, desto schlechter kann das Modell Informationen aus diesem Kontext korrekt abrufen.
Anders gesagt: Je mehr du in das Fenster stopfst, desto schlechter arbeitet der Agent mit konkreten Details. Die Lösung besteht darin, eine Struktur externer Dateien zu pflegen, die Claude als Reaktion auf eine konkrete Anfrage selbst aufrufen kann. Das ist ein zweites Gehirn.
Was ist ein zweites Gehirn, und wie lässt sich Tiago Fortes Konzept auf Claude anwenden?
Wichtigster Punkt
Die Idee eines „zweiten Gehirns“ ist einfach: Dein Geist ist zum Denken da, nicht zum Speichern. Für Claude Code wird ein zweites Gehirn von einer Produktivitätsmethode zu einer Agentenarchitektur: einem externen Notizordner, auf den der Agent direkt über das Dateisystem zugreifen kann.
Typischerweise geht es bei einem zweiten Gehirn allgemein um Produktivität: Menschen erstellen einen Obsidian-Tresor und fügen Auszüge aus Büchern, Gesprächsnotizen und Projektideen hinzu.
Als der Autor diese Idee auf die Arbeit mit Claude Code anwandte, ging es nicht mehr um Produktivität, sondern um Agentenarchitektur.
Beim klassischen Ansatz gehört das zweite Gehirn dir, und du greifst manuell darauf zu. Bei der Arbeit mit Claude Code wird das zweite Gehirn zweiwegig: Sowohl du als auch der Agent greifen darauf zu. Das verändert die Anforderungen an sein Format.
Da der Agent selbst darauf zugreift, müssen die Dateien in einem Format vorliegen, das er ohne separate Integration versteht. Markdown ist ideal: Text, eine Überschriftenhierarchie und Verknüpfungen zwischen Dateien. Notion und Google Docs sind nicht geeignet. Du kannst sie über MCP verbinden, aber das fügt eine weitere Ebene, ein weiteres Token pro Anfrage und eine weitere Fehlerquelle hinzu.
Da sich die Dateien im Dateisystem neben dem Projekt befinden, liegen sie automatisch in Reichweite von Claude Code. Keine Einrichtung nötig. Starte den Agenten im Projektordner, und er kann alle darin enthaltenen Dateien sehen. Es ist kostenlos und funktioniert sofort.
Tipp
Du kannst dein zweites Gehirn in Obsidian führen - ich öffne es dort ebenfalls, damit sich der Verbindungsgraph leichter ansehen lässt. Die Dateien selbst liegen jedoch in einem gewöhnlichen Ordner neben dem Code. Obsidian ist nur eine praktische Hülle um Markdown-Dateien. Claude kann sie auch ohne Obsidian sehen. Du kannst jeden Editor verwenden; entscheidend ist, dass die Dateien auf der Festplatte liegen und nicht in einem Cloud-Dienst mit eigenem Format.
Welche Erinnerungshierarchie hat Claude Code standardmäßig?
Wichtigster Punkt
Claude Code kann standardmäßig vier Ebenen von CLAUDE.md lesen (Enterprise, Benutzer, Projekt und lokal). Seit Version 2.1.59 führt es außerdem einen eigenen automatischen Speicher unter ~/.claude/projects/<project>/memory/. Das genügt für grundlegende Erinnerungen, aber nicht für den Geschäftskontext - diesen legst du in einem separaten Ordner neben dem Projekt ab.
Bevor wir etwas Eigenes hinzufügen, sehen wir uns an, woran sich Claude ohne deine Hilfe erinnern kann. Anthropic beschreibt in seiner offiziellen Dokumentation zwei Mechanismen: CLAUDE.md (Regeln, die du schreibst) und automatische Erinnerung (Erkenntnisse, die Claude selbst festhält). Beide werden zu Beginn jeder Sitzung geladen.
CLAUDE.md wird gleichzeitig an vier Orten gesucht:
| Ebene | Speicherort | Zweck |
|---|---|---|
| Enterprise | /Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows) | Regeln, die ein Administrator über MDM für das gesamte Team bereitstellt. Einzelne Nutzer benötigen diese Ebene nicht. |
| Benutzer | ~/.claude/CLAUDE.md | Persönliche Regeln, die für alle Projekte gelten. „Antworte in meiner bevorzugten Sprache“, „verwende keine Gedankenstriche“. |
| Projekt | ./CLAUDE.md im Projektstammverzeichnis | Regeln für ein bestimmtes Projekt: Stack, Ordnerstruktur, Geschäftsregeln. Wird in Git eingecheckt. |
| Lokal | ./CLAUDE.local.md | Deine persönlichen Notizen zu diesem Projekt, die nicht in Git eingecheckt werden. In .gitignore. |
Alle vier Dateien werden in den Kontext geladen. Je spezifischer die Ebene, desto höher ist ihre Priorität. Die lokale Datei wird zuletzt gelesen, sodass ihre Regeln alle anderen überschreiben.
Eine CLAUDE.md-Datei kann auch in jedem Ordner innerhalb des Projekts liegen. Wenn Claude eine Datei aus einem Unterordner liest, lädt es die CLAUDE.md dieses Unterordners bei Bedarf. Das ist in einem Monorepo nützlich: Die Frontend-Regeln liegen in frontend/CLAUDE.md, die Backend-Regeln in backend/CLAUDE.md, und sie werden nur geladen, wenn der Agent am jeweiligen Teil arbeitet.
Die automatische Erinnerung erschien in Claude Code 2.1.59. Dabei handelt es sich um Dateien, die Claude über dich schreibt:
~/.claude/projects/<project-name>/memory/
├── MEMORY.md # Index, in jeder Sitzung geladen (200 Zeilen oder 25KB)
├── debugging.md # Detaillierte Notizen (bei Bedarf geladen)
├── api-conventions.md
└── ...
Anthropic beschreibt es in der offiziellen Dokumentation so:
Claude speichert nicht in jeder Sitzung etwas. Es entscheidet selbst, was sich zu merken lohnt, je nachdem, ob die Information in einem zukünftigen Gespräch nützlich sein könnte.
Die automatische Erinnerung wird mit dem Flag autoMemoryEnabled in ~/.claude/settings.json aktiviert. Claude entscheidet, was dort geschrieben wird. Du kannst MEMORY.md lesen und manuell bearbeiten - es ist gewöhnliches Markdown.
Warnung
Die automatische Erinnerung ist nützlich, aber kein Ersatz für ein zweites Gehirn. Claude schreibt dort taktische Erkenntnisse über Tools und Code-Muster fest. „Dieses Skript funktioniert ohne Flag X nicht“, „diese Datenbanktabelle heißt so“. Geschäftsstrategie hält es dort nicht fest. Wenn sich der Agent merken soll, wer deine Zielgruppe ist und warum du einen bestimmten Preis gewählt hast, musst du das selbst in einem separaten Kontextordner ablegen.
CLAUDE.md oder ein zweites Gehirn - wo ist die Grenze?
Wichtigster Punkt
CLAUDE.md ist ein Handbuch für einen neuen Mitarbeiter: wie er sich verhalten und welche Befehle er verwenden soll und was er nicht tun darf. Ein zweites Gehirn ist ein Unternehmens-Wiki: Was du tust, für wen es ist, wie die Wirtschaftlichkeit aussieht und was du ausprobiert hast. Eine Datei mit Verhaltensregeln plus eine Struktur externen Wissens. CLAUDE.md ist der Index; das zweite Gehirn ist das Archiv. Ohne den Index weiß der Agent nicht, dass es das Archiv gibt. Ohne das Archiv kennt er nur die Regeln, nicht den Geschäftskontext.
Hier ist der Vergleich, den ich in meinen Vorträgen verwende: Stell dir vor, du hast einen neuen Mitarbeiter eingestellt. Was gibst du ihm am ersten Tag?
Ein Handbuch: wie man sich kleidet, wann man erscheint, welchen Ton man gegenüber Kunden verwendet und über welches System veröffentlicht wird. Es ist ein kurzes Dokument. Es erklärt weder, was ihr tut, noch warum. Es sagt lediglich, wie man sich verhalten soll.
Und zusätzlich den Zugang zum Unternehmens-Wiki. Es erklärt, was das Produkt ist, für wen es gedacht ist, wer zur Zielgruppe gehört, wie hoch der Preis ist und warum, wer die Wettbewerber sind und welche Fehler ihr gemacht habt. Es ist ein umfangreiches Archiv. Niemand liest alles darin - man schlägt dort eine konkrete Frage nach.
CLAUDE.md = Handbuch. Zweites Gehirn = Wiki. Du brauchst beides.
Die Unterscheidung ist einfach. Alles, was für jede Aufgabe relevant ist, gehört in CLAUDE.md:
- Wer der Agent in diesem Projekt ist (Helfer, Leiter, Assistent)
- In welcher Sprache er antworten soll
- Verwendeter Tool-Stack
- Befehle zum Veröffentlichen
- Verbote (keine Gedankenstriche verwenden,
git push --forcenicht ausführen) - Verweise: wo der Geschäftskontext und wo die Prinzipien zu finden sind
Alles, was bei Bedarf gebraucht wird, gehört ins zweite Gehirn:
- Produkt, Zielgruppe, Wirtschaftlichkeit und Ziele
- Wettbewerber und Markt
- Vergangene Entscheidungen und ihre Gründe
- Kundenbeispiele und Bewertungen
- Prinzipien und Methodik
Anthropic unterscheidet in seiner Dokumentation genauso:
Halte CLAUDE.md kurz. Sie wird in jeder Sitzung geladen, daher sollte sie nur Informationen enthalten, die allgemein gelten. Für Fachwissen oder Arbeitsabläufe, die nur manchmal gebraucht werden, verwende Skills. Claude lädt sie bei Bedarf, ohne jede Unterhaltung aufzublähen.
Skills sind eine Möglichkeit, episodisches Wissen zu speichern. Ein neben dem Projekt liegender business/-Ordner ist eine andere. Ich verwende beides und erläutere es weiter unten genauer.
Woraus besteht ein Projektgehirn - 5 Teile plus Zeitmaschine
Wichtigster Punkt
Ein Projektgehirn besteht aus fünf Ordnern mit Git darüber. CLAUDE.md legt Regeln und Verweise fest. ai-clone/ speichert dein digitales Abbild: deine Prinzipien, deinen Ton und Feedback nach Fehlern. business/ speichert Wissen über das Projekt. plans/ enthält technische Pläne nach Phasen. retrospectives/ enthält Rückblicke nach Sitzungen. Git macht daraus eine Zeitmaschine: Ein Jahr später kannst du jede Datei öffnen und sehen, was darin stand, als eine Entscheidung getroffen wurde.
Eine Beispielarchitektur aus der vom Autor beschriebenen Erfahrung:
| Ordner | Inhalt | Zweck |
|---|---|---|
CLAUDE.md | Projektregeln, Stack, Dateistruktur, Ordnerverweise, Kommunikationssprache | Das ist das Handbuch des Agenten. Es wird in jeder Sitzung geladen. Weniger als 200 Zeilen, idealerweise 80-120. |
ai-clone/ | Wer ich bin, meine Prinzipien, mein Ton, mein Entscheidungsstil, Feedback nach Fehlern | Ein digitales Abbild von mir als Entscheidungsträger. Es weiß, was ich sofort ablehnen werde, in welchem Stil ich Vorschläge formuliere und welche Regeln ich aus Fehlern gelernt habe. |
business/ | Produkt, Zielgruppe, Ziele, Wirtschaftlichkeit, Marketing, vergangene Entscheidungen, Beispiele | Verknüpfte Markdown-Dateien mit Wiki-Links. Jede Datei ist über [[...]]-Links mit anderen verbunden. Der Agent ruft sie bei konkreten Fragen auf. |
plans/ | Ein Plan pro Funktion. Datei YYYY-MM-DD-feature.md mit Phasen und Kontrollkästchen | Der Plan-Modus existiert innerhalb eines Gesprächs und geht nach /clear verloren. Der Ordner plans/ liegt im Repository - jeder Agent kann den Plan jederzeit fortsetzen. |
retrospectives/ | Rückblicke nach jeder Sitzung: Was erledigt wurde, woran man denken sollte, was besser laufen könnte | Selbstlernen des Systems. Fehler werden zu Regeln in ai-clone/feedback/. |
+ git | Versionsverlauf aller Dateien | Eine Zeitmaschine. Öffne eine beliebige Datei und führe git log aus, um zu sehen, wann und warum sie geändert wurde. |
Der entscheidende methodische Punkt ist die Trennung von ai-clone/ und business/.
business/ beantwortet die Frage „Was machen wir?“ Produkt, Zielgruppe, Preise, Wettbewerber. Es geht um das Projekt. Wenn du das Projekt morgen an einen Partner übergibst, geht dieser Ordner mit.
ai-clone/ beantwortet die Frage „Wie treffe ich Entscheidungen?“ Meine Prinzipien, mein Ton, meine Arbeitsweise und meine Tabuwörter. Es geht um mich. Wenn ich morgen ein neues Projekt beginne, kommt dieser Ordner mit.
Möchtest du nicht nur einen zweiten Ordner einrichten, sondern auch ein System aufbauen, das Claude konsistent macht? Das allein reicht nicht. Ohne ai-clone/ antwortet der Agent für alle, nicht für dich. Ohne Context Engineering streift er durch den ganzen Ordner und verbraucht Tokens. Sinnvoll ist es, alle drei Dinge zu verbinden: zweites Gehirn + KI-Klon + Context Engineering. Das sind die drei Säulen, ohne die KI halluziniert.
Was gehört in business/, und was nicht?
Wichtigster Punkt
Lege Projektfakten, die sich höchstens einmal pro Woche ändern, in business/ ab: Positionierung, Zielgruppe, Produkte und Preise, Quartalsziele und wichtige Entscheidungen. Lass Chatkorrespondenz, unverarbeitete Rohmaterialien, Informationen, die bereits im Code stehen, Screenshots und dynamische Zahlen weg. Ersetze Zahlen durch den LIVE-Marker und einen Link zu einer SQL-Abfrage - das erkläre ich weiter unten in einem eigenen Abschnitt.
Die oberste business/-Struktur im vom Autor beschriebenen Projekt:
business/
├── INDEX.md ← Ordnerübersicht, zuerst lesen
├── company/ ← Mission, juristische Person, Werte, rechtliche Richtlinien
├── products/ ← Produkte, Programme, Preise
├── audience/ ← Kundenprofil, Segmente, Einwände
├── goals/ ← Jahres-, Quartals- und Monatsziele, Kennzahlen
├── economics/ ← Stückkostenrechnung, Einnahmen, Ausgaben, Prognose
├── marketing/ ← Kanäle, Funnel, Materialien, Wettbewerber
├── execution/ ← Wochenplanung, Backlog
└── assets/ ← Designsystem, Bewertungen, Textbausteine
Dies ist ein Beispiel aus dem vom Autor beschriebenen Projekt, kein Dogma. Ich lege Ordner nach Bedarf an. Angefangen habe ich mit drei (products/, audience/, goals/); die anderen kamen nach 2-3 Monaten hinzu, als unklar wurde, wohin neue Dinge gehörten.
Die wichtigste Datei des Ordners ist INDEX.md. Sie ist eine Karte. Darin steht eine Tabelle „Frage → Datei“, anhand der Claude erkennt, wohin es gehen soll. Ohne sie verschwendet der Agent Tokens, indem er jede Datei der Reihe nach liest.
Ein Beispielauszug aus INDEX.md:
### Wo du etwas findest
| Gesucht | Hier nachsehen |
|---|---|
| Wer unser Kunde ist und welche Probleme er hat | `business/audience/avatar.md` |
| Produkte, Tarife und Preise | `business/products/` |
| Ziele und Kennzahlen | `business/goals/` |
| Wirtschaftlichkeit (Einnahmen, Ausgaben, Stückkostenrechnung) | `business/economics/` |
| Werbekanäle und Materialien | `business/marketing/` |
Dann genügt eine Zeile in CLAUDE.md: „Lies bei Fragen zum Geschäft business/INDEX.md und folge der Übersicht.“ Der Agent lädt nicht den ganzen Ordner in den Kontext. Er lädt die Übersicht, wählt die passende Datei aus und liest nur diese.
Checkliste: Was nicht in business/ gehört:
- Unverarbeitete Chatkorrespondenz. Wenn es eine Erkenntnis gibt, destilliere sie und halte sie fest. Wenn nicht, lass sie weg.
- Informationen, die bereits im Code stehen. „Zahlungen laufen über CloudPayments“ ist unnötig; der Agent kann es im Code sehen.
- Screenshots und Bilder. Sie vergrößern den Ordner und werden von einem Textmodell ohne zusätzlichen Schritt nicht verarbeitet.
- Dynamische Zahlen. „Heute gibt es 423 Zahlungen für das Produkt“ ist in einer Woche veraltet. Verwende den LIVE-Marker und einen Link zu einer Datenbankabfrage.
- Sensible oder fragwürdige Informationen. Wenn das Repository morgen auf YouTube vor 100 tausend Fremden veröffentlicht würde, behalte nur, was du zeigen würdest. Mitarbeiter, Agenten und manchmal externe Auftragnehmer lesen den Ordner.
Warnung
Wenn das Repository öffentlich ist, ist der Ordner business/ ebenfalls öffentlich. Ich behandle das zweite Gehirn so, als könnte das Repository morgen öffentlich werden, auch wenn es jetzt privat ist. Keine Kundennamen ohne Zustimmung, keine monatlichen Umsatzzahlen, keine Passwörter. Diese Gewohnheit erspart viel Stress.
Warum gibt es einen separaten Ordner ai-clone, und warum sollte er nicht mit business vermischt werden?
Wichtigster Punkt
ai-clone/ speichert dein digitales Abbild: Prinzipien, Ton, Tabuwörter und Feedback nach Fehlern. Jeder Agentenfehler wird nach dem Muster „Regel → warum → wie anwenden“ zu einer Regel in ai-clone/feedback/. Der Ordner begleitet dich von Projekt zu Projekt. business/ bleibt beim Projekt. Halte sie getrennt: In einem neuen Projekt ist business/ neu, doch deine Prinzipien und dein Stil bleiben gleich.
Die Idee ist einfach: Das Unternehmen weiß, was wir tun. Der Klon weiß, wie ich Entscheidungen treffe.
Die ai-clone/-Struktur im vom Autor beschriebenen Projekt:
ai-clone/
├── INDEX.md ← Ordnerübersicht
├── role.md ← wer ich bin, mein Hintergrund, was wichtig ist
├── identity/ ← Werte, Vision, Mission
├── thinking/ ← mentale Modelle aus Vorträgen
├── voice/ ← Ton, Wortschatz, Stil
├── principles/ ← Überzeugungen zu Produkt, Code, Geschäft
├── feedback/ ← aus Fehlern gelernte Regeln ← Hauptordner
├── style/ ← Tabuwörter, Telegram-Format
└── reference/ ← Tools, Umgebung
Der nützlichste Ordner ist feedback/. Darin stehen konkrete Regeln, die ich aus Fehlern des Agenten gelernt habe. Jede Regel kommt in eine eigene Datei und folgt diesem Format:
---
name: short-name
description: eine Zeile - was in der Datei steht und wann sie anzuwenden ist
type: feedback
---
Eine kurze Regel in einem Satz.
**Warum:** Warum es diese Regel gibt. Kontext, Vorfall, Beobachtung.
**Anwendung:** Konkrete Auslöser dafür, wann die Regel gilt.
Ohne „Warum“ ist die Regel tot - der Agent überträgt sie nicht auf eine ähnliche Situation. Ohne „Anwendung“ ist unklar, wann die Regel zu verwenden ist.
Ein Beispiel aus meinem Ordner: die Regel „Bindestrich, kein Gedankenstrich“. Sie entstand, weil der Gedankenstrich — ein wichtiges visuelles Kennzeichen generierter Texte ist. Sie gilt für alle Texte, die öffentlich erscheinen. Die Datei liegt unter ai-clone/feedback/no-em-dashes.md.
Ich mache es etwas anders: Ich schreibe Regeln in ai-clone/feedback/, nicht in CLAUDE.md. CLAUDE.md ist eine Projektdatei, aber Regeln zu Ton und Stil sind persönlich. Sie begleiten mich ins nächste Projekt. CLAUDE.md bleibt beim Projekt.
Hinweis
Ein Maß dafür, wie ausgereift dieser Ansatz ist: Wie oft pro Woche sagst du dem Agenten wegen derselben Sache „Nein, nicht so“? In einem ausgereiften System lautet die Antwort: null. Jeder Fehler wird zu einer Regel in feedback/, und der Agent wiederholt ihn beim nächsten Mal nicht.
Was sind Live Metrics, und warum sollte man Zahlen nicht fest in Dateien eintragen?
Wichtigster Punkt
Zahlen in Dateien des zweiten Gehirns veralten innerhalb weniger Tage. „Heute haben wir 1,000 Kunden“ wird morgen zu 1,050 und in einem Monat zu 2,000. Wenn du die Zahl fest einträgst, schlägt der Agent einen Monat später Dinge auf Basis der Daten von gestern vor. Die Lösung ist ein LIVE-Marker in der Datei plus ein separates Dokument live-metrics.md mit sofort ausführbaren SQL-Abfragen. Wenn der Agent LIVE sieht, ruft er die Datenbank auf, holt die aktuelle Zahl und stützt seine Überlegungen auf aktuelle Daten.
Eine der größten Fallen beim Aufbau eines zweiten Gehirns ist es, es mit veralteten Zahlen zu füllen. Du schreibst „Wir haben 320 Kunden“, und zwei Wochen später sind es schon 410. Du schreibst „Der Monatsumsatz beträgt 4.7 Millionen“, und einen Monat später fehlt der Zahl der Kontext: Ist das ein Ziel, ein Ist-Wert oder eine Prognose?
Im Beispiel des Autors funktioniert es so. In der Datei business/products/practicum.md steht statt einer Zahl ein Marker:
## Kohorten
> **LIVE** - führe die Abfragen in `live-metrics.md`, Abschnitt „Verkäufe“ aus,
> um die aktuellen Zahlungen je Kohorte zu sehen.
| Kohorte | Daten | Zahlende |
|-------|------|------------|
| 1 | 10.-12. März 2026 | LIVE |
| 2 | 24.-26. März 2026 | LIVE |
Eine separate Datei live-metrics.md enthält sofort ausführbare SQL-Abfragen und Beschreibungen ihrer Ergebnisse:
## Verkäufe (Zahlungen nach Kohorte)
```sql
SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue
FROM purchases p
JOIN cohorts c ON c.id = p.cohort_id
WHERE p.status = 'paid'
GROUP BY c.name
ORDER BY c.starts_at DESC;
```
Wenn ich den Agenten frage: „Wie viele Zahlungen haben wir für die zweite Kohorte?“, dann:
- Liest er
business/products/practicum.md - Sieht er den LIVE-Marker neben der Zahl
- Öffnet er
live-metrics.md - Findet er den Abschnitt „Verkäufe“
- Führt er die Abfrage gegen die Produktionsdatenbank aus
- Antwortet er mit aktuellen Daten
Damit werden zwei Probleme gleichzeitig gelöst. Zahlen veralten nicht. Und Entscheidungen beruhen auf dem aktuellen Stand, nicht auf dem des letzten Jahres.
Warnung
Im vom Autor beschriebenen Ansatz haben nur vertrauenswürdige Agenten Zugriff auf die Produktionsdatenbank. Sie erhalten diesen Zugriff ausschließlich über einen Wrapper, der Abfragen protokolliert und keine Passwörter offenlegt. Einen direkten psql-Befehl mit Klartextpasswort in live-metrics.md abzulegen, ist keine gute Idee. Erstelle einen Wrapper, der das Passwort aus einer Umgebungsvariable bezieht und es nicht in der Ausgabe offenlegt. Das ist eine separate technische Ebene, aber ohne sie wird LIVE zu einer Sicherheitslücke.
Wie navigiert die KI bei einer einzelnen Anfrage durch das zweite Gehirn?
Wichtigster Punkt
Der Anfragepfad ist immer derselbe: Claude liest CLAUDE.md, sieht die Übersichten (business/INDEX.md, ai-clone/INDEX.md), öffnet den relevanten INDEX, folgt ihm zu einer bestimmten Datei und ruft bei Bedarf über LIVE eine Zahl ab. Das sind 5-6 Lesevorgänge, statt den ganzen Ordner in den Kontext zu stopfen. Das Fenster bleibt fürs Schlussfolgern frei, und Tokens werden nicht für irrelevante Dateien verschwendet.
Eine konkrete Anfrage könnte zum Beispiel lauten: „Verfasse eine E-Mail an die Teilnehmer zur neuen Kohorte.“
- Claude beginnt mit einem leeren Fenster. Es lädt CLAUDE.md (Regeln, Stack, Verweise).
- Anhand der Verweise in CLAUDE.md sieht es: „
ai-clone/INDEX.md- zu Beginn jeder Sitzung lesen.“ Es öffnet die Datei und erfährt, wer ich bin, welchen Ton ich anschlage und welche Tabuwörter ich verwende. - In den Verweisen sieht es: „E-Mail-Vorlagen -
src/lib/email/layout.ts.“ Es öffnet die Datei und versteht das Format. - Es sieht: „Produktkontext -
business/products/practicum.md.“ Es öffnet die Datei und liest über das Produkt. - Es sieht den LIVE-Marker in der Datei und einen Verweis auf
live-metrics.md. Es öffnet die Datei und findet das ausführbare SQL. Wenn es eine aktuelle Zahl braucht, führt es die Abfrage aus. Andernfalls vermerkt es: „Diese Zahl beim Versand abrufen.“ - Es sieht die Tonregeln in
ai-clone/style/telegram-format.md, das Verbot von Gedankenstrichen inai-clone/feedback/no-em-dashes.mdund die Funnel-Konversionsraten inbusiness/marketing/funnel.md.
Es schreibt die E-Mail in meinem Ton, mit aktuellen Zahlen und ohne Gedankenstriche oder KI-Kennzeichen.
Anthropic nennt diesen Ansatz in seinem Engineering-Blog „Just-in-time-Kontext“:
Agenten, die nach dem „Just-in-time“-Ansatz aufgebaut sind, behalten leichte Verweise (Dateipfade, gespeicherte Abfragen, Links usw.) und verwenden diese Links, um zur Laufzeit dynamisch Daten mithilfe von Tools in den Kontext zu laden.
Anders gesagt: Claude trägt Verweise auf Daten mit sich, nicht die Daten selbst. Das ist wesentlich token-effizienter und genauer, weil nur relevante Informationen im Kontext landen. Das Fenster bleibt fürs Schlussfolgern frei.
5 Anti-Patterns beim zweiten Gehirn - was solltest du vermeiden?
Wichtigster Punkt
Die häufigsten Fehler von Anfängern beim zweiten Gehirn: 1) eine überladene CLAUDE.md mit 500+ Zeilen statt eines kurzen Wegweisers; 2) ein Sammelordner, der zur Ablage für alles wird; 3) Duplikate von Dingen, die Claude bereits aus der Sprache oder dem Code kennt; 4) fest eingetragene Zahlen, die ohne LIVE veralten; 5) Kontext für den Agenten unzugänglich zu lassen oder keinen Weg dorthin anzugeben – unabhängig davon, ob er im selben Repository oder einem separaten privaten Speicher liegt.
Anti-Pattern 1. Eine überladene CLAUDE.md. 500 Zeilen mit Anweisungen, „statt alles an einem Ort abzulegen“. Anthropic sagt es deutlich:
Halte sie kurz. Frage dich bei jeder Zeile: „Wird Claude anfangen, Fehler zu machen, wenn ich sie entferne?“ Wenn nicht, streiche sie. Überladene CLAUDE.md-Dateien führen dazu, dass Claude deine eigentlichen Anweisungen ignoriert!
Die Ziellänge liegt bei 80-120 Zeilen. Alles andere kommt in separate Dateien, auf die du verweist.
Anti-Pattern 2. Ein Sammelordner. Du wirfst alles ins zweite Gehirn: unbearbeitete Chatkorrespondenz, nutzlose Screenshots, Berichte, die niemand lesen wird. Einen Monat später ist der Ordner angeschwollen, der Agent verschwendet Tokens mit dem Lesen von Unrat, und du weißt nicht mehr, wo etwas liegt. Die Regel: Jede Datei im zweiten Gehirn sollte eine konkrete Frage beantworten. Wenn seit sechs Monaten niemand sie geöffnet hat, lösche sie oder verschiebe sie ins Archiv.
Anti-Pattern 3. Duplikate. „Zahlungen laufen über CloudPayments, unter src/lib/payment/cloudpayments.ts; der Anbieter ist in .env konfiguriert.“ Der Agent kann das alles im Code sehen. Du musst es nicht in business/ duplizieren. Duplikate veralten: Der Code ändert sich, business/ wird nicht aktualisiert, und der Agent arbeitet mit veralteten Informationen.
Anti-Pattern 4. Fest eingetragene Zahlen. „Wir haben 1,247 Kunden bei einer Konversionsrate von 6.3 %“ - stell dir vor, das wären Zahlen eines abstrakten Fintech-Start-ups. All diese Zahlen sind in einer Woche veraltet. Verwende den LIVE-Marker und live-metrics.md. Der Abschnitt dazu steht weiter oben.
Anti-Pattern 5. Kontext ohne zugänglichen Verweis. Liegt das zweite Gehirn anderswo und fehlen dem Agenten Berechtigung oder Verweis, reicht der Start im Codeordner nicht. Für unkritische gemeinsame Notizen sind business/ und ai-clone/ im Repository praktisch. Private Informationen gehören an einen separat kontrollierten Ort mit ausdrücklich erlaubtem Zugriff und klaren Verweisen. Ein bequemer Ordneraufbau hat keinen Vorrang vor Vertraulichkeit.
Tipp
Ein separater Branch (context oder business-context) ordnet Arbeit, ist aber keine Zugriffsgrenze. Seine Dateien sind weiterhin Git-Objekte desselben Repositorys und können mit Branches oder Historie veröffentlicht werden. Nutze für privaten Geschäftskontext ein eigenes privates Repository oder einen externen Speicher mit ausdrücklichen Zugriffsregeln und erlaubten Agentenverweisen. Ein Submodul kann auf ein privates Repository zeigen; geschützt wird es durch dessen Berechtigungen, nicht durch das Submodul selbst. Möglich ist auch ein bewusst ignorierter lokaler Ordner mit eigenem Backup. Das Ignorieren entfernt weder bereits erfasste Dateien noch veröffentlichte Historie. Speichere nur teilbaren Kontext beim Code.
Wie du ein zweites Gehirn in einer Stunde aufbaust - eine Schritt-für-Schritt-Anleitung
Wichtigster Punkt
Du kannst in einer Stunde ein minimales zweites Gehirn einrichten: Erstelle die Stammordner business/ und ai-clone/, lege in jedem eine INDEX.md-Übersicht an, füge eine kurze Produktbeschreibung unter business/products/, eine Kundenbeschreibung unter audience/ und eine Beschreibung deiner Person in ai-clone/role.md hinzu. Ergänze Verweise auf diese Ordner in CLAUDE.md. Erweitere die Struktur anschließend bei der Arbeit: Nach jedem Fehler des Agenten kommt eine Regel in ai-clone/feedback/, nach jeder Entscheidung eine Notiz in business/.
Erstelle zwei Stammordner
Im Projektstammverzeichnis, neben
src/:mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style}Erstelle eine INDEX.md als Ordnerübersicht
business/INDEX.mdist eine Tabelle „Frage → Datei“. Beginne mit mindestens 5 Zeilen und füge nach und nach weitere hinzu. Mach dasselbe inai-clone/INDEX.md.Füge kurze Beschreibungen des Produkts und des Kunden hinzu
business/products/main.md- was das Produkt ist, für wen es gedacht ist, wie viel es kostet und wodurch es sich unterscheidet. 30-50 Zeilen.business/audience/avatar.md- wer der Kunde ist, welche Probleme er hat und was er kauft. 30-50 Zeilen. Beschreibe keinen idealen Kunden, sondern einen echten. Wenn du etwas nicht weißt, markiere es mit „zu klären“ und fahre fort.Beschreibe dich selbst in ai-clone/role.md
Wer du bist, was du tust und was dir wichtig ist. 20-30 Zeilen. Das genügt für den Anfang. Ergänze Ton, Prinzipien und Tabuwörter, sobald dir auffällt, dass der Agent in einem Stil schreibt, der nicht deinem entspricht.
Ergänze Verweise in CLAUDE.md
Öffne
CLAUDE.mdund füge einen Abschnitt hinzu:## Projektübersicht - Geschäftskontext → `business/INDEX.md` - Kontext über mich → `ai-clone/INDEX.md` - Technische Pläne → `plans/YYYY-MM-DD-*.md` - Rückblicke auf vergangene Sitzungen → `retrospectives/` Lies `ai-clone/INDEX.md` und `business/INDEX.md` immer zu Beginn einer Sitzung.Starte Claude Code und prüfe es
Öffne den Agenten. Frage: „Erzähl mir von meinem Produkt und meiner Zielgruppe.“ Wenn er aus dem Ordnerkontext antwortet, funktioniert es. Wenn er sich Dinge ausdenkt, prüfe, ob sich die Ordner neben dem Projekt befinden, ob die Dateien korrekt benannt sind und ob die Verweise in
CLAUDE.mdpräzise formuliert sind.
Danach wächst das zweite Gehirn nach zwei Prinzipien.
Erstens: Füge jedes Mal eine Regel hinzu, wenn der Agent einen Fehler macht. Nach 3-4 Wochen enthält ai-clone/feedback/ 15-20 Regeldateien, und der Agent macht die meisten häufigen Fehler nicht mehr.
Zweitens: Halte jede geschäftliche Entscheidung in business/ fest. Wenn du den Preis erhöhst, ergänze business/products/pricing.md um eine Notiz mit Datum und Begründung. Wenn du die Positionierung änderst, ergänze business/company/about.md. Sechs Monate später hast du ein Archiv, das sich an das „Warum“ erinnert.
Prompt: Sofort einsetzbarer Prompt für eine abendliche Aktualisierung des zweiten Gehirns
Wir haben diese Woche gemeinsam eine beträchtliche Menge an Arbeit erledigt.
Analysiere alle Codeänderungen und Commits, die wir diese Woche gemacht haben.
Welche wertvollen Informationen daraus sollten in business/ stehen? Schreibe sie in die passenden Dateien
und ergänze Wiki-Links zu benachbarten Dateien, damit der Kontext nicht verloren geht.
Wenn es im Code Entscheidungen gibt, die ich nicht erklärt habe, frage mich nach dem Warum
und halte die Begründung mit dem Datum in der passenden Datei fest.
Dupliziere nichts, was aus dem Code bereits offensichtlich ist. Nimm nur auf, was der Agent
in der nächsten Sitzung ohne business/ nicht wissen würde.
Was kommt als Nächstes - Skills, Subagents und Context Engineering
Wichtigster Punkt
Ein zweites Gehirn plus CLAUDE.md bildet die Grundlage. Darauf aufbauend kommen Skills (prozedurales Wissen, das je nach Aufgabenbeschreibung bei Bedarf geladen wird), Subagents (isolierte Claude-Instanzen mit eigenen Kontextfenstern für anspruchsvolle Aufgaben) und Context Engineering (die Verwaltung dessen, was in das Fenster gelangt). Das sind die drei oberen Stockwerke. Ohne das Fundament funktionieren sie nicht - der Agent hat nichts zu lesen.
Sobald das zweite Gehirn eingerichtet ist, gibt es noch drei weitere Tools, die Anthropic als drei verschiedene Ebenen der Kontextoptimierung beschreibt.
Skills sind prozedurales Wissen. Wenn du einen Arbeitsablauf wiederholst (einen Lernleitfaden schreiben, einen Telegram-Beitrag erstellen, eine Website prüfen), kannst du ihn in einer SKILL.md-Datei mit einer Aufgabenbeschreibung festhalten. Zu Beginn einer Sitzung scannt Claude die Namen und Beschreibungen der Skills und lädt nur diejenigen, die zur aktuellen Aufgabe passen. Das spart Tokens und hält den Fokus.
Subagents sind isolierte Claude-Instanzen mit eigenen Kontextfenstern. Starte einen Subagenten für eine anspruchsvolle Aufgabe (30 Dateien lesen und eine Zusammenfassung erstellen); er arbeitet in seinem eigenen Fenster und gibt nur das Ergebnis zurück. Dein Hauptfenster bleibt frei. Anthropic schreibt:
Spezialisierte Subagents können klar umrissene Aufgaben in sauberen Kontextfenstern lösen. [...] Jeder Subagent kann umfassend recherchieren und Zehntausende Tokens oder mehr verwenden, gibt aber nur eine komprimierte, destillierte Zusammenfassung seiner Arbeit zurück (oft 1,000-2,000 Tokens).
Context Engineering bedeutet, zu steuern, was überhaupt in das Fenster gelangt. Anthropic bezeichnete es 2025 als grundlegende Fähigkeit für die Arbeit mit Agenten, eine Ebene über Prompt Engineering. Prompt Engineering bedeutet, die Formulierung zu wählen. Context Engineering bedeutet, Dateien, Verweise, Skills und Subagents auszuwählen.
Ein zweites Gehirn ist der erste Baustein von Context Engineering. Ohne eines lesen Skills einen leeren Raum, Subagents haben keinen Anlaufpunkt und das Fenster des Agenten füllt sich mit zufälligen Informationen. Mit einem zweiten Gehirn kommen alle drei Tools zum Einsatz.
Nächster Schritt. Erstelle neben dem Projekt zwei Ordner: business/ und ai-clone/. Lege in jedem eine INDEX.md mit 5 Zeilen als Übersicht an. Ergänze vier Verweiszeilen in CLAUDE.md. In einer Stunde hast du ein funktionierendes Grundgerüst für ein zweites Gehirn. Erweitere es dann nach der Regel: „Füge nach jedem Fehler des Agenten eine Zeile zu ai-clone/feedback/ hinzu.“ Die vollständige CLAUDE.md-Vorlage für Verweise auf das zweite Gehirn erkläre ich im Leitfaden So richtest du CLAUDE.md richtig ein.
Quellen
- Claude-Code-Dokumentation zu Memory - offizielle Dokumentation von Anthropic zur Erinnerungshierarchie von Claude Code
- Best Practices für Claude Code - offizielle Anleitung zur Arbeit mit CLAUDE.md
- Effektives Context Engineering für KI-Agenten - Anthropic Engineering: eine Erklärung zu context rot, dem Aufmerksamkeitsbudget und Just-in-time-Kontext
- Skills erklärt - Anthropic-Blog: die Unterschiede zwischen Skills, Memory, Subagents und MCP
Entdecke Ailoot weiter unter ailoot.ai.
Weitere Details
Fragen und Antworten
Hält ein anderer Git-Branch Geschäftskontext privat?
Nein. Er gehört zum selben Repository; seine Dateien können mit dessen Objekten und Historie geteilt werden. Nutze einen separat kontrollierten privaten Speicher oder einen bewusst ignorierten lokalen Ordner mit Backup. Ignorieren löscht keine bereits erfasste Historie.
Wie findet der Agent privaten Kontext außerhalb des Code-Repositorys?
Gib einen ausdrücklichen Verweis und nur die für die Aufgabe nötigen Zugriffsrechte. Ein kurzer Index soll zum passenden Dokument führen. Prüfe, dass der Agent die erlaubte Datei lesen kann. Ein privater Ort ohne Verweis liefert nicht automatisch Kontext.