Skip to content

Status Report

beta  ·  Family communication-docs  ·  Phase undefined  ·  Sizes lean, full  ·  ~2,550 tokens

The periodic document that tells people who are not doing the work where a piece of work stands: what changed, what is at risk, and what is needed from the reader. It owns none of its own facts; every number in it is read from something with more authority, a KPI dashboard, a risk register, a RAID log, and the document’s job is to narrate what those sources mean for one audience in one period.

Fast reference for using the status-report bundle. For the full reasoning, history, and sources, read status-report_companion.md; a fully worked instance is status-report_example.md.

  • You need to tell people who are not doing the work where things stand: what changed, what is at risk, and what you need from them, on a recurring cadence (daily, weekly, monthly, or quarterly).
  • The document owns none of its own facts. Every number you would put in it already lives somewhere with more authority, a KPI dashboard, a risk register, a RAID log, and your job is to narrate what those sources mean for one audience in one period.
  • The audience needs the headline, not the instrument. Someone who could just as easily walk a live board or open the dashboard themselves does not need this document; write it for the reader who was not in the room.
  • The report reaches a governance body, a sponsor, or anyone outside the delivery team who still needs a record even though they were not there when the work happened.
  • You are defining what the metrics are, not narrating them. Naming a KPI, its formula, and who owns it is the kpi-dashboard bundle’s job. A status report reads numbers from that definition; it does not create or redefine them.
  • The ask outranks the update. If the meeting exists to get an approval, open with the decision ask, not with “here’s what happened since last time.” A status report that tries to carry every metric on every dimension as evidence for a single recommendation produces exactly the decision paralysis a focused ask is meant to avoid; that is a decision paper, not this document.
  • The audience already walks a live board. A team running a real information radiator has less need for a written report between people who see the board daily. Write this for the reader who cannot see it, not as a duplicate of it for people who can.
  • You want a formally specified management product with its own defined producer, recipient, and cadence rule. That is PRINCE2’s Highlight Report, a distinct named artifact, not a variant of this template. Learn from its shape; do not expect this template to replace it inside a PRINCE2 environment.
  • A problem has already happened and needs its own record. Track it in the risk register or RAID log by ID and reference that ID here; do not describe the underlying problem fresh in the report, or you will eventually report the same fact twice under two different names.

Status report, dashboard, or decision paper? (the question people actually have)

Section titled “Status report, dashboard, or decision paper? (the question people actually have)”
Status report KPI dashboard Decision paper / steering session
Answers “Where do things stand, and what do you need from me?” “What are we measuring, and how?” “Will you approve X?”
Opens with A report: what happened since last time A metric definition A decision ask
Coverage Every dimension the audience needs, at summary level Every metric the objective needs, defined precisely The narrow evidence for one recommendation
Owns its facts? No, reads them from elsewhere Yes, this is where a metric is defined No, reads them from elsewhere
Cadence Periodic (daily to quarterly) Continuous, standing Ad hoc, when a decision is needed

They are a chain, not a choice: the dashboard defines the numbers, the status report narrates what those numbers mean for one audience this period, and a decision paper narrows to the evidence for one ask when the report alone would produce paralysis rather than a decision.

  • Lean (default): Summary, Status, Accomplishments, Risks and Issues, Next Steps. The smallest report that still says where things stand, what happened, what is at risk, and what comes next.
  • Full: adds Metrics, Milestones, and Decisions Needed in place, for eight sections total. Use it once the audience is empowered to act on the numbers and the asks directly, not just to know the headline, for example a steering committee or a sponsor who reads this instead of walking the board.

Grow lean into full by adding sections in place; never reorder the five sections they share. The scaling signal is audience and cadence, not the size of the program: published templates split first by frequency (daily, weekly, monthly, quarterly) and second by audience (executive, team, portfolio, department), not by how much work is under way.

Score each 0, 1 or 2. Under 13 out of 18 (full) or 9 out of 12 (lean), and the reader will have to go check the source you were supposed to summarise for them. The report has stopped doing the one job this document type has.

