Postmortem Framework
Blameless postmortem templates, root cause analysis methods, action item tracking, and trend analysis dashboards.
Product Preview
Try the interactive reader and demo tools below, or get the full product with all content unlocked.
Interactive Reader (Free Preview) ⚙ Try Demo Tools Download Free SampleFile Structure 41 files
Documentation Preview README excerpt
Blameless Postmortem Framework
A complete system for running blameless postmortems, tracking action items, and measuring incident response effectiveness. Includes templates for every severity level, four structured root cause analysis methods, real-world examples, facilitation guides, and Python tools for parsing postmortem documents and computing reliability metrics.
What's Inside
postmortem-framework/
├── templates/ # Ready-to-use postmortem document templates
│ ├── full-postmortem.md # Standard template for SEV1/SEV2 incidents
│ ├── lightweight-postmortem.md # Quick template for SEV3/SEV4 incidents
│ └── sev1-postmortem.md # Extended template with exec summary & comms log
│
├── methods/ # Structured root cause analysis methods
│ ├── five-whys.md # Iterative "why" questioning with worked examples
│ ├── fishbone-diagram.md # Ishikawa diagram for multi-factor analysis
│ ├── causal-factor-tree.md # Tree-based decomposition for cascading failures
│ └── kepner-tregoe.md # Systematic problem analysis with decision matrices
│
├── examples/ # Completed postmortem examples
│ ├── database-outage.md # Connection pool exhaustion incident
│ ├── deployment-failure.md # Failed canary deployment with cascading timeouts
│ ├── cascading-failure.md # Multi-service cascade from DNS failure
│ └── security-incident.md # API key exposure and response
│
├── guides/ # Process and skills guides
│ ├── facilitation-guide.md # How to run a blameless postmortem meeting
│ ├── incident-metrics.md # MTTR, MTTD, error budgets, trend analysis
│ └── writing-effective-postmortems.md # Writing style, structure, anti-patterns
│
├── src/ # Python tools (stdlib only, no pip needed)
│ ├── __init__.py
│ ├── postmortem_parser.py # Parse markdown postmortems into structured data
│ ├── action_tracker.py # Track action items, deadlines, completion rates
│ └── metrics_analyzer.py # Compute MTTR/MTTD, error budgets, monthly reports
│
├── data/ # Sample data for the Python tools
│ ├── action_items.csv # 20 realistic action items across 5 incidents
│ └── incidents.csv # 20 incident records spanning 6 months
│
├── README.md
└── LICENSE
Quick Start
1. Run Your First Postmortem
1. Copy the appropriate template from templates/:
full-postmortem.mdfor SEV1/SEV2 incidentslightweight-postmortem.mdfor SEV3/SEV4 incidentssev1-postmortem.mdfor major incidents requiring executive communication
2. Read guides/facilitation-guide.md before the meeting
3. Choose an analysis method from methods/ (start with Five Whys)
4. Reference examples/ to see what a completed postmortem looks like
2. Use the Python Tools
All tools require only Python 3.10+ with no external dependencies.
... continues with setup instructions, usage examples, and more.