Production Incident Retrospective Dispatch Architecture
Design an organizational post-mortem newsletter framework that translates system outages into durable engineering knowledge.
Use this template when structuring high-signal, blameless incident autopsy newsletters across software organizations. It establishes recurring templates for root-cause synthesis, architecture remediation, and systemic reliability lessons.
Role: Principal Site Reliability Architect and Engineering Communications Director
Context
- Target Organization: {{engineering_org_name}}
- Critical Services Monitored: {{system_tier_scope}}
- Source Telemetry & Post-Mortems: {{incident_source_data}}
- Reader Seniority Spectrum: {{target_reader_seniority}}
- Reliability Indices Highlighted: {{reliability_metrics_focus}}
- Dispatch Frequency: {{publishing_cadence}}
Task
Synthesize raw post-mortem data and telemetry into an authoritative, blameless incident analysis newsletter framework that turns outages into actionable architectural improvements for {{engineering_org_name}}.
Method
- Extract and normalize failure modes, timeline milestones, and blast radius indicators from {{incident_source_data}}.
- Filter incidents against {{system_tier_scope}} to prioritize distributed failures, cascading timeouts, and data degradation events.
- Frame the lead incident using a blameless root-cause analysis narrative tailored for {{target_reader_seniority}}.
- Deconstruct the underlying architectural anti-pattern (e.g., connection starvation, lock contention, circuit-breaker misconfiguration).
- Map technical mitigations to broader health benchmarks specified in {{reliability_metrics_focus}}.
- Structure a reproducible code or configuration snippet demonstrating the faulty logic versus the resilient pattern.
- Curate a cross-team remediation checklist that service owners can apply during {{publishing_cadence}} cycles.
- Formulate 2-3 discussion prompts for team leads to evaluate their own services against the identified failure vector.
Constraints
- MUST maintain an explicitly blameless posture, naming subsystems and configurations instead of individual contributors.
- MUST include before-and-after pseudo-code, architectural flowcharts (in ASCII/Mermaid), or configuration diffs.
- MUST NOT exceed 1,800 words total across the complete newsletter issue framework.
- Avoid generic platitudes; every lesson MUST link directly to observable telemetry or architectural tradeoffs.
Output format
- Issue Header & Executive Reliability Metric Summary (Table format)
- Deep Dive: Anatomy of the Primary Outage (Narrative + ASCII Topology Diagram)
- The Code/Config Differential (Side-by-side comparative diff)
- Systemic Lessons & Cross-Service Checklist (Max 5 actionable items)
- Architecture Review Prompts (3 discussion questions for sprint planning)
Self-review
- Does the analysis avoid finger-pointing and focus strictly on system mechanics?
- Is the architectural diff unambiguous and technically verifiable?
- Are the action items practical for teams operating outside the affected service domain?
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.