← Developers

vigil

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

Agents werken in Claude Code en in Wisp, de code staat in GitLab, ideeën komen binnen in Toolbox. vigil is de plek waar dat samenkomt: het houdt bij wat er gevraagd is, wat er beslist is en wat er nog openstaat, en het zegt de poort in CI of iets mag mergen.
vigil in het midden van de ontwikkeling vigil staat centraal: Claude Code met de team-plugin en de editor Wisp leveren opdrachten en reviews aan, GitLab vraagt het oordeel voor de poort en krijgt merge requests van het bot, vigil bewaakt de runners, deelt status en ideeën met Toolbox en vraagt bij de registries alleen naar pakketnamen, terwijl een mens in vigil goedkeurt en beslist en in GitLab merget. KEURT GOED MERGET WERK · REVIEWS REVIEWS MR · UPDATES POORT · CI BEWAAKT PAKKETNAMEN STATUS · INBOX IDEEËN MENS Ontwikkelaar beslist · merget CLI Claude Code team-plugin · rollen EDITOR Wisp teamreview · pushknop KERN vigil geheugen · poortwachter CI GitLab merge requests · poort INTERN Runners en machines waar het team draait WEB Toolbox ideeën · statuskaarten EXTERN Publieke registries Packagist · npm · EOL LEGENDE vigil Mens of werkplek Eigen dienst Buiten het netwerk Beslissing van een mens Binnen Naar buiten Terug
vigil in het midden. De pijl in de accentkleur is een beslissing van een mens; al de rest is werk dat vigil bijhoudt of zelf doet.

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.

Het onderhoud van het portfolio Het agentteam

Van idee tot merge

Elke wijziging volgt dezelfde weg. Agents doen het werk, een mens neemt de beslissingen, en vigil houdt bij waar alles staat. Niets wordt gebouwd zonder goedgekeurde opdracht, en niets komt op main zonder review van precies die inhoud.
Van idee tot merge De werkstroom in vier banen: een agent maakt van een idee een analyse en opdracht, een mens keurt de opdracht goed in vigil, de agent bouwt en laat nakijken, vigil bewaart elke bevinding, de mens beslist per bevinding wat er nu gebeurt en of er nog een ronde komt, waarna het werk terug naar bouwen gaat, vigil opent de merge request als bot, de poort in GitLab vraagt vigil het oordeel, en een mens merget. MENS AGENTS VIGIL GITLAB VOORSTEL GOEDGEKEURD RAPPORT PM STELT VOOR NOG EEN RONDE STEMPEL MR NAAR MAIN POORT GROEN Analyse en opdracht PM · uit een idee Keurt goed doel · klasse · risico Bouwt op een eigen branch Teamreview reviewers per klasse Bewaart de review elke bevinding apart Beslist nu · inbox · aanvaard Opent de MR als bot, na de stempel De poort vraagt vigil het oordeel Merget daarna scant vigil LEGENDE Beslissing van een mens Werk van een agent vigil legt vast Poort Goedkeuring: pas dan wordt er gebouwd Terug naar bouwen: wat nu opgelost wordt, of nog een ronde
De werkstroom in vier banen. Een mens beslist op vier momenten: de opdracht goedkeuren, de bevindingen beslissen, eventueel nog een ronde vragen, en mergen.
  1. Idee Een idee komt binnen in de inbox van Toolbox, of een bevinding uit een review wordt er een.
  2. 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.
  3. Opdracht De PM schrijft een opdracht: doel, wat erbuiten valt, criteria, risicoklasse en dreigingsmodel. Ze komt in vigil en wacht daar.
  4. Goedkeuren Een mens keurt de opdracht goed, stelt ze bij of laat ze vallen. Pas na de goedkeuring wordt er gebouwd.
  5. Bouwen Een agent bouwt op een eigen branch, binnen wat de opdracht vraagt.
  6. Teamreview De risicoklasse bepaalt wie nakijkt. Het rapport komt in vigil, en elke bevinding wordt een eigen werkpunt.
  7. 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.
  8. 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.
  9. De poort In CI vraagt de poort vigil het oordeel. Zonder bevestigde, niet-blokkerende review van die inhoud gaat ze niet open.
  10. 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.

