Goals e Milestones

Você tem 50 tarefas distribuídas em 3 sprints. Está no caminho certo? Os goals dão a altitude necessária para ver a floresta sem se perder entre as árvores.

Um goal (milestone) é um objetivo de nível macro que agrupa work items relacionados a uma meta específica. Enquanto os sprints organizam o trabalho por tempo, os goals o organizam pelo resultado esperado.

Conceitos-chave

• Um goal pertence a um projeto e pode agrupar items de vários boards.
• Cada goal tem um estado, prioridade e data-alvo.
• Os work items são vinculados manualmente ao goal, permitindo combinar trabalho de diferentes sprints.
• O progresso é calculado automaticamente com base nos items concluídos.
• Um goal pode estar ativo simultaneamente com outros goals do mesmo projeto.

Estados de um goal

Estado	Descrição	Uso
planned	Planejado, ainda não iniciado	Goals futuros ou aguardando recursos
in_progress	Em andamento	Goals em que se está trabalhando
completed	Concluído	Goals alcançados com sucesso
on_hold	Em pausa	Goals suspensos temporariamente
cancelled	Cancelado	Goals que não serão realizados

Prioridades

Prioridade	Descrição
urgent	Requer atenção imediata
high	Alta importância, executar em breve
medium	Prioridade padrão
low	Baixa prioridade, executar quando possível

Criar um goal

1. Acesse a seção Goals pelo menu principal.
2. Selecione o projeto em que deseja criar o goal.
3. Clique em Novo Goal.
4. Preencha os campos:

Campo	Descrição	Obrigatório
title	Nome do goal (e.g., "Lanzamiento MVP Auth")	Sim
description	Descrição detalhada do objetivo	Não
priority	Prioridade: urgent, high, medium, low	Sim
targetDate	Data-alvo de conclusão	Sim
workItemIds	Items a vincular ao goal	Não

5. Confirme a criação.

Vincular work items

Diferentemente dos sprints, em que os items são associados automaticamente, nos goals a vinculação é explícita:

1. Abra o goal ao qual deseja adicionar items.
2. Selecione Adicionar Items.
3. Procure e selecione os work items que contribuem para esse goal.
4. Confirme a seleção.

Você também pode vincular items ao criar o goal usando o campo workItemIds.

dica

Um mesmo work item pode estar vinculado a vários goals. Isso é útil quando uma tarefa contribui para mais de um objetivo.

Acompanhar o progresso

O progresso de um goal é calculado automaticamente:

• Total de items: Número de work items vinculados ao goal.
• Items concluídos: Work items que estão em colunas com isDone = true.
• Percentual: Relação entre concluídos e total.

A visualização de detalhes do goal mostra:

• Barra de progresso visual.
• Lista de items agrupados por estado (concluídos versus pendentes).
• Dias restantes até a data-alvo.
• Métricas de distribuição por tipo e prioridade.

Editar um goal

1. Abra o goal que deseja modificar.
2. Clique em Editar.
3. Modifique os campos necessários (título, descrição, estado, prioridade, data-alvo).
4. Salve as alterações.

aviso

Alterar o estado para completed define automaticamente a data de conclusão. Essa ação não pode ser desfeita automaticamente.

Excluir um goal

Ao excluir um goal:

• Todas as associações com work items são removidas.
• Os work items NÃO são excluídos, apenas perdem a vinculação.
• O histórico do goal é perdido permanentemente.

Goals versus Sprints

Aspecto	Sprints	Goals
Organização	Por tempo (2 semanas)	Por objetivo
Escopo	Um único board	Vários boards
Items	Associação automática	Vinculação manual
Simultaneidade	Um ativo por board	Vários ativos
Relatórios	Velocidade, métricas	Progresso em direção à meta

Use sprints para organizar o trabalho diário da equipe e goals para comunicar o progresso em direção aos objetivos de negócio.

Para desenvolvedores

Para desenvolvedores

Ferramentas MCP

Tool	Descrição	Parâmetros principais
list_milestones	Lista todos os goals de um projeto	projectId
get_milestone	Obtém um goal com seus work items	milestoneId
get_milestone_progress	Obtém estatísticas de progresso	milestoneId
create_milestone	Cria um novo goal	projectId, title, priority, targetDate, workItemIds
update_milestone	Atualiza um goal existente	milestoneId, title, description, status, priority, targetDate
delete_milestone	Exclui um goal	milestoneId
add_work_items_to_milestone	Vincula items a um goal	milestoneId, workItemIds
remove_work_item_from_milestone	Desvincula um item de um goal	milestoneId, workItemId

Exemplo: criar um 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"]

Exemplo: consultar o progresso

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

Retorna:

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

Exemplo: adicionar items a um goal existente

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