Lint del Wiki IA — 2026-10-28

Ejecutado por Nura antes del pull de Xabi, sobre el commit 04c66df (ingest de Token Optimizer). Alcance: 33 ficheros .md en wiki/ (31 páginas de contenido + index.md + log.md) y 11 ficheros en raw/.

Resultado global

ComprobaciónResultado
Frontmatter válido (YAML)✅ 33/33
Campos obligatorios✅ 0 faltantes
Wikilinks rotos✅ 0
Nombres kebab-case✅ 0 violaciones
Páginas sin entrada en el índice✅ 0 (eran 10, corregidas)
Páginas fuera del índice✅ 0 (eran 10, corregidas)
Contradicciones detectadas✅ 0
Confidence high/medium/low28 / 5 / 0 (incluye index.md y log.md)

Problemas encontrados y corregidos

  1. Tres filas del índice apuntaban al fichero equivocado. En la tabla de Conceptos, prompt-architect enlazaba a sources/prompt-architect en vez de a concepts/prompt-architect. En la tabla de Entidades, rea y defuddle apuntaban a sus respectivos sources/ en lugar de a las entidades. Corregidas a [[prompt-architect]], [[rea]] y [[defuddle]].
  2. Los 10 source-summaries no aparecían en ninguna tabla. La sección “Fuentes ingeridas” solo listaba el fichero raw/ y su estado, sin enlace a la página de resumen, así que los 10 sources/*.md no tenían ninguna entrada navegable desde el índice: solo se llegaba a ellos por el campo sources: del frontmatter. (No son huérfanos en el sentido estricto del grafo — por convención son hojas, enlazadas vía metadatos — pero el índice es el catálogo maestro y no los listaba.) Añadida sección ”📄 Sources ingeridas” con las 10 páginas, confidence, fecha y origen.
  3. Enlace ambiguo en el nuevo ingest. La fila [[token-optimizer]] resolvía a la entidad, no al source-summary homónimo (mismo slug en entities/ y sources/). Resuelta usando la ruta completa en la tabla de sources.
  4. Enlaces con prefijo absoluto dentro del índice. Las filas antiguas usaban wikilinks con el prefijo absoluto del repo (IA/NURA_VPS/wiki_IA/wiki/sources/…), que funciona pero acopla el índice a la ruta del fichero dentro del repo. Sustituidas por wikilinks cortos donde el slug es único; se conserva la ruta completa solo en los dos casos con slug duplicado (sources/rea no duplica, sources/token-optimizer sí).

Avisos que no se han tocado

  • Dos sources: no casan con ningún fichero de raw/: raw/articles/Hermes Skills You're NOT Using (Yet).md y raw/articles/How I Built a Self-Improving LLM Wiki with Hermes Agent (and Why I'm Not Using Obsidian).md. Los ficheros reales usan apóstrofo tipográfico (You're, I'm) o han sido renombrados. Es solo higiene de metadatos: el enlace conceptual es correcto, pero un script que valide rutas lo marcará siempre.
  • Dos ficheros de raw/ sin ingerir: Hermes Skills que aún no usas - ES.md (traducción del ya ingerido, duplicado deliberado) y How I Built a Self-Improving LLM Wiki ... (Why I'm Not Using Obsidian).md con apóstrofo curvo — parece el mismo artículo duplicado por un guardado distinto. Recomendación: borrar el duplicado y la traducción si no se van a usar, o ingerirlos explícitamente.
  • 5 páginas con confidence medium, todas justificadas: el ingest de Token Optimizer (4 páginas) porque las cifras son autopublicadas por el autor, y reverse-engineering por la misma razón. No se propone cambiarlas.
  • Sin comparativas: la sección “Comparativas” sigue vacía. Candidata natural ahora que hay material: token-optimizer frente a la compactación nativa de Hermes.

Recomendaciones

  1. Añadir al checklist de ingest la comprobación de slugs duplicados entre entities/ y sources/: es el único caso que obliga a usar la ruta completa.
  2. Limpiar los dos duplicados de raw/ para que el ratio “raw ingerido” sea fiable.
  3. Valorar una comparativa token-optimizer vs compactación nativa, y quizá vs context-compaction como concepto.