Waarom een goede briefing het verschil maakt tussen rommelige code en een goede app

"Maak een afsprakenplanner" levert een afsprakenplanner op. Alleen niet de jouwe. Een AI-agent vult alles in wat jij niet zegt: welke velden, welke rollen, hoe het eruitziet, wat er gebeurt bij een fout. Elke aanname die je niet zelf maakt, maakt de agent voor je. Een briefing is niets anders dan die aannames vooraf opschrijven, zodat de agent ze niet hoeft te raden.

De vaste opbouw

Een goede briefing volgt steeds dezelfde opbouw, in deze volgorde, omdat het de volgorde is waarin een agent beslissingen neemt:

1. Doel. Eén zin: "Met deze app kan [wie] [wat doen], zodat [waarom]."
2. Gebruikers. Wie gebruikt de app, en wat mag die persoon.
3. Schermen. Elk scherm, met wat erop staat en wat je erop kunt doen.
4. Gegevens. Wat de app bewaart, per onderdeel de velden.
5. Niet. Wat er in deze versie uitdrukkelijk niet in zit.

Sluit af met hoe de agent moet werken: klein beginnen, elke stap laten zien, niets bouwen dat niet in de briefing staat.

Onze BRIEFING.md

Op softwaremaken.nl stel je zo'n briefing samen door de componenten aan te zetten die je app nodig heeft: rollen en rechten, betalingen, agenda, e-mail. De basis (inloggen, een beheerpaneel, een database) zit er altijd al in. Met één klik download je het resultaat als BRIEFING.md: een bestand met je gekozen componenten, onze technische standaarden voor een veilige, overdraagbare opzet, en de werkwijze voor je agent.

Die werkwijze bevat één harde regel: je agent stelt je maximaal twee vragen per ronde. Niet twintig vragen tegelijk, en niet in stilte een aanname doen. Zo houd jij de regie over je eigen idee, in je eigen tempo, en bouwt de agent nooit te ver door op een verkeerde aanname.

Zo klinkt een goede briefing

Kort, concreet, in gewone taal. Je hoeft geen technische woorden te gebruiken; je agent vertaalt die zelf. Wel helpt het om consequent te zijn: noem een afspraak overal een afspraak, niet de ene keer een boeking en de andere keer een reservering.

Twijfel je over iets? Schrijf dan op dat je twijfelt en vraag je agent om twee opties. Dat is beter dan gokken, en het voorkomt dat je een half uur verder bent voordat je ontdekt dat de agent iets anders bedoelde dan jij.

Wat je ermee doet

Geef BRIEFING.md aan je eigen AI-agent (bijvoorbeeld Claude Code, Cursor of een vergelijkbaar product) in een lege projectmap. Vraag hem eerst om de briefing in eigen woorden samen te vatten, nog zonder te bouwen. Klopt de samenvatting? Dan kan hij beginnen. Klopt hij niet, dan pas je de briefing aan voordat er één regel code geschreven is. Dat kost vijf minuten en bespaart je makkelijk een dag aan verkeerd gebouwde schermen.