Goals and Milestones

You have 50 tasks spread across 3 sprints. Are you on track? Goals give you the altitude to see the forest without getting lost in the trees.

A goal (milestone) is a macro-level objective that groups work items related to a specific target. While sprints organize work by time, goals organize it by expected outcome.

Key concepts

• A goal belongs to a project and can group items from multiple boards.
• Each goal has a status, priority, and target date.
• Work items are manually linked to the goal, allowing you to combine work from different sprints.
• Progress is calculated automatically based on completed items.
• A goal can be active simultaneously with other goals in the same project.

Goal statuses

Status	Description	Use
planned	Planned, not yet started	Future goals or awaiting resources
in_progress	Actively in progress	Goals currently being worked on
completed	Completed	Successfully achieved goals
on_hold	On hold	Temporarily suspended goals
cancelled	Cancelled	Goals that will not be pursued

Priorities

Priority	Description
urgent	Requires immediate attention
high	High importance, execute soon
medium	Standard priority
low	Low priority, execute when possible

Creating a goal

1. Access the Goals section from the main menu.
2. Select the project where you want to create the goal.
3. Click New Goal.
4. Complete the fields:

Field	Description	Required
title	Goal name (e.g., "MVP Auth Launch")	Yes
description	Detailed description of the objective	No
priority	Priority: urgent, high, medium, low	Yes
targetDate	Target completion date	Yes
workItemIds	Items to link to the goal	No

5. Confirm the creation.

Linking work items

Unlike sprints where items are automatically associated, in goals the linking is explicit:

1. Open the goal you want to add items to.
2. Select Add Items.
3. Search and select the work items that contribute to this goal.
4. Confirm the selection.

You can also link items when creating the goal using the workItemIds field.

tip

A single work item can be linked to multiple goals. This is useful when a task contributes to more than one objective.

Tracking progress

A goal's progress is calculated automatically:

• Total items: Number of work items linked to the goal.
• Completed items: Work items that are in columns with isDone = true.
• Percentage: Ratio between completed and total items.

The goal detail view shows:

• Visual progress bar.
• List of items grouped by status (completed vs pending).
• Days remaining until the target date.
• Distribution metrics by type and priority.

Editing a goal

1. Open the goal you want to modify.
2. Click Edit.
3. Modify the necessary fields (title, description, status, priority, target date).
4. Save the changes.

warning

Changing the status to completed automatically sets the completion date. This action cannot be automatically undone.

Deleting a goal

When deleting a goal:

• All associations with work items are removed.
• The work items are NOT deleted, they only lose the link.
• The goal's history is permanently lost.

Goals vs Sprints

Aspect	Sprints	Goals
Organization	By time (2 weeks)	By objective
Scope	Single board	Multiple boards
Items	Automatic association	Manual linking
Simultaneity	One active per board	Multiple active
Reports	Velocity, metrics	Progress toward target

Use sprints to organize your team's daily work and goals to communicate progress toward business objectives.

For developers

For Developers

MCP tools

Tool	Description	Main parameters
list_milestones	Lists all goals of a project	projectId
get_milestone	Gets a goal with its work items	milestoneId
get_milestone_progress	Gets progress statistics	milestoneId
create_milestone	Creates a new goal	projectId, title, priority, targetDate, workItemIds
update_milestone	Updates an existing goal	milestoneId, title, description, status, priority, targetDate
delete_milestone	Deletes a goal	milestoneId
add_work_items_to_milestone	Links items to a goal	milestoneId, workItemIds
remove_work_item_from_milestone	Unlinks an item from a goal	milestoneId, workItemId

Example: Create a goal

Tool: create_milestone
Parameters:
  projectId: "project-uuid"
  title: "MVP Authentication Launch"
  priority: "high"
  targetDate: "2026-04-15"
  workItemIds: ["item-uuid-1", "item-uuid-2"]

Example: Query progress

Tool: get_milestone_progress
Parameters:
  milestoneId: "goal-uuid"

Returns:

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

Example: Add items to an existing goal

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