Een tweede brein in Claude Code: zo bouw je de structuur in een uur

Ailoot-naslagdocumentatie: ailoot.ai/docs/.

Waarom heeft Claude Code een tweede brein nodig en wat is essentieel?#

Je opent Claude Code op dinsdag. Je legt uit: dit is het project, dit is de doelgroep, doe dit niet. Jullie werken samen. Op donderdag is het een nieuwe chat en moet je alles weer opnieuw uitleggen.

Als je een CLAUDE.md hebt, heb je de eerste frustratie opgelost. De basisregels en projectbeschrijving staan in één bestand en worden in elke sessie geladen. Ik heb uitgelegd hoe dit bestand werkt in mijn handleiding voor CLAUDE.md - lees die eerst om de basis op orde te brengen.

Maar CLAUDE.md is een handleiding voor een nieuwe medewerker. Hoe je je moet kleden, welke toon je bij klanten gebruikt, welke opdrachten je voor publicaties gebruikt. Dat is niet genoeg om goede beslissingen over het project te nemen. Daarvoor is kennis nodig: wat het product is, wie de doelgroep is, hoe de financiën werken, wat je hebt geprobeerd en wat niet werkte.

In de ervaring van de auteur die hier wordt beschreven, bevond die kennis zich vroeger op vier plekken: in diens hoofd, in Telegram-chats, in Google-documenten en in het hoofd van medewerkers. Een maand na een beslissing wist niemand meer waarom die was genomen. Een nieuw teamlid was een uur bezig met vragen aan het team om op gang te komen. Claude maakte helemaal geen deel uit van die context.

Vóór het tweede brein betekende elke sessie, volgens de beschreven ervaring van de auteur, dat opnieuw moest worden uitgelegd wie de klant was, hoe het aanbod was opgebouwd en welke provider de betalingen afhandelde. Met business/ open ik een chat en zeg ik: “werk het aanbod bij voor het nieuwe prijsplan” - Claude gaat zelf naar business/company/legal.md, leest de vereisten en gaat daarna naar business/products/pricing.md, ziet het nieuwe prijsplan en stelt in één keer een aanpassing voor. De opstartuitleg is niet meer nodig; de context wordt automatisch geladen.

Anthropic noemt dit probleem contextrot in zijn engineeringblog:

Met andere woorden: hoe meer je in het venster stopt, hoe slechter de agent met details kan werken. De oplossing is een structuur van externe bestanden die Claude op eigen initiatief kan raadplegen wanneer een specifieke vraag daarom vraagt. Dat is een tweede brein.

Wat is een tweede brein en hoe is het toepasbaar op Claude?#

Doorgaans draait een tweede brein om productiviteit in het algemeen: mensen maken een Obsidian-kluis en voegen fragmenten uit boeken, notities van gesprekken en projectideeën toe.

Toen de auteur dit idee toepaste op het werken met Claude Code, ging het niet langer over productiviteit, maar over agentarchitectuur.

Bij de klassieke aanpak is het tweede brein van jou en raadpleeg je het handmatig. Bij het werken met Claude Code wordt het tweede brein tweerichtingsverkeer: zowel jij als de agent heeft er toegang toe. Dat verandert de eisen aan de indeling.

Omdat de agent er zelf toegang toe heeft, moeten bestanden in een formaat staan dat hij zonder aparte integratie begrijpt. Markdown is ideaal: tekst, een hiërarchie van koppen en links tussen bestanden. Notion en Google Docs zijn niet geschikt. Je kunt ze koppelen via MCP, maar dat voegt een extra laag toe, nog een token per verzoek en nog een mogelijk storingspunt.

Omdat de bestanden in het bestandssysteem naast het project staan, vallen ze automatisch binnen het bereik van Claude Code. Er is geen configuratie nodig. Start de agent in de projectmap en hij kan alle bestanden daarin zien. Het is gratis en werkt direct.

Welke geheugenhiërarchie heeft Claude Code standaard?#

Laten we, voordat je zelf iets toevoegt, bekijken wat Claude zonder jouw hulp kan onthouden. Anthropic beschrijft in zijn officiële documentatie twee mechanismen: CLAUDE.md (regels die je zelf schrijft) en automatisch geheugen (lessen die Claude zelf opschrijft). Beide worden aan het begin van elke sessie geladen.

