Marktmannen wiki Claude Cowork en Kenniswerk

Skills, Hooks en Geheugen (AI Report)

Laatst bijgewerkt

TL;DR: Nadat je map met bestanden staat, laat je de AI het werk dóen — skills die je met één woord oproept, routines die vanzelf draaien, en twee hooks plus een sessie.md die je geheugen tussen sessies vasthouden.

Sessie 2 van de AI Report kennissysteem-reeks (Oscar Lepoeter), voortbouwend op Kennissysteem Fundering (AI Report). Het uitgangspunt volgens Oscar: skills, automatisering en geheugen werken op elke tool (Claude, Cowork, Codex) en vragen geen regel code. Dat is te ruim: persoonlijke skills (~/.claude/skills/) laden niet in Cowork of cloudsessies, en Codex is hier niet getoetst. Oscar heeft inmiddels 128 skills en schrijft ze zelden zelf — hij vraagt zijn chatbot er een te maken of haalt het jargon uit een gevonden skill. "Ik kijk hier bijna nooit naar. Ik toets alleen of het werkt."

Skills: leg je aanpak één keer vast

Een skill is een Markdown-bestand met een instructie in mensentaal, opgeroepen met één woord (/brief). Je kijkt naar de output, niet naar de skill. Werkt iets niet, dan pas je de skill aan via de chat — niet het opgeleverde bestand. Eén handigheid: een woord achter de skill kiest een variant/smaak (één skill, meerdere smaken).

De drie skills uit de ProRail-casus, in de volgorde van een drukke maandagochtend (wat weet ik al / wat moet ik nog weten / wat lever ik op):

  • brief — gespreksvoorbereiding van max één pagina uit je dossier: doel, deelnemers + rol, context, 3-5 gesprekspunten, openstaande acties en deliverables. Gebaseerd op je eigen bestanden, niet verzonnen. Aanroep: /brief prorail "Karel Donders" werkdocument.
  • research — web-onderzoek in drie snelheden (eerste woord kiest): quick (één ronde, ~2 min, zuinig), standaard (splitst de vraag, meerdere rondes), deep (uitgebreid verslag). Leest échte pagina's, vat samen mét bronlink, schrijft op verzoek weg in je map zodat het eigen context wordt.
  • rapport — brengt interviews + onderzoek samen tot een tussenrapportage. Truc: een mapje references/ in de skill (een conventie, geen vast veld) met 2-4 echte voorbeelddocumenten (puur voor schrijfstijl, niet inhoud) zodat het niet als AI-tekst leest. Output blijft Markdown; converteer pas na controle naar Word/PDF.
  • naar-markdown (helper) — zet een Word/PDF/office-bestand of URL om naar schone, volledige Markdown. Maakt rommelige bronbestanden leesbaar voor de rest van het systeem.

De gouden regel: de agent is een stagiair, jij blijft de baas. Gebruik elke output als basis, lees na, fact-check wat ertoe doet, en verbeter de skill in plaats van het opgeleverde bestand.

Automatisering: drie lagen oplopend in zelfstandigheid

  1. Skill — jij roept aan (typt het woord, drukt enter).
  2. Routine — draait op een vast tijdstip zonder dat jij iets doet. Heet per tool anders: Routines (Claude Code) en Scheduled tasks (Cowork) — twee verschillende producten — en volgens Oscar Pulse (Codex; niet geverifieerd). Géén lokale cron-taak of launch agent: Routines draaien in de cloud van Anthropic (research preview, minimaal interval 1 uur, geen toegang tot lokale bestanden) en Cowork Scheduled tasks draaien remote, ook als de computer slaapt of de app dicht is. Alleen de desktop scheduled tasks van Claude Code draaien lokaal, en dan alleen als de app open is en de computer wakker. Voorbeeld: elke ochtend 8:00 checkt het systeem je agenda op één-op-één-afspraken met externen en draait automatisch de brief-skill; de briefing staat klaar als je gaat zitten.
  3. Hook — draait op een gebeurtenis i.p.v. een tijdstip (app openen, AI klaar met antwoorden).

Je beschrijft alle drie in gewone taal aan je chatbot, die het script maakt.

Geheugen dat blijft: de twee hooks

Een chatbot vergeet tussen sessies en zijn contextvenster loopt vol. Oplossing: een geheugenbestand sessie.md (scratchpad met koppen "Laatst gedaan" en "Volgende stap") plus twee hooks:

  • Hook 1 op Stop (AI klaar met antwoorden) — herinnert de agent sessie.md bij te werken. De agent cureert zelf, dus het bestand loopt niet vol.
  • Hook 2 op SessionStart (je begint opnieuw) — laadt sessie.md weer in, zodat de agent meteen weet waar je was.

Claude Code kent vijf hook-typen (command, http, mcp_tool, prompt, agent); alleen command-hooks zijn lokale scripts. settings.json koppelt beide hooks aan de juiste momenten (pas het pad aan naar je eigen map). Belangrijk: skills en hooks kunnen globaal of project-/mapgebonden zijn. De hook schrijft naar de sessie.md in de map waarin hij draait — zo blijven projecten gescheiden (je medische aantekeningen lekken niet in je werkgeheugen). Dat is precies waarom werken-in-mappen zo aantrekkelijk is.

Waarschuwingen

  • ⚠️ Agent = stagiair, jij blijft de baas. Laat de output nooit beslissen.
  • 💡 Fact-check wat ertoe doet — skills hallucineren minder door uit jouw bestanden te putten, maar zijn niet onfeilbaar (zeker cijfers, data, citaten).
  • ⚠️ Em-dashes verraden AI-tekst. Ze sluipen er steeds in; maak een aparte skill die ze vervangt door punten/komma's/haakjes.
  • ⚠️ Privacy is niet vanzelf veilig. Lokale bestanden naar Claude sturen betekent dat ze naar de server gaan. Oplossingen in opkomst: lokale modellen (Gemma), datamaskering (bijv. Amable), inference bij NL-datacenter of Azure Sweden. Gevoelige persoonsgegevens zonder verwerkersovereenkomst? Gebruik gefingeerde namen.
  • ⚠️ Alleen skills/hooks van een vertrouwde bron — behandel als software.

Open vragen

  • Welke van de vier skills (brief/research/rapport/naar-markdown) zijn 1-op-1 bruikbaar in het Marktmannen-OS, en welke overlappen met bestaande Marktmannen-skills?

Verwante concepten

Bronnen

#niet-technisch #skills #geheugen #automatisering

Backlinks