Hoe houden we PR-reviews bij in het tijdperk van AI?
AI heeft fundamenteel veranderd hoe snel we code produceren, en dat is een goede zaak. Maar het volume aan PR's dat nu wordt gegenereerd, groeit sneller dan ad-hoc review kan verwerken. Daarom hebben we de Foundation team review rotation weeks geïntroduceerd: toegewijde cycli waarin Foundation-engineers zich richten op het bijhouden van de reviewwachtrij en het handhaven van kwaliteit over de hele linie. Wat die rotaties hebben blootgelegd, is een patroon: PR's die niet afgebakend zijn, niet zelf gereviewd zijn en niet bewezen werken, slokken reviewcycli op die eigenlijk naar opleveren zouden moeten gaan. Deze post is de correctie. Dit zijn geen nieuwe ideeën. Het grootste deel hiervan is engineering common sense. Maar common sense werkt alleen als het gemeengoed is, en dat is het op dit moment niet, dus zetten we het op papier. **TL;DR voordat je op "request review" klikt - één onderwerp, zelf gereviewd, tests groen, bewijs dat het werkt, de juiste reviewer, en een beschrijving waarin jouw eigen stem doorklinkt. En als je al 5 open PR's hebt (draft of niet), ga dan iemand anders' PR reviewen.**

Vat samen met AI


