Provider Integration Postmortem Template


Use this structure whenever a provider integration regresses:

Incident Summary

  • Date: YYYY-MM-DD
  • Impact: who was affected and how long
  • Detection: how the issue was discovered

Root Cause

Describe the direct trigger and any contributing systems.

Fix

export function summarizeFailure(surface: string, reason: string): string {
  return `Integration failure on ${surface}: ${reason}`;
}

Follow-Ups

  • Add deterministic verification for the failing path.
  • Remove temporary mitigations once the durable fix lands.
  • Link the release note that shipped the fix.