teqo-backup/.agents/skills/bug-fix/postmortem-template.md
Francisco Solla f58a712ad9 feat(OPS104): inicia o deploy no merge, com staging automático e produção com review
- deploy.yml: trigger push em main + preflight guard (pula se há run queued/in_progress; waiting não conta) e job hosted requeue após deploy-staging (fora do grupo deploy-homeserver)
- scripts/lib/deploy-trigger.mjs (decidePreflight/decideRequeue) + CLIs deploy-preflight/deploy-requeue; github-api ganha listWorkflowRuns/getBranchHead
- pins: ciSkipInvariants reescrito (push + guard + dispatch + requeue fora do grupo), deployTrigger/githubApi novos; deployScript intocado
- docs realinhados (AGENTS*, AGENT-OPS, README, runbook, rules/skills) + changelog

Closes #980
2026-09-14 03:07:59 -03:00

2 KiB

Post-mortem: <título curto do bug>

Template do /bug-fix. Preencha com fatos apurados; o que não for apurado fica "não apurado" — nunca invente.

Registro

Campo Valor
Data do post-mortem YYYY-MM-DD
Severidade crítica / alta / média / baixa
Ambiente prod / dev / CI
Issue(s) #N ou "sem Issue"
PR do fix #N
Detectado por humano / teste / log / usuário

Timeline

Momento Data/hora Evento
Início provável quando o bug começou (commit/entrega que o introduziu, se apurado)
Detecção
Correção mergeada
Deploy (bug de prod: deploy começa no merge; produção após approve do environment)
Verificado em prod (bug de prod: confirmação do humano)

O bug

O que acontecia, como se manifestava, quem afetava. Sintoma — não a causa.

Causa-raiz

Por que e como aconteceu (5-whys). Origem file:line / commit quando apurado. Se a reprodução falhou, registre as condições testadas e a base da hipótese.

Correção

O que mudou e por que resolve a causa (não o sintoma). Referências: arquivos, PR, migration se houver.

Verificação

  • Teste de regressão: <nome do teste> — falha sem o fix, passa com
  • Suíte: <resultado> (pnpm gate:fast / test:int / e2e afetado)
  • CI: verde no PR #N
  • Prod: <confirmação do humano, data/hora> ou "não se aplica (bug local)"

Prevenção

Estratégia Custo Estado
barata implementada agora (commit/PR)
cara documentada — não implementada neste fluxo

Estratégia implementada: o que foi adicionado para o bug não voltar (teste de regressão, guard, lint, validação…).

Estratégia documentada (cara): o que preveniria a recorrência mas exige engenharia relevante — candidata a Issue futura.

Lições

Observações livres: padrões que geraram o bug, sinais precoces ignorados, o que fazer diferente.