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.
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
- Map the timeline of events from initial symptom detection in {{incident_symptom}} to steady-state restoration.
- Dissect the initial hypotheses from {{misleading_hypotheses}}, articulating why telemetry suggested them and how they were ruled out.
- Detail the exact diagnostic steps executed via {{debugging_toolchain}} to isolate code or runtime state.
- Break down the mechanical physics of {{root_cause_mechanism}} down to the line of code, kernel parameter, or concurrency race condition.
- Cross-reference the efficacy of {{remediation_steps}} against short-term mitigation versus long-term architectural prevention.
- Assemble the Debugging Journey Matrix comparing symptom, hypothesis, investigation vector, finding, and final takeaway.
- 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:
- Investigation & Diagnostic Matrix (Markdown table containing: Investigation Phase, Metric/Telemetry Signal, Working Hypothesis, Tooling Used, Outcome/Verdict).
- Root Cause Technical Anatomy (A structured breakdown explaining the failure mechanism of {{root_cause_mechanism}} in under 300 words).
- 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?
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.