Skip to content

Appcircle Incident Reports (IR)

This page is the canonical entry point for Appcircle's incident report archive. Each IR documents a production or significant non-production incident: what happened, why, and what we changed as a result.

Status legend

  • ✅ Resolved – Incident is closed; action items completed.
  • 🔄 In Progress – Incident is active or action items are still open.
  • 📝 Draft – Report is being written.

IR catalogue

Ordered by IR number. Filenames are NNNN-title.md.

See the IR Index for the full table.

How to add a new IR

  1. Pick the next number (zero-padded to 4 digits), e.g. 0003.
  2. Create the file under docs/ir/: 
    docs/ir/0003-short-title.md
  3. Use the IR template as the starting point.
  4. Add a row to IR Index.
  5. Commit and open a PR.

Conventions

  • One incident per IR. If a single event has multiple distinct root causes, split them only if the remediation is also distinct.
  • Stable links: never rename IR files; create a follow-up IR if the scope changes.
  • Blameless: focus on systems and processes, not individuals.
  • Link all related Linear issues, PRs, and runbooks.