Release notes uit sprintdemo's, in de woorden van het team zelf

De release gaat dinsdag de deur uit en de release notes zijn nog een lege pagina. Wat erin zit, is hardop gezegd: twee sprintdemo's, een ontwikkelaar die elke wijziging laat zien, iemand die terloops opmerkt dat terugkerende opdrachten in één geval nog steeds niet synchroniseren. De commitlog bevat de code, niet de uitleg, en de tracker zegt "Done" in de afkortingen van de ontwikkelaars. De beste beschrijving van elke wijziging is wat de ontwikkelaar zei terwijl hij of zij die liet zien.

Een kortere route: neem sprintdemo's op in Speak-Y, druk op een sneltoets wanneer een ontwikkelaar iets laat zien dat live gaat of een bekend probleem noemt, en vraag vóór de release uw AI-assistent om de markeringen via MCP te verzamelen voor de releasetag en de notes op te stellen. Elke regel komt terug met wie het zei, in diens eigen woorden, de datum van de demo, de tijd in de opname en het ticket om te controleren. Bevestigen wat live gaat, schrijven voor klanten en data beloven blijft bij mensen.

Deze gids volgt de macOS-app van Speak-Y en de MCP-server zoals gecontroleerd op 17 november 2026, met één verzonnen voorbeeld: Priya Nair, productmanager bij Crewboard, een planningsapp voor buitendienstteams, levert release 4.2 op 24 november aan klanten. Die bevat het werk van twee sprints, getoond in demo's op 30 oktober en 13 november.

Wat hebben release notes nodig uit een sprintdemo?

Gidsen over release notes zijn het eens over de vorm. Keep a Changelog (versie 1.1.0) begint bij "changelogs zijn voor mensen, niet voor machines", groepeert wijzigingen per type — Added, Changed, Deprecated, Removed, Fixed, Security — en waarschuwt ertegen de git-log erin te dumpen. De stijlgids voor documentatie van MongoDB houdt in elke set release notes een sectie Known issues aan, ook als daar "None for this release" staat, en vraagt per probleem het effect op de gebruiker en een eventuele workaround (beide opgezocht op 17 november 2026).

De demo is waar deze feiten hardop worden gezegd. De Scrum Guide beschrijft de Sprint Review als een werksessie met stakeholders, niet alleen een presentatie — de uitleg, de vragen en de kanttekeningen zitten dus allemaal in het gesprek. Vier dingen gaan verloren tussen de demo en de notes:

Vóór de eerste demo: twee notitietypen en een releasetag

Open Instellingen → Notities. Hernoem onder Notitietypen het standaardtype Moment markeren naar Shipped (live gegaan) en laat het op ⌥1 staan. Klik op Notitietype toevoegen, typ Known issue (bekend probleem) in Naam van type, klik op Opslaan, daarna op Sneltoets instellen en druk op ⌥2.

Kies één tag voor de release, zoals release-4-2, en zet die op elke demo waarvan het werk erin gaat. Vóór de release leest de assistent dan precies deze gesprekken, en niets uit een eerdere release of een klantgesprek.

Wat elke markering wordt in de release notes: markeringen Shipped en Known issue, en het aarzelende 'zou erin moeten zitten' dat geen markering is
Twee notitietypen sorteren de demo terwijl die loopt; een misschien wacht op de tracker.

Tijdens de demo: laat de ontwikkelaar het tonen, druk op de toets

Neem de demo op als vergadering. Er doet geen bot mee: Speak-Y neemt uw microfoon en het geluid van het gesprek op uw Mac op, dus het werkt hetzelfde in Zoom, Google Meet of Microsoft Teams. Zijn er mensen van buiten het team bij, zeg dan aan het begin dat de demo wordt opgenomen — zie is het legaal om vergaderingen op te nemen voor hoe de regels voor toestemming verschillen.

Drie gewoonten maken de markeringen bruikbaar:

  1. Druk na de zin. Een markering beslaat de laatste 15 seconden van het gesprek, dus de beschrijving die net is uitgesproken valt erbinnen.
  2. Vraag "wat kan de gebruiker nu?" Dat maakt van de demo van een endpoint een zin die een klant begrijpt. Markeer het antwoord op ⌥1.
  3. Vraag naar de randgevallen. "Werkt het ook voor terugkerende opdrachten?" haalt de kanttekening boven terwijl de ontwikkelaar nog in beeld is. Markeer die op ⌥2.

