/ops-runbook

Se encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.

Cria runbook operacional passo a passo para tarefa ou procedimento recorrente.

Agente

Clawdia — hub operacional, calendário, emails, tarefas, decisões.

Output

## Runbook: [Nome da Tarefa]
**Responsável:** [Time/Pessoa] | **Frequência:** [Diária/Semanal/Mensal/Conforme Necessário]
**Última Atualização:** [Data] | **Última Execução:** [Data]

### Objetivo
[O que esse runbook realiza e quando usar]

### Pré-requisitos
- [ ] [Acesso ou permissão necessária]
- [ ] [Ferramenta ou sistema necessário]
- [ ] [Dado ou input necessário]

### Procedimento

#### Etapa 1: [Nome]
```
[Comando exato, ação ou instrução]
```
**Resultado esperado:** [O que deve acontecer]
**Se falhar:** [O que fazer]

#### Etapa 2: [Nome]
```
[Comando exato, ação ou instrução]
```
**Resultado esperado:** [O que deve acontecer]
**Se falhar:** [O que fazer]

### Verificação
- [ ] [Como confirmar que a tarefa foi concluída com sucesso]
- [ ] [O que checar]

### Troubleshooting
| Sintoma | Causa Provável | Solução |
|---------|---------------|---------|
| [O que você vê] | [Por quê] | [O que fazer] |

### Rollback
[Como desfazer isso se algo der errado]

### Escalação
| Situação | Contato | Método |
|----------|---------|--------|
| [Quando escalar] | [Quem] | [Como contatar — Discord/WhatsApp/telefone] |

### Histórico
| Data | Executado por | Notas |
|------|--------------|-------|
| [Data] | [Pessoa] | [Issues ou observações] |

Se Conectores Disponíveis

Se Notion MCP estiver conectado:

• Buscar runbooks existentes para atualizar em vez de criar do zero
• Publicar o runbook finalizado na wiki de ops do Notion

Se Linear MCP estiver conectado:

• Vincular o runbook a tipos de incident e change requests relacionados
• Referenciar issues de manutenção recorrentes

Dicas

1. Seja dolorosamente específico — "Rodar o script" não é uma etapa. "Rodar python sync.py --prod --dry-run no servidor de ops" é.
2. Inclua modos de falha — O que pode dar errado em cada etapa e o que fazer a respeito.
3. Teste o runbook — Peça a alguém não familiarizado com o processo para segui-lo. Corrija onde travarem.