El método, paso a paso

Cómo se convierte un Diario de sesiones en una tabla, un turno de palabra por fila. Es el mismo método con el que se hicieron los 16 corpus, y cualquiera puede aplicarlo.

Skills y código

Una skill es un archivo de instrucciones que un asistente de IA sigue cuando la tarea lo pide: qué hacer, en qué orden, con qué herramientas y cuándo parar. Es la palabra con que Claude Code y otros asistentes llaman a estos archivos; por eso aquí no se traduce.

Son veintiuna skills de Claude Code. Cada una describe un paso: qué lee, qué hace, qué escribe y cuándo debe detenerse.

El trabajo repetible lo hace código determinista: el mismo archivo da siempre el mismo resultado. El asistente solo interviene donde hace falta juicio, como un orador mal reconocido o un nombre que admite dos lecturas.

Y ninguna de esas decisiones es definitiva sin una persona. El método está hecho para que quien investiga vea lo que la máquina no ve.

De la fuente a la tabla

Trece pasos, en este orden. Cada uno deja su resultado en una carpeta propia, de modo que se puede volver a cualquier punto sin rehacer lo anterior.

Preparar
1. Configurar el país. Lee unos pocos Diarios, deduce su formato —cómo se escriben las fechas, cómo se anuncia a un orador— y pregunta lo que no puede deducir.
  /diaries-bootstrap
Del documento al texto
1. Reconocer el texto. Solo para los PDF escaneados. Un modelo que funciona en su equipo lee cada página; nada se envía fuera.
  /diaries-ocr
2. Extraer. Reúne cada sesión en un texto fiel, con sus saltos de página. No corrige nada: es el punto al que siempre se puede volver.
  /diaries-extract
3. Limpiar. Quita cabeceras, pies y números de página, une las palabras partidas al final de línea y deja cada intervención en su párrafo.
  /diaries-correct
De la sesión a los turnos
1. Fechar y describir la sesión. Fecha, número, tipo, legislatura y quién preside, tramo a tramo, con los relevos.
  /diaries-meta
2. Apartar duplicados. Una misma sesión publicada dos veces se aparta, sin borrarla, antes de seguir.
  /diaries-dedupe
3. Marcar los turnos. Señala dónde empieza cada turno de palabra y quién lo toma. Es el paso más delicado, y el que tiene el umbral más exigente.
  /diaries-tag
4. Pasar a tabla. Convierte el texto marcado en filas, un turno de palabra por fila, con su orden en la sesión.
  /diaries-matrix
De los turnos a las personas
1. Reunir el padrón. La lista de quien tuvo escaño en cada legislatura, de la fuente oficial o del pase de lista.
  /diaries-deputies
2. Vincular. Une cada orador con su diputado o diputada. Lo dudoso pasa por revisión humana, y lo revisado se conserva.
  /diaries-match
3. Completar. Añade a cada turno el partido, el distrito y el sexo de quien habla, según el mandato vigente aquel día.
  /diaries-merge
Publicar
1. Igualar. Lleva la tabla de cada país a las mismas 16 columnas, con identificadores estables dentro de una edición.
  /diaries-standardize
2. Documentar. Escribe el LÉAME, el diccionario de datos, las limitaciones conocidas y los metadatos de cada país.
  /diaries-document

El orden importa. Los duplicados se apartan antes de marcar los turnos: si no, la misma sesión contaría dos veces al aprender cómo anuncia cada cámara a sus oradores.

Quién decide en cada paso

Cada paso puntúa la confianza en su propio resultado, y la puntuación decide qué pasa después.

Sigue (AUTO). La confianza es alta: el resultado se guarda y el proceso continúa.
Se marca (FLAG). El resultado vale, pero tiene dudas. El proceso continúa y el caso queda en una lista para revisarlo a mano.
Se detiene (HALT). La confianza no basta. Nada avanza hasta que una persona interviene.

Marcar los turnos y vincular a los oradores tienen umbrales más exigentes que el resto: un error ahí atribuye palabras a quien no las dijo.

Para controlar el proceso

Además de los pasos, ocho skills sirven en cualquier momento.

Estado. Qué está hecho, qué espera revisión y qué se ha detenido, por país y por sesión.
/diaries-status
Revisión. Recorre uno a uno los casos marcados: aceptar, corregir, saltar.
/diaries-review
Corrección. Aplica un arreglo a una sesión, a un tramo de sesiones o a todo un paso, y marca lo que hay que rehacer.
/diaries-feedback
Decisión. Registra una decisión de método con su evidencia medida. Sin evidencia no se guarda.
/diaries-decide
Validación. Toma una muestra al azar y la revisa, para medir los errores que el proceso no ve.
/diaries-validate
Informe. Reúne en un documento lo hecho en un país, con sus decisiones y sus cifras.
/diaries-report
Guía. Explica el método a quien empieza y le propone por dónde seguir.
/diaries-teach
Mejora. Corrige una skill a partir de lo que se observó al usarla, y deja escrito el cambio.
/diaries-refine

Cada decisión, con su prueba

Toda decisión que alguien podría discutir después se escribe en el momento: qué se decidió, qué alternativas había y qué medida lo justifica.

Las decisiones superadas no se borran: se marcan y se enlazan desde la que las sustituye. De ese registro sale, generado, el documento de metodología del proyecto.

Para empezar

Instale las skills, abra Claude Code en la carpeta de su proyecto y pida la guía. Le preguntará qué tiene y le dirá por dónde seguir.

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

Después, dentro de Claude Code: /diaries-teach para la guía, o /diaries-bootstrap para configurar un país.

Pide Claude Code, Python y, solo para los PDF escaneados, Ollama, que reconoce el texto en su equipo. Las skills están escritas en español.

La documentación técnica, con las fórmulas de confianza y las opciones de cada paso, está en el repositorio.

Ver el repositorio

Es el método tal como se aplicó, en su versión actual. La copia exacta del código que produjo cada edición publicada se conserva aparte.

Skills y código

De la fuente a la tabla

Preparar

Del documento al texto

De la sesión a los turnos

De los turnos a las personas

Publicar

Quién decide en cada paso

Para controlar el proceso

Cada decisión, con su prueba

Para empezar