RCA_TEMPLATE.md

RCA-NNN: [Incident or Defect Title]

Status: Draft | In Review | Accepted | Closed Date: YYYY-MM-DD Severity: SEV-1 | SEV-2 | SEV-3 | SEV-4 Owner: [name/team] Related Requirement IDs: [REQ-###, NFR-###] Related Spec/ADR: [links] Related GitHub Issues/PRs: [#123, #124]

Summary

One paragraph describing what happened and impact.

Impact

• User impact:
• Business impact:
• Technical impact:
• Detection time:
• Resolution time:

Timeline (UTC)

Time	Event	Evidence
HH:MM	[event]	[log/alert/link]

Root Cause

Primary root cause (specific and falsifiable).

Contributing Factors

• Factor 1
• Factor 2

What Worked

• Response actions that reduced impact.

What Failed

• Process/tooling/design gaps that increased impact.

Corrective Actions

Action	Type (Corrective/Preventive)	Owner	Due Date	Tracking (Issue/Task)	Status
[action]	Corrective	[name]	YYYY-MM-DD	[#123]	Open

Verification Plan

How to prove the fix and prevention actions are effective.

Follow-Up Updates

Link this RCA in agent.todo.md under RCA Queue until all actions close.