CLAUDE.md wordt op vier plekken tegelijk gezocht:

Alle vier bestanden worden in de context geladen. Hoe specifieker het niveau, hoe hoger de prioriteit. Het lokale bestand wordt als laatste gelezen, dus de regels daarin hebben voorrang op alle andere.

Een CLAUDE.md-bestand kan ook in elke map binnen het project staan. Wanneer Claude een bestand uit een submap leest, laadt het de CLAUDE.md van die submap op verzoek. Dit is handig in een monorepo: frontendregels staan in frontend/CLAUDE.md, backendregels in backend/CLAUDE.md, en ze worden alleen geladen wanneer de agent aan dat deel werkt.

Automatisch geheugen verscheen in Claude Code 2.1.59. Dit zijn bestanden die Claude over jou schrijft:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Index, geladen in elke sessie (200 regels of 25KB)
├── debugging.md       # Gedetailleerde notities (op verzoek geladen)
├── api-conventions.md
└── ...

Anthropic beschrijft het zo in de officiële documentatie:

Automatisch geheugen wordt ingeschakeld met de vlag autoMemoryEnabled in ~/.claude/settings.json. Claude bepaalt zelf wat het daar opschrijft. Je kunt MEMORY.md lezen en handmatig bewerken - het is gewone markdown.

CLAUDE.md of een tweede brein - waar trek je de grens?#

Dit is de vergelijking die ik in lezingen gebruik: stel je voor dat je een nieuwe medewerker hebt aangenomen. Wat geef je die op de eerste werkdag?

Een handleiding: hoe je je moet kleden, wanneer je moet komen, welke toon je bij klanten gebruikt, via welk systeem je publiceert. Het is een kort document. Het legt niet uit wat je doet of waarom. Het zegt alleen hoe je je moet gedragen.

Daarnaast geef je toegang tot de bedrijfswiki. Die legt uit wat het product is, voor wie het is, wie de doelgroep is, wat de prijs is en waarom, wie de concurrenten zijn en welke fouten je hebt gemaakt. Het is een uitgebreid archief. Niemand leest alles; je gaat erheen voor een specifieke vraag.

CLAUDE.md = handleiding. Tweede brein = wiki. Je hebt beide nodig.

Het onderscheid is eenvoudig. Zet alles wat relevant is voor elke taak in CLAUDE.md:

• Wie de agent in dit project is (helper, leider, assistent)
• In welke taal hij moet antwoorden
• De toolstack
• Publicatieopdrachten
• Verboden (gebruik geen lange gedachtestreepjes, voer git push --force niet uit)
• Routering: waar zakelijke context en waar principes te vinden zijn

Zet alles wat alleen op verzoek nodig is in het tweede brein:

• Het product, de doelgroep, de financiën en de doelen
• Concurrenten en de markt
• Eerdere beslissingen en de redenen daarvoor
• Klantvoorbeelden en beoordelingen
• Principes en methodologie

Anthropic maakt hetzelfde onderscheid in zijn documentatie:

Skills zijn een manier om kennis voor bepaalde situaties op te slaan. Een map business/ naast het project is een andere. Ik gebruik beide en licht ze hieronder verder toe.

Waaruit bestaat een projectbrein - 5 delen plus een tijdmachine#

Een voorbeeldarchitectuur uit de ervaring die de auteur beschrijft:

Het belangrijkste methodologische punt is ai-clone/ en business/ gescheiden houden.

business/ beantwoordt de vraag “wat doen we?” Product, doelgroep, prijzen, concurrenten. Het gaat over het project. Als je het project morgen aan een partner overdraagt, gaat deze map mee.

ai-clone/ beantwoordt de vraag “hoe neem ik beslissingen?” Mijn principes, toon, vakmanschap en stopwoorden. Het gaat over mij. Als ik morgen een nieuw project begin, gaat deze map met mij mee.

