Handout: Bouwen met AI

Automatiseren en bouwen, niveau 3. Eén A4 om naast je te houden, bij dit project en bij elk volgend project.

De werkwijze: vier fasen per taak

Overgenomen uit de best practices van Claude Code; ze gelden voor elke codeerassistent.

Verkennen: de AI kijkt eerst wat er is en vat het samen. Jij leest mee.
Plannen: plan in maximaal zes stappen; per stap wat je ziet en welke check de AI zelf draait. Jij keurt goed, pas dan bouwen.
Bouwen: één stap tegelijk. De AI draait zijn check; jij kijkt zelf.
Vastleggen: commit met een regel in gewone taal; beslissingen in de projectinstructies.

De regels eromheen (dezelfde woorden als in niveau 1 en 2)

Eigen taak, en één taak per sessie. De rest: later-lijst.
"Klaar als ..." vooraf, per taak en per stap.
Kleine stappen: stap 1 levert binnen 20 minuten iets zichtbaars op.
Precies bijsturen: schermafbeelding plus één zin, of een zin citeren met de correctie erachter. Na twee mislukte correcties: terug naar de laatst vastgelegde staat en een betere opdracht.
AI stelt voor, jij beslist: de AI zegt "klaar" ook als het niet werkt. Kijk zelf.
Geheimen nooit in de chat: alleen in .env (lokaal, wordt niet vastgelegd) of in de secret-instellingen van de host. In de chat geplakt? Nieuwe aanmaken, oude intrekken.
Projectinstructies als geheugen (bij Claude Code CLAUDE.md): wat het project is, de regels, en "Beslissingen" met datum.
Afsluitcheck, altijd dezelfde vier: gecommit, live, werkt de URL, geheimen op hun plek.

Haalbaarheidstoets voor een project

Eén scherm. Eén soort gebruiker. Geen inloggen voor meerdere mensen (hooguit één eenvoudig wachtwoord als geheim op de host). Geen betalingen. Geen koppeling met diensten die je niet kent. Gegevens liefst in de browser of in één bestand. Spec past op een A4. Komt iets hier niet door: kleiner maken of later-lijst.

Faalpatronen (vink af wat je herkent)

Alles in één sessie willen stoppen.
Vertrouwen zonder controleren ("de AI zei dat het werkte").
Geen "klaar als" vooraf, dus eindeloos bijsturen.
"Het werkt niet" zeggen in plaats van wat je ziet en wat je verwachtte.
Doorgaan na twee mislukte correcties.
Goedkeuren wat je niet snapt.
Niet vastleggen, dus niet terug kunnen.
Een geheim in de chat of in de code.

Vier sjablonen

Interview en spec:

Interview me eerst, één vraag tegelijk, max acht, over: wat het doet, voor wie, wat niet, welke gegevens, wanneer klaar. Schrijf dan een spec van één A4: Wat, Voor wie, Doet wel, Doet niet, Gegevens, Klaar als (nu), Klaar als (later). Houd het klein. Begin nog niet met bouwen.

Plan:

Verken eerst de map en vat samen. Maak dan een plan in max zes stappen; per stap: wat je bouwt, wat ik zie, welke check je zelf draait. Stap 1 binnen 20 minuten zichtbaar. Wacht op mijn goedkeuring.

Bouwen:

Voer stap [n] uit. Doe niets anders. Klaar als: [zin]. Draai je check, laat zien wat je zag, en zeg hoe ik het zelf bekijk. Zeg het eerlijk als iets niet lukte.

Testen:

Test als een gebruiker die het voor het eerst ziet. Probeer ook: leeg, te groot, twee keer klikken, vernieuwen, smal scherm. Lijst wat niet klopt (wat je deed, wat gebeurde, wat had gemoeten). Repareer nog niets.

Uitleggen in eigen woorden

Werkend hebben is niet hetzelfde als snappen. Na elk project vertel je aan iemand die doorvraagt: wat doet het, hoe zit het in elkaar, waar staan de gegevens, wat gebeurt er als ik X doe, wat zou ik als eerste veranderen. Lukt een deel niet: laat de AI het in gewone taal uitleggen, en vertel het opnieuw.

Wat je nooit doet

Een sleutel of wachtwoord in de chat of in de code zetten.
Bouwen zonder goedgekeurd plan.
"Klaar" geloven zonder zelf te kijken.
Een derde keer bijsturen.
Live zetten met echte gegevens van anderen die je niet mag gebruiken.
Doorgaan met een woord of stap die je niet kunt uitleggen.

Ga je verder?

Een tweede project, zelf, met je later-lijst als bron: begin met het interview, eindig met de afsluitcheck. Of één taak van de later-lijst per sessie op dit project. Liever terug naar workflows: je tool kan de uitkomst van een workflow uit niveau 2 laten zien. Collega's meenemen: niveau 3 van Kantoorbaan, over afspraken in een team.