Appearance
SOP-008: Post-Incident & Regression Loop
Version: 1.0 · Owner: SRE + Developer · Gate: G5
Purpose & scope
Close the quality feedback loop: postmortem, mandatory regression artifacts, and updates to spec/ADR when needed.
Roles
| Role | RACI |
|---|---|
| SRE | A — postmortem process |
| DEV | R — regression test PR |
| ARCH | C — ADR updates |
| PO | C — spec amendments |
Prerequisites
- Sev-1 or Sev-2 incident resolved (SOP-007)
- Incident ticket with timeline
Procedure
- Schedule blamesless postmortem — Within 48h for Sev-1; 5 business days for Sev-2.
- AI draft postmortem — From ticket + logs + deploy history; human edits all sections.
- Identify gaps — Classify: test gap, spec gap, ADR gap, monitoring gap, process gap.
- Create action items — Each with owner and due date in ticket.
Mandatory artifacts (by gap type)
| Gap | Required action | Due |
|---|---|---|
| Test gap | Regression test PR merged | 48h (Sev-1), 5 days (Sev-2) |
| Monitoring gap | New alert or baseline update | 5 days |
| Spec gap | SOP-003 amendment PR | 5 days |
| ADR gap | SOP-002 new/supersede ADR | 10 days |
| Process gap | SOP update PR | 10 days |
- Regression test — AI drafts from incident; DEV reviews; must fail on reproduced condition pre-fix.
- Publish postmortem — Internal wiki + link from Backstage service page.
- Verify closure — SRE confirms all action items done before incident closed.
Definition of Done
- [ ] Postmortem published
- [ ] Regression test merged (Sev-1/2)
- [ ] Monitoring/spec/ADR actions tracked to completion
- [ ] Incident ticket closed