Release notes a partir das demos de sprint, nas palavras da equipe

O release sai na terça-feira e as release notes ainda são uma página em branco. O que entrou nele foi dito em voz alta: duas demos de sprint, um desenvolvedor mostrando cada mudança, alguém comentando de passagem que os serviços recorrentes ainda não sincronizam em um caso. O log de commits tem o código, não a explicação, e o tracker diz «Done» na linguagem abreviada dos desenvolvedores. A melhor descrição de cada mudança é o que o desenvolvedor disse enquanto a mostrava.

Um caminho mais curto: grave as demos de sprint no Speak-Y, aperte um atalho quando um desenvolvedor mostrar algo que vai ao ar ou citar um problema conhecido e, antes do release, peça ao seu assistente de IA que reúna as marcas via MCP pela tag do release e redija as notas. Cada linha volta com quem disse, nas palavras da pessoa, a data da demo, o horário na gravação e o ticket a conferir. Confirmar o que vai ao ar, escrever para os clientes e prometer datas continua com as pessoas.

Este guia acompanha o app do Speak-Y para macOS e o seu servidor MCP como estavam em 17 de novembro de 2026, com um exemplo inventado: Priya Nair, gerente de produto da Crewboard, um app de agendamento para equipes de serviço de campo, entrega o release 4.2 aos clientes em 24 de novembro. Ele reúne o trabalho de duas sprints, apresentado nas demos de 30 de outubro e 13 de novembro.

Do que as release notes precisam numa demo de sprint?

Os guias de release notes concordam sobre o formato. O Keep a Changelog (versão 1.1.0) parte de «changelogs são para humanos, não para máquinas», agrupa as mudanças por tipo — Added, Changed, Deprecated, Removed, Fixed, Security — e desaconselha despejar o log do git nelas. O guia de estilo da documentação da MongoDB mantém uma seção Known issues em todas as release notes, mesmo quando ela diz «None for this release», e pede, para cada problema, o efeito sobre o usuário e uma solução alternativa, se houver (ambos pesquisados em 17 de novembro de 2026).

A demo é onde esses fatos são ditos em voz alta. O Scrum Guide descreve a Sprint Review como uma sessão de trabalho com as partes interessadas, não apenas uma apresentação — então a explicação, as perguntas e as ressalvas estão todas na chamada. Quatro coisas se perdem entre a demo e as notas:

Antes da primeira demo: dois tipos de nota e uma tag do release

Abra Configurações → Notas. Em Tipos de notas, renomeie o padrão Marcar o momento para Shipped (entregue) e mantenha-o no ⌥1. Clique em Adicionar tipo de nota, digite Known issue (problema conhecido) em Nome do tipo, clique em Salvar, depois em Definir atalho e pressione ⌥2.

Escolha uma tag para o release, por exemplo release-4-2, e coloque-a em toda demo cujo trabalho entra nele. Antes do release, o assistente lê exatamente essas chamadas, e nada de um release anterior ou de uma chamada com cliente.

O que cada marca vira nas release notes: as marcas Shipped e Known issue, e o «deve entrar» hesitante que não é uma marca
Dois tipos de nota organizam a demo enquanto ela acontece; um talvez espera pelo tracker.

Durante a demo: deixe o desenvolvedor mostrar e aperte a tecla

Grave a demo como reunião. Nenhum bot entra: o Speak-Y grava o seu microfone e o som da chamada no seu Mac, então funciona do mesmo jeito no Zoom, no Google Meet ou no Microsoft Teams. Se houver pessoas de fora da equipe, avise no início que a demo está sendo gravada — veja é legal gravar reuniões? para saber como as regras de consentimento variam.

