Incident Postmortem — Incident Post-Analysis Pipeline
An agent team collaborates to perform timeline reconstruction -> root cause analysis -> impact assessment -> remediation planning -> report generation.
Execution Mode
Agent Team — 5 members communicate directly via SendMessage and cross-validate each other.
Agent Composition
| Agent |
File |
Role |
Type |
| timeline-reconstructor |
.claude/agents/timeline-reconstructor.md |
Event collection, chronological ordering, gap identification |
general-purpose |
| root-cause-investigator |
.claude/agents/root-cause-investigator.md |
5 Whys, Fishbone, Fault Tree |
general-purpose |
| impact-assessor |
.claude/agents/impact-assessor.md |
User/revenue/SLA/reputation impact assessment |
general-purpose |
| remediation-planner |
.claude/agents/remediation-planner.md |
Short/mid/long-term countermeasures, action items |
general-purpose |
| postmortem-reviewer |
.claude/agents/postmortem-reviewer.md |
Cross-validation, blameless culture verification |
general-purpose |
Workflow
Phase 1: Preparation (Performed directly by Orchestrator)
- Extract from user input:
- Incident Description: What happened and when
- Evidence (optional): Logs, metric screenshots, chat records, alert records
- Impact Information (optional): Number of affected users, services, duration
- Actions Taken (optional): Emergency measures already performed
- Create
_workspace/ directory at the project root
- Organize input and save to
_workspace/00_input.md
- If existing files are available, copy them to
_workspace/ and skip the corresponding Phase
- Determine execution mode based on the scope of the request (see "Modes by Task Scale" below)
Phase 2: Team Assembly and Execution
| Order |
Task |
Assignee |
Dependencies |
Deliverable |
| 1 |
Timeline Reconstruction |
reconstructor |
None |
_workspace/01_timeline.md |
| 2a |
Root Cause Analysis |
investigator |
Task 1 |
_workspace/02_root_cause.md |
| 2b |
Impact Assessment |
assessor |
Task 1 |
_workspace/03_impact_assessment.md |
| 3 |
Remediation Planning |
planner |
Tasks 2a, 2b |
_workspace/04_remediation_plan.md |
| 4 |
Final Review |
reviewer |
Tasks 1-3 |
_workspace/05_review_report.md |
Tasks 2a (root cause) and 2b (impact) can be executed in parallel.
Inter-team Communication Flow:
- reconstructor completes -> delivers timeline and trigger candidates to investigator; delivers incident duration and metrics to assessor
- investigator completes -> delivers root cause and contributing factors to planner
- assessor completes -> delivers impact magnitude and SLA violation status to planner
- planner completes -> delivers full countermeasures to reviewer
- reviewer cross-validates all deliverables. Requests fixes for RED Must Fix items (up to 2 times)
Phase 3: Integrated Report Generation
- Generate
_workspace/postmortem_report.md integrating all deliverables
- Report structure: Summary -> Timeline -> Root Cause -> Impact -> Remediation -> What Went Well -> Lessons Learned
- Deliver the final report to the user
Modes by Task Scale
| User Request Pattern |
Execution Mode |
Deployed Agents |
| "Write a postmortem report" |
Full Pipeline |
All 5 agents |
| "Organize the incident timeline" |
Timeline Mode |
reconstructor + reviewer |
| "Analyze the root cause" |
RCA Mode |
reconstructor + investigator + reviewer |
| "Just create remediation measures" (cause analysis exists) |
Remediation Mode |
planner + reviewer |
| "Review this postmortem" |
Review Mode |
reviewer only |
Leveraging Existing Files: If the user provides existing timelines, cause analyses, etc., copy the files to the appropriate location in _workspace/ and skip the corresponding agent's step.
Data Transfer Protocol
| Strategy |
Method |
Purpose |
| File-based |
_workspace/ directory |
Store and share main deliverables |
| Message-based |
SendMessage |
Real-time delivery of key information, fix requests |
| Task-based |
TaskCreate/TaskUpdate |
Progress tracking, dependency management |
Error Handling
| Error Type |
Strategy |
| Insufficient incident information |
Ask user additional questions, tag uncertain parts with "[Unconfirmed]" |
| Logs/metrics inaccessible |
Reconstruct from verbal accounts, tag with "[Verbal account-based]" |
| Agent failure |
Retry once -> if fails, proceed without that deliverable, note omission in review |
| RED found in review |
Request fix from relevant agent -> rework -> re-verify (up to 2 times) |
| Blaming language found |
Reviewer immediately requests fix — blameless culture is an absolute principle |
Test Scenarios
Normal Flow
Prompt: "Yesterday at 2 PM the payment service was down for 30 minutes. It happened right after a deployment and was recovered by rollback. Create a postmortem report."
Expected Result:
- Timeline: Deployment -> incident start -> detection -> response -> rollback -> recovery in chronological order
- Root Cause: Specific defect in deployed code, contributing factors like no canary deployment
- Impact: User count, revenue loss, SLA impact estimates
- Remediation: SMART action items like canary deployment adoption, auto-rollback, alert improvements
- Integrated Report: Complete postmortem ready for executive reporting
Existing File Utilization Flow
Prompt: "Review this postmortem report" + report attached
Expected Result:
- Copy existing report to
_workspace/
- Execute in review mode
- Verify consistency, completeness, and blameless culture adherence
- Provide improvement suggestions
Error Flow
Prompt: "The API server was slow this morning. Analyze the cause."
Expected Result:
- Collect incident details through additional questions (time, impact, actions, etc.)
- Execute RCA mode with collected information
- Clearly mark uncertain parts
Agent Extension Skills
| Skill |
Path |
Enhanced Agent |
Role |
| rca-methodology |
.claude/skills/rca-methodology/skill.md |
root-cause-investigator |
5 Whys, Fishbone, Fault Tree, change analysis, cognitive bias prevention |
| sla-impact-calculator |
.claude/skills/sla-impact-calculator/skill.md |
impact-assessor |
SLA/SLO/SLI framework, error budgets, revenue loss estimation, severity levels |
1---2name: incident-postmortem3description: A full pipeline where an agent team collaborates to generate incident postmortem reports. Systematically performs timeline reconstruction, root cause analysis, impact assessment, and remediation planning. Use this skill for requests like 'write an incident postmortem', 'post-incident analysis report', 'create an incident report', 'incident report', 'root cause analysis', 'RCA report', 'organize incident timeline', 'establish remediation measures', and other incident analysis tasks. Note: real-time incident response (on-call), monitoring system setup, and alert configuration are outside the scope of this skill.4---56# Incident Postmortem — Incident Post-Analysis Pipeline78An agent team collaborates to perform timeline reconstruction -> root cause analysis -> impact assessment -> remediation planning -> report generation.910## Execution Mode1112**Agent Team** — 5 members communicate directly via SendMessage and cross-validate each other.1314## Agent Composition1516| Agent | File | Role | Type |17|-------|------|------|------|18| timeline-reconstructor | `.claude/agents/timeline-reconstructor.md` | Event collection, chronological ordering, gap identification | general-purpose |19| root-cause-investigator | `.claude/agents/root-cause-investigator.md` | 5 Whys, Fishbone, Fault Tree | general-purpose |20| impact-assessor | `.claude/agents/impact-assessor.md` | User/revenue/SLA/reputation impact assessment | general-purpose |21| remediation-planner | `.claude/agents/remediation-planner.md` | Short/mid/long-term countermeasures, action items | general-purpose |22| postmortem-reviewer | `.claude/agents/postmortem-reviewer.md` | Cross-validation, blameless culture verification | general-purpose |2324## Workflow2526### Phase 1: Preparation (Performed directly by Orchestrator)27281. Extract from user input:29 - **Incident Description**: What happened and when30 - **Evidence** (optional): Logs, metric screenshots, chat records, alert records31 - **Impact Information** (optional): Number of affected users, services, duration32 - **Actions Taken** (optional): Emergency measures already performed332. Create `_workspace/` directory at the project root343. Organize input and save to `_workspace/00_input.md`354. If existing files are available, copy them to `_workspace/` and skip the corresponding Phase365. Determine **execution mode** based on the scope of the request (see "Modes by Task Scale" below)3738### Phase 2: Team Assembly and Execution3940| Order | Task | Assignee | Dependencies | Deliverable |41|-------|------|----------|-------------|-------------|42| 1 | Timeline Reconstruction | reconstructor | None | `_workspace/01_timeline.md` |43| 2a | Root Cause Analysis | investigator | Task 1 | `_workspace/02_root_cause.md` |44| 2b | Impact Assessment | assessor | Task 1 | `_workspace/03_impact_assessment.md` |45| 3 | Remediation Planning | planner | Tasks 2a, 2b | `_workspace/04_remediation_plan.md` |46| 4 | Final Review | reviewer | Tasks 1-3 | `_workspace/05_review_report.md` |4748Tasks 2a (root cause) and 2b (impact) can be **executed in parallel**.4950**Inter-team Communication Flow:**51- reconstructor completes -> delivers timeline and trigger candidates to investigator; delivers incident duration and metrics to assessor52- investigator completes -> delivers root cause and contributing factors to planner53- assessor completes -> delivers impact magnitude and SLA violation status to planner54- planner completes -> delivers full countermeasures to reviewer55- reviewer cross-validates all deliverables. Requests fixes for RED Must Fix items (up to 2 times)5657### Phase 3: Integrated Report Generation58591. Generate `_workspace/postmortem_report.md` integrating all deliverables602. Report structure: Summary -> Timeline -> Root Cause -> Impact -> Remediation -> What Went Well -> Lessons Learned613. Deliver the final report to the user6263## Modes by Task Scale6465| User Request Pattern | Execution Mode | Deployed Agents |66|---------------------|----------------|-----------------|67| "Write a postmortem report" | **Full Pipeline** | All 5 agents |68| "Organize the incident timeline" | **Timeline Mode** | reconstructor + reviewer |69| "Analyze the root cause" | **RCA Mode** | reconstructor + investigator + reviewer |70| "Just create remediation measures" (cause analysis exists) | **Remediation Mode** | planner + reviewer |71| "Review this postmortem" | **Review Mode** | reviewer only |7273**Leveraging Existing Files**: If the user provides existing timelines, cause analyses, etc., copy the files to the appropriate location in `_workspace/` and skip the corresponding agent's step.7475## Data Transfer Protocol7677| Strategy | Method | Purpose |78|----------|--------|---------|79| File-based | `_workspace/` directory | Store and share main deliverables |80| Message-based | SendMessage | Real-time delivery of key information, fix requests |81| Task-based | TaskCreate/TaskUpdate | Progress tracking, dependency management |8283## Error Handling8485| Error Type | Strategy |86|-----------|----------|87| Insufficient incident information | Ask user additional questions, tag uncertain parts with "[Unconfirmed]" |88| Logs/metrics inaccessible | Reconstruct from verbal accounts, tag with "[Verbal account-based]" |89| Agent failure | Retry once -> if fails, proceed without that deliverable, note omission in review |90| RED found in review | Request fix from relevant agent -> rework -> re-verify (up to 2 times) |91| Blaming language found | Reviewer immediately requests fix — blameless culture is an absolute principle |9293## Test Scenarios9495### Normal Flow96**Prompt**: "Yesterday at 2 PM the payment service was down for 30 minutes. It happened right after a deployment and was recovered by rollback. Create a postmortem report."97**Expected Result**:98- Timeline: Deployment -> incident start -> detection -> response -> rollback -> recovery in chronological order99- Root Cause: Specific defect in deployed code, contributing factors like no canary deployment100- Impact: User count, revenue loss, SLA impact estimates101- Remediation: SMART action items like canary deployment adoption, auto-rollback, alert improvements102- Integrated Report: Complete postmortem ready for executive reporting103104### Existing File Utilization Flow105**Prompt**: "Review this postmortem report" + report attached106**Expected Result**:107- Copy existing report to `_workspace/`108- Execute in review mode109- Verify consistency, completeness, and blameless culture adherence110- Provide improvement suggestions111112### Error Flow113**Prompt**: "The API server was slow this morning. Analyze the cause."114**Expected Result**:115- Collect incident details through additional questions (time, impact, actions, etc.)116- Execute RCA mode with collected information117- Clearly mark uncertain parts118119## Agent Extension Skills120121| Skill | Path | Enhanced Agent | Role |122|-------|------|---------------|------|123| rca-methodology | `.claude/skills/rca-methodology/skill.md` | root-cause-investigator | 5 Whys, Fishbone, Fault Tree, change analysis, cognitive bias prevention |124| sla-impact-calculator | `.claude/skills/sla-impact-calculator/skill.md` | impact-assessor | SLA/SLO/SLI framework, error budgets, revenue loss estimation, severity levels |