Een goede prompt schrijven voor programmeren met AI

Een prompt is de opdracht die je aan een AI geeft. Bij programmeren met een tool als Claude Code is dat de tekst waarin je beschrijft wat er gebouwd of veranderd moet worden. Je schrijft gewone zinnen, in het Nederlands, zonder speciale codes.

De AI kan niet in je hoofd kijken. Alles wat je niet vertelt, moet hij raden. Soms raadt hij goed, vaak net niet. Een goede prompt neemt dat giswerk weg. Dat is geen trucje, maar gewoon helder communiceren, net zoals je een opdracht aan een collega zou geven.

Een goede opdracht voor programmeren bevat bijna altijd deze vier onderdelen:

• waarom

  Het doel

  Wat moet het opleveren? Niet alleen wat je wilt zien, maar ook welk probleem het oplost. Bijvoorbeeld: klanten moeten zelf een afspraak kunnen plannen zodat ik minder hoef te bellen.

• wie

  De gebruikers

  Wie gaat het gebruiken? Een tool voor jezelf ziet er anders uit dan een pagina voor klanten die er één keer komen.

• wat

  Wat het moet kunnen

  Noem de belangrijkste dingen die het moet doen, en eventueel wat het juist niet moet doen.

• hoe

  De stap van nu

  Zeg welk deel je nu wilt laten bouwen. Niet alles tegelijk, maar het eerste stuk dat je kunt testen.

• slecht

  Maak een website voor mijn bedrijf.

  De AI weet niet wat voor bedrijf je hebt, voor wie de site is en wat erop moet. Je krijgt een algemene site die je daarna helemaal moet aanpassen.

• goed

  Een duidelijke website-opdracht

  Maak een website van één pagina voor mijn fietsenmakerij in Utrecht. Bezoekers zijn mensen uit de buurt die willen weten wat ik repareer, wat de openingstijden zijn en hoe ze me bereiken. Begin met de bovenkant van de pagina en een overzicht van de diensten.

• slecht

  Het werkt niet.

  De AI weet niet wat je deed, wat je verwachtte en wat er gebeurde. Hij gaat gokken en verandert misschien iets wat wel goed was.

• goed

  Een duidelijke foutmelding

  Als ik op opslaan klik in het formulier, verschijnt er niets in de lijst. Ik verwachtte dat de nieuwe klant onderaan zou staan. In de browser zie ik deze foutmelding: (plak hier de melding). Zoek uit wat er misgaat en los het op.

• slecht

  Maak het mooier.

  Mooi betekent voor iedereen iets anders. De kans is groot dat je iets krijgt wat je niet bedoelde.

• goed

  Een duidelijke ontwerpwens

  Maak de pagina rustiger: meer witruimte tussen de onderdelen, één accentkleur (donkergroen) en grotere letters voor de koppen. Laat de inhoud verder zoals hij is.

De grootste fout bij programmeren met AI is alles in één keer vragen. Een opdracht als 'bouw een complete webshop met betalen, voorraadbeheer en een klantenportaal' levert iets op dat half werkt, en dan weet je niet waar je moet beginnen met herstellen.

Knip je idee daarom op in kleine stappen. Bouw eerst het belangrijkste onderdeel, test het en ga pas verder als het werkt. Elke stap is dan een eigen, overzichtelijke opdracht. Gaat er iets mis, dan weet je precies welke stap het probleem veroorzaakte.

Zo zou je bijvoorbeeld een eenvoudig afsprakensysteem in stappen opbouwen:

1. 1

   Een pagina met beschikbare tijden

   Laat eerst alleen een overzicht van de week zien, met vaste tijden.

2. 2

   Een tijd kunnen kiezen

   Voeg een formulier toe waarmee iemand een tijd kiest en zijn naam invult.

3. 3

   Afspraken bewaren

   Zorg dat gekozen afspraken bewaard worden en niet meer te kiezen zijn.

4. 4

   Een overzicht voor jezelf

   Maak een aparte pagina waarop jij alle afspraken ziet.

Deze zinnen kun je toevoegen aan bijna elke opdracht in Claude Code of een andere AI-tool:

• Stel eerst vragen als iets onduidelijk is, voordat je begint.
• Maak eerst een plan en laat het me zien voordat je iets wijzigt.
• Verander alleen dit onderdeel en laat de rest zoals het is.
• Leg na afloop in gewone taal uit wat je hebt gedaan.
• Houd het zo eenvoudig mogelijk.
• Wat zijn de risico's of nadelen van deze aanpak?

Ook met een goede prompt is het eerste resultaat zelden perfect. Zie het als een gesprek: je bekijkt wat er is gebouwd en zegt concreet wat anders moet. Benoem wat je ziet, wat je verwachtte en wat je wilt. Hoe preciezer je bent, hoe sneller het goed is.

Merk je dat je in rondjes blijft draaien, stop dan even. Begin een nieuw gesprek, vat samen wat er al is en wat het probleem is, en geef dan één duidelijke opdracht. Een frisse start werkt vaak beter dan tien keer 'nee, nog steeds niet'.