SkillProgramaçãoSíntese

Escrita de Postmortem

Escreve postmortems blameless após incidentes - timeline, fatores contribuintes, lições e action items - duráveis o suficiente para serem lidos 6 meses depois. Use em até 5 dias úteis de qualquer incidente P0/P1.

Ações
PerfilDev
ProfundidadeMédia
IdiomaInglês (skill original)
Objetivo

Em uma frase.

Converter um incidente em aprendizado permanente. O documento deve ser blameless, baseado em evidências e acionável, focando em sistemas e não em pessoas, com o objetivo de prevenir recorrências em vez de punir culpados.

Aplicação

Quando
faz sentido.

Usar
  • Em até 5 dias úteis de qualquer incidente P0 ou P1
  • Após um quase-incidente que poderia ter sido P0 ou P1
  • Incidentes P2 recorrentes que compartilham a mesma classe de causa raiz
  • Quedas com impacto público em que a confiança do cliente exige uma narrativa escrita
Não usar
  • Problemas rotineiros P3/P4 (abra um ticket, não um postmortem)
  • Aprendizados de um único engenheiro (mantenha em notas pessoais)
  • Antes da mitigação estar concluída (o postmortem é retrospectivo, não um status update)
Prompt

Instruções
para a IA.

### Estrutura do documento

O template cobre: resumo de um parágrafo (o que aconteceu, impacto, status); impacto (usuários afetados, duração, efeito em receita/dados, comunicação enviada); timeline em UTC (detecção, alerta, ack do on-call, início e efetividade da mitigação, identificação da causa raiz, fix permanente, all clear); causa raiz com citação de logs e traces; fatores contribuintes; o que correu bem; o que correu mal; tabela de action items com ID, ação, dono, prioridade e prazo; e lições de 1-2 frases cada, memoráveis e transferíveis.

### Regras centrais

Seja blameless: foque em sistemas, não em pessoas ("o script de deploy permitiu X", não "a Alice rodou X"). Escreva em até 5 dias úteis, pois a memória se apaga rápido, e comprometa os action items revisando-os semanalmente até concluir. Publique para toda a organização, para que outros times aprendam e a confiança aumente.

### Anti-padrões

Evite "o Bob causou isso" (com culpa), action items sem dono, "ter mais cuidado" como lição e timeline adivinhada sem evidência de log. A entrega inclui o documento em markdown publicado, a lista de action items no issue tracker e, opcionalmente, uma versão voltada ao cliente quando houver impacto externo.
Execução

Como usar
com IA.

  1. 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
  2. 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
  3. 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o SKILL.md em .claude/skills/ (Claude Code) ou anexe o arquivo no Claude (claude.ai).