Wil je niet alleen een tweede map opzetten, maar ook een systeem bouwen dat Claude consistent maakt? Dat is op zichzelf niet genoeg. Zonder ai-clone/ antwoordt de agent voor iedereen, niet voor jou. Zonder context engineering dwaalt hij door de hele map en verbruikt hij tokens. Het is nuttig om alle drie te verbinden: tweede brein + AI-kloon + context engineering. Dit zijn de drie pijlers zonder welke AI hallucineert.

Wat hoort er in business/ en wat niet?#

De structuur op hoofdniveau van business/ in het beschreven project van de auteur:

business/
├── INDEX.md              ← mappenoverzicht, eerst lezen
├── company/              ← missie, juridische entiteit, waarden, juridische beleidsregels
├── products/             ← producten, programma’s, prijzen
├── audience/              ← klantprofiel, segmenten, bezwaren
├── goals/                ← jaar-, kwartaal- en maanddoelen, metrics
├── economics/            ← unit economics, inkomsten, uitgaven, prognose
├── marketing/             ← kanalen, funnel, materialen, concurrenten
├── execution/            ← weekplanning, backlog
└── assets/               ← designsysteem, beoordelingen, tekstenbank

Dit is een voorbeeld uit het beschreven project van de auteur, geen dogma. Ik maak mappen wanneer dat nodig is. Ik begon met drie (products/, audience/, goals/); de andere kwamen er na 2-3 maanden bij, toen onduidelijk werd waar nieuwe dingen thuishoorden.

Het belangrijkste bestand in de map is INDEX.md. Dat is een kaart. Er staat een tabel in met “vraag → bestand” die Claude helpt bepalen waar het heen moet. Zonder die kaart verspilt de agent tokens door elk bestand achtereenvolgens te lezen.

Een voorbeeldfragment uit INDEX.md:

### Waar je dingen vindt

| Wat je nodig hebt | Waar je moet kijken |
|---|---|
| Wie onze klant is en wat diens pijnpunten zijn | `business/audience/avatar.md` |
| Producten, abonnementen en prijzen | `business/products/` |
| Doelen en metrics | `business/goals/` |
| Financiën (inkomsten, uitgaven, unit economics) | `business/economics/` |
| Promotiekanalen en materialen | `business/marketing/` |

Daarna is één regel in CLAUDE.md genoeg: “Lees voor zakelijke vragen business/INDEX.md en volg de kaart.” De agent laadt niet de hele map in de context. Hij laadt de kaart, kiest het juiste bestand en leest alleen dat.

Checklist van wat je niet in business/ moet zetten:

• Onbewerkte chatcorrespondentie. Als er een inzicht in staat, haal dat eruit en schrijf het op. Zo niet, laat het weg.
• Informatie die al in de code staat. “Betalingen lopen via CloudPayments” is niet nodig; de agent kan dat in de code zien.
• Schermafbeeldingen en afbeeldingen. Ze maken de map groter en worden niet door een tekstmodel verwerkt zonder een extra stap.
• Dynamische cijfers. “Vandaag zijn er 423 betalingen voor het product” is over een week verouderd. Gebruik de markering LIVE en een link naar een databasequery.
• Gevoelige of twijfelachtige informatie. Als de repository morgen op YouTube zou worden gepubliceerd voor 100 duizend vreemden, bewaar dan alleen wat je hun zou willen laten zien. Medewerkers, agenten en soms externe opdrachtnemers lezen de map.

Waarom een aparte map ai-clone en waarom mag die niet worden vermengd met business?#

Het idee is eenvoudig: het bedrijf weet wat we doen. De kloon weet hoe ik beslissingen neem.

De structuur van ai-clone/ in het beschreven project van de auteur:

ai-clone/
├── INDEX.md           ← mappenoverzicht
├── role.md            ← wie ik ben, achtergrond, wat belangrijk is
├── identity/          ← waarden, visie, missie
├── thinking/          ← mentale modellen uit lezingen
├── voice/             ← toon, woordenschat, stijl
├── principles/        ← overtuigingen over product, code, zaken
├── feedback/          ← regels geleerd uit fouten ← belangrijkste map
├── style/             ← stopwoorden, Telegram-indeling
└── reference/         ← tools, omgeving

