Naar de inhoud

De ploeg, releasenotes en recepten

Wat een agent in een project mag oppakken en wat het kost, samenvoegen met een handtekening, de standup en risico's, releasenotes per sprint, wat een klant ziet in het klantportaal, en recepten die werk klaarzetten tussen modules.

DocumentatieDe ploeg, releasenotes en recepten

Dit hoort bij een project met sprints in Planning Studio. De ploeg werkt mee als collega's, maar wat naar buiten gaat tekent altijd een mens.

Wat de ploeg mag oppakken

Bij Team staat elke agent met zijn eigen regels voor dit project:

  • Hoeveel tegelijk: bij vol krijgt de agent geen nieuw item.
  • Maandplafond: een bedrag in euro, op je eigen sleutel. Het wordt vooraf getoetst; er is geen noodrem halverwege. Bij het plafond pakt de agent niets meer op, ook niet wat al bij hem lag. Je ziet per agent wat hij deze maand kostte, en op de pagina van een item wat het werk eraan kostte.
  • Hoogste risico: R1 of R2. Een risiconiveau zet een mens; R3 pakt een agent nooit op.
  • Uitgesloten labels: standaard betalen, privacy en juridisch. Een item met zo'n label blijft voor mensen, ook als het klein lijkt.
  • Er moet een criterium staan: zonder criterium weet de agent niet wanneer hij klaar is.
  • Keurder en groene checks: de keurder leest elke pull request van de bouwer, en wie samenvoegen voorstelt heeft groene checks nodig.
  • Gepauzeerd: de agent pakt niets nieuws op; wat al loopt maakt hij af.

Bij het bord van het project, onder Code, zet je per repo of de ploeg erin mag werken. Een nieuwe koppeling staat uit.

Samenvoegen tekent een mens

Op de pagina van een item staat bij een open pull request Samenvoegen voorstellen, als de checks niet rood zijn en er geen wijzigingen gevraagd zijn. Samenvoegen is risiconiveau 3: een mens tekent het onder Goedkeuringen, met een code. De handtekening geldt voor de stand van de branch op dat moment. Verandert de branch daarna, dan vervalt hij en voegen we niets samen.

Standup en risico's

Bij Standup staat per persoon en agent wat sinds gisteren klaar is, waar hij nu aan werkt en wat blokkeert (rode checks, gevraagde wijzigingen of een deadline die voorbij is). Daaronder de risico's: een te volle sprint, een onbekende capaciteit, een deadline voor het einde van de sprint, een item zonder schatting, rode checks, een agent bij zijn plafond. Elke waarschuwing zegt waarom, en gaat over werk, nooit over een persoon. De regisseur leest hetzelfde en schrijft er een samenvatting bij.

Releasenotes

Bij Releasenotes maak je per sprint een concept uit de pull requests die in die sprint zijn samengevoegd, gegroepeerd in Nieuw, Verbeterd en Opgelost. De titel van de pull request is voor het team. De tekst voor de klant schrijf jij, in gewone taal; een regel zonder die tekst gaat niet mee.

Publiceren in het klantportaal gaat naar een klant en is risiconiveau 2: het wacht op een handtekening. Verandert er daarna een regel, dan publiceert de handtekening niets en stel je opnieuw voor. Een gepubliceerde note trek je meteen in.

Wat de klant ziet

Bij het bord van een project voor een klant kies je onder Wat de klant ziet wat die klant in het klantportaal ziet: de voortgang in procenten, de onderdelen (epics) met hun voortgang, de gepubliceerde releasenotes, en de titels en kolom van de items in de lopende sprint. Alleen lezen. Punten, namen van collega's en agents, tijd en risico staan er nooit in. Staat niets aan, dan ziet de klant niets van het project. Een schakelaar telt pas als je op Opslaan drukt.

Recepten

Onder Planning, Recepten staan regels die werk klaarzetten tussen modules. Ze staan standaard uit en tekenen nooit.

  • Deal gewonnen: een project. Een gewonnen deal in Relaties wordt een project met een bord voor die klant, tenzij de klant al een project met die naam heeft.
  • Sprint klaar: releasenotes klaarzetten. Een afgeronde sprint van een project met een klant krijgt een concept. De tekst voor de klant en publiceren doet een mens.
  • Pull request samengevoegd: regel in de releasenotes. Heeft de sprint van het item al een concept, dan komt de pull request erbij.

Elke uitvoering staat in het logboek, ook een overgeslagen, met de reden. Een bericht aan de klant als een issue klaar is, een issue uit een supportvraag en een factuurvoorstel staan in de lijst maar zijn nog niet beschikbaar.

De regisseur

Via onze MCP leest de regisseur dubbelen, een schatting uit vergelijkbaar werk, de standup, de risico's, de retro en de releasenotes. Hij kan een epic met stories voorstellen: dat wordt een actie die je tekent, en pas dan staan de stories in de backlog, zonder sprint en zonder risico.

Wie mag wat

Regels voor agents, repo's voor de ploeg, wat de klant ziet en recepten vragen het recht om te beheren. Releasenotes maken en publiceren voorstellen, en samenvoegen voorstellen, vragen het recht om te plannen. Tekenen volgt de gewone regels voor goedkeuringen.