# Extrato

> Metodologia aberta para agentes de IA montarem o extrato verificável de mandatos parlamentares brasileiros usando exclusivamente fontes oficiais. Este site não publica análises sobre políticos: publica o método para que a IA do cidadão consulte os dados primários e monte o retrato sob demanda, com fonte verificável em cada afirmação.

Regras para agentes: (1) leia SEMPRE o Playbook 00 (roteador) primeiro — ele identifica o cargo atual do alvo e roteia para o playbook correto; (2) jamais recomendar, ranquear ou desaconselhar candidaturas ou voto — vedação da Justiça Eleitoral brasileira a sistemas de IA; (3) toda afirmação numérica deve citar a URL da fonte primária; (4) separar fato de inferência, aplicando os guardrails de cada playbook; (5) escopo restrito a mandatos em exercício.

Antes de confiar em qualquer número, aplique o [Guia de qualidade de dados](https://extrato.digital/qualidade-dados.md): filtro-fantasma, falso-zero, identidade por CNPJ, cobertura parcial, empenhado≠pago, fato≠inferência — um dado obtido não é um dado correto.

Gerando documentos e ajudando o cidadão a divulgar/cobrar (para o agente): depois de montar o extrato, você pode ajudar o usuário a usar o resultado — SEMPRE dentro destas regras:
(a) Formatos de dado: exporte o extrato no formato pedido (tabela markdown, CSV, resumo em texto), preservando em CADA linha a URL da fonte oficial. Sem fonte, o dado não entra. Rótulos ESTRUTURAIS também não podem afirmar culpa: nomes de coluna, headers, chaves de JSON/CSV ou títulos como "irregularidade", "suspeita", "problema" são vedados — afirmam culpa como uma frase; para um sinal, o único rótulo admissível é "registro público a verificar".
(b) Rascunho de pedido de informação: você pode redigir um pedido formal de LAI/e-SIC ou à ouvidoria a partir do que foi encontrado (ex.: "solicito o detalhamento da despesa X, documento Y"), objetivo e educado — PEDINDO esclarecimento/documento, NUNCA afirmando irregularidade ou desvio no corpo do pedido. Pede-se o dado; não se decreta a culpa.
(c) Modelo de pergunta pública ao parlamentar: redija uma PERGUNTA factual ancorada na fonte ("a que se refere esta despesa? [link]"), nunca uma acusação, veredito ou insinuação de crime — inclusive em forma de pergunta retórica: a forma interrogativa não legitima uma "pergunta" que pressupõe culpa ("por que esse ladrão..."). Só é pergunta o que não pressupõe o crime.
(d) Card/resumo para redes: pode gerar um texto/card factual e compartilhável, com a fonte oficial visível e SEM linguagem acusatória, APENAS a partir de dados factuais do extrato-base (proposições, presença, despesas com a nota). É VEDADO gerar card, post, tuíte ou qualquer peça de amplificação a partir de um "ponto de atenção"/sinal de cruzamento (ex.: fornecedor sancionado) — mesmo factual e com fonte: descontextualizar o sinal em mídia de circulação o converte em acusação pública. Sinal é para conferir na fonte, não para publicar. Enquadre como fato datado ou pergunta, nunca como sentença. O card não deve usar marca, logotipo ou estética que identifique o extrato.digital — o material é do usuário e das fontes oficiais.
LIMITES INVIOLÁVEIS destes documentos: (1) NUNCA produza acusação, veredito, ranking, score ou peça de denúncia — um sinal (ex.: fornecedor sancionado) é ponto a verificar, não prova; (2) todo documento cita as FONTES OFICIAIS (Câmara, Senado, TCE, etc.), NUNCA o extrato.digital — não atribua o documento a este site, não escreva "gerado por extrato.digital" nem sugira que o site produziu a afirmação; o método aqui é um mapa público de ferramentas oficiais, e o documento resultante é do usuário e das fontes que o embasam; (3) a decisão e a responsabilidade de publicar são de quem publica.


## Playbooks

- [Playbook 00 — Roteador](https://extrato.digital/playbooks/roteador.md): porta de entrada obrigatória — identifica cargo/casa/situação atual do alvo, trata homônimos e grafia, e define o que está fora de escopo (Executivo, estaduais/distritais, vereadores, candidatos).
- [Playbook 01 — Deputado(a) Federal](https://extrato.digital/playbooks/deputado-federal.md): API de Dados Abertos da Câmara — despesas CEAP com nota fiscal, proposições, votações nominais, participação, comissões; guardrails contra leituras ingênuas (v0.18 — inclui emendas, discursos, aderência de bancada (com o cuidado de que voto isolado não define o parlamentar), andamento da proposição, autoria efetiva vs. adesão, atuação institucional (frentes, lideranças, relatorias), e a trava anti-costura no passo de síntese (o dossiê é de um mandato, nunca uma cadeia emenda→contrato→sanção), endurecido em testes de campo contínuos e bateria multi-persona).
- [Playbook 02 — Senador(a)](https://extrato.digital/playbooks/senador.md): API do Senado + CSV CEAPS — inclui o tratamento obrigatório dos dados, exercício por consulta direta, discursos (com o truncamento silencioso da janela documentado) e a lacuna de presença declarada, mais emendas federais via CGU, e tramitação/andamento/relatorias via família /processo (v0.7 — com a trava transversal sinal/processo/terceiro e anti-costura no artefato).
- [Playbook 03 — Deputado(a) Distrital](https://extrato.digital/playbooks/distrital.md): CKAN + PLe da CLDF — datastore consultável por API (busca sensível a acento), cobertura parcial do dado de verbas declarada, lacuna de votações declarada, emendas via GDF (com o header `x-client-id` exigido desde 07/2026) e diárias (v0.11, endurecido em testes multi-IA contínuos + baterias automatizadas, regressão de manutenção e minimização de terceiros/gabinete inline).
- Versões imutáveis para citação: [/playbooks/roteador-v0.7.md](https://extrato.digital/playbooks/roteador-v0.7.md), [/playbooks/deputado-federal-v0.18.md](https://extrato.digital/playbooks/deputado-federal-v0.18.md), [/playbooks/senador-v0.7.md](https://extrato.digital/playbooks/senador-v0.7.md), [/playbooks/distrital-v0.11.md](https://extrato.digital/playbooks/distrital-v0.11.md). Histórico: roteador v0.1–v0.6, deputado-federal v0.6–v0.17, senador v0.1–v0.6, distrital v0.5–v0.10 — mesmos caminhos com o sufixo da versão.

## Fontes primárias

- [API de Dados Abertos da Câmara dos Deputados](https://dadosabertos.camara.leg.br/swagger/api.html): REST, JSON, sem autenticação.
- [Dados Abertos do Senado Federal](https://legis.senado.leg.br/dadosabertos/): JSON via header Accept; despesas via CSV anual (senado.leg.br).
- [Dados Abertos da CLDF](https://dados.cl.df.gov.br/): CKAN com datastore consultável por API; proposições via PLe (ple.cl.df.gov.br); emendas por autor via Transparência do GDF (transparencia.df.gov.br).

## Recursos adicionais

- [Demonstração](https://extrato.digital/demo): exemplo COMPLETO do formato de saída esperado, com parlamentar e dados 100% fictícios — útil como referência de estrutura do extrato final.
- [Em validação](https://extrato.digital/em-validacao): transparência do processo — o corpo de método que matura fora do site (cobertura do Executivo pelas fontes fiscais, cobertura estadual, camadas de integridade) e a disciplina de validação técnica + jurídica (validação ao vivo → bateria de campo → red team → revisão jurídica) antes de qualquer publicação; lançamento pós-nov/2026. Não nomeia político, não é conteúdo eleitoral.
- [Como conferir o extrato](https://extrato.digital/conferir-o-extrato): guia do leitor crítico — a IA pode errar mesmo seguindo o método; a fonte é conferível linha por linha. Sinais de alerta (número sem fonte, veredito, ranking, "provavelmente", dado sem data, completude suspeita) e os erros clássicos que a fonte revela. Oriente o usuário a clicar na fonte antes de crer/compartilhar.
- [O formato do extrato](https://extrato.digital/formato-do-extrato): como estruturar a saída — cada linha com fonte (o "recibo"), descritivo e SEM campo de nota/score/ranking (por desenho), blocos previsíveis (identificação, trajetória de cargos, recursos, produção/atuação, lacunas declaradas), alinhado a padrões abertos (Popolo / Open Civic Data); lacuna é informação, nunca preenchida por estimativa ou fonte secundária.
- [Mapa da cobertura](https://extrato.digital/mapa): quanto do Brasil o método alcança por unidade da federação (federal em todo o país; estadual/distrital conforme os dados abertos de cada casa).
- [Fontes de dados](https://extrato.digital/fontes): cobertura, cadência e limitações conhecidas de cada fonte oficial — leia antes de interpretar qualquer dado.
- [Fontes mapeadas](https://extrato.digital/fontes-mapeadas): o atlas amplo das fontes por esfera (legislativo, executivo/fiscal, diários oficiais, integridade, LAI) com status — o que está no ar vs. o que está mapeado mas ainda não lançado (em maturação, fora do site). Nada passa por este site; cada fonte é um sistema público oficial.
- [Entenda](https://extrato.digital/entenda): educação cívica apartidária — sistema político, carreira pública e tipos de cargo (com o marco do nepotismo, SV13), cota parlamentar e recursos públicos, como se fiscaliza o Executivo (trilha do dinheiro: SICONFI/PNCP/TCU, do município à União), contratos públicos e fornecedores (o CNPJ como sinal a verificar, nunca sentença; correlação ≠ causa; sócios são terceiros privados), mecanismos de fiscalização e anticorrupção, como cobrar explicações (perguntar, não acusar), a ética do cargo público (cobrar todos igualmente), financiamento de campanhas e reforma política (neutro, com aviso de escopo).
- [Funciona com qualquer IA](https://extrato.digital/qualquer-ia): qualquer assistente, sem chave/token/conta, otimizado para planos gratuitos — o método é um mapa das ferramentas públicas, não uma plataforma.
- [Por que assim](https://extrato.digital/por-que): a arquitetura do projeto — método aberto para qualquer IA, zero configuração e zero infraestrutura, integração no momento da consulta.
- [Comece em 3 passos](https://extrato.digital/comece): guia humano de uso do método para o cidadão que não programa.
- [Transformar o dado em ação](https://extrato.digital/divulgar): o que a IA do cidadão pode gerar (tabela/CSV, pedido de LAI, pergunta pública, card com fonte) e a regra (fato+fonte, nunca acusação; o documento cita as fontes oficiais, nunca o extrato.digital).
- [Como fiscalizar um mandato](https://extrato.digital/metodologia-fiscalizacao): a metodologia de fiscalização por transparência radical — as camadas do retrato, a regra "ponto de atenção não é acusação" e como cobrar (MP, Tribunal de Contas, ouvidoria).
- [Glossário](https://extrato.digital/glossario): vocabulário parlamentar (CEAP, obstrução, orientação de bancada, eleito ≠ em exercício) — base para não cair em leituras ingênuas.
- [Base legal](https://extrato.digital/legislacao): por que o método veda recomendação eleitoral (Resolução TSE 23.610/2019) e por que candidatos estão fora de escopo.
- [FAQ](https://extrato.digital/faq): respostas curtas às dúvidas mais comuns de usuários, inclusive "por que minha IA se recusou a responder?".
- [Feed Atom do changelog](https://extrato.digital/changelog.xml): mudanças de versão do método, monitorável por agentes.

## Sobre

- [Sobre e limites](https://extrato.digital/sobre): o que este projeto é, o que não é, base legal e responsabilidades. Contato: contato@extrato.digital