# Criterion 0 1 2
1 Headline stands alone No standalone headline; the reader must read the whole report to find the direction A headline exists but does not say what, if anything, is needed from the reader A reader who stops after the first sentence could state the direction and what is asked of them
2 Threshold beside every colour A colour appears with no threshold at all A threshold is stated, but it is the same number as the target rather than a separate green line, or it lives in another document Every colour carries the specific rule, a number or a named condition, that produced it, distinct from the target where the two differ
3 Accomplishments are completions Lines describe effort or intention (“worked on X”) Some lines are true completions; others describe ongoing or planned work Every line would still be true if checked today, and none could be pasted unchanged into next period’s report
4 Metrics are traceable (full only) A number appears with no named source A source is named, but the colour is graded against the target rather than a stated threshold, or the reverse Every metric names its system of record, states both target and threshold where they differ, and states which one produced the colour
5 Milestones carry a reason (full only) A milestone has no date A date and status exist, but an at-risk or missed milestone gives no reason Every milestone has a date, and any not on track states why in one line, pointing at a named source
6 Risks point at the record The section restates the whole register with no filter Items are filtered to what changed, but carry no register reference Every row names the authoritative register and its ID, and states what changed this period
7 Decisions ask, not inform (full only) The section repeats status or risk information with no decision attached A decision is named, but has no owner or deadline Every row names the decision, the decider, the deadline, and the one line of context needed, nothing more
8 Next steps are checkable Steps are vague continuations (“continue work”) Steps are specific, but nobody could check next period whether they happened Every step is phrased so a reader could answer yes or no at the next report, and any dependency on a decision above is named
9 No duplicate facts The same underlying item is reported as two separate things across sections, or against two different sources The duplication exists but is at least labelled as the same fact Every fact appears exactly once, and where it is the same underlying item as a sibling register entry, that is stated rather than hidden

Every cell above describes evidence, not a count. A threshold you can clear by adding rows will be cleared by adding rows; this library’s own bug-report research documents that mechanism for defect counts, and a rubric row is the same kind of target. If you can satisfy a cell without improving the report, the cell is written wrong.

Which rows apply to what. This bundle ships two variants, and three rows grade a section that only the full variant carries, so scoring lean against all nine would penalise the choice of variant rather than the quality of the report.

Variant Rows that apply Maximum Score against
full all 9 18 13
lean 1-3, 6, 8-9 (it carries no Metrics, Milestones, or Decisions Needed section) 12 9

Both thresholds sit above two-thirds of the available points; neither is a bare pass mark.

  1. Watermelon reporting. Green on the outside, red inside: the status colour and the underlying reality have already diverged. Fix: require the threshold beside the colour, not just the colour, so a reader can check the claim against the rule instead of trusting the paint.
  2. The gamed traffic light. A colour distorted to protect the reporter rather than inform the reader, especially once a project has already been marked amber or red and the reporter has learned what happens next. Fix: name the threshold in advance, before the number that will be graded against it exists.
  3. Status theatre. A report, or a Decisions Needed section, run for appearance rather than function: it satisfies the look of governance while asking nothing of anyone. Fix: keep Decisions Needed to rows with an actual decision attached, or write “No decisions needed this period” rather than padding it with information.
  4. The report nobody reads. Mistaking the status report for the whole communications plan, so it goes out on schedule and nobody closes the loop on whether it landed. Fix: pair the report with an actual feedback channel, not just distribution.
  5. The scarlet letter. Once a project is marked amber or red, its reputation, and its author’s, does not recover regardless of the new plan, which is exactly the incentive that produces optimism bias in the first place. Fix: separate the colour from the verdict on the person; a report that punishes honesty will stop receiving it.
  6. Reporting activity instead of outcome. Accomplishments that describe what shipped rather than what changed for the reader. Fix: ask what a completed line actually moved, not just what it produced.
  7. Duplicating the register. The same underlying fact reported twice, once in Risks and Issues and again somewhere else in the document, under two different names. Fix: read the item and its status from the authoritative register by ID; do not re-describe it from scratch in a second place.

When a reader who was not in the room can read it once, state the headline, name the one thing that is not going well, and act on (or approve) whatever this report actually needs from them, without opening the dashboard or the register to check your numbers.

That last part is the test that matters most: this document type exists to save the reader a trip to the source. The moment they have to make that trip anyway, the report has failed at the only job it has.

status-report_template-lean.md · ~2,550 tokens

