Een run opent geen pull request zodra de code geschreven is. Eerst controleert hij zijn eigen werk, en lost hij op wat hij vindt. Per project bepaal je welke controles gelden.
Open het project en ga naar Instellingen → Context en conventies. De controles staan onder Verificatiestap. Om ze te wijzigen moet je beheerder van de organisatie of eigenaar van het project zijn. Klik op Instellingen opslaan als je klaar bent.
Verificatiecommando
Het Verificatiecommando is het commando dat bewijst dat de wijziging werkt - je tests, build of linter. Bijvoorbeeld npm test, pytest -q of make ci.
- Nadat de run zijn wijzigingen heeft gemaakt, voert hij dit commando uit in de repository (of in de submap, als die is ingesteld).
- Faalt het, dan krijgt de AI de uitvoer, probeert hij het probleem op te lossen en draait hij het commando opnieuw.
- Herstelpogingen bij falen bepaalt hoeveel pogingen hij krijgt (0 tot 5, standaard 2).
- Faalt het commando na de laatste poging nog steeds, dan wordt de run Mislukt - je krijgt nooit een pull request die je build breekt.
Bij meerdere repositories draait het commando in elke repository die de run heeft gewijzigd.
Laat het Verificatiecommando leeg om de AI zijn eigen werk tijdens de run te laten controleren. Een verificatiecommando wordt sterk aangeraden: het is de betrouwbaarste manier om pull requests te krijgen die door CI komen. Repository analyseren (zie Projecten) stelt er een voor op basis van je repository.
Automatische fixes vanuit alerts starten alleen als het project een verificatiecommando heeft.
Zelfreview vóór de PR
Staat Zelfreview vóór de PR aan (standaard), dan leest een reviewer-agent de wijziging voordat de pull request wordt geopend.
- Blokkerende problemen gaan terug en worden automatisch opgelost, waarna de wijziging opnieuw wordt geverifieerd.
- Kleinere opmerkingen komen in de beschrijving van de pull request, voor je reviewer.
- Staat er na de herstelpogingen nog een blokkerend probleem open, dan wordt het in de beschrijving van de pull request als onopgelost vermeld, zodat je reviewer het ziet.
Beveiligingsscan vóór de PR
Staat Beveiligingsscan vóór de PR aan (standaard), dan wordt de gewijzigde code gescand op beveiligingsproblemen, gelekte secrets en kwetsbare afhankelijkheden voordat de pull request wordt geopend.
- Laat Commando voor beveiligingsscan (optioneel) leeg om de beschikbare scanners te gebruiken: semgrep, gitleaks, pip-audit en npm audit. Is er geen enkele beschikbaar, dan wordt de scan overgeslagen.
- Of vul je eigen commando in; een exitcode anders dan nul telt als bevindingen.
- Bevindingen gaan terug naar de AI om op te lossen. Wat er na de herstelpogingen overblijft, wordt gemarkeerd in de beschrijving van de pull request.
Op eigen runners draaien het verificatiecommando, de zelfreview, de beveiligingsscan en de documentatiestap niet vóór de pull request; de architectuurregels en het herstel bij falende CI wel. Zie Controles bij self-hosted runs.
Documentatie bijwerken in PR's
Staat Documentatie bijwerken in PR's aan (standaard uit), dan werkt de run ook de CHANGELOG en de documentatie bij die door de wijziging geraakt wordt, in dezelfde pull request. Mislukt deze stap, dan gaat de run zonder verder.
Automatisch doorwerken tot alles groen is
Automatisch doorwerken tot alles groen is is geen controle vóór de pull request, maar erna: faalt CI of vraagt een reviewer om wijzigingen, dan start CodeLynq een nieuwe ronde om het op te lossen. Zie De CI-feedbacklus.
Architectuurregels
Heeft het project architectuurregels voor een repository (zie Architectuurkaart en -regels), dan controleert een run ook dat zijn wijziging geen afhankelijkheid toevoegt die de regels verbieden. Staat Bij runs op Herstellen, dan stuurt de run een gebroken regel terug naar de agent en verifieert daarna opnieuw. De sectie Structure changes in de pull request toont wat overblijft, samen met wat de wijziging verder aan de structuur veranderde.
Welke controles gebruik je
- Stel altijd een Verificatiecommando in als je project tests of een build heeft.
- Laat Zelfreview vóór de PR en Beveiligingsscan vóór de PR aanstaan; zet er een alleen uit als die voor dit project in de weg zit.
- Elke herstelpoging kost extra tijd en modelgebruik, dus een heel hoog aantal Herstelpogingen bij falen maakt mislukte runs duurder. De standaard past bij de meeste projecten.