21 · Glossário interativo

Vocabulário é infraestrutura. A tela /glossario consolida toda a terminologia do agente em um único lugar pesquisável, com referências cruzadas ao código e à literatura.

21.0 · Por que um glossário é uma instituição, não um anexo

A teoria de vocabulários controlados (ISO 25964; Hjørland, 2007) parte de uma observação simples: quando um termo técnico é usado por mais de duas pessoas, ele deixa de pertencer a quem o cunhou e passa a ser infraestrutura compartilhada. A partir desse ponto, ambiguidade terminológica não é ruído — é custo de transação permanente, no sentido de Coase (1937): cada deliberação reabre, sem necessidade, debates sobre o que as palavras significam, em vez de avançar sobre o que elas implicam.

Em fundações híbridas (academia + mercado + terceiro setor), o problema é agravado porque o mesmo termo carrega significados incompatíveis entre comunidades. "Risco" em finanças é variância retornada; em epidemiologia é probabilidade condicional de evento adverso; em política pública é exposição estrutural a dano. "Impacto" em avaliação é mudança causalmente atribuível; em marketing institucional é alcance bruto. Sem um glossário canônico que fixe qual significado o agente adota em cada contexto, decisões parecem alinhadas no nível da palavra e divergentes no nível da ação — o pior dos cenários para uma instituição que pretende durar.

Por isso o glossário do agente não é um PDF, nem um anexo do manual: é uma tela operacional, versionada, com referência cruzada ao capítulo do manual em que o termo é desenvolvido e ao módulo de código em que ele é instanciado. A invariante de manutenção é forte: nenhum termo aparece em capítulo do manual sem entrada correspondente no glossário, e o CI do repositório falha quando essa regra é violada. É uma forma de linguistic continuous integration.

21.1 · Estrutura

• Categorias — Metodologia, Mercado, Regulação, Causalidade, Operacional.
• Busca textual — em todos os campos (termo, definição, sinônimos).
• Filtro alfabético — A–Z, com contagem de termos por letra.
• Referência cruzada — cada termo lista capítulos do manual e arquivos do código onde aparece.

21.2 · Anatomia de um verbete

A definição obedece a três regras herdadas da lexicografia técnica (Béjoint, 2000): (i) genus proximum + differentia specifica — o termo é situado em sua classe mais próxima e em seguida distinguido dela; (ii) circularidade proibida — uma definição não pode usar o termo definido nem qualquer um de seus sinônimos; (iii) profundidade finita — toda cadeia de definições termina em vocabulário pré-teórico (palavras que se assumem conhecidas). Verbetes que violam qualquer destas regras são marcados em revisão pelo Comitê Acadêmico antes de irem ao ar.

21.3 · Mantendo o glossário vivo

O glossário é editável pelo Comitê Acadêmico. Novos termos surgem da literatura, de mudanças regulatórias e de iterações da equipe. A regra: nenhum termo pode aparecer em capítulo do manual sem entrada correspondente no glossário. O CI do repositório falha quando essa invariante é violada.

Termos depreciados não são apagados — recebem rótulo "obsoleto", com link para o substituto e justificativa de mudança. Apagar entrada antiga quebra documentos, decisões e auditorias que a ela se referem. A política segue o princípio de Postel (1980) adaptado: "be conservative in what you remove, liberal in what you cross-reference".