Runbook | Revisão mensal de DEFINICOES
Procedimento mensal para auditar DEFINICOES.md, promover definições estáveis a STYLE-GUIDE/MEMORY-CONTRACT, e revogar as que perderam validade.
Quando rodar
- Última sexta de cada mês, após a sessão de consolidação semanal.
- Ad-hoc quando DEFINICOES passar de 50 entradas ativas ou 2000 linhas.
- Após mudança estrutural do projeto (nova fase, substituição de ferramenta crítica, mudança de owner).
Tempo estimado: 20 a 30 minutos.
Pré-requisitos
- DEFINICOES.md aberto no Obsidian.
- STYLE-GUIDE.md e MEMORY-CONTRACT.md acessíveis.
- Lista das reuniões do mês (consultar MEETINGS).
- 5 minutos de foco contínuo.
Passos
1. Inventário rápido (3 min)
Conte o número de definições ativas no DEFINICOES (linhas com **Definição:** que não estejam na seção “Histórico”).
| Mês | Total ativas | Promovidas | Revogadas | Adicionadas |
|---|---|---|---|---|
| 2026-05 | preencher | preencher | preencher | preencher |
Anotar na tabela acima (ou criar issue de tracking).
2. Triagem por idade (5 min)
Para cada definição com data de origem ≥ 30 dias atrás:
- ✅ Continua válida e estável → manter como está (nada a fazer).
- 🚀 Estável + impacto amplo (afeta 3+ pessoas/agentes, vai continuar) → candidata a promoção. Marcar com tag
#candidata-promocao. - 🗑️ Não se aplica mais → revogar (ver passo 4).
3. Promoção a STYLE-GUIDE ou MEMORY-CONTRACT (10 min)
Para cada #candidata-promocao:
Decisão: STYLE-GUIDE × MEMORY-CONTRACT × decisão canônica
| Tipo de definição | Destino |
|---|---|
| Convenção de escrita, formato, naming, lint | STYLE-GUIDE |
| Permissão de agente, contrato de leitura/escrita, princípio de governança | MEMORY-CONTRACT |
| Mudança de direção estratégica | decisoes (criar entrada com peso de decisão) |
| Definição operacional curta (rituais, papéis temporários) | Manter em DEFINICOES |
Como promover:
- Copiar o conteúdo essencial para o arquivo destino, adaptado ao formato dele.
- Em DEFINICOES, marcar a entrada original com riscado e link de destino:
~~**Definição original:** ...~~ **Revogada em 2026-05-30** — promovida a [[STYLE-GUIDE#secao|secao]] · contexto preservado em [[arquivo-original]]. - Mover a entrada riscada para a seção “Histórico” ao final do DEFINICOES.
- Se a promoção foi material (mudou peso ou alcance da regra), criar entrada em decisoes referenciando a mudança.
4. Revogação sem promoção (3 min)
Para definições que perderam validade:
- Marcar entrada com
~~texto~~. - Adicionar linha:
**Revogada em 2026-05-30** — motivo: [reunião X / mudança Y / owner saiu]. - Mover para seção “Histórico”.
5. Validação cruzada (3 min)
Rodar:
python3 99-operacao/scripts/vault-lint.py
python3 99-operacao/scripts/fix-pipe-escapes.py --dry-runSe houver wikilinks quebrados (ex: definição apontava para reunião que foi removida), corrigir manualmente.
6. Registro da revisão (2 min)
Criar entrada curta em decisoes no formato:
## 2026-05-30 · Revisão mensal de DEFINICOES (maio 2026)
- **Promovidas:** N (ver lista abaixo)
- **Revogadas:** M
- **Adicionadas no mês:** P
- **Owner:** Pedro Villa
- **Próxima revisão:** última sexta de junho
### Promoções
- [definição] → [[STYLE-GUIDE#secao|secao]]
- ...
Checklist final
- Inventário do mês registrado
- Triagem por idade feita
- Promoções aplicadas com riscado + link
- Revogações movidas para Histórico
-
vault-lint.pysem violações novas - Decisão de revisão registrada em
decisoes.md - Próxima revisão agendada (última sexta do mês seguinte)
Antipadrões a evitar
- Promover prematuro. Definição com 1 semana não está estável o suficiente.
- Revogar sem deixar rastro. Sempre manter em Histórico com motivo e data.
- Promover sem adaptar formato. STYLE-GUIDE tem estrutura própria (exemplos bom/ruim, antipadrões); MEMORY-CONTRACT tem outra (matriz de permissões, princípios). Copiar bruto não funciona.
- Esquecer a entrada em decisoes.md. Revisão sem rastro canônico é equivalente a não ter acontecido.