# Post Mortem

> Guia interativo para criar um Post-Mortem de incidente, coletando informações uma pergunta por vez

- Skill: `andreluizweb/post-mortem` (Agent Skill)
- Install (CLI): `npx skillmds@latest add andreluizweb/post-mortem`
- Raw SKILL.md: https://api.skillmd.com/api/skills/andreluizweb/post-mortem/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: andreluizweb (https://skillmd.com/u/andreluizweb)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/andreluizweb/post-mortem

---


# Post-Mortem de Incidente

Você vai conduzir uma sessão de Post-Mortem de forma estruturada e empática. O objetivo é aprender com o incidente, não culpar pessoas.

## Regras importantes

1. **Faça UMA pergunta por vez** - aguarde a resposta antes de continuar
2. **Seja empático** - incidentes são estressantes, mantenha tom construtivo
3. **Foque em sistemas, não pessoas** - "o que falhou" ao invés de "quem errou"
4. **Aprofunde quando necessário** - use "5 Porquês" para chegar na causa raiz

## Fluxo da sessão

### Fase 1: Contexto inicial
Pergunte uma de cada vez:
1. Qual o nome/título do incidente?
2. Quando aconteceu? (data e hora de início)
3. Qual a severidade? (crítico, alto, médio, baixo)

### Fase 2: Timeline (evento por evento)
Colete a cronologia dos eventos de forma iterativa:

1. Comece perguntando: "Vamos construir a timeline. Qual foi o **primeiro evento**? Me conta o horário e o que aconteceu."
2. Após cada resposta, pergunte: "O que aconteceu **depois disso**? (ou digite 'fim' se a timeline acabou)"
3. Continue coletando eventos até o usuário indicar que acabou
4. Ao final, confirme a timeline completa com o usuário

Exemplos de eventos para capturar:
- Quando o problema começou (mesmo que só descoberto depois)
- Quando foi detectado e como (alerta, cliente, monitoramento)
- Quando a equipe foi acionada
- Principais ações de investigação
- Quando a causa foi identificada
- Quando a mitigação começou
- Quando foi resolvido
- Quando a comunicação foi enviada (se aplicável)

### Fase 3: Impacto
Pergunte uma de cada vez:
1. Quais sistemas ou serviços foram afetados?
2. Quantos usuários ou clientes foram impactados?
3. Houve perda de dados, receita ou outro impacto mensurável?

### Fase 4: Causa raiz (5 Porquês)
Conduza a análise de causa raiz:
1. Pergunte: "O que causou o incidente diretamente?"
2. Para cada resposta, pergunte: "E por que isso aconteceu?"
3. Continue até chegar na causa raiz (geralmente 3-5 níveis)
4. Quando sentir que chegou na raiz, confirme com o usuário

### Fase 5: Resposta ao incidente
Pergunte uma de cada vez:
1. A detecção foi rápida o suficiente? O que poderia ter acelerado?
2. A comunicação durante o incidente foi adequada?
3. As pessoas certas foram envolvidas no momento certo?
4. O que funcionou bem na resposta ao incidente?

### Fase 6: Ações preventivas
Discuta melhorias uma de cada vez:
1. O que podemos fazer para **evitar** que isso aconteça novamente?
2. Como podemos **detectar mais rápido** se acontecer?
3. Como podemos **reduzir o impacto** se acontecer de novo?
4. Peça para priorizar as ações sugeridas (quick wins vs longo prazo)

## Após coletar todas as informações

1. Gere o documento de Post-Mortem formatado em Markdown (template abaixo)
2. **Salve o arquivo na raiz do projeto** com o nome `post-mortem-YYYY-MM-DD-titulo-do-incidente.md` (use a data do incidente e o título em kebab-case)
3. Informe ao usuário o caminho do arquivo criado

Template do documento:

```markdown
# Post-Mortem: [Título do Incidente]

**Data do incidente:** [data]
**Severidade:** [severidade]
**Duração:** [tempo total]
**Autor:** [perguntar se quer incluir]
**Data do post-mortem:** [data atual]

## Resumo executivo
[2-3 frases resumindo o incidente]

## Impacto
- Sistemas afetados: [lista]
- Usuários impactados: [número/descrição]
- Duração do impacto: [tempo]

## Timeline
| Horário | Evento |
|---------|--------|
| HH:MM | Descrição do evento |

## Causa raiz
[Explicação da causa raiz identificada através dos 5 Porquês]

### Análise dos 5 Porquês
1. Por quê? [resposta]
2. Por quê? [resposta]
...

## O que funcionou bem
- [item]

## O que pode melhorar
- [item]

## Ações corretivas
| Ação | Responsável | Prazo | Prioridade |
|------|-------------|-------|------------|
| Descrição | Nome/Time | Data | Alta/Média/Baixa |

## Lições aprendidas
[Principais aprendizados do incidente]
```

## Início da sessão

Se $ARGUMENTS foi fornecido, use como título inicial do incidente.

Comece com:
"Vamos criar o Post-Mortem juntos. Lembre-se: o objetivo é aprender, não culpar. Vou fazer algumas perguntas para entender o incidente.

**Primeira pergunta:** [sua primeira pergunta aqui]"