Concepts / Weekly Status Update Report Structure

Weekly Status Update Report Structure

A weekly status update uses the same five labeled sections every week so a sponsor can locate information quickly.

  • Programming

The Half-Minute Reader

Imagine a sponsor who receives one message from your team each week and has only half a minute to read it. That reader is not auditing your calendar. They want to know three things: what changed, what is stuck, and whether anything is about to go wrong. A weekly status update exists to answer those questions quickly.

The format is built around a simple idea: the reader should be able to predict where each answer will appear. Once a reader learns where the blocked items live, they can skip straight to that line. The structure is therefore a reading tool as much as a writing tool. When the structure drifts from one week to the next, the reader has to hunt for information again, and the update stops doing its job.

Tracing the Five Labeled Sections

The template begins with a header line that identifies the customer and the week. After the header come five labeled sections, always in the same order. Each section answers one question the sponsor cares about. Follow the sections in order below and notice that each one hands the reader to the next kind of information: finished work, then requests for action, then insight, then evidence, and finally a forecast.

Each section answers one question. WHAT SHIPPED reports finished work. WHAT'S BLOCKED reports anything that cannot move without help. WHAT WE LEARNED records insight that should influence later decisions. METRIC MOVEMENT shows how the numbers changed. ONE RISK FOR NEXT WEEK names the most dangerous possibility ahead. Because the labels never change, the reader's eye can go directly to the question they came to answer.

Writing Specific Shipped Work and Blockers

Shipped work and blockers share one requirement: specificity. A shipped entry should name the change itself and attach something the reader can inspect, such as a link to a demo, a dashboard, or a pull request. The template's own placeholder reads WHAT SHIPPED followed by a note to give a specific change with a link to the demo, dashboard, or PR. The expected detail is therefore a concrete change plus proof, not a general statement that progress was made.

A blocker is held to the same standard. It must name what is stuck, provide a path to unblock it, and identify an owner who can act on that path. If nothing is blocked, the update should say so explicitly rather than leaving the section blank, because a blank section forces the reader to wonder whether the item was skipped or whether there truly is nothing stuck.

Worked example

Rewriting a shipped entry and a blocker

A team has a vague week: it did some work on the evaluation suite and is waiting on someone for the data export. Turn these into entries a sponsor can act on.

  1. 1
    Name the change itself

    Vague version: 'Made good progress on the evaluation suite.' Specific version: 'Added a held-out set of 200 test cases to the evaluation suite.' The specific version says what changed.

  2. 2
    Attach proof the reader can inspect

    The specific shipped entry gains a link, such as the pull request that added the cases. Now the sponsor can verify the claim without asking anyone.

  3. 3
    State the blocker with an unblock path

    Vague version: 'Waiting on data.' Specific version: 'The data export for the pilot cohort is stuck because the vendor has not confirmed the schema. Unblock path: a 15-minute call with the vendor contact to confirm the schema.'

  4. 4
    Name an owner

    The blocker gains an owner, a named person responsible for making the call happen. The sponsor now knows who to follow up with and what decision or action is being requested.

Result

The shipped entry names a specific change with proof, and the blocker names what is stuck, the unblock path, and the owner. Both lines can now be acted on or verified in seconds.

Blocker Versus Risk

Blockers and risks look similar because both involve things that could hurt progress, but they sit in different sections for a reason. A blocker is stopping work now. A risk might stop work later. Placing each in its correct section tells the sponsor whether the team needs help immediately or needs to watch a possibility over the coming week.

The two also differ in what they ask of the reader. A blocker is a request for action, so the sponsor may need to remove an obstacle. A risk is a forecast, so the sponsor needs to know where attention should go and what the team is doing about it. This is why the risk section is limited to one item with its prevention step, while the blocker section can list every item that cannot move without help.

Lessons and Metrics as Evidence

The lessons section asks for one or two specific things from the week that change how the team should think about the rest of the engagement. The point is not a diary of activity. A lesson is useful only if it would alter a future decision, so each lesson should name the decision it affects.

The metric section compares three numbers for each measure: the current value, the value from last week, and the baseline. For the evaluation suite, the template asks for this week's pass rate against last week's. Showing movement against both a recent point and a fixed starting point lets the sponsor see whether a change is a real trend or just noise from one week.

