Mapa de conocimiento con un enjambre

El prompt del enjambre de agentes que lee una carpeta de documentos y arma el mapa (qué temas hay, cómo se conectan, qué falta), el CSV de ejemplo con el formato exacto de columnas, y el script que audita el mapa resultante detectando páginas huérfanas y enlaces rotos.

Para qué sirve

Cuando tienes 50, 200 o 500 documentos (transcripciones de un curso, notas, informes) y necesitas saber qué hay adentro sin leerlos todos. El enjambre los lee en paralelo y devuelve un mapa navegable, no un resumen.

Cómo funciona

1. Un agente por documento (o por carpeta chica) extrae: tema, subtemas, las 5 afirmaciones con cita, y a qué otros documentos se refiere.
2. Un agente de síntesis junta las extracciones en el mapa: un CSV con una fila por tema y sus conexiones.
3. El script de auditoría revisa el CSV: temas que nadie enlaza (huérfanos), enlaces a temas que no existen (rotos), y documentos que no cayeron en ningún tema.

El prompt del enjambre (el agente principal)

En la carpeta ./fuentes hay [N] documentos. Lanza un agente por documento (máximo 8 a la vez) con esta instrucción: «Lee el documento entero. Devuelve en JSON: titulo, tema_principal (3 palabras), subtemas (lista), afirmaciones (5, cada una con la cita textual), se_refiere_a (títulos de otros documentos que menciona), cobertura ("leído entero" o "leído hasta la línea N")».
Cuando terminen, escribe mapa.csv con las columnas del ejemplo y un resumen de 10 líneas: cuántos documentos, cuántos temas, los 3 temas más conectados, y cuántos documentos no cayeron en ningún tema.
Regla: un agente que no leyó entero lo declara. No se acepta "leído" sin la cobertura.

El CSV de ejemplo

tema,documentos,subtemas,se_conecta_con,afirmacion_clave,fuente_de_la_afirmacion
"calificación de leads","doc-03; doc-11","triage; disposición a invertir","ventas por DM; atribución","el filtro duro va en el formulario, no en el chat","doc-11, línea 42"

El script de auditoría

python auditar_mapa.py mapa.csv
# → huérfanos: temas sin ninguna conexión entrante
# → rotos: conexiones a temas que no están en la columna tema
# → sin tema: documentos de ./fuentes que no aparecen en ninguna fila

Un mapa con huérfanos o rotos no está terminado: se corrige y se vuelve a auditar.

Las trampas ya pagadas

• Un agente hereda el error del brief: si le dices «son 120 documentos» y son 118, lo repite. Que cuente.
• Ocho agentes a la vez es el techo cómodo; más, y la ventana de uso se agota antes de que termine el de síntesis, que es el que importa.

Qué NO resuelve

No decide qué hacer con el conocimiento: te dice qué hay y cómo se conecta. La síntesis con criterio (qué manda sobre qué) sigue siendo tuya.

Siguiente paso

El mapa es la entrada de «La plantilla del segundo cerebro»: cada tema, una página de la wiki.