The Agentic Nephew.

Toen ik zeventien was had ik een krantenwijk, en daar deed ik iets mee waar ik maar half trots op ben.

Ik kwam erachter dat de wijk niet één klus was, maar twee. Er waren de makkelijke adressen, dicht bij elkaar in de buurt, die je zonder nadenken op de fiets deed. En er waren de verre adressen, verspreid over de rand van de stad, waar je eigenlijk een motor voor wilde hebben. Dus vroeg ik een paar andere kinderen de makkelijke adressen op de fiets te doen. De verre nam ik zelf, op mijn brommer. En ik hield drie keer zoveel per adres over als zij kregen.

Niet bepaald een mooi verhaal. Ik ben me ervan bewust.

Maar het principe klopt, en het is het principe waar ik dit jaar steeds op terugkom. Eén iemand die de hele wijk begreep, verdeelde het werk, koppelde elk deel aan het juiste voertuig, en gaf de simpele klussen aan mensen die niet de hele wijk hoefden te begrijpen om ze goed te doen. Ik had er toen het woord niet voor. Nu zou ik mezelf de orchestrator noemen, en de kinderen uit de buurt sub-agents.

Ik begin hiermee omdat de AI die de meesten van ons gebruiken precies dit is gaan doen, uit zichzelf, zonder te vragen. En de meeste mensen hebben dat nog niet door.

Wat er in de harness zit

De harness geeft de neef vier dingen. Elk heeft een technische naam die je in de documentatie tegenkomt, en elk heeft een gewone betekenis die voor jou nuttiger is.

Een handleiding. Dit heten skills. Zie het als een encyclopedie waarin hij dingen kan opzoeken, zodat hij niet elke keer alles opnieuw hoeft te verzinnen of te leren. Als hij naar de buurtwinkel gaat om eten te halen, staat er een hoofdstuk over hoe je eten koopt en wat een goede prijs is. Bij de kassa staat een hoofdstuk over betalen. Technisch gezien is een skill een vaste set instructies, geschreven voor één soort taak, die elke keer naar het model wordt gestuurd als je iets op dat gebied vraagt. (Zelf een skill schrijven is makkelijker dan het klinkt. Ik begin met een lijst van wat alleen ik doe, in The Only-Me List.)

Een klok. Dit heten loops, schema's of cron jobs, zoals het in Linux heet. Je neef raakt, zoals veel tieners, afgeleid. Als hij klaar is, of denkt dat hij klaar is, dwaalt hij weg en doet hij iets anders. Of, wat jou betreft, niets. De klok is een timer plus een memo. Elke keer dat de wekker gaat, moet hij het memo opnieuw lezen, en het memo zegt: je werkt nog steeds voor je tante of oom, en je hebt de missie om X te doen. Technisch is het een prompt die elke paar minuten draait en de agent weer in beweging zet. Dit is het echte verschil met een model gewoon iets laten bouwen. Een enkel verzoek eindigt als het model besluit dat het klaar is. Een klok brengt het terug.

Een werkruimte. Dit zijn mappen, soms repo's (repositories, mappen met versiegeschiedenis ingebouwd), waar de agent werkt en bijhoudt wat er veranderde. Zie een nieuwe werkruimte niet als je neef ergens anders naartoe sturen. Zie het als een volledig nieuwe neef. Hij weet niet wat de andere wist. Dat blijkt heel veel uit te maken, zoals je zult zien.

Sleutels. Dit heten connectors, en ze komen in vele vormen: MCP-connectors, plug-ins, API's die op je netwerk draaien, webhooks. In gewone taal zijn het laden waarvan je hem de sleutel geeft. Telefoonnummers. Hulplijnen. Misschien zelfs je bankpas. Alles wat je hem laat gebruiken terwijl hij je helpt. En dat deelt hij allemaal met zijn broers en zussen.

Dat laatste is weer de krantenwijk. Harnesses verdelen het werk standaard: een orchestrator-rol die de hele wijk vasthoudt, en sub-agent-rollen die de makkelijke adressen nemen. Je hoeft dit niet in te stellen. Je moet wel weten dat het gebeurt.

