# WikiX — Reglas de Funcionamiento · v01

El contrato operativo del WikiX. Si se respetan estas reglas, el WikiX sirve a la IA y a humanos sin degradarse. Si se rompen, deja de ser navegable y se vuelve ruido.

---

## 0. Principio rector — una fuente, dos lecturas, una superficie

El WikiX es **una sola fuente** (los `.md` de `Wiki/`) que se lee de dos formas:
- **IA:** el SherpaX consulta los markdown para responder con contexto real.
- **Humano:** el SherpaX renderiza el grafo navegable desde esos mismos markdown.

Nunca se duplica el contenido para humanos. Se sirve, no se copia. La superficie de acceso es **el SherpaX**, no archivos sueltos ni Obsidian.

---

## 1. Estructura

```
IB-WikiX/
├── index.md     ← punto de entrada. Directorio + categorías + ingest log + health.
├── Wiki/        ← una página por concepto (la síntesis navegable).
└── Raw/         ← copias de las fuentes ingestadas (inmutable, capa-espejo).
```

**Regla de las dos zonas:** `Raw/` es la fuente de verdad inmutable (no se edita); `Wiki/` es la síntesis (sí se edita). Si una fuente cambia, se reemplaza en `Raw/` y se actualiza su página en `Wiki/`.

---

## 2. Naming

- **Carpeta/banco:** `IB-ENTIDAD-Nombre` (este banco es `IB-WikiX`).
- **Páginas `Wiki/`:** el nombre del archivo = **el concepto** (`SherpaX.md`, `Modelo-de-Negocio.md`). Es su dominio de naming propio: **NO** siguen el patrón de archivos `TIPO-…-vNN`. Una página = un concepto.
- **Archivos en `Raw/`:** conservan su naming canónico de origen `TIPO-ENTIDAD-Proyecto-Nombre-vNN.md`.
- El nombre del archivo `.md` es también el nombre del WikiLink: `[[NombreDeLaPagina]]`.

---

## 3. La convención de dos enlaces (REGLA CRÍTICA)

El WikiX usa `[[ ]]` para **dos cosas distintas** — hay que mantenerlas separadas:

| Tipo | Sintaxis | Para qué | En el grafo humano |
|------|----------|----------|--------------------|
| **Concepto ↔ concepto** | `[[NombrePagina]]` | navegación entre páginas | arista navegable |
| **Referencia a fuente** | `Source:` con `[[Raw/.../ARCHIVO-vNN]]` **o** texto en código `` `ARCHIVO-vNN` `` | trazabilidad para la IA | NO es nodo |

**Nunca** pongas una referencia a un documento fuente como `[[ARCHIVO-vNN]]` suelto en el cuerpo — el visor lo pintaría como nodo muerto. Si es fuente, va en la sección `Source:`/`Fuentes` con ruta `Raw/...`, o como código. Esta es la palanca que hace al WikiX navegable sin perder la trazabilidad.

---

## 4. Dos tipos de página

### 4.1 Página-concepto (canónica) — CON Asset Header
Para conceptos del ecosistema. Usa `Wiki/_Plantilla-Pagina-Concepto.md`. Lleva:
`**Type:** · **Domain:** · **Source:** [[Raw/...]] · **Last Updated:**`, luego `## Summary` (TL;DR), `## Key Points`, `## Relationships` (con `[[WikiLinks]]`), `## Open Questions / Gaps`.

### 4.2 Guía pedagógica / onboarding — SIN Asset Header
Para rutas de aprendizaje (ej. "Introducción a X", "Despierta tu X"). Usa `Wiki/_Plantilla-Guia-Pedagogica.md`. **NO** lleva Asset Header **ni** sección Fuentes — solo al pie:
`*Versión vNN · Última actualización: YYYY-MM-DD*`.
Estructura: TL;DR (blockquote) → Cómo usar → pasos numerados con `→ [[enlaces]]` → Rutas sugeridas → `## Conexiones`. El validador exenta estas páginas del check de header automáticamente. Crea estas guías con el comando `/creawikidoc` (ver `skills/`).

---

## 5. Reglas de oro de cada página
- **TL;DR siempre presente** — el lector entiende de qué trata en 10 segundos.
- **Una página = un concepto.** Si abarca dos, haz dos páginas y conéctalas.
- **Enlaza el primer mention** de cada concepto que tenga página propia, con `[[ ]]`.
- **Sin huérfanas:** cada página recibe al menos un enlace entrante. Las guías se enlazan desde su página madre ("Empieza aquí: [[Guía]]").
- **Verifica antes de cerrar:** cero `[[ ]]` rotos (corre el validador).

---

## 6. Ingesta (cuándo y cómo entra contenido)

**Entra a `Raw/`:** documentos Clase C / canónicos (CP-, MePB-, TP-, SOP-, PA-, PLB-, MP-) con conocimiento transferible.
**NO entra:** outputs de sesión (OUT-), minutas (MIN-/MiPg-), trackers, borradores, datos confidenciales de clientes.

**Proceso:** (1) copia las fuentes a `Raw/` (no muevas, copia). (2) Por cada concepto, crea/actualiza su página en `Wiki/`. (3) Conéctala con `[[WikiLinks]]`. (4) Regístrala en `index.md` (directorio + ingest log + conteo). (5) Verifica links.

---

## 7. Gobernanza
- **Gate G0 (vault-first):** consulta lo que ya existe antes de crear. Nunca produzcas desde cero lo que ya está.
- **Tripleta** en cada activo canónico: Owner + Sherpa + Ratificador.
- **Capas-espejo:** `Raw/` (y cualquier inbox tipo CloudVault) son espejo/tránsito — el chequeador de salud las exenta de penalización; no se "arreglan", se reconocen.

---

## 8. Herramientas y mantenimiento

| Herramienta | Qué hace | Cuándo |
|---|---|---|
| `tools/build_wiki_graph.py "VAULT" IB-WikiX` | genera el grafo humano (HTML navegable) | tras cada ingesta o cambio |
| `tools/wiki_validator.py "VAULT" IB-WikiX` | 5 checks: links rotos, huérfanas, cobertura, headers, index | tras cada ingesta |
| `tools/obsidian_health.py "VAULT" > salud.json` | salud del vault (scoring proporcional + exclusión de espejos) | revisión periódica |
| `tools/build_obsidian_dashboard.py salud.json T.html` | tablero visual | con el anterior |

**Salud (scoring proporcional):** la nota 0–100 pondera enlaces (30), naming de notas (25), duplicados-contenido (15), naming de bancos (15), nombres repetidos (10), carpetas vacías (5). Las capas-espejo (`IB-WikiX/Raw/`, inbox) **se excluyen** del cálculo que penaliza. El JSON reporta `broken_actionable` vs `broken_mirror` y `score_breakdown`.

---

## 9. Reglas inviolables (resumen)
1. Una fuente, dos lecturas, una superficie (SherpaX).
2. `Raw/` inmutable; `Wiki/` editable. Una página = un concepto.
3. Convención de dos enlaces: concepto↔concepto navegable; fuente→`Raw/`/código, nunca `[[ ]]` suelto.
4. Páginas-concepto con Asset Header; guías pedagógicas sin header, solo versión+fecha.
5. Cero links rotos Wiki→Wiki; cero huérfanas. Validar antes de cerrar.
6. Naming: páginas = concepto; Raw = canónico `TIPO-…-vNN`; banco `IB-WikiX`.

---
*WikiX Reglas de Funcionamiento v01 · derivado del WikiX de EmpowerLabs · 2026-06-15*