Sprints y reportes
Sin limites de tiempo, el trabajo se expande para siempre. Los sprints fuerzan una cadencia: planifica, ejecuta, mide, ajusta. Funcionan igual si el trabajo lo hacen humanos o agentes. Cada cierre de sprint te obliga a evaluar que se hizo, que quedo pendiente y que aprendiste. Sin esta disciplina, los proyectos se diluyen.
Un sprint es una iteracion con limite de tiempo dentro de un board. Permite planificar que work items se van a completar en un periodo determinado, hacer seguimiento del progreso y generar reportes al cierre.
Conceptos clave
- Cada board puede tener un solo sprint activo a la vez.
- Un sprint tiene fecha de inicio, fecha de fin y un objetivo.
- Los work items del board se asocian al sprint activo.
- Al cerrar un sprint se genera automaticamente un changelog y metricas de rendimiento.
- El historial de sprints anteriores se conserva con sus reportes.
Crear un sprint
- Accede al board donde quieres crear el sprint.
- Selecciona Nuevo Sprint.
- Completa los campos:
| Campo | Descripcion | Obligatorio |
|---|---|---|
name | Nombre del sprint (e.g., "Sprint 14 - Auth y Permisos") | Si |
startDate | Fecha de inicio | Si |
endDate | Fecha de fin | Si |
goal | Objetivo del sprint: que se quiere lograr | No |
- Confirma la creacion. El sprint queda activo inmediatamente.
Solo puede haber un sprint activo por board. Si ya existe uno activo, deberas cerrarlo antes de crear uno nuevo.
Asociar work items
Los work items que estan en el board cuando el sprint esta activo forman parte del sprint. No hay una accion explicita de "asociar" items al sprint: todos los items presentes en el board durante el sprint se contabilizan.
Esto significa que:
- Items nuevos creados durante el sprint se incluyen automaticamente.
- Items movidos al board durante el sprint se incluyen.
- Items archivados durante el sprint dejan de contabilizarse.
Preview de items completados
Antes de cerrar un sprint, puedes previsualizar que items se consideran "done". Almirant identifica los items que estan en columnas con el rol isDone = true y los presenta como candidatos a completados.
Esto te permite verificar si falta mover algun item a la columna correcta antes del cierre.
Cerrar un sprint
Existen tres modalidades de cierre, cada una para un escenario distinto:
1. Cierre normal
Cierre estandar al finalizar el periodo planificado.
- Accede al sprint activo del board.
- Selecciona Cerrar Sprint.
- Revisa el resumen de items completados vs. pendientes.
- Decide que hacer con los items no completados (moverlos al backlog o al siguiente sprint).
- Confirma el cierre.
2. Cierre adhoc
Cierre anticipado cuando se decide terminar el sprint antes de la fecha planificada. Util cuando se necesita replantear el trabajo o los objetivos cambiaron.
- Accede al sprint activo.
- Selecciona Cerrar Sprint Adhoc.
- Revisa y confirma. Los items pendientes se gestionan de la misma forma que en el cierre normal.
3. Cierre por fecha
Cierre automatico basado en una fecha especifica. Util para sprints que terminan en una fecha distinta a la planificada originalmente.
- Accede al sprint activo.
- Selecciona Cerrar por Fecha.
- Indica la fecha de corte.
- Los items completados antes de esa fecha se contabilizan como terminados.
Items no finalizados
Al cerrar un sprint, los work items que no estan en columnas isDone se consideran no finalizados. Puedes:
- Moverlos al backlog -- Los items vuelven a la columna por defecto para re-priorizacion.
- Incluirlos en el siguiente sprint -- Los items permanecen en su columna actual y se contabilizan en el nuevo sprint.
Changelog automatico
Al cerrar un sprint, Almirant genera automaticamente un changelog que incluye:
- Lista de items completados, agrupados por tipo.
- Resumen de los cambios realizados durante el sprint.
- Notas relevantes extraidas de los items.
El changelog se puede regenerar si es necesario usando el tool regenerate_sprint_changelog.
Reportes y metricas
Cada sprint cerrado genera un reporte con las siguientes metricas:
| Metrica | Descripcion |
|---|---|
| Velocidad (velocity) | Numero de items completados en el sprint |
| Distribucion por tipo | Desglose de items completados por tipo (epic, feature, story, task) |
| Distribucion por prioridad | Desglose por nivel de prioridad (urgent, high, medium, low) |
| Distribucion por asignado | Que trabajo completo cada miembro del equipo |
| Coste AI | Coste total de las sesiones AI ejecutadas durante el sprint |
| Comparacion con sprints anteriores | Evolucion de la velocidad y metricas respecto a sprints previos |
Los reportes incluyen visualizaciones graficas y la posibilidad de adjuntar screenshots para documentar el estado del producto al cierre del sprint.
Historial de sprints
Todos los sprints cerrados se conservan en el historial del board. Puedes acceder a cualquier sprint anterior para consultar:
- El reporte con metricas.
- El changelog generado.
- Los work items que formaron parte del sprint.
- Screenshots adjuntados.
Para developers
Herramientas MCP
| Tool | Descripcion | Parametros principales |
|---|---|---|
list_sprints | Lista todos los sprints de un board | boardId |
get_sprint | Obtiene los detalles de un sprint | sprintId |
get_active_sprint | Obtiene el sprint activo de un board | boardId |
create_sprint | Crea un nuevo sprint | boardId, name, startDate, endDate, goal |
close_sprint | Cierra el sprint activo (normal) | sprintId |
close_sprint_adhoc | Cierra el sprint anticipadamente | sprintId |
close_sprint_by_date | Cierra el sprint con fecha de corte | sprintId, date |
get_sprint_work_items | Obtiene los items asociados al sprint | sprintId |
preview_done_items | Previsualiza items completados antes de cerrar | sprintId |
regenerate_sprint_changelog | Regenera el changelog de un sprint cerrado | sprintId |
Ejemplo: Crear un 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"
Ejemplo: Previsualizar items completados
Tool: preview_done_items
Parametros:
sprintId: "uuid-del-sprint"
Devuelve la lista de items que se marcarian como completados al cerrar el sprint, permitiendo verificar antes del cierre.
Ejemplo: Cerrar sprint y generar reporte
Tool: close_sprint
Parametros:
sprintId: "uuid-del-sprint"
Al ejecutar el cierre, se generan automaticamente el changelog y las metricas del sprint.