← All guides

From incident notes to shared understanding

Recovered is not the same as understood.

An incident postmortem records verified impact, response and recovery, then separates causal findings from open questions and follow-up work.

Make this with my agent

Bring your notes. Review a draft before sharing.

Explore the method
  1. 01
    Count what was measured

    240 failed requests is not a count of unique affected users.

  2. 02
    Keep the sequence visible

    The UTC timeline separates observed errors, alert, rollback and confirmed recovery.

  3. 03
    Separate follow-up states

    Noor owns an open validation task; Eli’s alert test and ownership are only proposed.

THE REAL HTML · FICTIONAL EXAMPLEView on its own

A worked example, not a customer result. September 2026 dates are sample facts.

Now make it about your work

Your evidence. Your agent. A clearer account.

Make the impact and timeline easy to read without turning a hypothesis into a root cause or recovery into prevention.

Start with three things

  1. The verified timeline, timezone and impact measures.
  2. Recovery evidence and reviewed causal analysis.
  3. Confirmed follow-up owners, proposed tasks and disclosure limits.
Make this with my agent

You review the facts and access. Nothing is published without your approval.

The method behind the incident postmortemAsk your agent to preserve uncertainty, separate recovery from investigation, and make each follow-up’s actual status visible.

How can an agent help write an incident postmortem?

Give it the verified timeline, impact measures, mitigation record, and reviewed analysis. Ask for a clear account that separates observations from causal hypotheses and service recovery from permanent remediation. Have the incident owners verify it, remove sensitive operational details, then share the approved static reading page.

What to give your agent

  • A reconciled incident timeline with explicit timezone and the evidence behind key events.
  • Approved impact measures with units, measurement windows, coverage limits, and unknowns.
  • The actions taken during response and evidence of recovery, separate from proposed permanent fixes.
  • Reviewed contributing factors, open questions, and follow-up records with confirmed owners and status.
  1. Define impact before telling the story

    State the affected service, observation window, and what was measured. Failed requests are not necessarily unique affected users. If customer coverage or data loss is unknown, preserve that uncertainty rather than writing a reassuring absolute.

  2. Reconcile the timeline

    Use one explicit timezone and retain conflicts in the source record for review. Separate detection, response, recovery, and confirmation. Do not infer that the first alert was the start of impact, or that a mitigation immediately restored every user.

  3. Separate causes from plausible explanations

    Summarize the reviewed system conditions and evidence without assigning motives to people. A change occurring before an outage is not proof that it caused it. Keep hypotheses and unresolved causal analysis labeled, and do not expose secrets or exploitable infrastructure details in a wider-audience version.

  4. Make follow-through verifiable

    List what was done to recover service and what still needs work. For follow-ups, preserve an owner, intended verification, and agreed date if supplied. Keep proposed tasks distinct from accepted tasks and completed tasks distinct from proven prevention. The tracker remains the source for changing status.

Keep creating and revising in the agent you already use. Start with a saved artifact style and learn how to update HTML without changing its link.

Use the full promptReady for your agent and your notes

Use the conversation where you already did the work. Only attach material you are allowed to share.

Get the ready-to-copy creation request →
Create an incident postmortem from only the verified and authorized incident materials I provide. Ask for missing essentials: incident scope, timeline timezone, impact units and window, recovery evidence, reviewed analysis, and follow-up ownership. Separate observed facts from hypotheses and recovery from permanent remediation. Preserve conflicting timestamps and unknown impact for review. Do not infer unique affected users from request counts, assert no data loss without evidence, assign blame, invent causal certainty, or mark proposed work completed. Include confirmed owners and supplied dates, with agreed versus proposed status. Keep secrets, exploit details, personal data, and sensitive infrastructure information out of the audience-facing draft. Create static HTML without scripts, forms, or live monitoring claims. Use my saved artifact style if available. Return the draft with unresolved questions. Do not publish or change access without separate explicit approval. Do not perform remediation or modify incident records as part of drafting.
Check before you shareAccuracy, clarity, and permission
  • Do impact units and time windows match the underlying evidence?
  • Are detection, recovery, and investigation state distinct?
  • Are causal hypotheses labeled rather than asserted as findings?
  • Do follow-ups preserve confirmed ownership and proposed versus accepted status?
  • Have operational secrets and inappropriate details been removed for this audience?