Worked example

Reading metric movement against two reference points

For the evaluation suite, this week's pass rate is 82 percent, last week's was 76 percent, and the baseline recorded at the start of the engagement was 70 percent. How should the metric line be read?

  1. 1
    Compare against last week

    82 minus 76 gives a gain of 6 points since last week. This shows short-term movement.

  2. 2
    Compare against the baseline

    82 minus 70 gives a gain of 12 points since the starting point. This shows the cumulative change over the engagement.

  3. 3
    Judge whether it is a trend

    A gain that holds against both the recent point and the fixed starting point is more convincing than a single week's jump. The sponsor can see the change is not only noise from one week.

Result

The metric line communicates both the weekly change and the cumulative change, so the sponsor can judge whether the trend is real.

Common Ways an Update Fails

A weekly update usually fails in predictable ways. The reader may be unable to find the answer they need, or the answer they find may not be something they can act on. The before and after view below shows the same week reported two ways.

  • Common mistake

    Writing a general statement of progress instead of a specific change

    What it looks like

    WHAT SHIPPED: Good progress on the pipeline this week.

    Why it fails

    The reader cannot tell what changed or check it.

    Do this instead

    Name the change and attach a link to the demo, dashboard, or PR.

  • Common mistake

    Leaving a section blank when nothing is blocked

    What it looks like
    WHAT'S BLOCKED: (empty)
    Why it fails

    The reader cannot tell whether nothing is stuck or whether the item was skipped.

    Do this instead

    State explicitly that nothing is blocked this week.

  • Common mistake

    Listing a blocker without an owner or unblock path

    What it looks like

    WHAT'S BLOCKED: Waiting on the data export.

    Why it fails

    The sponsor has no way to act on it.

    Do this instead

    Add the path to unblock it and name the owner responsible for it.

  • Common mistake

    Writing lessons as a diary of activity

    What it looks like

    WHAT WE LEARNED: We held four meetings and reviewed the backlog.

    Why it fails

    Nothing in the statement would change a future decision.

    Do this instead

    Name a lesson that alters a future decision, and say which decision it affects.

  • Common mistake

    Listing many risks instead of one

    Why it fails

    A long list dilutes the signal and hides which risk matters most.

    Do this instead

    Name the single most important risk and its prevention step.

  • Common mistake

    Reporting a metric without a comparison point

    What it looks like

    METRIC MOVEMENT: Pass rate is 82 percent.

    Why it fails

    A single number does not show whether anything moved.

    Do this instead

    Show the current value, last week's value, and the baseline.

Practice: Rewriting a Week

MEDIUM

Rewrite this week's vague update so that a sponsor can act on it in half a minute. Original notes: the team did work on the reporting module, the data export is still stuck, the team learned that testing takes a long time, the pass rate went up, and there are several things that might go wrong. Produce one entry for each of the five sections, using the specificity rules from this article.

Hints
  • Use the placeholder pattern from the template: a specific change with a link to proof for WHAT SHIPPED.
  • A blocker needs a path to unblock it and an owner. Decide whether the data export belongs in blockers or risks based on whether it is stopping work now.
  • For METRIC MOVEMENT, you need the current value, last week's value, and the baseline. If you do not have a baseline, say so explicitly rather than inventing one.
  • Choose only the single most important risk, and attach a prevention step.

Key Takeaways

  • A weekly status update uses the same five labeled sections every week so the sponsor can predict where each answer appears: WHAT SHIPPED, WHAT'S BLOCKED, WHAT WE LEARNED, METRIC MOVEMENT, and ONE RISK FOR NEXT WEEK.
  • Each section plays a distinct role: shipped work records what happened, blockers request action, lessons judge the future, metrics are evidence, and the risk is a forecast. Keep these roles separate.
  • Shipped work needs a specific change with a checkable link. Blockers need an unblock path and an owner. If nothing is blocked, say so explicitly.
  • Metric movement compares the current value with last week and with the baseline, so the sponsor can tell a real trend from one week's noise. The risk section names one risk with its prevention step.
  • Vague, padded, or blank entries make the update fail its purpose. Correct them by making every line specific, verifiable, and tied to a decision or action.