Een kennisbank opbouwen met AI

Vandaag heb ik opgeruimd. Niet mijn bureau (dat is hopeloos), maar mijn projectenmap. Wat begon als “even die losse bestanden consolideren” werd een complete herstructurering van hoe ik kennis bewaar.

De situatie

Ik werk aan meerdere projecten tegelijk: een Zweedse taal-app, een gezondheids-tracker, een recepten-app, een statische website. Elk project heeft een LEARNINGS.md waar ik vastleg wat ik leer. Safari bugs, iOS quirks, dat soort dingen.

Het probleem? Die kennis zat verstopt. Als ik in project A een Safari-bug oploste, kon ik dat in project B niet meer terugvinden. Ik loste dezelfde problemen opnieuw op.

Herkenbaar?

Wat ik deed

Ik vroeg Claude om alle LEARNINGS.md bestanden door te lezen en te analyseren: wat zijn patronen, wat komt terug, wat is generiek genoeg om te delen?

Het resultaat was confronterend. Van de 44 learnings uit 6 projecten waren er minstens 10 die ik al eerder had opgelost. Dezelfde localStorage whitelist-bug. Dezelfde iOS Speech Recognition beperking. Dezelfde CSS variable inconsistentie.

Tijd voor een centrale kennisbank.

De nieuwe structuur

We maakten een _knowledge/ folder met thematische bestanden:

_knowledge/
  bronnen.md                  -- Externe links (WCAG, MDN, etc.)
  frontend/
    browser-quirks.md         -- Safari, iOS, MediaRecorder
    css-patterns.md           -- Variables, safe areas
    data-persistence.md       -- localStorage patterns
  devops/
    project-setup.md          -- CI/CD, GitHub Actions
    versioning.md             -- Semantic versioning
  design/
    design-principles.md      -- Kleur, a11y, modals
  audits/
    2025-12-05-audit.md       -- Project health checks

Elk bestand volgt een vast format: wanneer je dit gebruikt, wat het pattern is, waarom het werkt, waar het vandaan komt.

De opruiming

Naast de kennisbank consolideren, ruimde ik ook op. Dubbele bestanden weg, verouderde referenties geüpdatet, losse mappen samengevoegd.

De root van mijn projectenmap is nu schoon: alleen CLAUDE.md, PROJECTS.md en README.md.

De audit

Als bonus deed ik een audit van mijn twee grootste projecten: hoe goed volgen ze de standaarden uit de kennisbank?

Beide projecten scoorden rond de 80%. Goed, maar met duidelijke verbeterpunten. Die heb ik direct als GitHub issues aangemaakt.

De bronnenlijst

Ik voegde ook externe bronnen toe. Niet zomaar een linkdump, maar gecategoriseerd met uitleg:

Accessibility experts die ik volg:

• Adrian Roselli - diepgaande technische artikelen
• Heydon Pickering - creatieve oplossingen
• Rian Rietveld - Nederlandse expert

AI & Development:

• Simon Willison’s blog - eerlijke experimenten met LLMs
• Anthropic Cookbook - praktische Claude voorbeelden

UX & Content:

• GOV.UK Content Design - de gouden standaard
• Nielsen Norman Group - usability research

Plus een waarschuwing over accessibility overlays. Spoiler: gebruik ze niet.

Wat ik hiervan leerde

1. Kennis moet vindbaar zijn, niet alleen opgeschreven.

Een LEARNINGS.md per project is goed voor context. Maar generieke patterns moeten naar een centrale plek, anders vind je ze niet terug.

2. Opruimen is investeren.

Met AI duurde dit ongeveer een uur. Handmatig had het makkelijk een dag gekost. En de volgende keer dat ik een iOS Safari bug tegenkom, hoef ik niet opnieuw te googelen. Ik open browser-quirks.md.

3. Audits zijn confronterend maar nuttig.

Ik dacht dat mijn projecten goed op orde waren. De audit liet zien waar de gaten zitten. Test coverage is mijn achilleshiel.

4. AI is goed in consolideren.

Claude las 6 projecten door, identificeerde patronen, en stelde een structuur voor. Het saaie werk - bestanden vergelijken, duplicaten vinden, referenties updaten - deed de AI. Ik nam de beslissingen.

De cijfers

Wil je dit ook doen?

Drie tips:

1. Begin met je learnings. Lees ze door. Wat komt terug? Dat is je eerste kennisbestand.

2. Maak het vindbaar. Niet alles in één bestand. Thematische bestanden met duidelijke namen.

3. Audit jezelf. Schrijf op wat je standaarden zijn, en check of je projecten eraan voldoen. De gaps worden vanzelf zichtbaar.

Opruimen is niet sexy. Maar het voelt wel lekker als het klaar is.