Ruim af en toe de instructies van je agent op

Elke keer dat je agent iets fout doet, voeg je een regel toe aan zijn instructies. Een keer over de stijl, een keer over de mappen, een keer over een woord dat hij nooit mag gebruiken. Na een paar maanden is je AGENTS.md of CLAUDE.md een dik bestand geworden. En toch doet je agent soms dingen die je hem al lang hebt afgeleerd. Je herkent dat misschien wel.

In een vibe coding-opleiding had ik het over wat ik de token tax noem. We denken dat meer beter is. Dus schrijven we duizend lijnen in zo'n bestand, met heel veel context, want hoe meer hij weet, hoe beter het zal werken. Ik denk eigenlijk dat juistere instructies beter werken dan veel instructies. En daar hoort af en toe een beetje opkuiswerk bij.

Kopieer de prompt onderaan dit artikel. Daarmee laat je je agent zijn eigen instructies nakijken.

Cartoon

Waarom een groot bestand je agent in de war brengt

Een instructiebestand groeit zoals een schuif in de keuken. Je legt er telkens iets bij, en je haalt er nooit iets uit. Sommige regels staan er twee keer in, in andere woorden. Andere zijn overbodig geworden omdat je anders werkt. En een paar spreken elkaar gewoon tegen.

Die laatste zijn het gevaarlijkst, want ze ontstaan vanzelf. Stel dat je ooit aan een applicatie werkte en daar een kleurenpalet voor samenstelde, met een bepaalde look and feel. Dat staat ergens in je instructies. Maanden later bouw je een andere app, en je agent denkt dat hij dat palet daar ook moet gebruiken. Of hij krijgt twee instructies die tegen elkaar ingaan, en dan kiest hij er zelf een. Het bestand dat je schreef zodat hij jou beter zou begrijpen, maakt hem dan net onzeker.

En elke regel die er staat, leest hij bij elke taak opnieuw. Hoe meer daarvan dubbel of verouderd is, hoe minder plaats er overblijft voor wat er voor die taak echt toe doet.

Veelgestelde vragen

Waarom werkt een lang instructiebestand slechter?

Je agent leest het bij elke taak opnieuw. Regels die dubbel staan of verouderd zijn, nemen plaats in zonder iets toe te voegen. En tegenstrijdige regels laten hem zelf kiezen, vaak de verkeerde.

Waarom zou ik dit in een nieuwe sessie doen?

Een agent die al lang aan een project werkt, zit vol met dat project. In een frisse sessie leest hij zijn instructies met nieuwe ogen. Dan vallen dubbele en tegenstrijdige regels sneller op.

Mag mijn agent zelf regels schrappen?

Laat hem eerst een voorstel doen en beslis zelf per punt. Sommige regels staan er om een reden die alleen jij kent.

Waar leer ik werken met agents en hun instructies?

In de opleidingen ‘Vibe Coding met AI’ en ‘AI-agents’ werk je hands-on met agents en hun instructiebestanden. Alle data vind je bij Workshops & Events.

Lees gratis verder

Registreer gratis met je e-mailadres en lees verder. Met je account open je de gratis artikels in de leerruimte; de rest is voor abonnees, vanaf Learn Plus.

Al geregistreerd? Nog geen account?

Nog geen reactiesLees de reacties

Reacties

Leden reageren hier en lezen elkaars reacties. Registreer gratis of log in om mee te praten.

Registreer gratis of log in

Nog geen reacties. Wat neem jij mee?

    QR-code van deze pagina

    coachsteff.live/ruim-de-instructies-van-je-agent-op

    Scan met je telefoon om de pagina te openen.