O método, passo a passo

Como um Diário de sessões vira uma tabela, um turno de palavra por linha. É o mesmo método com que foram feitos os 16 corpora, e qualquer pessoa pode aplicá-lo.

Skills e código

Uma skill é um arquivo de instruções que um assistente de IA segue quando a tarefa pede: o que fazer, em que ordem, com que ferramentas e quando parar. É a palavra com que o Claude Code e outros assistentes chamam esses arquivos; por isso aqui não se traduz.

São vinte e uma skills do Claude Code. Cada uma descreve um passo: o que lê, o que faz, o que escreve e quando deve parar.

O trabalho repetível é feito por código determinístico: o mesmo arquivo dá sempre o mesmo resultado. O assistente só intervém onde é preciso juízo, como um orador mal reconhecido ou um nome que admite duas leituras.

E nenhuma dessas decisões é definitiva sem uma pessoa. O método foi feito para que quem pesquisa veja o que a máquina não vê.

Da fonte à tabela

Treze passos, nesta ordem. Cada um deixa seu resultado em uma pasta própria, de modo que se pode voltar a qualquer ponto sem refazer o que veio antes.

Preparar
1. Configurar o país. Lê alguns Diários, deduz seu formato — como se escrevem as datas, como se anuncia um orador — e pergunta o que não consegue deduzir.
  /diaries-bootstrap
Do documento ao texto
1. Reconhecer o texto. Só para os PDF escaneados. Um modelo que roda no seu computador lê cada página; nada é enviado para fora.
  /diaries-ocr
2. Extrair. Reúne cada sessão em um texto fiel, com suas quebras de página. Não corrige nada: é o ponto ao qual sempre se pode voltar.
  /diaries-extract
3. Limpar. Retira cabeçalhos, rodapés e números de página, une as palavras partidas no fim da linha e deixa cada intervenção em seu parágrafo.
  /diaries-correct
Da sessão aos turnos de palavra
1. Datar e descrever a sessão. Data, número, tipo, legislatura e quem preside, trecho a trecho, com as trocas na presidência.
  /diaries-meta
2. Separar duplicatas. Uma mesma sessão publicada duas vezes é separada, sem ser apagada, antes de seguir.
  /diaries-dedupe
3. Marcar os turnos de palavra. Indica onde começa cada turno de palavra e quem o toma. É o passo mais delicado, e o que tem o limiar mais exigente.
  /diaries-tag
4. Passar para tabela. Converte o texto marcado em linhas, um turno de palavra por linha, com sua ordem na sessão.
  /diaries-matrix
Dos turnos de palavra às pessoas
1. Montar o cadastro. A lista de quem teve cadeira em cada legislatura, da fonte oficial ou da chamada.
  /diaries-deputies
2. Vincular. Une cada orador ao seu deputado ou deputada. O duvidoso passa por revisão humana, e o revisado é conservado.
  /diaries-match
3. Completar. Acrescenta a cada turno de palavra o partido, o distrito e o sexo de quem fala, segundo o mandato vigente naquele dia.
  /diaries-merge
Publicar
1. Igualar. Leva a tabela de cada país às mesmas 16 colunas, com identificadores estáveis dentro de uma edição.
  /diaries-standardize
2. Documentar. Escreve o LEIA-ME, o dicionário de dados, as limitações conhecidas e os metadados de cada país.
  /diaries-document

A ordem importa. As duplicatas são separadas antes de marcar os turnos de palavra: senão, a mesma sessão contaria duas vezes ao aprender como cada câmara anuncia seus oradores.

Quem decide em cada passo

Cada passo pontua a confiança no próprio resultado, e a pontuação decide o que acontece depois.

Segue (AUTO). A confiança é alta: o resultado é guardado e o processo continua.
É marcado (FLAG). O resultado vale, mas tem dúvidas. O processo continua e o caso fica em uma lista para revisão manual.
Para (HALT). A confiança não basta. Nada avança até que uma pessoa intervenha.

Marcar os turnos de palavra e vincular os oradores têm limiares mais exigentes que o resto: um erro ali atribui palavras a quem não as disse.

Para controlar o processo

Além dos passos, oito skills servem a qualquer momento.

Estado. O que está feito, o que espera revisão e o que parou, por país e por sessão.
/diaries-status
Revisão. Percorre um a um os casos marcados: aceitar, corrigir, pular.
/diaries-review
Correção. Aplica um ajuste a uma sessão, a um intervalo de sessões ou a todo um passo, e marca o que precisa ser refeito.
/diaries-feedback
Decisão. Registra uma decisão de método com sua evidência medida. Sem evidência, nada é guardado.
/diaries-decide
Validação. Tira uma amostra ao acaso e a revisa, para medir os erros que o processo não vê.
/diaries-validate
Relatório. Reúne em um documento o que foi feito em um país, com suas decisões e seus números.
/diaries-report
Guia. Explica o método a quem começa e sugere por onde seguir.
/diaries-teach
Melhoria. Corrige uma skill a partir do que se observou ao usá-la e deixa a mudança registrada.
/diaries-refine

Cada decisão, com sua prova

Toda decisão que alguém poderia discutir depois é escrita na hora: o que se decidiu, que alternativas havia e que medida a justifica.

As decisões superadas não são apagadas: são marcadas e ligadas a partir da que as substitui. Desse registro sai, gerado, o documento de metodologia do projeto.

Para começar

Instale as skills, abra o Claude Code na pasta do seu projeto e peça o guia. Ele vai perguntar o que você tem e dizer por onde seguir.

git clone https://github.com/rodrodr/parlaibero-tools.git
cd parlaibero-tools
bash install_skills.sh

Depois, dentro do Claude Code: /diaries-teach para o guia, ou /diaries-bootstrap para configurar um país.

Requer Claude Code, Python e, só para os PDF escaneados, Ollama, que reconhece o texto no seu computador. As skills estão escritas em espanhol.

A documentação técnica, com as fórmulas de confiança e as opções de cada passo, está no repositório (em espanhol).

Ver o repositório

É o método tal como foi aplicado, em sua versão atual. A cópia exata do código que produziu cada edição publicada é guardada à parte.

Skills e código

Da fonte à tabela

Preparar

Do documento ao texto

Da sessão aos turnos de palavra

Dos turnos de palavra às pessoas

Publicar

Quem decide em cada passo

Para controlar o processo

Cada decisão, com sua prova

Para começar