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

58 lines
2 KiB
Markdown

# 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.