# Automations, hooks e eventos

Automação é a camada que acorda a pipeline, registra evidência e impede ações sem gate.

## Ordem de preferência

1. Evento push: webhook, Channel, callback de CI, Jira, Slack ou PR.
2. Polling temporário: scheduled task quando não há webhook confiável.
3. Hook local: validação determinística antes/depois de tool use.

## Hooks locais

| Hook | Função |
|---|---|
| `sdd hook write-guard` | impede escrita por agents read-only |
| `sdd hook bash-guard` | bloqueia comandos destrutivos, merge, push e deploy sem gate |
| `sdd hook task-gate` | valida TaskCreated, TaskCompleted e TeammateIdle |
| `sdd hook trace-log` | grava auditoria de tool use |
| `sdd hook subagent-audit` | grava parada de subagents |
| `sdd hook notify` | notifica quando há input/permissão pendente |

## Eventos externos recomendados

| Evento | Ação da pipeline |
|---|---|
| Ideia criada | inicia PRD |
| PRD aprovado | inicia Tech Spec |
| Tech Spec aprovada | inicia Tasks |
| Refinement aprovado/dispensado | libera Execution |
| PR aberto | inicia Review |
| CI verde | completa evidência de Review |
| Review aprovado | libera checkpoint de merge |
| Deploy concluído | inicia Memory |

## Regra de segurança

Ausência de evento não é aprovação. Timeout não é aprovação. Comentário solto não é aprovação. Gate humano exige decisão explícita.
