Sprints e relatórios
Sem limites de tempo, o trabalho se expande para sempre. Os sprints impõem uma cadência: planeje, execute, meça, ajuste. Eles funcionam da mesma forma, seja o trabalho feito por pessoas ou agentes. Cada encerramento de sprint obriga você a avaliar o que foi feito, o que ficou pendente e o que aprendeu. Sem essa disciplina, os projetos se diluem.
Um sprint é uma iteração com prazo definido dentro de um board. Ele permite planejar quais work items serão concluídos em determinado período, acompanhar o progresso e gerar relatórios no encerramento.
Conceitos-chave
- Cada board pode ter apenas um sprint ativo por vez.
- Um sprint tem data de início, data de término e um objetivo.
- Os work items do board são associados ao sprint ativo.
- Ao encerrar um sprint, um changelog e métricas de desempenho são gerados automaticamente.
- O histórico de sprints anteriores é mantido com seus relatórios.
Criar um sprint
- Acesse o board em que deseja criar o sprint.
- Selecione Novo Sprint.
- Preencha os campos:
| Campo | Descrição | Obrigatório |
|---|---|---|
name | Nome do sprint (e.g., "Sprint 14 - Auth y Permisos") | Sim |
startDate | Data de início | Sim |
endDate | Data de término | Sim |
goal | Objetivo do sprint: o que se deseja alcançar | Não |
- Confirme a criação. O sprint ficará ativo imediatamente.
Só pode haver um sprint ativo por board. Se já houver um ativo, você deverá encerrá-lo antes de criar outro.
Associar work items
Os work items que estão no board enquanto o sprint está ativo fazem parte do sprint. Não há uma ação explícita para "associar" items ao sprint: todos os items presentes no board durante o sprint são contabilizados.
Isso significa que:
- Novos items criados durante o sprint são incluídos automaticamente.
- Items movidos para o board durante o sprint são incluídos.
- Items arquivados durante o sprint deixam de ser contabilizados.
Prévia de items concluídos
Antes de encerrar um sprint, você pode visualizar quais items são considerados "done". O Almirant identifica os items que estão em colunas com o papel isDone = true e os apresenta como candidatos a concluídos.
Isso permite verificar se falta mover algum item para a coluna correta antes do encerramento.
Encerrar um sprint
Há três modalidades de encerramento, cada uma para um cenário diferente:
1. Encerramento normal
Encerramento padrão ao final do período planejado.
- Acesse o sprint ativo do board.
- Selecione Encerrar Sprint.
- Revise o resumo de items concluídos versus pendentes.
- Decida o que fazer com os items não concluídos (movê-los para o backlog ou para o próximo sprint).
- Confirme o encerramento.
2. Encerramento ad hoc
Encerramento antecipado quando se decide terminar o sprint antes da data planejada. Útil quando é necessário reformular o trabalho ou os objetivos mudaram.
- Acesse o sprint ativo.
- Selecione Encerrar Sprint Adhoc.
- Revise e confirme. Os items pendentes são gerenciados da mesma forma que no encerramento normal.
3. Encerramento por data
Encerramento automático baseado em uma data específica. Útil para sprints que terminam em uma data diferente da planejada originalmente.
- Acesse o sprint ativo.
- Selecione Encerrar por data.
- Informe a data de corte.
- Os items concluídos antes dessa data são contabilizados como finalizados.
Items não concluídos
Ao encerrar um sprint, os work items que não estão em colunas isDone são considerados não concluídos. Você pode:
- Movê-los para o backlog -- Os items retornam à coluna padrão para repriorização.
- Incluí-los no próximo sprint -- Os items permanecem em sua coluna atual e são contabilizados no novo sprint.
Changelog automático
Ao encerrar um sprint, o Almirant gera automaticamente um changelog que inclui:
- Lista de items concluídos, agrupados por tipo.
- Resumo das alterações realizadas durante o sprint.
- Notas relevantes extraídas dos items.
O changelog pode ser gerado novamente se necessário usando a tool regenerate_sprint_changelog.
Relatórios e métricas
Cada sprint encerrado gera um relatório com as seguintes métricas:
| Métrica | Descrição |
|---|---|
| Velocidade (velocity) | Número de items concluídos no sprint |
| Distribuição por tipo | Detalhamento dos items concluídos por tipo (epic, feature, story, task) |
| Distribuição por prioridade | Detalhamento por nível de prioridade (urgent, high, medium, low) |
| Distribuição por responsável | Qual trabalho cada membro da equipe concluiu |
| Custo de IA | Custo total das sessões de IA executadas durante o sprint |
| Comparação com sprints anteriores | Evolução da velocidade e das métricas em relação a sprints anteriores |
Os relatórios incluem visualizações gráficas e a possibilidade de anexar screenshots para documentar o estado do produto no encerramento do sprint.
Histórico de sprints
Todos os sprints encerrados são mantidos no histórico do board. Você pode acessar qualquer sprint anterior para consultar:
- O relatório com métricas.
- O changelog gerado.
- Os work items que fizeram parte do sprint.
- Screenshots anexados.
Para desenvolvedores
Ferramentas MCP
| Tool | Descrição | Parâmetros principais |
|---|---|---|
list_sprints | Lista todos os sprints de um board | boardId |
get_sprint | Obtém os detalhes de um sprint | sprintId |
get_active_sprint | Obtém o sprint ativo de um board | boardId |
create_sprint | Cria um novo sprint | boardId, name, startDate, endDate, goal |
close_sprint | Encerra o sprint ativo (normal) | sprintId |
close_sprint_adhoc | Encerra o sprint antecipadamente | sprintId |
close_sprint_by_date | Encerra o sprint com data de corte | sprintId, date |
get_sprint_work_items | Obtém os items associados ao sprint | sprintId |
preview_done_items | Visualiza os items concluídos antes de encerrar | sprintId |
regenerate_sprint_changelog | Gera novamente o changelog de um sprint encerrado | sprintId |
Exemplo: criar um sprint
Tool: create_sprint
Parametros:
boardId: "uuid-del-board"
name: "Sprint 14 - Autenticacion"
startDate: "2025-03-01"
endDate: "2025-03-14"
goal: "Completar el sistema de login con Google OAuth y roles de usuario"
Exemplo: visualizar items concluídos
Tool: preview_done_items
Parametros:
sprintId: "uuid-del-sprint"
Retorna a lista de items que seriam marcados como concluídos ao encerrar o sprint, permitindo verificar antes do encerramento.
Exemplo: encerrar um sprint e gerar relatório
Tool: close_sprint
Parametros:
sprintId: "uuid-del-sprint"
Ao executar o encerramento, o changelog e as métricas do sprint são gerados automaticamente.