Zo schrijf je een goede opdracht voor een AI-agent

Twee ontwikkelaars geven een agent dezelfde taak. De eerste schrijft: "Fix de export." De tweede schrijft vijf zinnen. De tweede krijgt een voorstel dat hij in tien minuten goedkeurt. De eerste krijgt iets waar hij een uur mee bezig is.

Een agent is geen collega die al jaren in je bedrijf werkt. Hij weet alleen wat in de code staat en wat jij hem vertelt.

De vijf onderdelen van een goede opdracht

1. Wat er mis is of wat er moet gebeuren

Beschrijf het gewenste resultaat, niet alleen het probleem. "De datum in de PDF-export toont maand en dag omgekeerd. Ze moet in het formaat dag/maand/jaar staan."

2. Waar het zich bevindt

Noem het bestand, de module of het scherm als je het weet. Dat spaart de agent zoekwerk en voorkomt dat hij op de verkeerde plaats begint.

3. Hoe je weet dat het klaar is

Dit is het belangrijkste onderdeel. "Er is een test die een factuur van 3 februari exporteert en controleert dat er 03/02 staat." Een duidelijk eindpunt maakt het verschil.

4. Wat niet mag veranderen

"Pas de opmaak van de PDF niet aan." "Raak de database niet aan." Grenzen voorkomen verrassingen.

5. Context die niet in de code staat

"Klanten in Nederland gebruiken dezelfde export." Wat jij weet en de code niet vertelt, moet in de opdracht.

Een voorbeeld

De datum op de PDF-export van facturen staat als maand/dag/jaar. Ze moet dag/maand/jaar zijn, zoals overal in de applicatie. De export zit in de module facturatie. Voeg een test toe die een factuur van 3 februari 2026 exporteert en controleert dat 03/02/2026 in de PDF staat. Wijzig de opmaak van de PDF niet.

Vijf zinnen. Twee minuten schrijven. Het verschil tussen een bruikbaar voorstel en een uur verloren tijd.

Leren schrijven

Goede opdrachten schrijven is een vaardigheid die je team snel leert. Het is een vast onderdeel van onze online workshops en van elke implementatie.