De nuttigste map is feedback/. Daarin staan specifieke regels die ik heb geleerd door fouten van agents. Elke regel staat in een apart bestand met dit formaat:

---
name: short-name
description: one line - what’s in the file and when to apply it
type: feedback
---

Een korte regel in één zin.

**Waarom:** waarom deze regel bestaat. Context, incident, observatie.

**Hoe toepassen:** specifieke omstandigheden waarin de regel geldt.

Zonder “Waarom” is de regel dood - de agent past hem dan niet toe op een vergelijkbare situatie. Zonder “Hoe toepassen” is niet duidelijk wanneer de regel moet worden gebruikt.

Een voorbeeld uit mijn map: de regel “koppelteken, geen lange gedachtestreep”. Die is ontstaan omdat de lange gedachtestreep — een belangrijke visuele aanwijzing voor gegenereerde tekst is. De regel geldt voor alle teksten die voor het publiek zijn bedoeld. Het bestand staat op ai-clone/feedback/no-em-dashes.md.

Ik doe het iets anders: ik schrijf regels in ai-clone/feedback/, niet in CLAUDE.md. CLAUDE.md is een projectbestand, maar regels over toon en stijl zijn persoonlijk. Ze gaan met me mee naar het volgende project. CLAUDE.md blijft bij het project.

Wat zijn Live Metrics en waarom moet je cijfers niet hardcoderen in bestanden?#

Een van de grootste valkuilen bij het opzetten van een tweede brein is het vullen ervan met verouderde cijfers. Je schrijft “we hebben 320 klanten” en twee weken later zijn het er al 410. Je schrijft “de maandelijkse omzet is 4.7 miljoen” en een maand later ontbreekt de context bij dat cijfer: is het een doel, werkelijk resultaat of prognose?

In het voorbeeld van de auteur werkt het zo. In het bestand business/products/practicum.md staat een markering in plaats van een cijfer:

## Cohorten

> **LIVE** - voer de queries uit in de sectie “Sales” van `live-metrics.md`
> om de actuele betalingen per cohort te zien.

| Cohort | Datums | Betalend |
|-------|------|------------|
| 1 | 10-12 maart 2026 | LIVE |
| 2 | 24-26 maart 2026 | LIVE |

Een apart bestand live-metrics.md bevat direct uitvoerbare SQL-queries en beschrijvingen van de resultaten:

## Verkoop (betalingen per cohort)

```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;
```

Wanneer ik de agent vraag: “hoeveel betalingen hebben we voor het tweede cohort?”, doet hij het volgende:

1. Leest business/products/practicum.md
2. Ziet de LIVE-markering naast het cijfer
3. Opent live-metrics.md
4. Vindt de sectie “Sales”
5. Voert de query uit op de productiedatabase
6. Antwoordt met actuele gegevens

Dit lost twee problemen tegelijk op. Cijfers raken niet verouderd. En beslissingen worden genomen op basis van de huidige situatie, niet die van vorig jaar.

Hoe navigeert AI voor één verzoek door het tweede brein?#

Een specifiek verzoek, bijvoorbeeld: “schrijf een e-mail aan deelnemers over het nieuwe cohort.”

1. Claude begint met een leeg venster. Het laadt CLAUDE.md (regels, stack, routering).
2. Via de routering in CLAUDE.md ziet het: “ai-clone/INDEX.md - altijd lezen aan het begin van een sessie.” Het opent het bestand en leert wie ik ben, wat mijn toon is en welke stopwoorden ik gebruik.
3. Het ziet in de routering: “e-mailsjablonen - src/lib/email/layout.ts.” Het opent het bestand en begrijpt de indeling.
4. Het ziet: “productcontext - business/products/practicum.md.” Het opent het bestand en leest over het product.
5. Het ziet de LIVE-markering in het bestand en een verwijzing naar live-metrics.md. Het opent dat bestand en vindt de direct uitvoerbare SQL. Als het een actueel cijfer nodig heeft, voert het de query uit. Zo niet, dan noteert het: “haal dit cijfer op op het moment van verzenden”.
6. Het ziet de toonregels in ai-clone/style/telegram-format.md, het verbod op lange gedachtestreepjes in ai-clone/feedback/no-em-dashes.md en de conversiepercentages van de funnel in business/marketing/funnel.md.

