Blog
AuraScore 89/100

Incident Post-Mortem Deconstruction Matrix for Developer Blogs

Convert complex debugging logs and critical production war stories into an educational post-mortem matrix for developer blogs.

Use this template when translating a severe production outage or hard-to-find code bug into a transparent, educational blog post. It helps site reliability engineers and staff developers organize debugging hypotheses and lessons learned into a clean analytical format.

Template

Role: Staff Site Reliability Engineer & Technical Content Strategist

Context

  • Observed production anomaly: {{incident_symptom}}
  • Impacted services and dependencies: {{impacted_services}}
  • Diagnostic toolchain utilized: {{debugging_toolchain}}
  • Red herrings and debunked hypotheses: {{misleading_hypotheses}}
  • Underlying root cause mechanism: {{root_cause_mechanism}}
  • Implemented systemic remediation: {{remediation_steps}}

Task

Generate a comprehensive incident deconstruction matrix and chronological narrative structure that transforms the debugging journey of {{incident_symptom}} across {{impacted_services}} into a compelling, highly technical engineering blog post.

Method

  1. Map the timeline of events from initial symptom detection in {{incident_symptom}} to steady-state restoration.
  2. Dissect the initial hypotheses from {{misleading_hypotheses}}, articulating why telemetry suggested them and how they were ruled out.
  3. Detail the exact diagnostic steps executed via {{debugging_toolchain}} to isolate code or runtime state.
  4. Break down the mechanical physics of {{root_cause_mechanism}} down to the line of code, kernel parameter, or concurrency race condition.
  5. Cross-reference the efficacy of {{remediation_steps}} against short-term mitigation versus long-term architectural prevention.
  6. Assemble the Debugging Journey Matrix comparing symptom, hypothesis, investigation vector, finding, and final takeaway.
  7. Develop practical code-level or configuration snippets illustrating the exact bug and the verified fix.

Constraints

  • MUST preserve psychological safety by focusing exclusively on systems, tooling, and code, never individual human error.
  • MUST include at least two specific diagnostic techniques using {{debugging_toolchain}}.
  • MUST NOT oversimplify the technical complexity or skip intermediate investigation failures.
  • Narrative framing MUST prioritize transparency and actionable engineering takeaways.

Output format

Deliver the output in three structured sections:

  1. Investigation & Diagnostic Matrix (Markdown table containing: Investigation Phase, Metric/Telemetry Signal, Working Hypothesis, Tooling Used, Outcome/Verdict).
  2. Root Cause Technical Anatomy (A structured breakdown explaining the failure mechanism of {{root_cause_mechanism}} in under 300 words).
  3. Blog Article Structural Blueprint (4 clear narrative beats with explicit code snippet placement recommendations).

Self-review

  • Does the matrix clearly explain why the red herrings in {{misleading_hypotheses}} seemed plausible at the time?
  • Are the remediation actions in {{remediation_steps}} categorized by operational immediacy versus long-term prevention?
  • Is the tone blameless, educational, and technically rigorous?
AuraScore breakdown
89/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 specification14/14 · Strong

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.

writing-content
writing-blog
software-engineering-debugging
debugging
post-mortem
site-reliability