Story: Document the sprint health charts
Table of Contents
This page documents a story in Sprint 19. It captures the goal, current status, acceptance criteria, and the tasks that compose it.
Goal
Every sprint page carries four health charts (PRs & commits per day,
daily line churn, PR cycle time, cumulative stories done), but nothing
documents them as a set: what each chart measures, why we generate it,
and how to read it. The four gnuplot scripts that render them sit in
scripts/ as undocumented developer scripts, disconnected from the
charts they produce.
This story delivers a single agile knowledge page that documents the
charts — definition, measure, purpose, and interpretation, phrased in
the project's agile domain terms — and becomes the literate home of
the gnuplot sources, tangled back to scripts/ so compass sprint
charts keeps working unchanged. The sprint Charts sections and the
agile process page link to it.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent sprint | Sprint 19 |
| Now | Nothing. |
| Waiting on | Nothing. |
| Next | Nothing. |
| Last touched | 2026-06-05 |
Acceptance
- A knowledge page exists under
doc/agile/documenting all four sprint health charts: what each chart is, what it measures, its purpose, and how to interpret it (healthy and unhealthy patterns). - The page uses the project's agile domain definitions (story, task, sprint, DONE, PR cycle) with id-links to their sources.
- The four gnuplot scripts live in the page as org-babel source
blocks tangled to
scripts/sprint_*.gnuplot; the tangled files carry a header marking them as generated from the page. compass sprint chartsrenders all four charts unchanged.- The sprint Charts section (current sprint and the codegen sprint template) links to the page.
- The agile process page links to the page.
- The page links to the sprint health review runbook and to the compass recipe for generating the charts.
Tasks
| Task | State | Start | End | Description |
|---|---|---|---|---|
| Implement Document the sprint health charts | DONE | 2026-06-04 | 2026-06-05 | Knowledge page, literate gnuplot sources, links from sprint template, process page, recipe and runbook. |
Decisions
Out of scope
- Changing what the charts measure or how
compass sprint chartsextracts the metrics. - Adding new chart types.