0002 · Indicadores como fonte única em YAML

• Status: aceita
• Data: 2026-10-17
• Decisores: Rogério Figueiredo

Contexto

O modelo de maturidade precisa ser lido por pessoas (documentação), validado (estrutura consistente) e usado por máquinas (cálculo dos níveis e, no futuro, o coletor). Manter essas três formas à mão garante que elas divirjam.

Decisão

Os níveis, os pesos dos domínios e todos os indicadores ficam em modelo/indicadores.yaml. A CLI governanca valida o arquivo (tipos estritos e regras de consistência), e modelo/schema.json dá autocompletar e validação no editor. As páginas em docs/maturidade/indicadores/ são geradas a partir dele, e o CI falha se estiverem desatualizadas.

Consequências

• Mudar um limiar é um pull request em um único arquivo, revisado como qualquer código.
• O cálculo de pontuação e o futuro coletor leem a mesma fonte que a documentação.
• As páginas geradas não devem ser editadas à mão.