Truc één: zeg het lui, en laat hem dan het plan schrijven

De meeste harnesses doen zelf al een versie hiervan, maar iedereen zou het idee moeten kennen: briefing, dan een bouwplan, dan een implementatieplan, voordat er iets gebouwd wordt.

De luie prompt. Je komt nu weg met een vraag op hoofdlijnen. Wat telt is wat je hem daarna laat doen.

“Ik wil graag dat je een executive dashboard voor me bouwt. Interview me met vragen tot je alle informatie hebt die je nodig hebt om terug te komen met een goed eerste voorstel voor een bouwplan.”

Je krijgt dan een reeks vragen terug. Sommige modellen schetsen ook snel wat visuals. Neem hier de tijd voor. Hier controleer je of hij begrijpt wat je wilt en nodig hebt, en of hij weet welke databronnen hij echt kan bereiken. Als hij niet weet waar de data staat, gaat hij gokken, en dat kom je veel liever nu te weten dan in het afgeronde dashboard.

Het bouwplan. Als de vragen op zijn:

“Maak hier een bouwplan van. Beschrijf de architectuur, de tools en webtechnologie die nodig zijn, waar de data vandaan komt, en hoe het eindresultaat wordt verspreid en aan mij wordt getoond. Schrijf het voor iemand die geen engineer is.”

Dit is een document dat je echt moet lezen, en goed lezen. Als delen ervan je ongemakkelijk maken, corrigeer en becommentarieer dan alleen wat je begrijpt. Doe niet alsof over de rest. Voor de rest is er een truc: kopieer het hele bouwplan naar een chatvenster, de Gemini-app of welke je ook maar prettig vindt, en praat het met een model door tot je het snapt. Het is de goedkoopste docent die je ooit zult hebben, en hij zucht nooit.

Het implementatieplan. Dan:

“Maak van het bouwplan een implementatieplan: duidelijke, genummerde instructies die elk van je broers en zussen kan oppakken en opleveren zonder bij dit gesprek te zijn geweest.”

Dat laatste zinsdeel doet veel werk. De sub-agents zaten niet in de kamer. Ze weten alleen wat er opgeschreven staat. (Klinkt dat als het inwerken van een nieuw teamlid, dan is dat ook zo. Dat is het hele betoog van Agent Inclusive.)

In één regel: vertel hem wat je wilt, laat hem terugvertellen hoe hij het gaat bouwen, en laat hem dan het plan schrijven waar alle neefjes en nichtjes van gaan bouwen.

Volgorde, als je wilt dat het zelf draait. Zeg niet gewoon “voer het plan nu uit.” Zeg dit:

“Maak van het implementatieplan een takenlijst in de juiste volgorde. Geef bij elk punt aan of het parallel met andere punten kan of eerst iets anders nodig heeft, en houd daar rekening mee bij de volgorde.”

Die ene vraag, wat kan naast elkaar en wat moet wachten, is het verschil tussen een lijst en een planning. Het is ook de vraag die elke projectmanager stelt, wat een mooie herinnering is dat niets hiervan zo vreemd is als het klinkt.

Truc twee: de bouwloop

Nu zeg je niet meer “bouw het”, maar zet je hem op de klok.

“Start een loop die elke 15 minuten draait. Pak telkens het volgende open punt op de implementatielijst en werk het af. Als je denkt dat het klaar is, start dan een aparte agent om te testen of het echt is gebouwd zoals beschreven. Slaagt de test, streep het punt dan door en markeer het als afgerond in het implementatieplan.”

De volgende keer dat de wekker gaat, opent hij het volgende punt dat nog niet gebouwd is. Stap voor stap voor stap. Het is de simpelste manier die ik ken om uit te leggen hoe agents werken. Geef hem een lijst van duizend dingen en hij doet er duizend, in zijn eentje, tot hij er één tegenkomt die hij niet af krijgt of waarmee hij de test niet doorkomt. Dan stopt hij, en daar kom jij in beeld.

