Newsletters
AuraScore 81/100

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.

Template

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

  1. Extract and normalize failure modes, timeline milestones, and blast radius indicators from {{incident_source_data}}.
  2. Filter incidents against {{system_tier_scope}} to prioritize distributed failures, cascading timeouts, and data degradation events.
  3. Frame the lead incident using a blameless root-cause analysis narrative tailored for {{target_reader_seniority}}.
  4. Deconstruct the underlying architectural anti-pattern (e.g., connection starvation, lock contention, circuit-breaker misconfiguration).
  5. Map technical mitigations to broader health benchmarks specified in {{reliability_metrics_focus}}.
  6. Structure a reproducible code or configuration snippet demonstrating the faulty logic versus the resilient pattern.
  7. Curate a cross-team remediation checklist that service owners can apply during {{publishing_cadence}} cycles.
  8. 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

  1. Issue Header & Executive Reliability Metric Summary (Table format)
  2. Deep Dive: Anatomy of the Primary Outage (Narrative + ASCII Topology Diagram)
  3. The Code/Config Differential (Side-by-side comparative diff)
  4. Systemic Lessons & Cross-Service Checklist (Max 5 actionable items)
  5. 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?
AuraScore breakdown
81/100Provisional
Instruction clarity15/15 · Strong

Explicit role, a named task, and discrete steps the model can follow.

Context architecture12/12 · Strong

Background, inputs and variables the model needs before it starts.

Constraint engineering12/12 · Strong

Hard boundaries — what the model must and must not do.

Output specification6/14 · Thin

A named, field-level shape for the response.

Reasoning structure10/10 · Strong

Ordered work items that force analysis before an answer.

Model compatibility10/10 · Strong

Length and structure that travel across frontier models.

Token efficiency5/10 · Thin

Signal density — instruction weight without padding.

Reusability7/7 · Strong

Documented variables so the scaffold adapts to new inputs.

Robustness3/5 · Adequate

Quality bar, assumptions and behaviour when inputs are thin.

Observed performance1/5 · Thin

How much real usage the template has behind it.

emails
emails-newsletters
software-engineering-debugging
sre
post-mortem
system-architecture