In de demo van 13 november markeert Priya twee wijzigingen en één bekend probleem. Op 08:15 zegt mobiele ontwikkelaar Hana Kim: "Monteurs kunnen nu hun dag herschikken door opdrachten te slepen in de mobiele app, en de planner ziet de nieuwe volgorde meteen." Op 19:35, gevraagd of het werkt voor terugkerende opdrachten, antwoordt Hana: "Terugkerende opdrachten synchroniseren nog steeds niet met Google Calendar als de reeks een uitzondering heeft. Je moet het evenement met de hand aanpassen." Priya markeert het als bekend probleem. Als backendontwikkelaar Marco Lee toevoegt dat CSV-export "erin zou moeten zitten, als QA het vrijdag goedkeurt", markeert ze dat niet: het is iets om te controleren, niet iets om aan te kondigen.

Na de demo: geef de sprekers een naam en voeg de tag toe

Klik op het tabblad Per spreker op elke sprekerchip en typ naam en rol — "Hana Kim, mobiel" — zodat het concept mensen citeert en geen nummers. Voeg de tag release-4-2 toe. De chips boven de transcriptie tellen de markeringen per type, en een klik op een chip toont alleen die antwoorden.

De Speak-Y-opname van de sprintdemo van 13 november op Per spreker, met markeringen Shipped en Known issue naast de antwoorden van de ontwikkelaars
Elke markering staat naast het antwoord waar ze bij hoort, met de naam van de ontwikkelaar en de tijd in de demo.

Dezelfde opname dient ook voor de volgende vergadering: de retrospective kan ervan uitgaan, zoals in opvolging van de sprintretrospective.

Vraag uw assistent om het concept

Koppel uw assistent één keer aan de MCP-server van Speak-Y: AI-assistent verbinden in het accountmenu onder in de zijbalk, of Instellingen → Integraties, en dan Verbinden naast Claude, ChatGPT of Cursor. De stappen staan in vergadernotities koppelen aan AI-assistenten. De server is gratis in elk abonnement en leest de bibliotheek op uw Mac.

Bewaar vaste instructies in een project in Claude of ChatGPT, zodat het verzoek vóór elke release één regel is:

Stel de release notes op voor Crewboard 4.2:
demogesprekken met de tag "release-4-2".

Regels:
- Gebruik alleen mijn markeringen Shipped en
  Known issue.
- Groepeer als Toegevoegd, Gewijzigd, Opgelost,
  Bekende problemen.
- Per item: de woorden van de ontwikkelaar, wie
  het zei, de datum van de demo en de tijd,
  zoals (13 nov, 08:15).
- Voeg "Controleren:" toe met het ticket om te
  bevestigen. Verzin nooit een ticketnummer.
- Zet alles wat met "zou erin moeten zitten" of
  "denk ik" is gezegd bij onbevestigd.
- Geen tekst voor klanten en geen data.

De assistent roept list_recordings aan met de tag en leest elke demo. Naast de transcriptie geeft Speak-Y hem een lijst Notes — elke markering met tijd, type, spreker en eerste woorden. De tijd van een markering is het moment waarop u op de toets drukte, een paar seconden na het begin van het antwoord; het concept noemt het begin van het antwoord:

