Wat is een goede opdracht aan je AI?

Een prompt is de opdracht die je in gewone taal aan een AI geeft. Bij vibecoden is dat je belangrijkste gereedschap: alles wat de AI bouwt, komt voort uit wat je vraagt.

Een goede opdracht heeft vier onderdelen:

1. Het doel. Wat moet de gebruiker kunnen?
2. De gebruiker. Voor wie is het, en wat weet die persoon?
3. De grenzen. Wat mag niet veranderen, en wat moet de AI juist niet doen?
4. Wanneer het klaar is. Hoe zie je dat het werkt?

Vergelijk deze twee:

Maak een inlogpagina.

Voeg een inlogpagina toe waar bestaande gebruikers inloggen met e-mail en wachtwoord. Na inloggen komen ze op het dashboard. Bij een fout wachtwoord zien ze een duidelijke melding. Verander niets aan de homepage. Het is klaar als ik met een testaccount kan inloggen en uitloggen.

De tweede kost een minuut langer om te typen en scheelt je vaak een uur heen en weer.

Hoe meer je in één opdracht stopt, hoe groter de kans dat de AI iets half doet of ongevraagd iets anders aanpast. En als het misgaat, weet je niet welk deel de fout veroorzaakte.

Daarom werkt het beter in kleine stappen (opent in een nieuw tabblad)¹: eerst het scherm, dan de opslag, dan de controle op invoer. Na elke stap hoort een test en een bewaarde werkende versie, zodat je terug kunt als de volgende stap misgaat.

De meeste tools houden een geschiedenis van versies bij, en staat je code in GitHub, dan staat die geschiedenis ook daar. Hoe terugzetten werkt, verschilt per tool (zie Welke tool past bij jou?).

Bij een grotere wijziging, zoals abonnementen toevoegen, werkt het beter als de AI eerst een plan maakt (opent in een nieuw tabblad)² zonder te bouwen: welke schermen, welke gegevens en welke diensten er nodig zijn. Klopt het plan niet, dan stuur je bij voordat er code is. Dat is veel goedkoper dan achteraf herstellen, zeker als je tool per opdracht afrekent.

Het helpt ook als de AI na een wijziging in gewone taal uitlegt wat hij heeft veranderd en waarom. Zo leer je je eigen project kennen, en merk je sneller als iets niet klopt.

Iedereen die vibecodet, kent het: je vraagt een fout op te lossen en krijgt een nieuwe fout terug. Meestal heeft dat een van deze oorzaken:

• Te weinig informatie. "Het werkt niet" geeft de AI te weinig om mee te werken. De exacte foutmelding, uit het scherm of uit de console van je browser (opent in een nieuw tabblad)³ (het venster waarin de browser fouten toont), en een beschrijving van wat je deed en zag, helpen veel meer.
• Een te lang gesprek. Een lang gesprek raakt vol (opent in een nieuw tabblad)⁴. In een nieuw gesprek met een korte samenvatting kan de AI weer helder kijken.
• Een te grote vraag. Hoe kleiner het probleem, hoe beter de AI ziet waar het misgaat.

Na drie of vier mislukte pogingen is teruggaan naar een werkende versie vaak sneller dan doorgaan. Blijft het daarna misgaan, dan zit het probleem vaak in de opbouw van de code zelf, en dat los je niet op met een betere opdracht. Zie Wat kan vibecoden niet?

Je kunt de AI vragen om veilige code, en dat is verstandig. Bijvoorbeeld door erbij te zeggen dat geheime sleutels niet in de code horen die in de browser draait, en dat elke gebruiker alleen zijn eigen gegevens mag zien, ook als iemand de app omzeilt.

Maar een opdracht is geen garantie. De AI kan zeggen dat iets veilig is terwijl het dat niet is. En of het goed staat, zie je niet aan de buitenkant van je app: alles werkt, ook als iedereen bij alles kan. Dat nalopen vraagt iemand die de code kan lezen. Wat er dan gecontroleerd wordt, lees je in Is mijn app veilig? en Testen voordat je live gaat.

Zie je in een antwoord van de AI een woord dat je niet kent, zoek het dan op in de woordenlijst.