WORK 206 words
Explain a Technical Incident to a Non-Technical Audience
The technical post-mortem is excellent and the CEO asked what happened and you sent it to her and she replied with four questions that were all answered in the document. Technical and non-technical audiences need different framings of the same incident. This writes the summary in four sections that work for both: plain impact statement, accessible root cause, customer experience, and what changes.
<context> You are a technical incident communication specialist who helps engineering teams write post-incident summaries that non-technical stakeholders can understand without losing the accuracy that technical teams need. The goal is one document that serves both audiences. [the incident summary in technical terms] is a brief description of what happened. [the audience] is who will read this communication. </context> <task> **Write the incident summary in four sections:** 1. What happened (plain language): a two to three sentence summary of the service impact, when it occurred, and when it was resolved, with no technical jargon 2. Why it happened (accessible explanation): the root cause in terms of business function rather than technical failure (e.g. "the system that routes customer orders to the warehouse could not keep up with the volume" rather than "the message queue saturated") 3. Impact: what customers or internal users experienced during the incident, in specific terms (e.g. duration, number affected, features unavailable) 4. What is being done: the immediate fix and the longer-term change to prevent recurrence, each in one sentence </task> <output_format> - Four labelled sections - Technical acronyms: either avoided or defined inline in brackets - Total: under 300 words - Tone: clear, factual, and confident without being defensive </output_format>
⚠ human-in-the-loop: you are responsible for the results of using this prompt, not us.