Registros de decisão

Cada decisão técnica relevante do projeto vira um registro curto (ADR, architecture decision record) nesta pasta. O registro explica o que foi decidido, por quê e com base em que evidência. Assim, quem chegar depois, inclusive o autor daqui a um ano, entende as escolhas sem precisar reconstruí-las.

As decisões do marco M0 vêm de spikes: experimentos pequenos e descartáveis que respondem a uma pergunta específica. Os scripts ficam em spikes/ e podem ser rodados de novo para reproduzir os números.

Índice

Nº	Decisão	Status
0001	Certificados do sistema operacional com truststore	aceita
0002	Frontend: router por hash do SvelteKit, estado no hash e regl-scatterplot	aceita
0003	Fontes do corpus, casamento ArticleMeta↔OpenAlex e licença por artigo	aceita
0004	Embeddings com qwen3-embedding:0.6b, análise em inglês e exibição em português	aceita
0005	Classificação com qwen3.5:9b, sem raciocínio, concorrência 1 e checagem de memória contínua	aceita
0006	Corpus em Parquet via DuckDB, refeito a partir de brutos/	aceita
0007	Parâmetros do agrupamento em tópicos, calibrados no piloto	aceita
0008	Geografia: afiliações casadas com as instituições do OpenAlex	aceita
0009	Tendência dos tópicos por regressão logística quase-binomial	aceita
0010	Gráficos em SVG próprio, com módulos pequenos do d3	aceita
0011	Classificação ancorada em evidência: texto, prompt, evidência curta, nova tentativa e cache	aceita
0012	Validação: amostra estratificada, codificação cega, codificador de referência e métricas por par	aceita
0013	Painel: jobs um por vez, progresso por SSE com retomada, cancelamento e edição do YAML sem perder comentários	aceita

Modelo

Copie o bloco abaixo para um arquivo NNNN-titulo-curto.md, com o número seguinte da lista.

# NNNN. Título da decisão

- **Status:** proposta | aceita | substituída por NNNN
- **Data:** AAAA-MM-DD
- **Marco:** M0

## Contexto

Qual pergunta precisava de resposta e por que ela importa.

## Opções consideradas

- Opção A: ...
- Opção B: ...

## Evidência

Números do spike, com tabela quando couber. Diga como foram medidos.

## Decisão

O que foi escolhido.

## Consequências

O que muda no projeto e quais riscos continuam abertos.

## Como reproduzir

    uv run spikes/<script>.py