| name | runbook-generator |
| description | Gerador de Runbook. Gera runbooks operacionais rapidamente a partir do nome do serviço e personaliza para fluxos de trabalho de implantação, resposta a incidentes, manutenção e rollback. |
| agents | ["claude-code"] |
Runbook Generator
Nível: PODEROSO
Categoria: Engenharia
Domínio: DevOps / Engenharia de Confiabilidade de Sites
Visão Geral
Gere runbooks operacionais rapidamente a partir de um nome de serviço, depois personalize para fluxos de trabalho de implantação, resposta a incidentes, manutenção e rollback.
Capacidades Principais
- Geração de esqueleto de runbook a partir de uma CLI
- Seções padrão para início/parada/saúde/rollback
- Placeholders estruturados para escalonamento e tratamento de incidentes
- Templates de referência para playbooks de implantação e incidentes
Quando Usar
- Um serviço não tem runbook e precisa de uma linha de base imediatamente
- Os runbooks existentes são inconsistentes entre equipes
- A integração de plantão requer documentação operacional padronizada
- Você precisa de scaffolding de runbook repetível para novos serviços
Início Rápido
python3 scripts/runbook_generator.py payments-api
python3 scripts/runbook_generator.py payments-api --owner platform --output docs/runbooks/payments-api.md
Fluxo de Trabalho Recomendado
- Gere o esqueleto inicial com
scripts/runbook_generator.py.
- Preencha comandos e URLs específicos do serviço.
- Adicione verificações de validação e gatilhos de rollback.
- Faça um dry-run em staging.
- Armazene o runbook em controle de versão próximo ao código do serviço.
Documentos de Referência
references/runbook-templates.md
Armadilhas Comuns
- Gatilhos de rollback ou comandos de rollback ausentes
- Passos sem verificações de saída esperada
- Contatos de propriedade/escalonamento desatualizados
- Runbooks nunca testados fora de incidentes
Melhores Práticas
- Mantenha cada comando como copiar e colar.
- Inclua verificações de saúde após cada passo crítico.
- Valide os runbooks em uma cadência de revisão fixa.
- Atualize o conteúdo do runbook após incidentes e post-mortems.