Tools - Sprints
Los sprints representan periodos de trabajo delimitados dentro de un board. Al cerrar un sprint, los work items completados se archivan y se genera automaticamente un changelog y un reporte visual.
list_sprints
Lista todos los sprints de un board. El sprint abierto aparece primero, seguido de los sprints cerrados ordenados por fecha (mas recientes primero).
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| boardId | string (UUID) | Si | ID del board |
Ejemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Respuesta:
[
{
"id": "sprint-001",
"name": "Sprint 12",
"status": "open",
"startDate": "2025-02-10T00:00:00.000Z",
"endDate": "2025-02-24T00:00:00.000Z",
"boardId": "b1234567-...",
"workItemCount": 0,
"createdAt": "2025-02-10T09:00:00.000Z"
},
{
"id": "sprint-000",
"name": "Sprint 11",
"status": "closed",
"startDate": "2025-01-27T00:00:00.000Z",
"endDate": "2025-02-09T00:00:00.000Z",
"boardId": "b1234567-...",
"workItemCount": 18,
"createdAt": "2025-01-27T09:00:00.000Z"
}
]
get_sprint
Obtiene un sprint por su ID, incluyendo el numero de work items.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| id | string (UUID) | Si | ID del sprint |
Ejemplo:
{
"id": "sprint-001"
}
get_active_sprint
Obtiene el sprint actualmente abierto de un board. Devuelve null si no hay ningun sprint abierto.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| boardId | string (UUID) | Si | ID del board |
Ejemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Respuesta:
{
"id": "sprint-001",
"name": "Sprint 12",
"status": "open",
"startDate": "2025-02-10T00:00:00.000Z",
"endDate": "2025-02-24T00:00:00.000Z",
"boardId": "b1234567-...",
"workItemCount": 0
}
create_sprint
Crea un nuevo sprint en un board. Solo puede haber un sprint abierto a la vez por board.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| boardId | string (UUID) | Si | ID del board |
| name | string | Si | Nombre del sprint |
| startDate | string | No | Fecha de inicio en formato ISO 8601 |
| endDate | string | No | Fecha de fin en formato ISO 8601 |
Ejemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 13",
"startDate": "2025-02-24",
"endDate": "2025-03-10"
}
close_sprint
Cierra un sprint abierto. Archiva todos los work items en columnas "done" y los registra como work items del sprint. Opcionalmente filtra por rango de fechas. Al cerrar, se genera automaticamente un reporte visual y un changelog.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| sprintId | string (UUID) | Si | ID del sprint a cerrar |
| boardId | string (UUID) | Si | ID del board del sprint |
| startDate | string | No | Fecha inicio ISO 8601 para filtrar items por finishedAt >= startDate |
| endDate | string | No | Fecha fin ISO 8601 para filtrar items por finishedAt <= endDate |
Ejemplo:
{
"sprintId": "sprint-001",
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
close_sprint_adhoc
Crea y cierra un sprint en una sola transaccion. Util para registrar retroactivamente un sprint que ya se completo. Opcionalmente filtra items por rango de fechas.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| boardId | string (UUID) | Si | ID del board |
| name | string | Si | Nombre del sprint |
| startDate | string | No | Fecha inicio ISO 8601 para filtrar items |
| endDate | string | No | Fecha fin ISO 8601 para filtrar items |
Ejemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 10 (retroactivo)",
"startDate": "2025-01-13",
"endDate": "2025-01-26"
}
close_sprint_by_date
Crea y cierra un sprint con fechas explicitas de inicio y fin en una sola transaccion. Archiva todos los work items actualmente en columnas "done". Fechas de inicio y fin son obligatorias.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| boardId | string (UUID) | Si | ID del board |
| name | string | Si | Nombre del sprint |
| startDate | string | Si | Fecha de inicio ISO 8601 (ej: 2025-01-01) |
| endDate | string | Si | Fecha de fin ISO 8601 (ej: 2025-01-14) |
Ejemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 9",
"startDate": "2025-01-01",
"endDate": "2025-01-14"
}
get_sprint_work_items
Lista todos los work items completados y archivados en un sprint especifico.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| sprintId | string (UUID) | Si | ID del sprint |
Ejemplo:
{
"sprintId": "sprint-000"
}
preview_done_items
Previsualiza los work items en columnas "done" que serian archivados al cerrar un sprint. Util para revisar antes de ejecutar close_sprint.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| boardId | string (UUID) | Si | ID del board |
Ejemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Respuesta:
[
{
"id": "wi-001",
"taskId": "A-T-37",
"title": "Implementar login",
"type": "task",
"columnName": "Done",
"finishedAt": "2025-02-20T15:30:00.000Z"
},
{
"id": "wi-002",
"taskId": "A-T-38",
"title": "Tests de integracion auth",
"type": "task",
"columnName": "Done",
"finishedAt": "2025-02-21T10:00:00.000Z"
}
]
Antes de cerrar un sprint, ejecuta preview_done_items para verificar que los items correctos se van a archivar. Despues ejecuta close_sprint o close_sprint_adhoc.
regenerate_sprint_changelog
Regenera el documento de changelog para un sprint cerrado. Util para regenerar despues de mejoras en los prompts o para sprints antiguos que no tienen changelog.
Parametros:
| Nombre | Tipo | Requerido | Descripcion |
|---|---|---|---|
| sprintId | string (UUID) | Si | ID del sprint (debe estar cerrado) |
| fallbackStrategy | string | No | Estrategia para items sin documentacion IA: list-only (defecto, lista sin resumen), ai-analyze (genera resumenes IA al vuelo), skip (omite items sin documentacion) |
Ejemplo:
{
"sprintId": "sprint-000",
"fallbackStrategy": "ai-analyze"
}
Respuesta:
{
"message": "Changelog generated successfully for sprint 'Sprint 11'",
"documentId": "doc-uuid-001"
}