When HTML fits

A reviewed incident explanation for colleagues or an approved external audience, with a concise impact summary and evidence-led detail below.

When another format fits better

Use established incident tooling for active response, monitoring, alerts, and action tracking. Keep confidential investigation material in its approved system. This workflow is not security-incident advice, an emergency response tool, or a guarantee that recurrence is prevented.

What we started withThe same facts, as a wiki page

Fictional team wiki

Pine Reports — Download-07 incident review

Timeline

September 7, 2026; all times UTC. Timeline T-07: download errors first observed at 09:12, monitoring alert at 09:14, rollback started at 09:22, recovery confirmed at 09:30. The observed impact window is 18 minutes; we do not know whether errors occurred earlier.

Impact

Impact I-07: 240 failed download requests during that window. Requests were not deduplicated, so unique affected users are unknown. No overall request denominator, error-rate percentage or data-loss assessment is available.

Recovery and analysis

Recovery R-07: rollback restored downloads at 09:30. No deployment commands, infrastructure identifiers or credentials are included. Analysis A-07: a configuration change preceded the errors, but its causal role remains provisional and under validation. There is no confirmed root cause, mechanism or personal blame established.

Follow-up actions

F-01 remains open: Noor owns validation of the configuration hypothesis, with an agreed September 10 review. Compare reviewed change evidence with the timeline and record whether it supports the hypothesis. F-02 proposes Eli as owner of an alert coverage test. That task is not accepted or scheduled; there is no test result or prevention claim.

Review and source records

Incident owners must review facts and audience before sharing. Source logs and sensitive infrastructure stay out of the reading page. Source URLs are absent; the existing incident tracking workflow remains authoritative. This is a fictional communication exercise, not an actual outage or security instruction.

Inspect the HTMLOne self-contained file

The example is sanitized and isolated from this site. No scripts, forms, or live data.