Três hábitos tornam as marcas úteis:

  1. Aperte depois da frase. Uma marca cobre os últimos 15 segundos da chamada, então a descrição que acabou de ser dita cai dentro dela.
  2. Pergunte «o que o usuário consegue fazer agora?». Isso transforma a demo de um endpoint numa frase que o cliente entende. Marque a resposta no ⌥1.
  3. Pergunte pelos casos-limite. «Funciona para serviços recorrentes?» traz a ressalva à tona enquanto o desenvolvedor ainda está na tela. Marque no ⌥2.

Na demo de 13 de novembro, Priya marca duas mudanças e um problema conhecido. Aos 08:15, a desenvolvedora mobile Hana Kim diz: «Agora os técnicos podem reorganizar o dia arrastando os serviços no app mobile, e o despachante vê a nova ordem na hora.» Aos 19:35, perguntada se funciona para serviços recorrentes, Hana responde: «Serviços recorrentes ainda não sincronizam com o Google Calendar se a série tiver uma exceção. É preciso editar o evento à mão.» Priya marca como problema conhecido. Quando o desenvolvedor de backend Marco Lee acrescenta que a exportação para CSV «deve entrar, se o QA aprovar na sexta», ela não marca: é algo a conferir, não algo a anunciar.

Depois da demo: dê nome aos falantes e adicione a tag

Na aba Por falantes, clique em cada chip de falante e digite o nome e a função — «Hana Kim, mobile» —, para que o rascunho cite pessoas, não números. Adicione a tag release-4-2. Os chips acima da transcrição contam as marcas por tipo, e um clique em um chip mostra só essas falas.

A gravação no Speak-Y da demo de sprint de 13 de novembro na aba Por falantes, com marcas Shipped e Known issue ao lado das falas dos desenvolvedores
Cada marca fica ao lado da fala a que pertence, com o nome do desenvolvedor e o horário na demo.

A mesma gravação serve também para a próxima reunião: a retrospectiva pode partir dela, como em dar seguimento à retrospectiva da sprint.

Peça o rascunho ao assistente

Conecte o seu assistente ao servidor MCP do Speak-Y uma vez: Conectar assistente de IA no menu da conta, na parte de baixo da barra lateral, ou Configurações → Integrações, e depois Conectar ao lado de Claude, ChatGPT ou Cursor. Os passos estão em como conectar notas de reunião a assistentes de IA. O servidor é gratuito em todos os planos e lê a biblioteca no seu Mac.

Salve instruções fixas num projeto do Claude ou do ChatGPT, para que antes de cada release o pedido caiba numa linha:

Redija as release notes do Crewboard 4.2:
chamadas de demo com a tag «release-4-2».

Regras:
- Use só as minhas marcas Shipped e Known issue.
- Agrupe em Adicionado, Alterado, Corrigido,
  Problemas conhecidos.
- Para cada item: as palavras do desenvolvedor,
  quem disse, a data da demo e o horário, como
  (13 nov., 08:15).
- Acrescente «Conferir:» com o ticket a
  confirmar. Nunca invente um número de ticket.
- Liste como não confirmado tudo o que foi dito
  com «deve entrar» ou «acho».
- Sem texto para clientes e sem datas.

O assistente chama list_recordings com a tag e lê cada demo. Junto com a transcrição, o Speak-Y entrega uma lista Notes — cada marca com o horário, o tipo, o falante e as primeiras palavras. O horário de uma marca é o momento em que você apertou a tecla, alguns segundos depois do início da fala; o rascunho cita o início da fala:

Release 4.2 — rascunho (das demos de sprint)
Adicionado
- Arrastar para reorganizar o dia. Hana Kim:
  «Agora os técnicos podem reorganizar o dia
  arrastando os serviços no app mobile.»
  (13 nov., 08:15)
  Conferir: ticket de reordenação, release mobile
Alterado
- Lembretes de serviço. Marco Lee: «Os lembretes
  agora saem uma hora antes do serviço, não na
  noite anterior.» (30 out., 14:05)
  Conferir: ticket das configurações de lembrete