On this page
- 1. Beperk elke PR tot één ding
- 2. Vraag pas review aan als het echt klaar is
- 3. Maximaliseer je open PR's op 5 (drafts tellen mee)
- 4. Stop een menselijke stem in je PR-beschrijving
- 5. Bewijs dat de fix werkt
- 6. SQL- en prestatiewijzigingen hebben echte validatie nodig
- 7. AI is een versneller, geen brein
- 8. Valideer security-PR's voordat je ze opent
- 9. Routeer PR's naar de juiste reviewer
- 10. Architectuurgesprekken gebeuren vroeg
- 11. Lichtgewicht pad voor triviale fixes
- 12. Open geen PR's namens anderen
1. Beperk elke PR tot één ding
De snelste manier om reviewmomentum te killen is een PR die drie dingen tegelijk doet. Reviewers zouden niet mentaal moeten uitpluizen welke wijzigingen bij de bugfix horen en welke bij de refactor die je erin hebt gesmokkeld.
-
Eén bugfix, één veld, één feature, niet alle drie in dezelfde PR.
-
Een gerichte PR van ~1.000 regels die één duidelijk probleem oplost is prima. Een PR van 300 regels met drie aandachtspunten niet. Als je ruim boven de 1.000 regels zit, is dat een sterk signaal om op te splitsen.
-
Gebruik stacked PR's voor grotere wijzigingen.
-
Check voor je iets opent: kan iemand dit in één keer reviewen? Doet het precies één ding? Zou jij het mergen?
2. Vraag pas review aan als het echt klaar is
Drafts bestaan niet voor niets. Een PR uit draft halen is een signaal aan het team dat je je huiswerk hebt gedaan en dat dit iemands tijd waard is. Als dat signaal onbetrouwbaar is, valt het hele reviewsysteem uit elkaar.
Haal alleen uit draft als je op alles ja kunt zeggen:
-
Je hebt een self-review gedaan
-
Alle tests slagen, inclusief e2e
-
Nul onopgeloste comments (die van Devin inbegrepen)
-
Je hebt het lokaal getest voor UI/UX-wijzigingen
-
Voor wijzigingen die door geautomatiseerde tests gedekt kunnen worden, heb je geverifieerd dat het 100% gedekt is
-
Alle CI-jobs zijn groen (behalve de lastige Vercel-previews)
Als op iets het antwoord nee is, laat het dan als draft staan. Drafts die review aanvragen vervuilen de wachtrij en vertragen PR's die echt klaar zijn.
3. Maximaliseer je open PR's op 5 (drafts tellen mee)
Open PR's zijn voorraad. Ze brengen context-switchingkosten, risico op mergeconflicten en reviewschuld met zich mee. Als je er meer dan vijf tegelijk open hebt, klopt de rekensom niet. Je produceert sneller dan het team kan verwerken.
Als je 5 PR's open hebt, draft en niet-draft samen, begin dan niet aan iets nieuws. Ga in plaats daarvan de PR's van je teamgenoten reviewen of werk je oudere werk af.
4. Stop een menselijke stem in je PR-beschrijving
De beschrijving hoeft niet volledig door jou geschreven te zijn. AI is prima voor de opzet en het samenvatten van de diff. Het probleem met wat we nu zien, zijn de enorme AI-gegenereerde beschrijvingen die lezen als een generieke checklist waar niemand echt iets mee heeft gedaan. Ze missen het menselijke element dat een reviewer echt nodig heeft.
-
Een korte auteur-opmerking van één zin over de afweging die je hebt gemaakt, of waarom deze fix nu belangrijk is, gaat verder dan een lang blok "Key Review Points" / "Human Review Checklist".
-
Als je code shipt die nog nergens gebruikt wordt, zeg dan waarom.
-
Als AI de beschrijving heeft opgesteld, bewerk die dan terug en voeg de context toe die alleen jij hebt.
5. Bewijs dat de fix werkt
Een PR die zegt "fixes bug X" zonder bewijs vraagt de reviewer om het maar op goed vertrouwen aan te nemen. Laat ze dat niet doen.
-
Screenshots, screen recordings, dashboards voor en na, alles wat laat zien dat de bug weg is en niets anders is regressed.
-
Functionele QA is verplicht voor UX/UI-wijzigingen, niet optioneel.
6. SQL- en prestatiewijzigingen hebben echte validatie nodig
Code review alleen kan niet bevestigen dat een query rewrite standhoudt onder productielast. Een query-diff lezen en zeggen "ziet er goed uit" is geen validatie. Voor PR's die query-paden of rewrites raken:
-
EXPLAIN ANALYZE op een dataset die op productie lijkt
-
Latencycijfers voor en na, of screenshots van dashboards
-
Rollout achter een feature flag voor risicovolle wijzigingen
7. AI is een versneller, geen brein
AI kan snel code genereren. Het kan niet beslissen of die code überhaupt zou moeten bestaan. Het denken moet nog steeds van jou komen.
-
Eerst ontwerpen. Schets de aanpak, denk door edge cases heen, schrijf een korte notitie en geef daarna pas een prompt.
-
Lees na het genereren door de agent het echt zelf. Self-review vangt Prisma-aanroepen op de verkeerde plek, genegeerde agent-richtlijnen, fragiele structuur, enzovoort.
-
Vraag voor je iets opent: wat raakt dit? Enige impact op gebruikers? Implicaties voor performance of security? Wat is de blast radius als het fout is?
8. Valideer security-PR's voordat je ze opent
Bevestig dat de kwetsbaarheid echt van toepassing is op hoe we de code gebruiken. PR's met "Fix vulnerability X" die gevoelige paden raken, kunnen meer risico introduceren dan het oorspronkelijke rapport.
9. Routeer PR's naar de juiste reviewer
De verkeerde reviewer verspilt twee mensen hun tijd: de reviewer die geen zinvolle feedback kan geven en de auteur die moet wachten op een tweede ronde met de juiste persoon.
-
PR's met veel domeinkennis (Salesforce/CRM-routing, teamprofiel-migraties, enz.) horen bij de domeineigenaar, niet bij Foundation dat simpelweg een door AI gegenereerde testsuite afvinkt.
-
Wijzigingen aan core/foundation-paden (query-infra, hasTeamAccess, enz.) verdienen een snelle afstemming met het owning team voordat de PR open gaat.
10. Architectuurgesprekken gebeuren vroeg
Op dezelfde plek drie keer een patch aanbrengen is een signaal, geen toeval. Als je opnieuw om dezelfde beperking heen werkt, is de juiste stap een gesprek en mogelijke rewrite, niet nog een patch.
Praat met Foundation/Head of Engineering voordat je implementeert. Zo zijn de infra-modules samengekomen, en consistentie stapelt zich op.
11. Lichtgewicht pad voor triviale fixes
Niet alles heeft Foundation-review nodig. We moeten reviewcapaciteit besteden waar die het meest telt.
Toasts aanpassen, knopafmetingen, mechanische naamswijzigingen, tekstwijzigingen, mainline features - die kunnen door AI-review en/of teamniveau-reviews gaan. Reserveer Foundation-review voor wijzigingen die het echt nodig hebben.
12. Open geen PR's namens anderen
Als Engineer X het werk doet, opent Engineer X de PR. Anders komen comments bij de verkeerde persoon terecht, blijven vragen onbeantwoord en loopt de PR vast.