Twee details dragen het gewicht. De aparte testagent doet ertoe omdat de bouwer een slechte rechter is van zijn eigen huiswerk, zoals de meesten van ons. Een verse neef die alleen het plan en het resultaat heeft, en geen trots op het werk, is een veel betere inspecteur. En het doorstrepen doet ertoe omdat de lijst het geheugen is. Als de wekker hem wakker maakt, weet hij de laatste vijftien minuten niet meer. Hij leest de lijst.

Je kunt dit veel rijker maken. Je kunt het hele proces hierboven in een loop draaien: schrijf elke stap op die je normaal in een project zou nemen, maak dat het memo, en zet de klok op zestig minuten. Je kunt meerdere loops naast elkaar draaien. Maar begin met de simpele. Die leert je hoe de neef zich gedraagt als je niet kijkt.

Truc drie: de gauntlet

Dit soort loop is nu erg populair, en het is degene die ik zou gebruiken voor werk waarbij kwaliteit het punt is en niet alleen af zijn: een strategiereview, een marktverdieping, een boardpack. Hij draait in een cyclus:

1. Laat hem zien hoe goed eruitziet. Geef hem een heel duidelijke referentie voor hoe het resultaat eruit moet zien, aanvoelen of lezen. “Hier is een uitstekende consultancypresentatie. Bestudeer de structuur, de volledigheid, de kwaliteit van de data.”
2. Bouw. “Duik diep in mijn energiedata thuis. Wees zeer gestructureerd. Analyseer A, B en C.”
3. Onafhankelijke review. Hij geeft zijn werk aan een andere agent, die het met de referentie vergelijkt en één aanwijzing teruggeeft: het ene belangrijkste ding dat moet veranderen.
4. Beoordeel. De cyclus begint opnieuw. Na de wijziging moet hij beoordelen of het rapport beter of slechter werd. Werd het slechter, dan probeert hij hetzelfde opnieuw te herstellen. Werd het beter, dan gaat hij naar de volgende aanwijzing.
5. Stop. Hij gaat door tot de reviewer drie, vier of vijf rondes achter elkaar geen verbetering meer kan vinden.

Die laatste regel is degene die mensen overslaan, en het is de regel die je redt. Zonder stopregel blijft een gretige neef eeuwig polijsten, en voorbij een bepaald punt is polijsten gewoon een mooier woord voor afdrijven. Een plateauregel (als drie rondes achter elkaar niets beters opleveren, ben je klaar) is hoe je een loop vertelt dat “goed genoeg” bestaat.

Als één prompt:

“Draai een gauntlet-loop. Dit is de referentie voor hoe goed eruitziet: [referentie]. Bouw een eerste versie van [het werk]. Elke ronde vergelijkt een aparte reviewer-agent de nieuwste versie met de referentie en geeft precies één verbetering. Pas die toe en beoordeel dan of het resultaat beter of slechter werd. Bij slechter probeer je dezelfde fix opnieuw. Bij beter pak je de volgende verbetering. Stop als drie rondes achter elkaar geen verbetering opleveren, en vertel me wat er elke ronde veranderde.”

Let op wat de menselijke taak hier is: de referentie schrijven. Precies zeggen hoe goed eruitziet. De loop doet het polijsten, maar de referentie bepaalt waar het polijsten eindigt.

De vangst: het huis wordt rommelig

Alles tot nu toe komt uit hoe mensen met AI programmeren, toegepast op het bedrijfsleven. Nu de kanttekening, en dat is het deel dat ik een nieuwkomer het liefst zou willen laten horen.

Naarmate je agents opstarten, meer leren en meer doen, raakt de werkruimte waarin ze opereren besmet. De neef voedt zich met de documenten die jij maakt, dus pikt hij ook informatie op uit elk ander document dat in dezelfde werkruimte rondslingert.

