Het hart van onze ontwikkeling
vigil begon als onze back office voor onderhoud: welke projecten draaien op kwetsbare of aflopende versies. Vandaag is het het geheugen en de poortwachter van alles wat we bouwen. Elke beslissing van een mens gebeurt in vigil: een opdracht goedkeuren, een bevinding beslissen, een extra reviewronde vragen. Alles wat een agent doet, wordt er vastgelegd.
Op deze pagina leest u hoe dat werkt en hoe vigil samenwerkt met het agentteam, Wisp en Toolbox. De werking tonen we volledig; de interne details van onze opstelling niet. Het onderhoud van het portfolio, waar vigil mee begon, heeft een eigen pagina.
Waar vigil in het midden staat
Claude Code en het agentteam
Het agentteam is een plugin met rollen: een PM die opdrachten schrijft, een code-reviewer, een security-reviewer, een test-schrijver, een updater en een designer. Ze leggen hun opdrachten en reviews in vigil neer en vragen er, via MCP, wat er in een project te doen is en wat er eerder al beslist werd.
Wisp
Onze editor laat het team nakijken vanuit de editor zelf. Die review telt in vigil net zo goed als een review uit Claude Code, en de pushknop volgt dezelfde regels: zonder geldige review geen push naar main. vigil als MCP-server stelt u in Wisp in zoals elke andere.
GitLab
De code en de merge requests. De poort in CI vraagt bij elke merge request naar main aan vigil of er een bevestigde review is van precies die inhoud. vigil haalt de resultaten van de controles in CI op, en opent merge requests naar main zelf, als bot.
Toolbox
Onze startpagina met de ideeën-inbox. vigil zet er de stand van het portfolio en van de runners op, en de lijst projecten waarbij een idee kan horen. Een bevinding die u "naar de inbox" stuurt, komt daar als idee binnen. Omgekeerd leest vigil de ingedeelde ideeën terug. Toolbox geeft ook de fouten van de projecten door, versleuteld voor vigil. Meer over Toolbox.
Runners en machines
Het team draait op eigen runners en machines. vigil bewaakt ze: zijn de runners online, hoe zwaar draaien de machines, welke geplande taken lopen er.
Publieke registries
Packagist, de npm-registry, de advisory-databanken en endoflife.date. Daar vraagt vigil alleen naar pakketnamen en versies, nooit naar welk project ze gebruikt.
Van idee tot merge
- Idee Een idee komt binnen in de inbox van Toolbox, of een bevinding uit een review wordt er een.
- Analyse Een agent werkt het idee uit tot een analyse in de repository. vigil toont die met haar status, en het idee wordt in Toolbox afgevinkt.
- Opdracht De PM schrijft een opdracht: doel, wat erbuiten valt, criteria, risicoklasse en dreigingsmodel. Ze komt in vigil en wacht daar.
- Goedkeuren Een mens keurt de opdracht goed, stelt ze bij of laat ze vallen. Pas na de goedkeuring wordt er gebouwd.
- Bouwen Een agent bouwt op een eigen branch, binnen wat de opdracht vraagt.
- Teamreview De risicoklasse bepaalt wie nakijkt. Het rapport komt in vigil, en elke bevinding wordt een eigen werkpunt.
- Beslissen De PM stelt per bevinding voor wat ermee moet. Een mens beslist: nu oplossen, naar de inbox, of aanvaarden met een reden. Na de fixes volgt één controleronde.
- Merge request Is het oordeel niet blokkerend, dan opent vigil de merge request naar main, als bot en alleen voor de inhoud die nagekeken is.
- De poort In CI vraagt de poort vigil het oordeel. Zonder bevestigde, niet-blokkerende review van die inhoud gaat ze niet open.
- Mergen Een mens merget, en vigil rondt de opdracht af. Na een gemergde update scant vigil het project meteen opnieuw; anders ziet de volgende scan het resultaat.
Scrol de strook opzij voor de volgende stappen. Grijs: een beslissing van een mens. Blauw: de poort.
Vandaag
Het beginscherm toont wat op u wacht, wat er nu loopt en wat aandacht nodig heeft, en het werkt zichzelf bij. Een opdracht goedkeuren of bijstellen doet u in een lade naast de lijst, zonder de pagina te verlaten. Welke blokken er staan, in welke volgorde en hoeveel regels elk, stelt u zelf in.
Plan
De pijplijn toont elk stuk werk in zijn fase: idee, analyse, opdracht, in bouw, in review, klaar voor merge en afgerond. Zo ziet u in één blik waar het werk vastzit, en bij wie.
Opdrachten: eerst afspreken, dan bouwen
Wat erin staat
Het doel, wat er bewust buiten valt, toetsbare acceptatiecriteria, een risicoklasse en een dreigingsmodel in één zin: wat staat er op het spel als dit misloopt. Wat buiten de opdracht valt, wordt een volgende opdracht, niet iets wat er stil bij komt.
Alleen een mens keurt goed
Een agent kan een opdracht voorstellen en bijstellen, maar niet goedkeuren: dat kan alleen een ingelogde gebruiker in vigil. U kan de opdracht ook eerst zelf aanpassen. Waaraan gebouwd wordt, is de versie die u goedkeurde.
Licht
Alleen tekst, zoals documentatie of vertalingen. Geen reviewer vooraf.
Hotfix
Iets wat niet kan wachten. Geen reviewer vooraf, maar de controles in CI blokkeren wel, en de review volgt achteraf, binnen een vaste termijn. Een hotfix mag niet aan CI, authenticatie, geheimen of dependencies komen.
Normaal
Het gewone werk. De code-reviewer kijkt na op correctheid, randgevallen, foutafhandeling en tests.
Gevoelig
Alles wat aan beveiliging, gegevens of dependencies raakt. De security-reviewer en de code-reviewer kijken tegelijk na. Wie zonder opdracht code wijzigt, valt automatisch in deze klasse.
Reviews, bevindingen en de poort
Bevindingen als werk
Elke bevinding krijgt een eigen plaats in vigil. De PM stelt voor wat ermee moet; u beslist: nu oplossen, naar de inbox van Toolbox, of aanvaarden met een reden. Wat al beslist is, meldt de volgende review niet opnieuw.
Twee rondes, dan beslist u
Na de review volgt hoogstens één controleronde, die alleen naar de fixes kijkt. Staat er daarna nog iets open, dan beslist u in vigil: aanvaarden, naar de inbox, of uitdrukkelijk nog een ronde vragen. Zo blijft een review niet eindeloos doorlopen.
Een oordeel voor precies die inhoud
Het oordeel van een review hoort bij de exacte inhoud die nagekeken werd. Verandert er daarna nog iets, dan geldt het niet meer. Een push naar main zonder geldig oordeel houden Claude Code en Wisp tegen.
Het bot opent de merge request
Een merge request naar main opent vigil zelf, en alleen als het een bevestigde, niet-blokkerende review van die inhoud kent. Geen agent en geen pipeline krijgt daarvoor een eigen sleutel.
De poort in CI
Bij elke merge request naar main vraagt de poort het oordeel aan vigil. Kent vigil geen goede review, of is vigil niet bereikbaar, dan blijft de poort dicht. De poort kan niet uitgezet worden, en haar oordeel staat als notitie op de merge request.
Wat opvalt
Een merge request naar main zonder poort, of een die de CI-configuratie wijzigt, valt op in vigil. Dekt een review haar opdracht niet meer, dan zegt vigil: niet mergen. En een mens merget altijd zelf.
Fouten uit productie
Via Toolbox binnen
Een project stuurt zijn fouten niet rechtstreeks naar vigil, maar naar Toolbox. vigil haalt ze daar elke paar minuten op. Ligt Toolbox even plat, dan merkt de applicatie daar niets van.
Toolbox leest niet mee
Elke fout wordt versleuteld voor vigil voor ze het project verlaat. Toolbox bewaart ze, maar kan ze niet openen: het ziet alleen van welk project een fout komt, hoe ernstig, wanneer, hoe vaak en hoe groot ze is, en welke meldingen bij dezelfde fout horen, maar niet welke fout dat is. Pas in vigil is ze weer leesbaar.
Minder gegevens, niet geen
Voor het versleutelen haalt het project mailadressen, IP-adressen, query-strings en tokens uit de fout. Namen en andere persoonsgegevens in vrije tekst herkent het niet; die horen daarom niet in een foutmelding. Identificatienummers, zoals dat van een bestelling, mogen erin.
Elke fout is vijandige invoer
Een foutmelding bevat vaak tekst van buiten, zoals een adres of wat een bezoeker invulde. vigil controleert elke fout streng op vorm en grootte en weigert wat afwijkt, in plaats van het in te korten; geweigerde fouten worden geteld, niet getoond. Wat vigil toont, is platte tekst: geen links en geen opmaak.
Groepen met een status
Dezelfde fout op dezelfde plaats is per project één groep, met een teller en de eerste en laatste keer. Een groep is open, opgelost of terug: terug is een fout die u had opgelost en die daarna opnieuw voorkwam. Het detail opent in een lade naast de lijst.
Nog bij geen enkele agent
De inhoud van een fout gaat vandaag naar geen enkele agent: niet via MCP, niet op Vandaag en niet in een sessie. Alleen wie in vigil inlogt, leest ze. Een test in vigil bewaakt dat.
Analyses en ideeën
Uit Toolbox
Ideeën komen binnen in de inbox van Toolbox en worden ingedeeld bij een project. vigil toont per project de ideeën die op een analyse wachten.
In de repository
Een agent schrijft de analyse als document in het project zelf. vigil leest ze en geeft ze een status: nieuw, in bespreking, goedgekeurd of gevallen. Wijzigt een goedgekeurde analyse nog, dan ziet u dat.
Afgevinkt
Is de analyse er, dan vinkt u het idee af in Toolbox, met de analyse als resultaat. Uit een goedgekeurde analyse kan een opdracht volgen, die aan haar analyse gekoppeld blijft.
Waar het naartoe gaat
Het plan als werkbord
De pijplijn wordt een bord waarop u werk naar de volgende fase sleept. Elke sleep is een beslissing: een opdracht naar "in bouw" vraagt eerst uw goedkeuring.
Van analyse naar opdracht
Nieuwe ideeën en analyses krijgen een eigen plek, een analist werkt ze uit, en uit een goedgekeurde analyse maakt u met één knop een opdracht.
vigil start het werk
Vandaag start vigil updates en nakijkrondes als run, met een tijdlijn en een plafond op de kosten. Straks ook opdrachten en analyses, en flows die u per project zelf samenstelt.
Agents volgen en antwoorden
Sessies van agents starten en volgen vanuit vigil, en hun vragen om toestemming beantwoorden in "wacht op jou", naast de opdrachten. Ook de live sessies uit de editor komen erbij.
Een nachtploeg
Goedgekeurd werk dat 's nachts doorloopt, zodat de ochtend begint met reviews om te beslissen in plaats van werk om te starten.
Van fout naar opdracht
Gepland is dat de nachtploeg van een fout uit productie een concept-opdracht maakt. Bouwen gebeurt pas als een mens die opdracht goedkeurt in vigil, zoals bij elke andere opdracht. Vandaag gaat de inhoud van een fout nog naar geen enkele agent.
Ontwerp en QA als stappen
De designer bestaat al als rol in het team: hij maakt schema's, clips en screenshots. Gepland is dat ontwerpen en testen in de browser ook eigen stappen worden in de werkstroom van vigil, naast bouwen en nakijken. En een commandopalet om overal snel naartoe te springen.