<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Pine Reports · Download-07 postmortem</title><style>
*{box-sizing:border-box}html{color-scheme:light}body{margin:0;background:#faf6fa;color:#302439;font:17px/1.65 system-ui,sans-serif}main{max-width:1000px;margin:auto;padding:clamp(20px,5vw,64px)}h1,h2,h3,p{margin:0 0 18px}h1{font:500 clamp(32px,5vw,58px)/1.14 Georgia,serif;letter-spacing:-.025em;overflow-wrap:anywhere}h2{font:500 29px/1.3 Georgia,serif;overflow-wrap:anywhere}h3{font-size:19px;line-height:1.4}.label{font:700 12px/1.6 system-ui,sans-serif;letter-spacing:.08em;text-transform:uppercase}.intro{font-size:20px}.lead{background:#53355f;color:white;padding:24px;margin:28px 0}.lead p:last-child{margin:0}.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,230px),1fr));gap:20px;margin:24px 0}.card{background:white;border:1px solid #bbc5c4;padding:24px}.metric{font:500 38px/1.2 Georgia,serif;display:block;margin-bottom:12px}section{margin:36px 0}ul,ol{padding-left:22px}li{margin-bottom:12px}.note{font-size:14px}.warning{border-left:5px solid #956118;padding-left:20px}a{color:inherit;text-underline-offset:4px}a:focus-visible,summary:focus-visible{outline:3px solid #956118;outline-offset:4px}table{width:100%;border-collapse:collapse;table-layout:fixed;font-size:15px}th,td{text-align:left;vertical-align:top;border-bottom:1px solid #bbc5c4;padding:12px 8px;overflow-wrap:anywhere}caption{text-align:left;font-weight:700;padding:12px 0}pre,code{white-space:pre-wrap;overflow-wrap:anywhere}footer{border-top:1px solid #bbc5c4;padding-top:24px;margin-top:40px;font-size:14px}@media(max-width:480px){th,td{padding:10px 4px;font-size:14px}}@media print{body{background:white}.card,.lead{break-inside:avoid}h2,h3{break-after:avoid}}
</style></head><body><main><header><p class="label">Fictional incident / September 7, 2026 / All times UTC</p><h1>Downloads recovered. Investigation remains open.</h1><p class="intro">Download-07 · A reviewed account of observed impact, response, and remaining questions.</p></header>
<section class="lead"><h2>240 failed requests over 18 observed minutes.</h2><p>Unique affected users are unknown. There is no supplied request denominator for an error-rate calculation.</p></section>
<section><h2>The verified timeline</h2><ol><li><strong>09:12:</strong> first observed download errors.</li><li><strong>09:14:</strong> monitoring alert.</li><li><strong>09:22:</strong> rollback started.</li><li><strong>09:30:</strong> recovery confirmed.</li></ol><p class="note">Source T-07. The record does not establish whether impact began before 09:12.</p></section>
<section><h2>What recovery establishes</h2><p>The rollback restored report downloads. It does not establish a completed causal analysis or permanent prevention.</p><p class="note">Source R-07. No deployment commands or infrastructure identifiers are included.</p></section>
<section class="warning"><h2>A hypothesis—not a confirmed root cause</h2><p>A configuration change preceded the errors. Its causal role is provisional and still being validated.</p><p>No data-loss assessment was supplied. This page does not claim that no data was lost.</p><p class="note">Sources A-07 and I-07.</p></section>
<section><h2>Follow-through has two different states</h2><div class="grid"><article class="card"><p class="label">F-01 · Open / owner confirmed</p><h3>Noor: validate the hypothesis</h3><p>Review date: September 10, 2026. Compare reviewed change evidence with the timeline and record whether it supports the hypothesis.</p></article><article class="card"><p class="label">F-02 · Proposed / not accepted</p><h3>Eli: proposed alert coverage test</h3><p>Ownership and scheduling are not accepted. The intended test would assess detection coverage; no result exists.</p></article></div></section>
<section><h2>Where the work continues</h2><p>The existing incident tracker remains authoritative. This page does not run remediation, close tasks, or prove recurrence has been prevented.</p><p class="note">Source: accompanying fictional incident notes. Source URLs were not supplied.</p></section><footer>Fictional worked example by share/artifacts. Names, dates, figures and records are invented for demonstration. Static snapshot; no live data or automatic updates.</footer></main></body></html>
The original worked scenarioThe source scenario, step by step

Recovered service is not a completed investigation

A fictional report-download incident. Request failures are measured; the unique customer count is not.

The original notes

September 7 UTC: download errors observed 09:12; alert 09:14; rollback started 09:22; recovery confirmed 09:30. There were 240 failed requests during the 18-minute observation window; unique affected users are unknown. A configuration change preceded impact, but causal analysis is provisional. Rollback restored downloads. Noor owns validating the configuration hypothesis by September 10; Eli is the proposed owner of an alert coverage test, not yet accepted or scheduled. No data-loss assessment was supplied.

Observed impact

240 failed requests over an 18-minute observation window; unique affected users are unknown.

Timeline

Errors 09:12, alert 09:14, rollback 09:22, recovery confirmed 09:30 UTC.

Recovery

Rollback restored downloads. This does not complete the investigation.

Analysis

A preceding configuration change is a provisional hypothesis, not a confirmed cause. No data-loss assessment was supplied.

Follow-up

Noor owns validation by September 10. Eli's alert coverage test is proposed, not accepted or scheduled.

The page can be decisive about recovery while remaining honest about what the team has not yet established.

Questions, adaptations & sourcesGo deeper when you need to

Must the root cause be known before writing?

No. A draft can preserve the verified timeline and impact while marking analysis incomplete. Do not title a plausible explanation as the root cause merely to fill a section.

Can an internal postmortem be published unchanged?

Not automatically. A wider audience may require a separate reviewed version with sensitive details removed. Confirm both the facts and the disclosure boundary before publication.

Does the page track remediation?

No. It displays a reviewed snapshot and can link to authorized action records. Refresh the page only after reviewing updated evidence; it does not close or synchronize tasks.

Further reading