Escrever notas de versão
- Encontre o intervalo:
git describe --tags --abbrev=0fornece a última tag. Se não houver, use todo o histórico. - Liste os assuntos:
git log <última-tag>..HEAD --no-merges --pretty=format:%s. - Chame a ferramenta MCP
group_commits(servidorteam-kit) com esses assuntos. Ela retorna Markdown agrupado por tipo, com breaking changes primeiro. Se a ferramenta não estiver disponível, agrupe manualmente usando os mesmos cabeçalhos. - Re-escreva para leitores, não para committers: uma frase simples por item, efeito visível para o usuário primeiro, sem ruído de tickets. Mescle duplicatas. Mantenha tudo sob "Breaking changes" e informe o que os usuários devem fazer.
- Saída:
## <versão> (<AAAA-MM-DD>)
<parágrafo de destaque de 2 a 3 frases>
<seções agrupadas>
Nunca invente mudanças que não estejam na lista de commits. Se um commit não estiver claro, leia seu diff (git show <sha> --stat) antes de descrevê-lo. Pergunte ao usuário pelo número da versão caso não consiga inferi-lo.