De werkwijze die het verschil maakt tussen een werkende app en een berg code

Het gereedschap is gekozen, de briefing is klaar. Nu de manier van werken. Dit is waar het verschil ontstaat tussen mensen die na een week een werkende app hebben, en mensen die na een week een berg code hebben die niets doet.

Regel 1: klein beginnen

Vraag nooit om de hele app in één keer. Vraag om het kleinste stukje dat je kunt zien werken: één scherm, zonder formulier, zonder inloggen. Als dat werkt, komt het volgende stukje. Dat voelt trager, maar is het niet: een agent die een klein stukje bouwt maakt weinig fouten; een agent die alles tegelijk bouwt maakt fouten die je pas na uren vindt.

Regel 2: altijd een werkende versie

Voordat je aan iets nieuws begint, moet het vorige werken. Dat betekent: na elke stap open je de app en probeer je het. Werkt het niet, dan repareer je dat eerst. Je begint nooit aan de volgende stap terwijl de vorige kapot is.

Regel 3: elke stap testen

Testen betekent hier: doen wat een gebruiker zou doen. Klik erop, vul iets geks in, laat een veld leeg, druk twee keer op dezelfde knop. Gaat er iets mis, vertel dan precies wat je deed en wat je zag. "Het werkt niet" is geen bruikbare foutmelding; "ik liet het naamveld leeg en kreeg een witte pagina" wel. Laat je agent daarnaast ook zelf geautomatiseerde tests schrijven; die vang je fouten op zonder dat je zelf alles hoeft na te klikken.

Regel 4: laat uitleggen wat er gebouwd is

Vraag na elke stap: "Leg in gewone taal uit wat je hebt gemaakt en welke bestanden je hebt aangeraakt." Je hoeft de code niet te begrijpen, wel het verhaal. Noemt de uitleg iets dat je niet had gevraagd, vraag dan waarom. Vaak is het een goed idee; soms is het een agent die er zelf een aanname bij heeft bedacht.

Regel 5: één ding tegelijk

Geef nooit twee opdrachten in één bericht. "Voeg een veld toe en maak de kleur anders" wordt twee berichten. Anders doet de agent het ene half en het andere verkeerd, en weet je niet meer welke wijziging wat kapotmaakte.

Als het vastloopt

Het gaat een keer mis: de agent draait in kringetjes, of maakt het bij elke poging erger. Doe dan dit, in deze volgorde:

1. Stop. Zeg tegen je agent dat hij niets meer moet veranderen.
2. Ga terug naar de laatste werkende versie in je versiebeheer.
3. Maak de opdracht kleiner; meestal was hij te groot.
4. Begin een nieuw gesprek. Een lang gesprek vol mislukte pogingen maakt een agent slechter, niet beter.

Kom je er echt niet uit, dan is er de hulpsessie: een half uur via Teams waarin een developer meekijkt op je scherm en je code. Probeer eerst de vier stappen hierboven; negen van de tien keer is dat al genoeg.