Het schrijft de e-mail in mijn toon, met actuele cijfers en zonder lange gedachtestreepjes of AI-kenmerken.

Anthropic noemt deze aanpak just-in-time context in zijn engineeringblog:

Met andere woorden: Claude draagt verwijzingen naar gegevens met zich mee, niet de gegevens zelf. Dat is veel efficiënter met tokens en veel nauwkeuriger, omdat alleen relevante informatie in de context terechtkomt. Het venster blijft vrij om te redeneren.

5 antip patronen voor een tweede brein - wat moet je vermijden?#

Antipatroon 1. Een uit de kluiten gewassen CLAUDE.md. 500 regels instructies “in plaats van alles op één plek te zetten”. Anthropic is daar duidelijk over:

De aanbevolen lengte is 80-120 regels. Zet al het andere in aparte bestanden en verwijs ernaar.

Antipatroon 2. Een verzamelmap. Je gooit alles in het tweede brein: onbewerkte chatcorrespondentie, nutteloze schermafbeeldingen, rapporten die niemand leest. Een maand later is de map uitgedijd, verspilt de agent tokens aan rommel en weet je niet meer waar iets staat. De regel: elk bestand in het tweede brein moet een specifieke vraag beantwoorden. Heeft niemand het zes maanden geopend, verwijder het dan of verplaats het naar het archief.

Antipatroon 3. Dupliceren. “Betalingen lopen via CloudPayments in src/lib/payment/cloudpayments.ts; de provider is ingesteld in .env.” De agent kan dit allemaal in de code zien. Dupliceer het niet in business/. Duplicaten raken verouderd: de code verandert, business/ wordt niet bijgewerkt en de agent werkt met verouderde informatie.

Antipatroon 4. Cijfers hardcoderen. “We hebben 1,247 klanten, met een conversiepercentage van 6.3%” - stel je voor dat dit cijfers zijn van een willekeurige fintechstart-up. Al zulke cijfers zijn binnen een week verouderd. Gebruik de LIVE-markering en live-metrics.md. De sectie hierover staat hierboven.

Antipatroon 5. Context zonder bereikbare route. Staat het tweede brein elders en heeft de agent geen toestemming of verwijzing, dan is starten in de codemap niet genoeg. Voor niet-gevoelige gedeelde notities is business/ en ai-clone/ in de repository bewaren handig. Houd privécontext op een afzonderlijk beheerde locatie en stel toegestane toegang en routering expliciet in. Een handige mapindeling gaat niet boven vertrouwelijkheid.

Hoe bouw je in een uur een tweede brein - een stapsgewijze handleiding#

1. Maak twee hoofdmapmappen

   In de hoofdmap van het project, naast src/:

   mkdir -p business/{products,audience,goals,economics,marketing}
   mkdir -p ai-clone/{identity,voice,principles,feedback,style}
   

2. Maak een INDEX.md als mappenoverzicht

   business/INDEX.md is een tabel met “vraag → bestand”. Begin met minstens 5 regels en voeg er gaandeweg meer toe. Doe hetzelfde in ai-clone/INDEX.md.

3. Voeg korte beschrijvingen van het product en de klant toe

   business/products/main.md - wat het product is, voor wie het is, wat het kost en wat het onderscheidt. 30-50 regels. business/audience/avatar.md - wie de klant is, diens pijnpunten en wat die koopt. 30-50 regels. Beschrijf geen ideale klant, maar een echte. Als je iets niet weet, markeer het dan als “te verduidelijken” en ga verder.

4. Beschrijf jezelf in ai-clone/role.md

   Wie je bent, wat je doet en wat belangrijk voor je is. 20-30 regels. Dat is genoeg om te beginnen. Voeg toon, principes en stopwoorden toe zodra je merkt dat de agent in een stijl schrijft die niet bij jou past.

