Evolve · especificação para o Codex
O Evolve é a especificação editorial e operacional que orienta o Codex a investigar, estruturar e incorporar conhecimento no InfraMov. Não é uma lista de tarefas, um changelog ou um gerador de prompts.
Objetivo operacional: Aumentar a qualidade, a cobertura e a coerência do observatório sem deixar que cada pesquisa redesenhe o produto de maneira isolada.
Pautas de pesquisa
7 ideias especificadas para orientar futuras investigações.
Modelo do site
Roadmap estrutural para evoluir dados, navegação, experiência e governança do observatório.
Manual de operação
Regras para investigar, separar evidências e alimentar o modelo sem remodelar o site a cada pesquisa.
Pesquisas já incorporadas
O arquivo de pesquisas publicadas e em revisão é alimentado pela base de dados; não deve ser confundido com a Agenda futura.
Checklist antes de ampliar uma cidade
A cidade cresce por etapas. Cada etapa precisa ter uma saída verificável antes de receber novos conteúdos, gráficos ou comparações.
Identidade e escopo
- • slug, nome, estado e país
- • status editorial e data de revisão
- • fonte populacional com natureza da medida
A cidade pode ser selecionada sem misturar seu contexto com outro território.
Contexto territorial
- • narrativa histórica com fontes
- • sistema urbano de mobilidade descrito
- • limitações e lacunas declaradas
O leitor entende o território sem que contexto seja apresentado como indicador de desempenho.
Entidades e relações
- • organizações sem duplicação
- • serviços e presenças territoriais com evidência
- • infraestruturas e mapas com fonte
A cidade entra nos catálogos comuns e pode crescer por dados, não por exceções de interface.
Pesquisas e análises
- • pautas registradas no Evolve
- • pesquisas com metodologia, referências e status
- • séries somente quando medidas e fontes forem suficientes
Toda afirmação relevante aponta para evidência, interpretação ou lacuna identificável.
Futuros e manutenção
- • CityFutureDataset somente quando houver linha de base e série
- • sinais e limites visíveis
- • próxima revisão ou pauta aberta
A cidade pode ganhar uma leitura prospectiva sem transformar hipótese em previsão.
Uma pesquisa não precisa criar uma nova página
Catálogos, filtros, comparações, mapas e páginas de cidade.
Uma leitura interpretativa com metodologia, referências e status editorial.
Síntese da plataforma, prioridade de navegação ou posicionamento multi-cidade.
Contexto territorial, narrativa, fontes e leituras específicas daquele município.
Perguntas que ainda não têm evidência ou decisão suficiente para publicação.
Como o Codex deve operar
- 01
Escolher uma pauta antes de pesquisar
Toda investigação começa por uma pergunta catalogada na Agenda, não por uma ideia solta ou por uma página nova.
- • Selecionar uma pauta existente ou criar uma nova com pergunta, escopo, não-objetivos e critérios de saída.
- • Não iniciar pesquisa apenas para preencher uma cidade ou produzir volume de conteúdo.
- 02
Investigar com separação epistemológica
Impedir que fato, interpretação, hipótese e ausência de dados sejam misturados.
- • Registrar fonte, instituição, data de referência e nível de confiabilidade.
- • Separar fatos verificáveis, leituras editoriais, hipóteses, conflitos entre fontes e lacunas.
- 03
Mapear a saída no modelo de dados
Fazer a pesquisa ampliar a base reutilizável antes de criar exceções de interface.
- • Preferir registros e campos reutilizáveis em data.ts e city-datasets.ts.
- • Organizações, infraestruturas, linhas, operadores e pesquisas devem ser dados antes de serem blocos visuais.
- 04
Controlar o impacto editorial
Evitar que cada nova pesquisa molde a arquitetura inteira do site.
- • Homepage muda apenas quando houver síntese multi-cidade, posicionamento ou decisão de navegação.
- • Página individual de cidade muda quando a leitura territorial ou o contexto daquela cidade evoluir.
- 05
Validar e registrar limites
Tornar o resultado auditável e impedir que intenção seja confundida com entrega.
- • Executar validate:content e validate:evolve antes de considerar uma pauta incorporada.
- • Executar TypeScript, build e revisão proporcional das páginas afetadas.
- 06
Modelar presença territorial sem generalizar
Registrar como uma empresa, serviço ou infraestrutura aparece em cada cidade sem transformar catálogo nacional em prova de operação local.
- • Cadastrar a organização uma vez e usar presenças territoriais para indicar serviço, status, fonte e data por cidade.
- • Distinguir presença anunciada, operação documentada, disponibilidade indicada, popularidade medida e impacto avaliado.
- 07
Aplicar protocolo rígido de verificação
Garantir que nenhum número, status de serviço ou leitura comparativa entre na plataforma sem medida, data, escopo e fonte identificáveis.
- • Todo número precisa declarar o que mede, unidade, território, data de referência e se é censo, estimativa, observação ou cálculo.
- • População nunca deve aparecer como um valor solto: separar Censo, estimativa e população presente, sem comparar medidas de naturezas diferentes.
- 08
Transformar futuros em saída de dados aplicada
Manter o método de cenarização no Evolve e reservar a rota pública /futuros para séries, cenários, sinais e limites de cada cidade.
- • Nunca colocar o manual, o roadmap do site ou instruções de pesquisa como conteúdo principal de /futuros.
- • Toda leitura prospectiva por cidade precisa de linha de base, ao menos uma série observável, cenários explicitamente hipotéticos, sinais de acompanhamento e limitações.
Próxima pauta
Base editorial e mobilidade de Pirenópolis
Pauta registrada para orientar trabalho futuro. Não iniciar investigação nesta etapa.
Ver agenda →Fonte de verdade
- • src/lib/data.ts: entidades públicas, cidades, organizações, infraestrutura e pesquisas publicadas.
- • src/lib/city-datasets.ts: narrativa, fontes, agenda e camadas específicas de cada cidade.
- • src/lib/data.ts: mobilityServicePresences registra oferta, infraestrutura e grau de evidência por cidade sem duplicar organizações.
Último registro técnico
v0.15.3 · 2026-08-12
Navegação global passa a acompanhar a leitura: o cabeçalho fixa no topo, compacta durante a rolagem e mantém menus e troca de cidade acessíveis sem interromper o contexto.
Ver histórico →