๐Ÿ“ˆ Agile Metrics: Velocity, Burndown & Burnup Explained

๐Ÿ“ˆ Agile Metrics: Velocity, Burndown & Burnup Explained

Sprint Health Analyzer provides three core Agile metrics to help teams evaluate sprint progress and delivery trends over time:

  • Velocity โ€“ how much work the team completed

  • Burndown โ€“ how work was reduced each day

  • Burnup โ€“ how scope and progress evolved together

These charts appear in the Agile Metrics mode of the app. You can switch to this view by clicking the "Agile Metrics" button and optionally adjust the sprint dates using the built-in date pickers.


โœ… Required Conditions

To ensure metrics are accurate:

Requirement

Purpose

Requirement

Purpose

Story Points field present

Needed to measure effort quantitatively

Issues linked to a sprint

Required to filter the correct dataset

Resolution date or Done status

Used to determine when issues were completed

Complete changelog access

Needed for advanced calculations (optional)


๐Ÿ“Š 1. Velocity Chart

A snapshot of how many story points were completed during the selected sprint.

๐ŸŽฏ What it shows:

  • Completed story points (from issues marked Done before sprint end)

  • Total sprint scope (sum of all story points in scope)

๐Ÿ“˜ How it's calculated:

velocity = SUM(storyPoints WHERE doneAt <= sprintEnd) totalScope = SUM(storyPoints of all sprint issues)

๐Ÿ“– How to read it:

  • The bar represents completed work

  • The subtitle shows velocity vs total scope (e.g. Velocity: 21 / 34)

  • The percentage helps teams assess sprint delivery capacity


๐Ÿ“‰ 2. Burndown Chart

Tracks how many story points remain each day vs. ideal progress.

๐ŸŽฏ What it shows:

  • Actual remaining story points per day

  • Ideal linear trend from total scope โ†’ 0

๐Ÿ“˜ How it's calculated:

remaining[day] = SUM(storyPoints of issues NOT done on or before day) ideal[day] = totalScope - (totalScope / (days - 1)) * dayIndex

  • Ideal burndown assumes uniform progress across all sprint days.

  • Completed issues reduce the "remaining" value each day.

๐Ÿ“– How to read it:

  • If the actual line stays above the ideal โ†’ progress is behind

  • If the actual line drops faster โ†’ you're ahead of schedule

  • Flat spots = no completion; upward spikes = scope increased mid-sprint


๐Ÿ“ˆ 3. Burnup Chart

Visualizes cumulative work completed alongside evolving scope.

๐ŸŽฏ What it shows:

  • Completed work (cumulative story points Done by day)

  • Total scope (including issues added mid-sprint)

๐Ÿ“˜ How it's calculated:

completed[day] = SUM(storyPoints WHERE doneAt <= day) totalScope[day] = SUM(storyPoints WHERE addedAt <= day)

  • This chart accounts for scope creep: issues added after sprint start still contribute to scope line.

๐Ÿ“– How to read it:

  • The gap between completed and total scope = remaining work

  • If scope line goes up mid-sprint โ†’ new work was added

  • If lines are close together โ†’ good alignment between commitment and delivery


๐Ÿงฎ Example Use Cases

Use Case

Metric to Watch

What It Reveals

Use Case

Metric to Watch

What It Reveals

Sprint forecast accuracy

Velocity

Whether team delivers what they plan

Delivery pacing

Burndown

Whether team finishes work consistently

Scope management

Burnup

Whether new tasks were added during sprint

Team consistency across sprints

Velocity

Compare sprint-to-sprint throughput


๐Ÿ›‘ Limitations

  • Velocity is not a productivity metric โ€” it only reflects completion rate

  • Burndown assumes linear ideal progress โ€” itโ€™s a guide, not a rule

  • Burnup requires that storyPoints and addedAt (or created date) are populated


๐Ÿ“Œ Summary

Metric

Input Field Used

Main Goal

Metric

Input Field Used

Main Goal

Velocity

storyPoints, doneAt

Measure delivery volume

Burndown

storyPoints, doneAt, sprint dates

Compare actual vs ideal burn

Burnup

storyPoints, addedAt, doneAt

Track completed vs total work