AI-agent voor de dagelijkse sprintupdate: je GitHub-repository elke ochtend samengevat in een wiki

Een bruikbare sprintupdate is kort, gedateerd en van dag tot dag vergelijkbaar. Hij is ook lastig te maken: je moet de repository openen, de gemergede pull requests tellen, zoeken welke op review wachten, de issues doorlopen, nagaan of een release in aantocht is en twee alinea's schrijven die niemand tijd heeft om te verfijnen. Meestal bestaat de update niet, of hij wordt vlak voor het overleg in elkaar gezet, met blokkades die te laat opvallen. Het is een ideale taak voor een autonome AI-agent: ze herhaalt zich identiek, steunt op al gestructureerde data en is in één oogopslag te controleren.

De inspiratie: de ochtendupdate die niemand heeft samengesteld

Het uitgangspunt is een gebruik uit verhalen van mensen die autonome agenten inzetten: agenten die de tools van het ontwikkelteam lezen, tellen wat er gebeurd is en elke ochtend een sprintrapport neerleggen. Wat in die verhalen terugkomt, is niet de hoeveelheid data maar de regelmaat: de update bestaat elke dag, met dezelfde opbouw, zodat je trends ziet in plaats van te reageren op één los cijfer.

Atako neemt dat idee over met één agent en één resultaat. De agent leest GitHub, rekent, schrijft en publiceert. Hij verandert niets in de repository, en het rapport is het enige wat hij produceert.

Wat de agent doet

De deliveryanalist leest de repository in GitHub, die je opgeeft als eigenaar/naam. Bij elke ronde volgt hij een vaste methode.

Eerst telt hij, over zeven voortschrijdende dagen vanaf de datum van vandaag, de gemergede pull requests, de nog open met hun leeftijd, die welke langer dan drie dagen op review wachten, de geopende en gesloten issues en de gepubliceerde releases. Daarna herkent hij de blokkades: pull requests die langer dan vijf dagen open staan, issues die zich rond hetzelfde onderwerp opstapelen, een release die te laat lijkt gezien de commits. Elk noemt hij met zijn link en auteur. Ten slotte vergelijkt hij met de voorgaande zeven dagen en zegt wat er is verschoven.

Dan schrijft hij in de projectwiki een nieuwe pagina «Sprintupdate - » gevolgd door de datum van de dag. Bestaat de pagina van de dag al, dan werkt hij die bij in plaats van een tweede aan te maken. De opbouw verandert niet: de drie of vier cijfers die tellen, de voortgang ten opzichte van de vorige periode, de blokkades en pull requests die blijven liggen, en de beslissingen om te overwegen. Hij begint met de conclusie, is in twee minuten te lezen en vat het belangrijkste samen in de chat.

Wat de agent niet doet

De analist leest, hij schrijft nooit in GitHub: geen commentaar, label, review, merge of sluiting. Hij pusht geen code. Hij neemt met niemand contact op: het rapport en de chat zijn zijn enige uitvoerkanalen. Hij verzint nooit een cijfer of link, en een ontbrekend getal wordt «niet beschikbaar» geschreven.

Elke dag heeft zijn pagina: de agent overschrijft nooit een eerdere dag, zodat er een historie ontstaat die het team kan teruglezen. Feiten zijn gescheiden van interpretatie, en de interpretatie is als zodanig aangegeven. Het rapport stelt prioriteiten voor, het legt ze niet op: dat is het principe van een ontwerp met menselijke goedkeuring.

Zo richt je het in Atako in

Vanaf de pagina van deze use case verloopt de uitrol in vier stappen.

1. GitHub koppelen. Geef Atako leestoegang tot de te volgen repository wanneer erom wordt gevraagd. De koppeling wordt gecontroleerd voordat er iets wordt aangemaakt.
2. Je context invullen. Geef de repository op als eigenaar/naam, en de lezers van het rapport, zodat de toon erbij past.
3. Uitrollen. Eén handeling maakt de agent en het project «Sprintupdate» aan. De agent wordt ingericht en krijgt zijn eerste instructies zelf.
4. Eerste update, daarna een dagelijks ritme. De analist maakt het eerste rapport over de laatste zeven dagen en plant daarna zelf zijn ronde van 8:00 uur, elke ochtend.

Heb je nog geen account, dan start het aanmaken ervan je proefperiode en wordt het scenario direct daarna ingericht. Heeft je beheerder je niet toegestaan agenten aan te maken, dan meldt de uitrol dat en stopt.

Waar je de resultaten ziet

Het rapport staat in de wiki van het project «Sprintupdate», één pagina per dag, van nieuw naar oud. De samenvatting van de agent komt ook in zijn chat binnen, zodat je het belangrijkste op je telefoon kunt lezen voordat je de pagina opent. Op de Atako-werkvloer verschijnt de analist met zijn activiteit: je ziet wanneer hij de repository leest en wanneer hij schrijft, zonder te hoeven vragen hoe ver de update is.

Je kunt met hem praten in zijn chat. Vraag waar een cijfer vandaan komt, laat een blokkade toelichten, een andere repository volgen of de update vanuit een andere hoek opnieuw maken. De agent onthoudt zijn eerdere rondes.

Waarborgen

De toegang is bewust smal en alleen-lezen: acht GitHub-tools, om repositories op te vragen, een repository te lezen, pull requests op te vragen en te lezen, issues op te vragen en te doorzoeken en commits en releases op te vragen. Een agent die een korte lijst tools ziet, gebruikt ze betrouwbaarder dan een agent die verdwaalt in een catalogus van honderden. Standaard wordt niets toegekend, en elke toegang kan op elk moment in Atako worden ingetrokken.

De menselijke goedkeuring zit op de beslissing. Het rapport signaleert de blokkades en de pull requests die blijven liggen; het team kiest of het een reviewer aanspoort, een pull request opsplitst of een release uitstelt. De agent ziet alleen wat GitHub hem geeft: een pull request zonder beschrijving of een repository met issues zonder labels levert een minder nauwkeurige update op, en het rapport zegt dat in plaats van het te verbergen.

Wat je kunt verwachten

Verwacht een eerste update die nuttig maar nog algemeen is, en die nauwkeurig wordt zodra je in de chat de lezers en de drempels hebt aangepast, bijvoorbeeld door pull requests te laten signaleren die twee in plaats van drie dagen op review wachten. De waarde komt uit herhaling: na twee weken kun je de opeenvolgende pagina's vergelijken en zien welke blokkade blijft bestaan en welke trend zich aftekent. Voor een klein technisch team is dat het verschil tussen een overzicht uit het hoofd vlak voor het overleg en een dagelijkse update die gewoon bestaat, met elke dag dezelfde definities.