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.
When to use
Section titled “When to use”- 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.
When NOT to use
Section titled “When NOT to use”- 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.
Pick a variant
Section titled “Pick a variant”- 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.
The rubric
Section titled “The rubric”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.
Named anti-patterns (the usual wrecks)
Section titled “Named anti-patterns (the usual wrecks)”- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 it is good enough
Section titled “When it is good enough”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.
The artifacts
Section titled “The artifacts”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-reportsize: leansource_template: status-reportsource_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 routineperiod read by an audience that only needs the headline and does not act on individual metrics or decisionsdirectly. To grow it into the governance-grade full variant (see status-report_template-full.md), ADDsections; 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 meanfor one audience in one period; it does not originate numbers. Every figure below must be read fromsomething with more authority - a KPI dashboard, a risk register, a RAID log - never estimated or recalledfresh for this report. Say plainly where a number comes from. This no-new-facts framing is this library's ownconvention, 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 schemein existence defines Red, Amber and Green and then declines to define the two colours in between, leavingthe hardest calls to judgement. Every Status entry in this template must therefore carry the rule thatproduced 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 writebiased 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 directcounterweight. See status-report_companion.md section 1.
HOW TO FILL THIS IN1. 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}}status-report_template-full.md · ~4,050 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-reportsize: fullsource_template: status-reportsource_template_version: 0.1.0---
<!--FULL STATUS REPORT. The governance-grade report: everything in the lean variant, plus the specific numbersbehind the status colour (Metrics), the deliverable-and-date baseline progress is measured against(Milestones), and the specific asks of the reader (Decisions Needed). Use it when the audience is empoweredto act on metrics and decisions directly, not just to know the headline - a steering committee, a sponsor, oranyone who reads this instead of walking the board.
This is a STRICT SUPERSET of status-report_template-lean.md: Summary, Status, Accomplishments, Risks andIssues, and Next Steps appear in the same relative order; full only inserts Metrics, Milestones, andDecisions Needed in place. If you are growing from lean, add these; do not reorder.
THIS DOCUMENT OWNS NONE OF ITS OWN FACTS. A status report narrates what already-authoritative sources meanfor one audience in one period; it does not originate numbers. Every figure below must be read fromsomething with more authority - a KPI dashboard, a risk register, a RAID log - never estimated or recalledfresh for this report. Say plainly where a number comes from. This no-new-facts framing is this library's ownconvention, 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 schemein existence defines Red, Amber and Green and then declines to define the two colours in between, leavingthe hardest calls to judgement. Every Status entry in this template must therefore carry the rule thatproduced it, not just the colour, and the Metrics section below is where that rule gets its numbers. Seestatus-report_companion.md sections 3 and 6.
REPORTS SKEW OPTIMISTIC. The one measured finding behind this bundle: experienced project managers writebiased 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 directcounterweight. See status-report_companion.md section 1.
DECISIONS NEEDED IS NOT A SECOND STATUS TABLE. Keep it to rows with an actual decision attached, or a reportthat surfaces every metric and asks for nothing is exactly the status-theatre failure this section exists toprevent. See status-report_companion.md section 3 (Anatomy > Decisions Needed) and section 7.
HOW TO FILL THIS IN1. 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. Two decisions below need this group's sign-off." 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; the Metrics table below carries both. -->
| Dimension | Status | Threshold | What changed ||---|---|---|---|| {{status_dimension}} | {{status_rag}} | {{status_threshold}} | {{status_change}} |
## Metrics
<!-- WHAT The specific numbers behind the Status call above, one row per metric, each read from its named system of record rather than estimated or recalled for this report. WHY This is where the no-new-facts rule stops being an aspiration and becomes a table: the Status colour above is only as honest as the numbers under it, and this section is where a reader who does not trust the colour can check the figure. Attested as "Key Performance Indicators (KPI's)" with named formulas, and "Project Metrics". Deep dive: status-report_companion.md section 3 (Anatomy > Metrics). ASK For each metric behind the Status call: what is the current value, and where did you read it (a KPI dashboard or another system of record, never memory)? What is the target, and is the green threshold the same number as the target or a different one? What does it read as against the threshold that produced the colour? PRIORITY One row per metric that feeds the Status call above; do not introduce a number here that has no named source. Target and threshold are often different numbers - state both, not just one. ROW HINT A good row names the metric, states current against target AND threshold separately, names the source, and states what it reads as. A weak row states a number with no named source. GOOD | Checkout success | 98.9% | 99.6% by Q2 (target); green at 99.5% | kpi-dashboard, updated 2026-07-20 | Amber (below the green line, not the target) | WEAK | Checkout success | Improving | | | Green | TRAP Reading a colour against the target when a separate green threshold exists, or reporting a figure that is not traceable to a named source. Two different lines can produce two different honest colours for the same number. -->
| Metric | Current | Target / Threshold | Source of record | Reads as ||---|---|---|---|---|| {{metric_name}} | {{metric_current}} | {{metric_target_threshold}} | {{metric_source}} | {{metric_reads_as}} |
## 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}}
## Milestones
<!-- WHAT The deliverable-and-date structure this period's progress is measured against: the milestone, its target date, and its status against that date. WHY Accomplishments without milestones have no baseline to be judged against. Attested as "Deliverables and Milestones", "Milestone Review" alongside "Project Deliverables", and "Upcoming tasks and milestones". Deep dive: status-report_companion.md section 3 (Anatomy > Milestones). ASK What are the upcoming or recently passed milestones? What is the target date? Is each on track, at risk, or missed - and if not on track, why? PRIORITY Order by date. State the reason for any at-risk or missed milestone in one line, not just the status word. ROW HINT A good row names the milestone, the date, the status, and (if not on track) why. A weak row is a bare status with no date or reason. GOOD | Platform query engine live | 2026-08-01 | At risk | Dependency confirmed by the owning team; see D-01 in the RAID log | WEAK | Query engine | | At risk | | TRAP A milestone with no date is not a milestone, it is an intention. -->
| Milestone | Target date | Status | Note ||---|---|---|---|| {{milestone_name}} | {{milestone_date}} | {{milestone_status}} | {{milestone_note}} |
## 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, see Decisions Needed | 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}} |
## Decisions Needed
<!-- WHAT The specific asks of the reader: what they must decide, and by when. And the honest label: nothing in this document type's published corpus attests this title. WHY It is this library's own addition, kept because a report that surfaces every metric and asks for nothing is exactly the status-theatre failure named elsewhere in this bundle: a document that satisfies the appearance of governance while producing no decision. A named practitioner source draws the sharpest line found between a status update (covers every metric) and a decision session (narrows to the evidence for one recommendation) - this section is the narrow decision slice, not a second status table. Deep dive: status-report_companion.md section 3 (Anatomy > Decisions Needed) and section 8. ASK What decision does this report need from its reader? By when? What happens if it is not made? What is the minimum context they need to decide, not the full case? PRIORITY Keep this short. Only rows with an actual decision attached belong here. ROW HINT A good row names the decision, the decider, the deadline, and the one-line context needed to decide. A weak row states a problem with no decision attached. GOOD | Approve emergency budget for a second query-engine contractor | Steering group | 2026-08-10 | Without it, the platform query engine milestone slips past go-live; see raid-log D-01 | WEAK | Query engine is a risk | | | | TRAP Turning this into a second Risks and Issues table. If there is nothing to decide, write "No decisions needed this period" rather than padding it with information, not asks. -->
| Decision | Decider | Needed by | Context ||---|---|---|---|| {{decision}} | {{decision_owner}} | {{decision_deadline}} | {{decision_context}} |
## 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 a decision 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, pending the query-engine budget decision above." 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}}---title: "Reporting Platform Modernization Status Report - 14-28 July 2026"program: "Reporting Platform Modernization (Acme Analytics)"reporting_period: "14-28 July 2026"prepared_by: "Marta Reyes (Program Manager)"audience: "Program steering group"cadence: "Fortnightly, timed to the program steering group's review"status: "Amber"related: - "../kpi-dashboard/kpi-dashboard_example.md (source of every Metrics row below)" - "../risk-register/risk-register_example.md (source of R-05, and the register's escalation and appetite language)" - "../raid-log/raid-log_example.md (source of ISS-11, ISS-12, D-01, A-01 and A-02, and the escalation aging)" - "../incident-postmortem/incident-postmortem_example.md (DEF-2291; the trigger for R-05's 2026-07-14 escalation)" - "../definition-of-done/definition-of-done_example.md (the 2026-07-24 amendment reported under Accomplishments)" - "../product-roadmap/product-roadmap_example.md (the Now-lane commitment Saved Views work reports against)" - "../okrs/okrs_example.md (the FY26 Q3 objective the Metrics section's two headline rows already feed)"doc_type: status-reportsize: fullsource_template: status-reportsource_template_version: 0.1.0---
> **Worked example.** A filled `status-report`, full variant, for the **Reporting Platform Modernization**> program at Acme Analytics, the same program the `kpi-dashboard`, `risk-register`, `raid-log`,> `product-roadmap` and `okrs` examples already cover. Per the `communication-docs` family contract, this> document owns none of its own facts: every number and every reference ID below is read from one of those> five siblings, or from the `incident-postmortem` and `definition-of-done` examples, and the table below> states where each one comes from rather than restating it as if this report discovered it.>> **Read the dates.** It covers 14-28 July 2026 and is written as though prepared on the last of those days,> one day after the [FY26 Q3 OKRs](../okrs/okrs_example.md) were agreed on 27 July and three days after the> [Definition of Done](../definition-of-done/definition-of-done_example.md) amendment on 24 July. Everything> it cites, the [KPI dashboard](../kpi-dashboard/kpi-dashboard_example.md), the> [risk register](../risk-register/risk-register_example.md) and the> [RAID log](../raid-log/raid-log_example.md), all last reviewed 20 July, the> [DEF-2291 postmortem](../incident-postmortem/incident-postmortem_example.md), dated 16 July, already existed> by then. Nothing below cites a document dated after 28 July.>> All figures, names and dates are illustrative and drawn from documents that already exist elsewhere in this> library, not invented for this report.
# Reporting Platform Modernization Status Report - 14-28 July 2026
## Summary
This fortnight reads amber. The program's two headline numbers are Time to Insight and Saved Views adoption,both of which the kpi-dashboard already calls amber and improving, and neither has crossed into green yet. Theitem most worth this group's attention is the PII-exposure gap tracked as R-05: a shared saved view can exposea viewer to revenue data outside their region, and the ask raised at triage two weeks ago, fund a strongerentitlement control or accept the residual formally, still has no answer. Both decisions below sit with thisgroup; neither is optional this period.
## Status
| Dimension | Status | Threshold | What changed ||---|---|---|---|| Overall | Amber | The green bar sits at a 25 percent Time to Insight improvement and 55 percent Saved Views adoption together; a single metric crossing its own line is not enough on its own to move the overall call | R-05's steering-group ask has now been open 14 days without a decision; the query-engine dependency (D-01) stayed confirmed, so no schedule slip followed from it this period |
## Metrics
| Metric | Current | Target / Threshold | Source of record | Reads as ||---|---|---|---|---|| Time to Insight | 18 percent faster than the FY26 baseline | 30 percent by Q3 is the target; 25 percent is the separate green line | kpi-dashboard, last reviewed 20 Jul 2026 | Amber. It clears neither line, though it sits closer to the green line than to the target || Saved Views adoption | 41 percent of Recurring Analysts weekly | 60 percent by end Q3 is the target; 55 percent is the separate green line | kpi-dashboard, last reviewed 20 Jul 2026 | Amber, and only one point clear of the 40 percent floor below which the same table calls it red || View-list load, p95 | 620ms | Green sits under 500ms; red starts past 700ms | kpi-dashboard, last reviewed 20 Jul 2026 | Amber. This is the identical figure carried as ISS-12 on the RAID log; see Risks and Issues, not reported twice || Weekly active analysts | 495 distinct analysts | Hold at 480 or more | kpi-dashboard, last reviewed 20 Jul 2026 | Green || Migration integrity | Not yet measurable; cutover has not happened | 100 percent required at cutover | kpi-dashboard, last reviewed 20 Jul 2026 | No colour assigned. Scoring a pre-cutover metric would manufacture a result nobody has measured |
## Accomplishments
- Reverified the DEF-2291 fix and re-ran the entire twelve-combination permission matrix from the start, not only the failing case, resuming Phase 2 sharing testing on 15 July after a two-day suspension.- Closed the twin gap the postmortem named: TC-053 now asserts the same aggregate-before-filter defect class against the dashboard's row-count badge, the other element on that computation path.- Amended the squad's Definition of Done on 24 July so any future change touching entitlement logic requires the full permission matrix re-run as a Sprint-level criterion, not left to a risk-tier test to catch.
## Milestones
| Milestone | Target date | Status | Note ||---|---|---|---|| Query engine handoff from the Platform team | 1 Aug 2026 | Open, and confirmed | RAID log dependency D-01: still an open handoff, not yet delivered, but confirmed by Lee Zhang's team rather than left unconfirmed like D-03 below. Saved Views build cannot begin without it, which is why it stays on this list even while it reads green || Design-partner pilot readout | 5 Aug 2026 | Upcoming | Tests RAID log assumption A-02, that analysts want saved views enough to abandon a habitual workflow. A weak readout here is the likelier reason Saved Views adoption stalls amber than anything in the build || Charting vendor licence terms locked | 15 Aug 2026 | Unconfirmed | RAID log dependency D-03, Legal's sign-off, still unconfirmed. It rests on assumption A-01, that the vendor renews on current terms; if that assumption fails, register risk R-01 hardens from a watched item into a live re-platform |
## Risks and Issues
| Ref | Description | Status | What changed ||---|---|---|---|| R-05 (risk-register) | A shared saved view can disclose PII to a recipient without the matching entitlement | Escalated, residual 8, above the register's PII appetite line of 6 | 14 days with the steering group, counted from the 14 July escalation raised at the DEF-2291 postmortem's triage; still no funding decision or formal residual acceptance. The RAID log's own ageing column reads 6 days because it was last reviewed earlier in this period: the age is recomputed here from the same escalation date, not restated from the log || ISS-11 (raid-log) | Query-engine lead departed with no documented handover; the materialized form of register risk R-03 | Open, escalated | Past the RAID log's own two-week aging line; the backfill-contractor budget is the second row in Decisions Needed below || ISS-12 (raid-log) | Staging p95 view-list load recorded over the 500ms budget | In progress | Same reading as the View-list load row above, not a second problem. Its 24 July resolution target has passed with no fresher number logged; the next reading falls due at the dashboard's August review |
## Decisions Needed
| Decision | Decider | Needed by | Context ||---|---|---|---|| Fund a platform-level entitlement-aggregate control for shared saved views, or formally accept R-05's residual at board level | Steering group | No formal date is on record; the ask has sat open since 14 July | Raised at the DEF-2291 postmortem's triage and carried onto the risk register as R-05's live action. The longer it stays undecided, the harder the residual becomes to defend at a board review || Approve a GBP 45,000 backfill contractor to cover the departed query-engine lead (ISS-11) | Steering group | 31 Jul 2026, the issue's own resolution target | Without it, nobody is driving the handover behind milestone D-01 past the current team's existing bandwidth |
## Next Steps
- Read the design-partner pilot out on 5 August against assumption A-02; treat a weak result as the leading explanation for Saved Views adoption if it stays amber into the next report.- Confirm the charting vendor's licence terms by 15 August; if they move, bring forward the fallback rendering spike R-01 already has planned rather than waiting for the licence to actually change.- Keep paginating and lazy-loading the view list under the R-06 mitigation, and re-test at three times today's view count before the dashboard's next scheduled review closes ISS-12 out.- Carry Saved Views from its current specification into general availability, the same initiative the FY26 Q3 OKRs already hold against their second key result's 60 percent adoption target.Provenance
Section titled “Provenance”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.