Skip to content

Repository files navigation

program-reporting-frameworks

Frameworks for the reporting half of program management: status updates, executive communications, and investment cases. Built from reporting on security, infrastructure and compliance programs to engineering teams, senior leadership, and executive sponsors.

Reporting is overhead, and it's also the only part of the program most of your stakeholders ever see. A status update that lands late and vague buys you a week of questions you'd rather have spent on the work.


Current Scope

Reporting patterns for technical programs, where clarity and trust matter more than slide polish.

  • Program status reporting
  • Executive investment cases
  • Steering committee deck structure
  • Lessons learned facilitation
  • Sample Red / Yellow / Green reporting

This isn't a dashboard product or a portfolio-management system. It's a set of reporting patterns for TPMs who need program reality visible early enough for someone to act on it.

What Is Here

Framework What It Is
Program Status Reporting Framework A two-tier status report model - short version for async triage, long version for full context. Includes status color definitions, cadence guidance, executive vs. operational reporting, and the most common mistakes.
Executive Investment Framework How to build and present an investment case for a security or infrastructure program. Covers the five questions every investment case must answer, how to structure a compliance-driven request, and how to report on investment progress once approved.
Steering Committee Deck Structure Slide-by-slide guide for building a steering committee deck that drives decisions rather than just reporting status. Covers what each slide should answer, what does not belong in the deck, and how to run the meeting itself.
Lessons Learned Facilitation Guide How to run a retrospective that generates real insight. Covers pre-work, psychological safety, facilitation structure, common failures, and how to turn the session into useful output rather than a list of platitudes.

Examples

File What It Shows
Sample Red / Yellow / Green Status A weak status update vs. a complete one, with an explanation of why the difference matters for decision-making.
Sample Steering Committee Decision A weak decision item vs. a decision the committee can actually make, plus the recorded outcome and the five questions every steering decision must answer. Fills Slide 5 of the Steering Committee Deck Structure.

How to Use These

Starting a program: Set up your status report format at kickoff. Establish the cadence, the audience, and the channel before the first update goes out. Consistency builds trust faster than quality alone.

Reporting to leadership: The Status Reporting Framework's long version is your source document. The short version is what you send. The executive can ask for the long version if they need it, and most of the time they won't.

Making an investment case: Work through the Five Questions in the Executive Investment Framework before you write anything. If you can't answer all five clearly, you're not ready to make the ask.

Reporting on an approved investment: See the last section of the Executive Investment Framework on progress reporting. The metric that justified the investment is the metric you report against.

Running a steering committee: Use the Steering Committee Deck Structure before you build the slide deck, not after. It defines what belongs in the meeting and what doesn't, which is as important as the format itself.

Closing a program: The Lessons Learned Facilitation Guide gives you the structure for a retrospective that produces real insight. Run it before the team disperses. The output feeds the close-out report and the next program team.


Where This Breaks

Reporting frameworks fail when they become performance art: clean decks, vague health colors, no ownership, and no decision asked.

If the report doesn't change what someone knows, decides, escalates, or does next, it's probably overhead.


A Note on Honesty in Reporting

Everything here is built around one principle: status reports should reflect reality, not aspiration.

A program that's Yellow but reported as Green isn't being managed. It's being managed around. The people who need to know it's Yellow don't know, so they can't help, so it gets worse. By the time it goes Red the options are limited and the trust is already spent.

Call things what they are. Yellow or Red with a path to green is a sign of a well-run program. Green followed by a sudden crisis is a sign of a reporting problem. Stakeholders who trust your reporting will give you room to operate. Stakeholders who suspect they're getting a managed version of reality start asking for the details you least want to hand over.


Built from reporting on platform security, infrastructure, and compliance programs to engineering teams and executive leadership. Maintained by Eric White | ChefPlex

License

Copyright (c) 2026 Eric White. Licensed under CC BY 4.0: use it, adapt it, put it to work in your own program. Credit is the only condition.

About

How to write a status report an executive can act on, and a steering deck that forces a decision.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors