Zo bouw je een AI-logboek met een mappenstructuur
Jop van Hooft, eCommerce AI Club
Uit de sessie: AI Champion meeting feb 2026
Na een vraag uit de groep legt Jop van Hooft in de AI Champion-meeting van februari 2026 uit hoe zijn AI-logboek in elkaar zit. In ruim een minuut hoor je de mappenstructuur, de logboekindex met één regel per taak en de skill die elke sessie samenvat en naar GitHub schrijft.
Voor wie: Je wilt dat je AI-assistent onthoudt wat je eerder deed, en zoekt een simpele structuur om mee te beginnen.
Waarom dit ertoe doet
Een AI die niets onthoudt, moet je elke keer opnieuw uitleggen wie je klant is en wat je vorige maand besloot. Jop van Hooft lost dat op met een eenvoudige structuur: mappen per klant, een index met één regel per afgeronde taak en per taak een detailpagina in markdown. Het model leest eerst de korte index en opent alleen het document dat ertoe doet. Dat scheelt ruimte in het werkgeheugen van het model en tijd voor jou. Hij houdt zo'n logboek sinds ongeveer twee maanden bij. Voor een webshopteam is het een goedkope manier om kennis van medewerkers vast te leggen, met tools die gratis of al in huis zijn.
Belangrijkste inzichten
- Jop van Hooft laat Claude werken in een mappenstructuur met een map per klant en mappen voor zijn werkwijzen.
- De logboekindex heeft 1 regel per afgeronde taak, met per taak een eigen md-pagina.
- Het model zoekt eerst in de korte index en opent alleen het relevante document.
- Een /logboek-skill vat elke sessie samen, schrijft 1 regel naar de index en commit naar GitHub.
- Jop houdt het logboek sinds ongeveer 2 maanden bij en zegt dat het hem weinig moeite kost.
De mappenstructuur als geheugen
Jop van Hooft laat Claude werken in een vaste mappenstructuur. Elke klant heeft een map en er zijn meer mappen voor zijn manieren van werken. Hij heeft vastgelegd hoeveel lagen diep het model in een map moet kijken. Zo heeft het model 'een soort structuur in zijn hoofd': dit is mijn geheugen, hier staat alles. In Claude Code kun je zo'n afspraak vastleggen in een CLAUDE.md-bestand in de hoofdmap, dat het model bij elke sessie leest.
Index en detailpagina's
Een van de mappen heet logboek. Daarin staat een index waarin elke afgeronde taak in één regel wordt beschreven. Bij elke regel hoort een volledige pagina, een md-bestand, met de details. Krijgt Jop een vraag over klant X, dan zoekt het model eerst in de korte index en opent daarna alleen het bijbehorende document. Daarmee kent het de hele historie van dat onderwerp. Dit patroon, eerst een korte inhoudsopgave en dan pas het detail, voorkomt dat het model alles tegelijk moet lezen.
De /logboek-skill
Aan het eind van elke Claude Code-sessie typt Jop /logboek. Die skill vraagt het model het gesprek samen te vatten volgens een paar eisen, één regel naar de index te schrijven en alles naar GitHub te committen. Een skill is volgens Anthropic een map met instructies, scripts en bronnen die Claude laadt als ze nodig zijn. GitHub zorgt voor versiebeheer: je ziet wat wanneer is toegevoegd en kunt terug naar een eerdere versie.
Klein beginnen
Jop zegt zelf dat het 'geen rocket science' is. In de sessie belooft hij een generieke versie van zijn instructie te delen. Later in dezelfde sessie raadt hij aan om simpel te beginnen: log je eigen werk, laat de AI elke vraag meeschrijven naar Notion, een wiki of een map, en kies het definitieve formaat later. Let op wat je vastlegt: klantgegevens en wachtwoorden horen niet in een repository die anderen kunnen lezen. Houd de index kort en consequent: één regel met datum, klant en uitkomst is genoeg, want de details staan in het bijbehorende bestand. Test het na een week met een echte vraag: kan het model zonder jouw hulp terugvinden wat je vorige maand besloot?
Probeer dit deze week
- Maak een map logboek met een index.md en schrijf daar na elke AI-sessie 1 regel in.
- Leg per afgeronde taak een md-bestand aan met vraag, aanpak, besluit en resultaat.
- Zet het logboek na 2 weken in een privé Git-repository zodat je versies bewaart.
Begrippen
- Logboekindex
- Kort overzicht met één regel per afgeronde taak, met een verwijzing naar de details.
- Markdown (md)
- Eenvoudig tekstformaat met koppen en lijsten dat mensen en AI goed kunnen lezen.
- Commit
- Een opgeslagen versie van wijzigingen in Git, met datum en omschrijving.
- CLAUDE.md
- Bestand in een projectmap met vaste instructies die Claude Code bij elke sessie leest.
Verdiep je in de gids
Transcriptie
Uitgeschreven uit de audio van dit fragment. Stopwoorden en herhalingen zijn weggelaten. Waar [onverstaanbaar] staat, is de opname niet te verstaan.
En het is op zich, is het geen rocket science, op hoofdlijnen is het gewoon, ik laat Claude in bepaalde mappenstructuur werken, ik heb dus mapjes aangemaakt voor de manieren waarop ik werk, dus elke klant is een mapje, elke data is een mapje, en daar heb ik gespecificeerd van hoeveel lagen dat die in een mapje goed duiken, dus hij heeft een soort van structuur in zijn hoofd van, hey, dit is mijn geheugen, hier zit alles in, en een van die mapjes heet logboek, Daar zit een logboekindex in, waar hij gewoon in één regel uitlegt van, hé, dit is de taak die ik heb gedaan. En bij elke index hoort een hele pagina, een MD-documentje, waarop detailje ingegaan wordt. Dus hij kan razendsnel even kijken in al die éénregelige logboekentries van, wat is er gebeurd afgelopen tijd. We hebben nu een vraag over een voorkast van klant X, zoek die even op. En dan pakt hij vervolgens dat document erbij, en dan weet hij de hele historie van dat ding. Dus zo maak je dat hij heel snel bezoekbaar is. En los daarvan heb ik gewoon een skill geschreven. Slash logboek. Die typ ik aan het einde van elke Claude Code sessie. En die skill zegt van. Ja, vat het gesprek samen wat je zojuist hebt gehad. Daar heb ik een paar eisen aan gesteld. Hoe ik dat dan moet samenvatten. En schrijf één regel weg naar de index. En commit alles wat we hebben gedaan naar GitHub. En we hebben eigenlijk alles compleet. Een mappenstructuur waar alles in staat.
Spreker: Jop van Hooft, eCommerce AI Club
Bronnen
Meer over AI Implementatie
Duur 1:09Walmart: meer omzet, minder mensen
Tachmy Dilmy, eCommerce AI Club
Walmart draait 600 miljard omzet, met steeds minder mensen
Duur 0:57YourSurprise: vier AI-doelen voor het hele bedrijf
Arne Timmerman, YourSurprise
Vier bedrijfsbrede AI-doelen, zo pakt YourSurprise het aan
Duur 1:40Context Window: van 2K naar 2 miljoen tokens
Jop van Hooft, eCommerce AI Club
Van enkele pagina's naar 10 boeken tegelijk in je AI-model, en dat verandert alles