Modellen zijn bijna fanatiek in het zoeken naar extra context om je beter te helpen. Dat is de gretigheid, en meestal is dat een voordeel. Wat ze niet weten, is welke informatie geschikt is om te delen. Ik bedoel dat niet in de zin van gegevensbescherming, hoewel dat ook telt. Ik bedoel dit: je zit halverwege een onderzoek. Er staan tussenconclusies in de map die niet gecontroleerd en niet definitief zijn. Een andere neef stuit erop, vindt ze nuttig, en gaat ze gebruiken in een studie die bedrijfskritieke, geverifieerde informatie nodig heeft. Niemand loog. Niemand brak een regel. Een concept liep gewoon de keuken uit, verkleed als feit.

Eerst geïsoleerd, dan gelaagd, dan bestuurd

Stap één: isoleren. Denk in silo's. Geef elke agent alleen toegang tot een heel specifieke werkruimte, en wees bewust in het bouwen van geïsoleerde.

Het addertje is dat in isolatie alles elke keer opnieuw moet worden uitgevonden. Elke nieuwe neef zoekt het zelf helemaal uit. Skills zijn een antwoord: als iemand iets uitgezocht heeft, bak het in een skill en gebruik de skill de volgende keer. Dat is de handleiding die zijn werk doet. Maar er is een meer schaalbare, gestructureerde manier.

Stap twee: lagen. Organiseer je werkruimtes zoals een verstandig bedrijf afdelingen organiseert, naar wat ze met de informatie doen:

1. Verzamelen: de data binnenhalen.
2. Verwerken: opschonen en vormgeven.
3. Onderzoek: de analyse en de conclusies.
4. Visualisatie: het dashboard, de deck, het ding waar mensen naar kijken.

Elke laag leest alleen uit de laag eronder. Een half afgemaakt onderzoek kan niet doorlekken in de verzamellaag, en niets bereikt het dashboard zonder eerst door het onderzoek te gaan.

Stap drie: besturen. Voeg bovenop de vier lagen één overkoepelende werkruimte toe, wiens taak het is te leren tussen de lagen. Die:

• doet steekproeven op de integriteit van de data;
• let op kruisbesmetting tussen lagen;
• zoekt patronen. “Dit hebben drie verschillende agents zelf uitgezocht. Laten we er een skill van maken.”

Die laatste taak sluit de cirkel van isolatie. De silo's houden het werk schoon, en de governance-laag zorgt dat wat de ene silo leert daar niet blijft steken.

“Zet dit project op als gelaagde werkruimtes: verzamelen, verwerken, onderzoek en visualisatie. Elke laag mag alleen lezen uit de laag eronder. Voeg daarboven een governance-werkruimte toe die dagelijks een steekproef doet op de integriteit van de data, alles meldt wat lijkt op ongecontroleerd werk dat tussen lagen beweegt, en een nieuwe skill voorstelt zodra hij ziet dat meerdere agents zelfstandig hetzelfde probleem oplossen.”

Waarvan je hem de sleutels geeft

Eén eerlijke kanttekening, zodat dit niet als een brochure leest. Alles hierboven wordt krachtiger met elke connector die je toevoegt, en elke fout ook. De neef is gretig, niet kwaadaardig. Maar een gretige agent met een bedrijfspas is nog steeds een gretige agent met een bedrijfspas. En onthoud: welke sleutels je hem ook geeft, hij deelt ze met zijn broers en zussen.

Wees dus zuinig, zeker in het begin. Geef leestoegang vóór schrijftoegang. Geef één map voor je de hele schijf geeft. Alles wat verstuurt, betaalt, publiceert of verwijdert moet wachten op een mens die ja zegt, althans tot je hebt gezien hoe hij het meerdere keren afhandelt. En de sleutels zijn meestal niet van jou om uit te delen: de data, systemen en accounts van je bedrijf hebben eigenaren en regels, dus praat met degene die ze beheert voordat je de neef aansluit. Ik ben geen securityengineer, en dit is geen securitygids. Het is het minimum dat ik iemand zou willen laten weten voordat de eerste loop 's nachts draait.