Release 4.2 — concept (uit sprintdemo's)
Toegevoegd
- Slepen om de dag te herschikken. Hana Kim:
  "Monteurs kunnen nu hun dag herschikken door
  opdrachten te slepen in de mobiele app."
  (13 nov, 08:15)
  Controleren: ticket herschikken, mobiele release
Gewijzigd
- Herinneringen voor opdrachten. Marco Lee:
  "Herinneringen gaan nu een uur voor de opdracht
  uit, niet de avond ervoor." (30 okt, 14:05)
  Controleren: ticket herinneringsinstellingen

Bekende problemen
- Hana Kim: "Terugkerende opdrachten
  synchroniseren nog steeds niet met Google
  Calendar als de reeks een uitzondering heeft.
  Je moet het evenement met de hand aanpassen."
  (13 nov, 19:40)

Onbevestigd
- CSV-export. Marco Lee: "Zou erin moeten
  zitten, als QA het vrijdag goedkeurt."
  (13 nov, 23:10)
Wat de assistent via MCP leest — de markeringen met tijden, typen en sprekers — en het concept van de release notes waarin hij ze groepeert
Wijzigingen zijn per type gegroepeerd; elke regel houdt de demo en de tijd waarop het werd gezegd.

De demo's weten niet wat er daarna gebeurde. Schuift QA de CSV-export door naar de volgende release, zeg dat dan in dezelfde chat: houd de rechter ⌘ (Right ⌘) ingedrukt in het berichtveld, dicteer "CSV-export is niet door QA gekomen, gaat naar 4.3", laat los en verstuur. De assistent haalt de regel uit het concept en houdt ernaast wat er in de demo is gezegd.

Wat bij de productmanager blijft

Het concept weet wat het team heeft gezegd. Vier dingen kan het niet:

Vier controles voordat het concept gepubliceerde release notes wordt, elk met het waarschuwingssignaal dat het nog niet klaar is
De demo's vertellen wat er is gezegd; de tracker, de formulering en de beloften zijn aan mensen.

Grenzen en kosten

In het kort

Shipped op ⌥1, Known issue op ⌥2, één tag per release. Vraag wat de gebruiker nu kan, vraag naar de randgevallen en druk op de toets; daarna de namen van de sprekers en de tag. Vóór de release levert één verzoek een concept op, gegroepeerd per type, met de woorden van de ontwikkelaars, tijden en het ticket om te controleren; wat live gaat, de formulering voor klanten en elke belofte zijn aan u. Om de planningsvergadering aan het andere eind van de sprint om te zetten in taken, zie van sprintplanning naar concepttaken in Claude Code.

FAQ

Kan een AI-assistent release notes opstellen uit opgenomen sprintdemo's?

Hij kan een concept maken uit wat het team heeft gezegd. Gekoppeld aan de MCP-server van Speak-Y leest Claude, ChatGPT of Cursor de demogesprekken met uw releasetag — de transcriptie per spreker en een lijst Notes met uw markeringen en hun tijdstippen — en groepeert de gemarkeerde momenten in Shipped en Known issues, met de woorden van de ontwikkelaar, de datum van de demo en de tijd in de opname. Wat echt live gaat, wordt daarna in de tracker gecontroleerd.

Hoe markeer ik tijdens een sprintdemo wat live gaat?

Maak notitietypen aan in Speak-Y onder Instellingen → Notities: hernoem het standaardtype Moment markeren naar Shipped op ⌥1 en voeg Known issue op ⌥2 toe. Eén druk markeert de laatste 15 seconden van het gesprek met dat type, zodat de zin die de ontwikkelaar net uitsprak al gesorteerd in de lijst van de assistent belandt, met spreker en tijd.

Is een demo genoeg om te zeggen dat een functie in de release zit?

Nee. Een demo laat zien dat iets op iemands computer werkt; de tracker en de releasebranch bepalen of het live gaat. Vraag de assistent om bij elk item een regel Controleren met het ticket dat het moet bevestigen, om alles wat met 'zou erin moeten zitten' of 'denk ik' is gezegd als onbevestigd op te nemen, en om nooit een ticketnummer te verzinnen.

Moeten release notes de woorden van de ontwikkelaars behouden?

In het concept wel, in de gepubliceerde notes niet. De zin van de ontwikkelaar is de nauwkeurigste beschrijving van de wijziging en met de tijd in de opname kunt u hem terugluisteren; de tekst voor klanten herschrijft de productmanager of de schrijver, in termen van wat de gebruiker nu kan.

Welk Speak-Y-abonnement heb ik nodig voor sprintdemo's van 45 minuten?

Pro of hoger. Gecontroleerd op speak-y.com op 17 november 2026: Free stopt een vergaderopname na 30 minuten, Pro ($10 per maand) na een uur, en Pro+ ($15) en Max ($30) na vier uur. De MCP-server is gratis in elk abonnement.