Tela /score · pesos, cenários e Top 10

15.0 · Por que este capítulo existe (abertura conceitual)

O ato de calibrar um índice composto carrega uma tradição teórica longa e, ao mesmo tempo, um conjunto de armadilhas práticas que justificam um capítulo inteiro só sobre a interface. Do lado teórico, a literatura sobre composite indicators da OECD (Nardo et al., 2008) e do Joint Research Centre da Comissão Europeia estabelece que a escolha de pesos é simultaneamente um ato técnico (precisa ser justificável estatisticamente) e um ato político (reflete prioridades de quem decide). O Agente DET segue essa tradição: pesos default existem para garantir reprodutibilidade, mas a possibilidade de calibração formal — versionada, assinada, com racional textual obrigatório — existe para garantir que a política não fique escondida atrás da técnica.

Do lado prático, três armadilhas justificam o esforço pedagógico deste capítulo: (i) o efeito ancoragem (Tversky & Kahneman, 1974) faz com que operadores raramente movam pesos mais que ±0,05 a partir do default, mesmo quando o contexto pede recalibração mais agressiva — por isso o sistema permite movimentos até ±0,15 sem racional, mas registra todo movimento como auditável; (ii) a falácia da soma constante faz com que se subestime o impacto cruzado: aumentar w₁ em 0,10 obriga a reduzir outro peso em igual magnitude, e o efeito real no Top 10 vem mais da redução do que do aumento; (iii) o viés de confirmação institucional faz com que se calibre até o Top 10 "parecer certo" — exatamente o oposto do uso correto, que é deixar o Top 10 surpreender e investigar a surpresa.

15.1 · Anatomia da tela

A rota /score está organizada em quatro zonas verticais. Memorize esta anatomia — todas as instruções deste capítulo se referem a uma delas.

15.2 · Fluxo canônico de uma calibração

1. Verifique os pesos default (Zona B). Eles refletem o consenso do Comitê Acadêmico em abr/2026: w₁ = 0,40 · w₂ = 0,25 · w₃ = 0,20 · w₄ = 0,15.
2. Mova um slider em até ±0,15. Movimentos maiores são tecnicamente possíveis mas exigem racional textual obrigatório no momento de salvar.
3. Observe o Top 10 (Zona C). A tabela recalcula em tempo real; identifique quais municípios entraram, saíram e mudaram de posição.
4. Cruze com Premissas (Zona D). Se há premissa estratégica vigente que justifica o movimento (ex.: "priorizar Norte por pacto climático COP30"), associe-a antes de salvar.
5. Salve a calibração (Zona A). Escreva o racional em uma frase. O sistema gera hash, registra autor e dispara o trigger de drift se a calibração for marcada como vigente.

15.3 · Erros comuns e como evitá-los

• Mover dois sliders ao mesmo tempo sem registrar racional: o sistema permite, mas o histórico fica ilegível. Convencione mover um por vez quando estiver explorando.
• Salvar calibração sem racional: tecnicamente possível, operacionalmente vedado pelo Conselho. Toda calibração sem racional é candidata automática a revisão na próxima reunião.
• Confundir "salvar" com "tornar vigente": são dois cliques distintos. Salvar gera registro; tornar vigente substitui a referência ativa do agente e dispara o trigger de drift.
• Calibrar até o Top 10 "parecer certo": é o erro epistemológico clássico — confunde validação técnica com confirmação intuitiva. A intuição do operador deve ser insumo, não oráculo.

15.4 · Lendo a banda P5–P95 no Top 10

Cada linha do Top 10 traz três números: P5, P50 (mediana) e P95. Interpretação executiva rápida:

• Banda estreita (P95 − P5 < 0,15): recomendação robusta; aporte âncora defensável.
• Banda média (0,15–0,30): recomendação cautelosa; programa de médio porte com co-financiamento.
• Banda larga (> 0,30): incerteza alta; piloto pequeno + fortalecimento institucional. Tipicamente municípios com Pro < 0,5.

15.5 · O que vem na sequência

Os próximos capítulos do manual operacional cobrem: Cap. 16 tela /diagnostico (choropleth e quartis), Cap. 17 motor causal (DAG e Granger), Cap. 18 mapa de decisão e exportação de PDF, Cap. 19 mercado e atores, Cap. 20 premissas e drift em profundidade, Cap. 21 glossário, Cap. 22 operações administrativas.