Marktmannen wiki Context Engineering en Geheugen

Geheugen en Context

Laatst bijgewerkt

TL;DR: Vier geheugenlagen (CLAUDE.md → brand context → sessiegeheugen → cross-sessie) lossen het "elke sessie bij nul beginnen"-probleem op en maken AI-output consistent.

Contextbeheer is het fundament van elk goed Agentic OS. Zonder het juiste systeem start elke AI-sessie bij nul.

De 4 geheugenlagen

Laag 1: CLAUDE.md (Sessie-instructies)

Het identiteitsbestand van de agent. Wordt bij elke sessie geladen (CLAUDE.md-bestanden in submappen pas wanneer Claude daar bestanden opent). Het is context, geen afdwingbare configuratie; houd het onder ~200 regels. - Wie de agent is, hoe hij zich gedraagt - Welke regels hij volgt - Geïnstalleerde patronen en learnings (groeit via Compound Engineering)

Laag 2: Brand Context (Statische business-context)

Een gedeelde map met bedrijfscontext die zelden verandert: - Brand voice & voice profile - ICP (Ideal Customer Profile) - Positionering & marktboodschap - Klantdetails

Staat op één plek; alle skills trekken eruit. Update op één plek → alle skills profiteren.

Laag 3: Sessiegeheugen (Context Mode)

Context Mode houdt de huidige sessie schoon door: - Raw tool-output te routeren via een sandbox (alleen het relevante deel terug in context) - Alle events te tracken in een lokale SQL-database - Na context-compactie een sessie-snapshot te rebuilden

Volgens de maker is zonder Context Mode na 30 minuten zo'n 40% van je context opgebruikt door tool-output, en scheelt de sandbox tot 98% daarvan. Volgens de maker (README, benchmarkregel) groeit de sessietijd daardoor van ~30 minuten naar ~3 uur; zelfgerapporteerd door de leverancier, niet onafhankelijk getoetst.

Laag 4: Cross-sessiegeheugen (ClaudeMem)

ClaudeMem draagt kennis over naar toekomstige sessies: - Wat er is gedaan - Welke beslissingen zijn genomen - Wat heeft gewerkt - Lopende projecten

Context Rot

Definitie: Het fenomeen waarbij Claude halverwege een lange sessie requirements vergeet, corners cut, en outputs produceert die doen alsof taken klaar zijn terwijl dat niet zo is.

Oorzaak: Het contextvenster raakt vol met raw tool-output (logs, snapshots, API-responses).

Oplossing: Context Mode (de bron noemde ook GSD, inmiddels gearchiveerd).

Identity Files per Tool

Tool Identiteitsbestand
Claude Code CLAUDE.md (leest ook AGENTS.md, zie hieronder)
OpenClaw SOUL.md (persona) + AGENTS.md (instructies)
Codex / anderen AGENTS.md

Zelfde idee, andere naam: het bestand wordt elke sessie meegeladen zodat de AI relevant reageert. In Claude Code komt CLAUDE.md niet in de systeemprompt maar als bericht ná de systeemprompt.

AGENTS.md in Claude Code: vanaf v2.1.277 leest Claude Code AGENTS.md rechtstreeks, maar alleen als er geen CLAUDE.md, .claude/CLAUDE.md of CLAUDE.local.md is. Heb je beide, importeer dan @AGENTS.md vanuit je CLAUDE.md, of zet in /config de instelling Project instructions op claude-md-and-agents-md.

De vier functies van CLAUDE.md

CLAUDE.md is meer dan een instructiebestand — het vervult vier functies tegelijk:

  1. Kennis-compressie — in plaats van elke sessie alle bestanden te lezen, vat CLAUDE.md de werkruimte samen op een hoog niveau (in het voorbeeld van Nick Saraev ~45x compressie t.o.v. de broncode)
  2. Persoonlijke voorkeuren — conventies die niet standaard in Claude Code zitten (bestandspaden, programmeerstijl, wanneer documentatie te raadplegen)
  3. Capaciteiten-declaratie — wat de agent al kán binnen deze workspace, zodat Claude niet onderschat wat het zelf kan uitvoeren
  4. Logboek van successen en fouten — een groeiend "lab notes"-bestand met wat niet te proberen, zodat elke volgende sessie sneller is dan de vorige

Global vs. local CLAUDE.md

Scope Locatie Inhoud
Global ~/.claude/CLAUDE.md Hoog-niveau redeneerstrategieën, persoonlijke context (wie ben je, wat doe je), token-conservatie-regels
Project ./CLAUDE.md of ./.claude/CLAUDE.md in de repo/project Laag-niveau projectkennis, API-documentatie, projectspecifieke conventies
Local (persoonlijk) ./CLAUDE.local.md, in .gitignore Eigen projectvoorkeuren die je niet incheckt

Daarnaast kun je regels per bestandstype in .claude/rules/ zetten en andere bestanden binnenhalen met @pad-imports.

/init analyseert de codebase en maakt een project-CLAUDE.md met build-commando's, testinstructies en conventies; bestaat er al een, dan stelt het verbeteringen voor. Met CLAUDE_CODE_NEW_INIT=1 wordt het een interactief traject.

De update-loop: lokaal en globaal

Lokale loop: plan een feature → Claude bouwt (faalt en slaagt onderweg) → compileer de learnings → werk de lokale CLAUDE.md bij. Elke iteratie wordt sneller omdat de zoekruimte van mogelijke fouten kleiner wordt.

Globale loop (via /insights): na meerdere lokale loops maakt /insights een HTML-rapport over je recente sessies op deze machine (max. 200 nog niet geziene sessies per run; het rapport wordt na cleanupPeriodDays, standaard 30 dagen, verwijderd) en brengt terugkerende patronen naar boven ("Claude gaat consequent een verkeerde richting op bij X"). Een mens reviewt dit handmatig — fouten stapelen zich anders op (0.9³ ≈ 73% slaagkans bij drie opeenvolgende AI-stappen van elk 90%) — en voegt de hoog-informatiedichte bullets toe aan de globale CLAUDE.md.

Automemory (#9 in de feature-ranking)

In Nate Herks ranking van Claude Code-features (zie Claude Code Functie-overzicht) staat automemory op #9. Officieel heet het auto memory: notities die Claude zelf schrijft op basis van je correcties en voorkeuren, zonder dat je er expliciet om vraagt. Er zijn vier typen (user, feedback, project, reference); de eerste 200 regels of 25KB van MEMORY.md laden elke sessie. Aan/uit via /memory (autoMemoryEnabled). De video noemt het "voorheen autodream" en beschrijft een achtergrondproces op vaste intervallen; die naam en dat interval staan niet in de docs.

Dit automatiseert een deel van ClaudeMem (Laag 4 hierboven): waar ClaudeMem kennis overdraagt naar toekomstige sessies, legt auto memory zelf learnings vast. Eigen interpretatie: dat overlapt deels met wat je anders handmatig via de globale update-loop verzamelt; /insights zelf levert alleen een rapport met suggesties en schrijft geen geheugen. Vergelijkbaar idee, andere bron: zie de "Mem search"-functionaliteit in Hermes Agent.

Praktische tip: laat AI je interviewen

In plaats van je identiteitsbestand vanaf nul schrijven:

"Ik bouw mijn identiteitsbestand. Stel me 15 vragen over hoe ik werk, wat ik wil, wat ik niet wil, hoe ik wil dat je reageert."

De antwoorden worden je user.md of personality.md.

Verwante concepten

Bronnen

#context #geheugen #architectuur

Backlinks