Problemas conhecidos
- Hana Kim: «Serviços recorrentes ainda não
  sincronizam com o Google Calendar se a série
  tiver uma exceção. É preciso editar o evento
  à mão.» (13 nov., 19:40)

Não confirmado
- Exportação para CSV. Marco Lee: «Deve entrar,
  se o QA aprovar na sexta.» (13 nov., 23:10)
O que o assistente lê via MCP — as marcas com horários, tipos e falantes — e o rascunho de release notes em que ele as agrupa
As mudanças ficam agrupadas por tipo; cada linha mantém a demo e o horário em que foi dita.

As demos não sabem o que aconteceu depois delas. Se o QA passar a exportação para CSV para o próximo release, diga isso no mesmo chat: segure o ⌘ direito (Right ⌘) no campo de mensagem, dite «A exportação para CSV não passou no QA, vai para o 4.3», solte e envie. O assistente tira a linha do rascunho e mantém ao lado dela o que foi dito na demo.

O que fica com o gerente de produto

O rascunho sabe o que a equipe disse. Quatro coisas ele não consegue fazer:

Quatro verificações antes de o rascunho virar release notes publicadas, cada uma com o sinal de alerta que mostra que ele não está pronto
As demos dizem o que foi falado; o tracker, o texto e as promessas cabem às pessoas.

Limites e custos

Em resumo

Shipped no ⌥1, Known issue no ⌥2, uma tag por release. Pergunte o que o usuário consegue fazer agora, pergunte pelos casos-limite, aperte a tecla; depois, os nomes dos falantes e a tag. Antes do release, um único pedido traz um rascunho agrupado por tipo, com as palavras dos desenvolvedores, os horários e o ticket a conferir; o que vai ao ar, o texto para os clientes e qualquer promessa são seus. Para transformar em tarefas a reunião de planejamento, na outra ponta da sprint, veja do planejamento da sprint a rascunhos de tarefas no Claude Code.

FAQ

Um assistente de IA consegue redigir release notes a partir de demos de sprint gravadas?

Consegue redigir um rascunho a partir do que a equipe disse. Conectado ao servidor MCP do Speak-Y, o Claude, o ChatGPT ou o Cursor lê as chamadas de demo com a tag do release — a transcrição por falante e uma lista Notes com as suas marcas e os horários — e agrupa os momentos marcados em Shipped e Known issues, com as palavras do desenvolvedor, a data da demo e o horário na gravação. O que de fato entra no release é conferido depois no tracker.

Como marco o que foi entregue durante uma demo de sprint?

Crie tipos de nota no Speak-Y em Configurações → Notas: renomeie o padrão Marcar o momento para Shipped no ⌥1 e adicione Known issue no ⌥2. Cada toque marca os últimos 15 segundos da chamada com aquele tipo, então a frase que o desenvolvedor acabou de dizer chega à lista do assistente já classificada, com o falante e o horário.

Uma demo basta para dizer que uma funcionalidade está no release?

Não. Uma demo mostra que algo funciona na máquina de alguém; o tracker e a branch de release dizem se aquilo vai ao ar. Peça ao assistente uma linha Conferir com o ticket a confirmar para cada item, que liste como não confirmado tudo o que foi dito com «deve entrar» ou «acho» e que nunca invente um número de ticket.

As release notes devem manter as palavras dos desenvolvedores?

No rascunho, sim; nas notas publicadas, não. A frase do desenvolvedor é a descrição mais precisa da mudança, e o horário na gravação permite ouvi-la de novo; o texto para os clientes é reescrito pelo gerente de produto ou pelo redator, em termos do que o usuário agora consegue fazer.

Qual plano do Speak-Y preciso para demos de sprint de 45 minutos?

Pro ou superior. Conferido em speak-y.com em 17 de novembro de 2026: o Free encerra a gravação de uma reunião aos 30 minutos, o Pro ($10 por mês) a uma hora, e o Pro+ ($15) e o Max ($30) às quatro horas. O servidor MCP é gratuito em todos os planos.