Back to Claude Scientific Skills

Status Report / Executive Briefing Template

scientific-skills/markdown-mermaid-writing/templates/status_report.md

2.38.07.0 KB
Original Source
<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->

Status Report / Executive Briefing Template

Back to Markdown Style Guide โ€” Read the style guide first for formatting, citation, and emoji rules.

Use this template for: Weekly/monthly status updates, executive briefings, project health reports, quarterly reviews, sprint retrospectives, or any document that updates stakeholders on progress, risks, and decisions needed. Designed to be read in under 5 minutes by someone with decision-making authority.

Key features: TL;DR at the top for executives who won't read further, traffic-light health indicators, explicit "decisions needed" section that surfaces blockers, metrics table with trends, and risk register with mitigations.

Philosophy: The #1 failure mode of status reports is burying the important stuff in a wall of accomplishments. Lead with what needs attention. If the reader only has 30 seconds, the TL;DR and health summary give them what they need. If they have 5 minutes, the full report answers every follow-up question they'd ask. Never make leadership dig for the thing they need to act on.


How to Use

  1. Copy this file for each reporting period
  2. Name it by date: status-2026-02-14.md or status-week-07.md
  3. Fill in the TL;DR first โ€” if you can't summarize it, you don't understand it yet
  4. Be honest about health status โ€” green means green, not "green because I'm optimistic"
  5. Add Mermaid diagrams for progress timelines, architecture changes, or risk impact flows

The Template

Everything below the line is the template. Copy from here:


[Project/Team Name] โ€” Status Report

[Reporting period: Week of Month DD, YYYY / Month YYYY / Q# YYYY] [Author] ยท [Date]


๐Ÿ“‹ TL;DR

[3โ€“5 bullet points. One sentence each. The most important things leadership needs to know. If they read nothing else, this is it.]

  • Overall: [One-sentence project health summary]
  • Progress: [Key milestone hit or approaching]
  • Blocker: [The biggest risk or decision needed, or "None" if clear]
  • Next: [What happens in the next period]

๐Ÿšฆ Health Summary

AreaStatusTrendNotes
Schedule๐ŸŸข On trackโ†’[Brief context]
Scope๐ŸŸก At riskโ†“[What's causing concern]
Budget๐ŸŸข On trackโ†’[Brief context]
Quality๐ŸŸข Goodโ†‘[What's improving]
Team๐ŸŸก Stretchedโ†’[Staffing or morale note]

Status key: ๐ŸŸข On track ยท ๐ŸŸก At risk ยท ๐Ÿ”ด Off track / blocked Trend key: โ†‘ Improving ยท โ†’ Stable ยท โ†“ Declining


โš ๏ธ Decisions Needed

This section is for items that require action from leadership or stakeholders. If nothing needs a decision, write "No decisions needed this period."

Decision 1: [Specific question that needs an answer]

Context: [Why this decision is needed now โ€” 2โ€“3 sentences]

Options:

OptionImpactRecommendation
[Option A][What happens][Recommended / Not recommended]
[Option B][What happens][Recommended / Not recommended]

Deadline: [When this decision is needed by and what happens if it's delayed]

Decision 2: [Another question]

[Same structure as above]


๐Ÿ“Š Key Metrics

MetricPreviousCurrentTargetTrend
[Metric 1 โ€” e.g., Sprint velocity][Value][Value][Target][โ†‘/โ†’/โ†“]
[Metric 2 โ€” e.g., Open bugs][Value][Value][Target][โ†‘/โ†’/โ†“]
[Metric 3 โ€” e.g., Test coverage][Value][Value][Target][โ†‘/โ†’/โ†“]
[Metric 4 โ€” e.g., Uptime SLA][Value][Value][Target][โ†‘/โ†’/โ†“]
<details> <summary><strong>๐Ÿ“Š Detailed Metrics</strong></summary>

[Extended metrics, charts, or breakdowns that support the summary table but would overwhelm the main report.]

</details>

โœ… Accomplishments

Completed this period

  • [Accomplishment 1] โ€” [Impact or outcome. Why it matters.]
  • [Accomplishment 2] โ€” [Impact]
  • [Accomplishment 3] โ€” [Impact]

Milestones

MilestonePlanned dateActual dateStatus
[Milestone 1][Date][Date or โ€”]โœ… Complete
[Milestone 2][Date][Date or โ€”]๐Ÿ”„ In progress
[Milestone 3][Date]โ€”๐Ÿ“‹ Upcoming

๐Ÿ”„ In Progress

Work itemOwnerStartedExpected completionStatus
[Item 1][Person][Date][Date][On track / At risk / Blocked]
[Item 2][Person][Date][Date][Status]
[Item 3][Person][Date][Date][Status]

๐Ÿšจ Risks and Issues

Active risks

RiskLikelihoodImpactMitigationOwner
[Risk 1]๐ŸŸก Medium๐Ÿ”ด High[What we're doing about it][Person]
[Risk 2][Level][Level][Mitigation][Person]

Active blockers

BlockerImpactNeeded fromStatus
[Blocker 1 โ€” or "None"][What's delayed][Who can unblock][Escalated / Waiting / Resolved]
<details> <summary><strong>๐Ÿ“‹ Resolved Issues</strong></summary>
IssueResolutionDate resolved
[Issue 1][How it was resolved][Date]
[Issue 2][Resolution][Date]
</details>

๐Ÿ“ Plan for Next Period

Priorities

  1. [Priority 1] โ€” [What will be done and expected outcome]
  2. [Priority 2] โ€” [What will be done]
  3. [Priority 3] โ€” [What will be done]

Key dates

DateEvent
[Date][What's happening]
[Date][What's happening]

๐Ÿ”— References


Next report due: [Date]