Goals y Milestones

Tienes 50 tareas distribuidas en 3 sprints. Vas por buen camino? Los goals te dan la altitud necesaria para ver el bosque sin perderte en los arboles.

Un goal (milestone) es un objetivo a nivel macro que agrupa work items relacionados con una meta especifica. Mientras los sprints organizan el trabajo por tiempo, los goals lo organizan por resultado esperado.

Conceptos clave

• Un goal pertenece a un proyecto y puede agrupar items de multiples boards.
• Cada goal tiene un estado, prioridad y fecha objetivo.
• Los work items se vinculan al goal manualmente, permitiendo combinar trabajo de diferentes sprints.
• El progreso se calcula automaticamente en base a los items completados.
• Un goal puede estar activo simultaneamente con otros goals del mismo proyecto.

Estados de un goal

Estado	Descripcion	Uso
planned	Planificado, aun no iniciado	Goals futuros o en espera de recursos
in_progress	En progreso activo	Goals en los que se esta trabajando
completed	Completado	Goals alcanzados exitosamente
on_hold	En pausa	Goals suspendidos temporalmente
cancelled	Cancelado	Goals que no se van a realizar

Prioridades

Prioridad	Descripcion
urgent	Requiere atencion inmediata
high	Alta importancia, ejecutar pronto
medium	Prioridad estandar
low	Baja prioridad, ejecutar cuando sea posible

Crear un goal

1. Accede a la seccion Goals desde el menu principal.
2. Selecciona el proyecto donde quieres crear el goal.
3. Haz clic en Nuevo Goal.
4. Completa los campos:

Campo	Descripcion	Obligatorio
title	Nombre del goal (e.g., "Lanzamiento MVP Auth")	Si
description	Descripcion detallada del objetivo	No
priority	Prioridad: urgent, high, medium, low	Si
targetDate	Fecha objetivo de completacion	Si
workItemIds	Items a vincular al goal	No

5. Confirma la creacion.

Vincular work items

A diferencia de los sprints donde los items se asocian automaticamente, en los goals la vinculacion es explicita:

1. Abre el goal al que quieres agregar items.
2. Selecciona Agregar Items.
3. Busca y selecciona los work items que contribuyen a este goal.
4. Confirma la seleccion.

Tambien puedes vincular items al momento de crear el goal usando el campo workItemIds.

tip

Un mismo work item puede estar vinculado a multiples goals. Esto es util cuando una tarea contribuye a mas de un objetivo.

Seguimiento del progreso

El progreso de un goal se calcula automaticamente:

• Total items: Numero de work items vinculados al goal.
• Items completados: Work items que estan en columnas con isDone = true.
• Porcentaje: Relacion entre completados y totales.

La vista de detalle del goal muestra:

• Barra de progreso visual.
• Lista de items agrupados por estado (completados vs pendientes).
• Dias restantes hasta la fecha objetivo.
• Metricas de distribucion por tipo y prioridad.

Editar un goal

1. Abre el goal que quieres modificar.
2. Haz clic en Editar.
3. Modifica los campos necesarios (titulo, descripcion, estado, prioridad, fecha objetivo).
4. Guarda los cambios.

aviso

Cambiar el estado a completed establece automaticamente la fecha de completacion. Esta accion no se puede deshacer automaticamente.

Eliminar un goal

Al eliminar un goal:

• Se eliminan todas las asociaciones con work items.
• Los work items NO se eliminan, solo pierden la vinculacion.
• El historial del goal se pierde permanentemente.

Goals vs Sprints

Aspecto	Sprints	Goals
Organizacion	Por tiempo (2 semanas)	Por objetivo
Scope	Un solo board	Multiples boards
Items	Asociacion automatica	Vinculacion manual
Simultaneidad	Uno activo por board	Multiples activos
Reportes	Velocidad, metricas	Progreso hacia meta

Usa sprints para organizar el trabajo diario del equipo y goals para comunicar el progreso hacia objetivos de negocio.

Para developers

Para Developers

Herramientas MCP

Tool	Descripcion	Parametros principales
list_milestones	Lista todos los goals de un proyecto	projectId
get_milestone	Obtiene un goal con sus work items	milestoneId
get_milestone_progress	Obtiene estadisticas de progreso	milestoneId
create_milestone	Crea un nuevo goal	projectId, title, priority, targetDate, workItemIds
update_milestone	Actualiza un goal existente	milestoneId, title, description, status, priority, targetDate
delete_milestone	Elimina un goal	milestoneId
add_work_items_to_milestone	Vincula items a un goal	milestoneId, workItemIds
remove_work_item_from_milestone	Desvincula un item de un goal	milestoneId, workItemId

Ejemplo: Crear un goal

Tool: create_milestone
Parametros:
  projectId: "uuid-del-proyecto"
  title: "Lanzamiento MVP Autenticacion"
  priority: "high"
  targetDate: "2026-04-15"
  workItemIds: ["uuid-item-1", "uuid-item-2"]

Ejemplo: Consultar progreso

Tool: get_milestone_progress
Parametros:
  milestoneId: "uuid-del-goal"

Devuelve:

{
  "totalItems": 12,
  "completedItems": 8,
  "progress": 66.67
}

Ejemplo: Agregar items a un goal existente

Tool: add_work_items_to_milestone
Parametros:
  milestoneId: "uuid-del-goal"
  workItemIds: ["uuid-item-3", "uuid-item-4"]