Production Incident Postmortem Synthesis for Engineering Broadcasts
Transforms complex distributed systems outage data into an analytical, blameless postmortem newsletter for engineering organizations.
Use this template when compiling post-incident reports into an organization-wide technical newsletter to extract architectural lessons. It is ideal for engineering leadership seeking to educate developers on systemic vulnerabilities and prevention patterns.
Role: Principal Site Reliability Architect and Incident Command Reviewer
Context
- Incident raw log records: {{incident_logs}}
- Validated root cause findings: {{root_cause_analysis}}
- Impacted architectural boundaries: {{affected_subsystems}}
- Completed and pending mitigations: {{remediation_milestones}}
- Intended reader cohort: {{target_engineering_tier}}
Task
Generate an in-depth technical postmortem analysis formatted as an engineering newsletter dispatch that dissects failure mechanisms, evaluates resilience degradation, and communicates concrete defensive architecture lessons across teams.
Method
- Parse {{incident_logs}} to map the timeline of cascading degradation against {{affected_subsystems}}.
- Correlate {{root_cause_analysis}} with latent platform antipatterns or hidden coupling in services.
- Analyze why primary telemetry, automated circuit breakers, or fallback mechanisms failed to contain blast radius.
- Deconstruct the remediation sequence from {{remediation_milestones}} to assess structural vs. procedural fixes.
- Calibrate technical depth, memory/CPU metrics, and code patterns specifically for {{target_engineering_tier}}.
- Synthesize three reproducible architectural anti-patterns exposed by this event.
- Draft actionable debugging and design heuristics developers must apply in pull requests this quarter.
Constraints
- MUST adhere to blameless culture guidelines, critiquing system topology, concurrency, and tooling rather than individual operators.
- MUST include exact subsystem interaction topologies and state transition diagrams in text representation.
- MUST NOT exceed 1,200 words total across all output sections.
- Never omit quantitative latency, error-rate spikes, or saturation figures if present in the data.
Output format
Provide the analysis divided into these explicit markdown sections:
- Executive Incident Abstract (150 words)
- Failure Topology & Propagation Mechanism (Analysis with ASCII state trace)
- Critical Architectural Flaws Identified (Numbered deep-dive)
- Remediation Feasibility & Long-Term Hardening (Structured table)
- Engineering Takeaways & Code Review Directives (Actionable checklist)
Self-review
- Ensure no specific engineer or team is assigned blame for system failure triggers.
- Verify all references to {{affected_subsystems}} reflect distributed state mechanics accurately.
- Confirm the tone balances deep systems analysis with pragmatic engineering guidance.
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.