---
title: "{{program_name}} Status Report - {{reporting_period}}"
program: "{{program_name}}"
reporting_period: "{{reporting_period}}"
prepared_by: "{{report_owner}}"
audience: "{{audience}}"
cadence: "{{cadence}}"
status: "{{status}}"
doc_type: status-report
size: lean
source_template: status-report
source_template_version: 0.1.0
---
<!--
LEAN STATUS REPORT. The smallest report that still says where things stand, what happened, what is at risk,
and what comes next: Summary, Status, Accomplishments, Risks and Issues, Next Steps. Use it for a routine
period read by an audience that only needs the headline and does not act on individual metrics or decisions
directly. To grow it into the governance-grade full variant (see status-report_template-full.md), ADD
sections; never rename or reorder the ones below, because the full variant is a strict superset of this one.
THIS DOCUMENT OWNS NONE OF ITS OWN FACTS. A status report narrates what already-authoritative sources mean
for one audience in one period; it does not originate numbers. Every figure below must be read from
something with more authority - a KPI dashboard, a risk register, a RAID log - never estimated or recalled
fresh for this report. Say plainly where a number comes from. This no-new-facts framing is this library's own
convention, not a rule any source read states outright; treat it as the discipline this document type needs,
not as recovered practice. See status-report_companion.md section 1.
A COLOUR WITHOUT A THRESHOLD IS AN OPINION, NOT A MEASUREMENT. Even the most detailed published RAG scheme
in existence defines Red, Amber and Green and then declines to define the two colours in between, leaving
the hardest calls to judgement. Every Status entry in this template must therefore carry the rule that
produced it, not just the colour. See status-report_companion.md sections 3 and 6.
REPORTS SKEW OPTIMISTIC. The one measured finding behind this bundle: experienced project managers write
biased reports more often than not, and the bias runs more than twice as often optimistic as pessimistic.
The Accomplishments section exists to be filled only with things that already happened, as the direct
counterweight. See status-report_companion.md section 1.
HOW TO FILL THIS IN
1. Read the comment under each heading: WHAT it wants, WHY it matters (with a pointer into
status-report_companion.md), guiding questions to ASK, a GOOD and a WEAK example, and the TRAP to avoid.
Tables add PRIORITY and ROW HINT.
2. Replace each {{placeholder}} with your content. Every figure needs a named source; every Status row
needs a threshold, not just a colour.
3. If a section does not apply this period, write "None this period" and one line of why, rather than
deleting the section.
4. Never finished, but before you send it: self-grade against status-report_guide.md, then DELETE every HTML
comment. They are guidance, not content.
-->
# {{program_name}} Status Report - {{reporting_period}}
## Summary
<!-- WHAT One or two sentences carrying the headline: the overall direction this period, and the single
thing the reader most needs to know. Written so a reader who opens only this section still
leaves informed.
WHY The summary is the triage surface; most readers stop here. Attested across the corpus as "A
summary of the project's current status", "Project Summary", and "Summary" preceded by an
"Introductory note". Deep dive: status-report_companion.md section 3 (Anatomy > Summary).
ASK What is the headline for this period? Would someone who reads only this section know whether
things are on track, and what (if anything) is needed from them?
GOOD "Amber this period: checkout success rate and settlement latency are both improving but still below
their green thresholds, and the PII exposure risk was escalated to the steering group on
2026-03-09. No action needed from this audience beyond staying aware."
WEAK "Good progress this week." (no direction, no headline, nothing to act on)
TRAP Burying the one thing that matters past the first sentence. If the reader stops here, they should
still know the headline. -->
{{summary}}
## Status
<!-- WHAT The overall health call for the period, one row per dimension you report on, each carrying the
threshold that produced its colour, not the colour alone.
WHY The fastest-read field in the whole document, and the one this document type gets wrong most
often: a colour without a stated rule is an opinion wearing the costume of a measurement, and
even the most careful public RAG scheme leaves its own middle colours undefined. Deep dive:
status-report_companion.md section 3 (Anatomy > Status) and section 6 (the RAG-threshold debate).
ASK What is the status of each dimension you report on (overall, or split by schedule/scope/budget/a
named metric)? What is the threshold - stated as a number or a named rule - that produced this
colour? What changed since the last report?
PRIORITY One row per dimension the audience actually needs; do not invent dimensions to fill the
table. State the threshold in the same row as the colour, not in a separate document only.
ROW HINT A good row names the dimension, states the colour, states the numeric or defined threshold
that produced it, and says what changed. A weak row is a colour with nothing behind it.
GOOD | Overall | Amber | Green requires checkout success at or better than 99.5% AND settlement
adoption at or above 55%; both metrics are still below their green line this period | Neither
headline metric has crossed to green yet; no schedule slip |
WEAK | Overall | Amber | | Things are okay-ish |
TRAP Colouring against a target that is not the same number as the threshold that defines the colour.
State which one produced the call. -->
| Dimension | Status | Threshold | What changed |
|---|---|---|---|
| {{status_dimension}} | {{status_rag}} | {{status_threshold}} | {{status_change}} |
## Accomplishments
<!-- WHAT What was actually completed this period, not what was planned, is in progress, or is hoped for.
WHY This is the direct counterweight to the optimism bias this document type has been measured to
carry: a section that can only honestly be filled with things that already happened. Attested as
"Specific accomplishments the team has achieved", "Work Completed Last Week", and "Key
Accomplishments". Deep dive: status-report_companion.md section 3 (Anatomy > Accomplishments) and
section 1 (the optimism-bias finding).
ASK What did the team actually finish this period? Would this line still be true if someone checked
it today?
GOOD "Shipped the new checkout flow to the full merchant cohort; success rate is now tracked against real
usage rather than a pilot group."
WEAK "Made good progress on checkout." (not a completion; could be written every period forever)
TRAP Reporting "in progress" or "on track" items here. If it is not finished, it belongs in Next
Steps, not Accomplishments. -->
- {{accomplishment_1}}
## Risks and Issues
<!-- WHAT What could still go wrong, and what has already gone wrong, that matters to THIS audience in
THIS period - not the full risk register or RAID log, but what those sources mean for the reader
right now, with a reference back to the authoritative entry.
WHY The sharpest-attested section in the corpus, and the one where the no-new-facts rule bites
hardest: read the item and its status from the register by ID, do not re-score or re-describe it
from scratch here. Deep dive: status-report_companion.md section 3 (Anatomy > Risks and Issues).
ASK What is the top risk or issue this reader needs to know about this period? What is its ID in the
authoritative register or log? What changed since last period (escalated, closed, materialized)?
Does it need anything from this reader?
PRIORITY Only what changed or still matters this period; this is not a re-listing of the whole
register. Every row names the source register and its ID.
ROW HINT A good row states what it is, its current status, its register reference, and what changed.
A weak row restates the entire register with no filter for relevance.
GOOD | R-11 (risk-register) | Card-network recertification may slip | Escalated to the steering group
2026-03-09 | Escalated this period; awaiting sign-off |
WEAK | Various risks | See register | | |
TRAP Duplicating the register wholesale, or reporting the same underlying fact twice under two
different names because it also sits in another log. -->
| Ref | Description | Status | What changed |
|---|---|---|---|
| {{item_ref}} | {{item_description}} | {{item_status}} | {{item_change}} |
## Next Steps
<!-- WHAT What happens next, independent of whether it depends on anything raised above.
WHY Closes the report on forward motion rather than a list of problems; the most consistently
attested section in the whole corpus - "The next steps", "Work Planned for Next Week", "Upcoming
Work" and "Action Items", "Action items". Deep dive: status-report_companion.md section 3
(Anatomy > Next Steps).
ASK What is planned for the next period? Does any of it depend on something raised above, and if so,
is that dependency named?
GOOD "Complete the second merchant cohort rollout, targeting 99.5 percent checkout success by end of the
next period."
WEAK "Continue work." (no specific action, nothing a reader could check next period)
TRAP A vague continuation with nothing to verify. Every next step should be checkable: did it happen,
yes or no, by the next report. -->
- {{next_step_1}}

The reasoning, the history and every source, in the repository:

  • Companion - the long-form argument: why these sections, where the sources disagree, and what the bundle refuses to claim
  • History - what changed in this bundle, and when
  • Research log - every source consulted, with what each one actually supports
  • Catalog metadata - the machine-readable record this page is generated from

Catalog record: 8 sections across 1 format(s), methodology methodology-agnostic, typically owned by PM / PgM.