5. Voeg routering toe aan CLAUDE.md

   Open CLAUDE.md en voeg een sectie toe:

   ## Projectoverzicht
   
   - Zakelijke context → `business/INDEX.md`
   - Context over mij → `ai-clone/INDEX.md`
   - Technische plannen → `plans/YYYY-MM-DD-*.md`
   - Terugblikken op eerdere sessies → `retrospectives/`
   
   Lees aan het begin van een sessie altijd `ai-clone/INDEX.md` en `business/INDEX.md`.
   

6. Start Claude Code en controleer het

   Open de agent. Vraag: “vertel me over mijn product en mijn doelgroep.” Als het antwoord geeft op basis van de mapcontext, werkt het. Als het dingen verzint, controleer dan of de mappen naast het project staan, of de bestanden de juiste namen hebben en of de routering in CLAUDE.md precies is geformuleerd.

Daarna groeit het tweede brein volgens twee principes.

Ten eerste: voeg elke keer dat de agent een fout maakt een regel toe. Na 3-4 weken bevat ai-clone/feedback/ 15-20 regelbestanden en maakt de agent de meeste veelvoorkomende fouten niet meer.

Ten tweede: leg elke zakelijke beslissing vast in business/. Als je de prijs verhoogt, voeg dan aan business/products/pricing.md een notitie met de datum en reden toe. Als je de positionering verandert, voeg dan een notitie toe aan business/company/about.md. Zes maanden later heb je een archief dat onthoudt “waarom”.

We hebben deze week samen een aanzienlijke hoeveelheid werk verricht.

Analyseer alle codewijzigingen van deze week, alle commits die we hebben gemaakt.
Welke waardevolle informatie hieruit hoort in business/ thuis? Schrijf die in de juiste bestanden,
met wikilinks naar verwante bestanden zodat de context niet verloren gaat.

Als er beslissingen in de code staan die ik niet heb uitgelegd, vraag me dan waarom
ik ze heb genomen en leg de reden vast in het juiste bestand, met de datum erbij.

Dupliceer niet wat al duidelijk uit de code blijkt. Neem alleen op wat de agent
zonder business/ in de volgende sessie niet zou weten.

Wat nu - Skills, Subagents en context engineering#

Zodra het tweede brein op zijn plaats staat, zijn er nog drie tools die Anthropic beschrijft als drie verschillende niveaus van contextoptimalisatie.

Skills zijn procedurele kennis. Als je een workflow herhaalt (een leergids schrijven, een Telegram-bericht samenstellen, een website controleren), kun je die vastleggen in een SKILL.md-bestand met een taakbeschrijving. Aan het begin van een sessie scant Claude de namen en beschrijvingen van skills en laadt het alleen de skills die bij de huidige taak passen. Dat bespaart tokens en houdt de focus scherp.

Subagents zijn afgeschermde instanties van Claude met eigen contextvensters. Start een subagent voor een veeleisende taak (30 bestanden lezen en een samenvatting samenstellen), dan werkt die in zijn eigen venster en stuurt alleen het resultaat terug. Je hoofdvenster blijft vrij. Anthropic schrijft:

Context engineering is beheren wat er überhaupt in het venster terechtkomt. Anthropic noemde dit in 2025 een essentiële vaardigheid voor het werken met agents, één niveau boven prompt engineering. Prompt engineering is de formulering kiezen. Context engineering is bestanden, routes, skills en subagents kiezen.

Een tweede brein is de eerste bouwsteen van context engineering. Zonder tweede brein lezen Skills een lege ruimte, hebben Subagents nergens om naartoe te gaan en raakt het venster van de agent gevuld met willekeurige informatie. Met een tweede brein gaan alle drie tools aan het werk.

Volgende stap. Maak naast het project twee mappen: business/ en ai-clone/. Voeg aan elke map een INDEX.md met 5 regels toe die als overzicht dienen. Voeg vier routeringsregels toe aan CLAUDE.md. Binnen een uur heb je een werkend raamwerk voor een tweede brein. Breid het daarna uit volgens de regel: “voeg na elke fout van een agent één regel toe aan ai-clone/feedback/.” De volledige CLAUDE.md-sjabloon waarmee je naar het tweede brein verwijst, leg ik uit in de handleiding CLAUDE.md correct instellen.

Ontdek Ailoot verder op ailoot.ai.