## Asset Header - **Asset ID:** DC-XX-LLMWiki-ViabilidadGrafoHumano-v01 - **Version:** v01 - **Status:** Draft — para ratificación - **Owner:** Victor Heredia - **Sherpa:** SherpaX - **Ratificador:** Victor Heredia - **IntellBank:** IB-XX-Maestro / IPI-XX-IP-Infraestructura / IPI-XX-Corp-LLM-Wiki - **Tipo:** DC — Documento de Concepto / Análisis de viabilidad - **Propósito:** Evaluar la viabilidad y factibilidad de convertir el LLM-Wiki de un grafo de conocimiento orientado a consumo de IA en un grafo de doble propósito — navegable por humanos y por IA — servido a través de SherpaX, sin perder su funcionalidad actual. - **Fecha:** 2026-06-09 - **Origen:** Room "Wiki sobre IntelliBanks" (arranque WORX /arrancaroom) --- # LLM-Wiki como Grafo de Doble Propósito ## Análisis de viabilidad y factibilidad — versión ejecutiva > *Veredicto: viable y de bajo riesgo. El grafo ya existe y está sano. El proyecto no es construir una wiki — es añadir una capa de navegación humana sobre la que ya alimenta a la IA. El único trabajo de fondo es separar dos tipos de enlace que hoy comparten una sola sintaxis.* --- ## 1. Objetivo Convertir el LLM-Wiki de **grafo para consumo de IA** a **grafo de doble propósito** — navegable tanto por humanos (WikiLinks + backlinks, lectura y exploración) como por la IA (recuperación semántica de contexto, como hoy) — entregado a través de **SherpaX** como superficie única. **Restricciones de diseño (ratificadas en el room):** - La wiki **no pierde** su funcionalidad actual de consumo por IA. - **Sin edición colaborativa** — solo lectura y navegación. - **No Obsidian** para el equipo (Victor lo usa local); **no** sitio web externo. - Superficie = **SherpaX**. El equipo accede al conocimiento como IntelliBanks, no como archivos. ## 2. Estado actual (línea base auditada 2026-06-09) El LLM-Wiki es un activo maduro, no un punto de partida en blanco: | Métrica | Valor | |---|---| | Páginas Wiki | 56 | | Fuentes en Raw/ | 366 (6 subcarpetas) | | WikiLinks totales | 531 | | Páginas sin TL;DR | 0 | | Páginas sin sección de fuentes | 0 | | Conceptos genuinamente faltantes | 0 | | Páginas huérfanas reales | 2 (`GPTBank`, `PLAN-DocumentType`) | El grafo está densamente tejido y bien conectado. **No hay deuda estructural que bloquee el proyecto.** ## 3. La brecha: un solo `[[ ]]`, dos tipos de arista El hallazgo central de la auditoría es que la wiki hoy usa la misma sintaxis `[[ ]]` para **dos relaciones conceptualmente distintas**: 1. **Concepto ↔ concepto** — el grafo humano. Ej.: `[[SherpaX]]` → `[[BrainOS]]`. Es lo que una persona quiere recorrer. 2. **Concepto → fuente Raw** — trazabilidad para la IA. Ej.: `[[SOMA-XX-Core-v01]]`, `[[MePB-XX-BrainCode-Anatomy-v02]]`. Apunta a documentos de `Raw/`, no a páginas navegables. Hoy conviven mezclados. La auditoría reportó "19 links rotos", pero al desglosarlos: 3 son ejemplos de plantilla, ~16 son referencias a fuentes Raw escritas con sintaxis de wikilink, y los conceptos genuinamente faltantes son **cero**. Es decir: el grafo no está roto — está usando un mismo símbolo para dos propósitos. **Implicación:** un visor humano que no distinga ambos tipos pintaría las ~16 referencias a fuentes como nodos muertos. Separar estos dos tipos de enlace es exactamente lo que habilita el doble propósito — no es un obstáculo, es la palanca. Brecha secundaria, menor: **dos formatos de encabezado coexisten** (49 páginas con `**Type:**`, 6 con `Asset ID`). No rompe nada, pero cualquier parser debe manejar ambos. Es estandarización, no salud. ## 4. Recomendación técnica **Una fuente, dos lecturas, una superficie.** Los `.md` de `Wiki/` no se reemplazan ni se migran a otra herramienta — siguen siendo la fuente única que alimenta a la IA. Encima de ellos, SherpaX **genera y sirve bajo demanda** una vista navegable para humanos. El mecanismo técnico recomendado es un **artifact servido por SherpaX** (precedente directo en tu vault: `VIZ-EL-BrainCodeMap-v01/v02.html`): una página viva, autocontenida, que parsea los markdown de `Wiki/`, resuelve los `[[WikiLinks]]` de tipo concepto→concepto a navegación interna, muestra panel de backlinks y graph view, e incluye búsqueda. Sin servidor, sin Obsidian, sin edición. La condición habilitante es la **convención de dos enlaces**: - `[[Concepto]]` → arista navegable del grafo humano. - Referencia a fuente → se mueve a un campo/sintaxis distinta (p. ej. la sección "Fuentes" con ruta `Raw/...`, no `[[ ]]`), de modo que el visor humano la trate como "ver fuente" y no como nodo del grafo, mientras la IA la sigue usando para trazabilidad. ## 5. Opciones y por qué esta | Opción | Qué es | Veredicto | |---|---|---| | **A — Visor artifact sobre los .md (recomendada)** | SherpaX renderiza el grafo existente bajo demanda | ✅ Bajo riesgo, doble propósito, respeta la fuente única y la superficie SherpaX | | B — Sitio estático externo (Quartz/MkDocs) | Publicar `Wiki/` como web | ❌ Rompe "superficie = SherpaX"; introduce mantenimiento aparte | | C — Wiki server multiusuario (MediaWiki/TWiki) | Wiki vivo editable | ❌ Edición descartada; choca con gobernanza WORX y con la curaduría canónica | ## 6. Roadmap propuesto 1. **Normalizar los dos tipos de enlace** — definir la convención (concepto vs. fuente) y aplicarla. Trabajo acotado: ~16 referencias a reclasificar + reparar 2 huérfanas. *(Habilitador crítico.)* 2. **Estandarizar encabezados** — un solo formato para que el parser sea simple. *(Opcional pero recomendado antes del visor.)* 3. **Prototipo del visor** — artifact con un subconjunto de páginas, validar navegación humana (wikilinks, backlinks, graph, búsqueda). 4. **Visor completo servido por SherpaX** — sobre las 56 páginas, abrible por el equipo. 5. **Integrar al ciclo de mantenimiento** — el `llm-wiki-validator` valida también la convención de enlaces en cada ingest. ## 7. Riesgos - **Drift de la fuente única:** si alguien edita el visor en vez de los `.md`, se rompe el modelo. Mitigación: el visor es solo lectura por diseño. - **Reintroducción de la mezcla de enlaces** en futuros ingests. Mitigación: el validator la chequea (paso 5). - **Legibilidad humana del contenido escrito para IA:** las páginas son síntesis densa. Mitigación: el TL;DR (presente en el 100%) cubre la entrada rápida; ajustar solo si el prototipo muestra fricción. ## 8. NEXTs - **NEXT (Victor):** ratificar este documento y el naming/ubicación. `#NEXT-Victor` - **NEXT (SherpaX):** al ratificar, ejecutar Paso 1 del roadmap (convención de dos enlaces) y levantar prototipo del visor (Paso 3). `#NEXT-SherpaX` --- ## Conexiones - [[IntelliBanks]] — la capa donde vive el conocimiento que el grafo navega - [[LLM-Wiki-Playbook]] — cómo se ingesta y mantiene la wiki hoy - [[SherpaX]] — la superficie que sirve el grafo a humanos e IA - [[CP-XX-IntelliBanks-Registry]] — registro maestro de activos ## Fuentes - Auditoría de salud del LLM-Wiki, 2026-06-09 (Room Wiki sobre IntelliBanks) - `IB-WikiX/index.md` · `IB-WikiX/Wiki/LLM-Wiki-Playbook.md` - Precedente técnico: `IB-EL-EmpowerLabs/VIZ-EL-BrainCodeMap-v02.html` --- *Documento de concepto v01 — generado en el Room "Wiki sobre IntelliBanks". Sujeto a ratificación de Victor Heredia.*