Het scherm Vandaag in vigil: bovenaan vier tegels (wacht op jou, loopt nu, aandacht nodig, pijplijn), daaronder de lijst van wat op u wacht met een teamreview die blokkeert en opdrachten die op goedkeuring wachten, en rechts wat aandacht nodig heeft, zoals beveiligingslekken.
Vandaag: wat op u wacht, wat nu loopt en wat aandacht nodig heeft. Een demo met verzonnen gegevens.
Het scherm Plan in vigil: het bord met zeven kolommen van idee tot afgerond (idee, analyse, opdracht, in bouw, in review, klaar voor merge en afgerond). Kaarten staan in de kolommen opdracht, in review, klaar voor merge en afgerond, elk met de titel van een opdracht, het project en de klasse, soms met de stand van de review of van de merge request. De kolommen idee, analyse en in bouw zijn leeg.
Plan: elk stuk werk in zijn fase, van idee tot afgerond. Een demo met verzonnen gegevens.
Vigil toont een teamreview met de status blokkerend: een tabel met bevindingen, het voorstel van de PM en knoppen om te kiezen tussen Nu, Inbox en Aanvaarden.
Van opdracht tot review: een opdracht openen en beslissen, en daarna de review met bevindingen en het voorstel van de PM. Een demo met verzonnen gegevens.

Opdrachten: eerst afspreken, dan bouwen

Een opdracht legt vast wat er gebouwd wordt voor er een regel code bestaat. Zo toetsen de reviewers later aan wat er gevraagd was, en niet aan wat er toevallig gemaakt is.
Een opdracht in vigil, geopend in een lade naast de lijst Opdrachten: het doel, wat er buiten valt, de acceptatiecriteria, de risicoklasse met wie nakijkt en het dreigingsmodel, met onderaan de knoppen Goedkeuren, Bijstellen en Laten vallen.
Een opdracht in een lade naast de lijst: doel, wat erbuiten valt, acceptatiecriteria, klasse en dreigingsmodel, met de beslissing van een mens eronder. Een demo met verzonnen gegevens.

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

Een review is pas iets waard als ze gevolgd wordt. vigil maakt van elke bevinding werk, onthoudt wat er beslist is, en laat de poort alleen opengaan voor wat echt nagekeken is.
Een teamreview in vigil met blokkerend oordeel: een tabel met per bevinding de ernst, het voorstel van de PM (nu, inbox of aanvaarden), wat al beslist is en knoppen om zelf te kiezen, met het rapport van de reviewers eronder.
Een review met haar bevindingen: per bevinding het voorstel van de PM, wat u al beslistte en uw keuze. Een demo met verzonnen gegevens.

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

Projecten die in productie draaien, sturen hun fouten versleuteld naar vigil. Daar ziet u per project welke fouten er zijn, hoe vaak ze voorkomen en of een opgeloste fout terugkomt.
Het scherm Fouten in vigil: bovenaan vier tegels (open, terug, ongeldig en weggevallen), daaronder een tabel met per foutgroep wanneer ze laatst voorkwam, de fout met haar melding en bestand, het project, het niveau, de status open, terug of opgelost, het aantal en de omgeving. Onderaan staan apart twee groepen van een project dat vigil nog niet kent.
Fouten: per project en per fout één groep, met haar status en hoe vaak ze voorkwam. Een demo met verzonnen gegevens.
Het detail van een fout in een lade naast de lijst: bovenaan de fout met project, niveau en status, knoppen om de groep open of opgelost te zetten, en daaronder de melding, het bestand, de eerste en laatste keer, het aantal, de omgeving, de release, een trace van tien regels en de context.
Het detail van een fout in een lade naast de lijst: melding, trace en context, als platte tekst. Een demo met verzonnen gegevens.

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

Niet elk idee wordt een opdracht. Tussen de inbox en de opdracht zit de analyse: wat is het probleem, welke opties zijn er, wat raden we aan en hoe groot is het.

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.

Vooruitblik

Waar het naartoe gaat

Alles hierboven werkt vandaag. Wat volgt, is gepland en nog niet gebouwd: vigil wordt de cockpit van waaruit het hele team gestuurd wordt, niet alleen de plek waar het werk wordt bijgehouden.

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.

Zelf gebruiken?

vigil is nog niet als pakket beschikbaar. Beheert u zelf een portfolio en wil u weten of het bij u past? Mail ons.

Vraag ernaar Terug naar Developers