Las wikis y el Oráculo de EL

Parte de la colección [[concept—workspace—supercontexto-00-vision]]. Cubre: las 6 wikis del workspace, la estructura de slugs, el frontmatter obligatorio, el Oráculo de EL y el Sync Cascade.

Las 6 wikis del workspace

Toda la documentación del equipo vive en el repositorio CreaRackSL-workspace, en la carpeta src/content/wiki/. Hay 462 archivos .md distribuidos en 6 secciones, que se diferencian por el campo product: del frontmatter (no por subcarpetas — todos los .md viven en el mismo directorio).

graph LR
    subgraph WIKIS["🗂️ 6 Wikis en src/content/wiki/"]
        W1["🟦 CreaRack Help\nproduct: crearack\n216 páginas\nAyuda al usuario final"]
        W2["🟧 CreaRack Tech\nproduct: crearack-tech\n129 páginas\nBackend · Frontend · Dev"]
        W3["🟩 Workspace\nproduct: workspace\n27+ páginas\nGuías equipo · Onboarding"]
        W4["🟨 Workspace Tech\nproduct: workspace-tech\n8 páginas\nInfra workspace"]
        W5["🟪 IA Tech\nproduct: ia-tech\n32 páginas\nCatálogo automatismos IA"]
        W6["🟥 Supercontexto\nproduct: supercontext\n36 páginas\nBibliotecario · ADRs · Runbooks"]
    end

Añadir una wiki nueva toca 5 sitios (footgun conocido): Sidebar.tsx, navigation.ts, wiki/index.astro, la nueva ruta wiki/<seccion>.astro, y audit_docs_drift.py. Tocar uno solo deja el menú desincronizado.

La estructura de slugs

Cada página tiene un slug que es a la vez su identificador único y el nombre del archivo .md. El patrón es:

<tipo>--<categoría>--<nombre-en-kebab-case>.md

Tipos posibles: entity · concept · feature · decision · incident · runbook

Ejemplos:

• concept--workspace--supercontexto-00-vision.md → esta página
• decision--20260516--auditoria-simplificacion-servicios-auxiliares.md
• runbook--workspace--pausar-sync-cascade.md
• feature--supercontext--sync-cascade.md

El slug es el identificador de los [[wikilinks]] en el estilo Obsidian. El título (campo title:) es independiente y puede cambiar sin romper enlaces. El slug NO cambia una vez creado.

El frontmatter obligatorio

Cada página wiki necesita al menos estos campos:

---
type: concept_page          # entity_page | concept_page | feature_page | decision_page | incident_page | runbook_page
slug: concept--workspace--mi-pagina
product: workspace          # crearack | crearack-tech | workspace | workspace-tech | ia-tech | supercontext
title: "Mi Página"
status: active              # draft | active | stale | archived | superseded
owner: edu                  # edu | dani | txell | agent-ingest
created_at: 2026-05-27T...
tags: ["etiqueta1", "etiqueta2", ...]   # 6-10 obligatorios
related: ["slug-relacionado-1", ...]    # 5-10 obligatorios
sources: []
---

Buenas prácticas de tags

Los tags deben cubrir 4 categorías:

• 1-2 de área/módulo (ej. monitoring, racks, workspace)
• 1-2 de concepto transversal (ej. seguridad, performance, automatismos)
• 1-2 de tecnología concreta (ej. django, typescript, cloudflare)
• 1-2 de fase o iniciativa si aplica (ej. supercontexto-fase-4)

El ciclo de vida de una página wiki

stateDiagram-v2
    [*] --> draft: Ingest crea el borrador automáticamente
    [*] --> active: Edu/Dani/Txell la crea directamente
    draft --> active: Curator la aprueba
    draft --> [*]: Curator la rechaza (se elimina)
    active --> stale: Lint detecta que el código asociado cambió sin actualizar la doc
    active --> superseded: Una nueva página la reemplaza
    active --> archived: El concepto ya no existe en el proyecto
    stale --> active: Alguien la actualiza (se vuelve a marcar active)
    superseded --> archived: Se archiva definitivamente

Cómo crear o editar páginas wiki

Desde Claude Code (recomendado)

Usar los tools MCP wiki_create_page y wiki_update_page. Son los únicos que garantizan el commit en GitHub Y el registro en D1 de forma atómica:

wiki_create_page(
    type="concept_page",
    slug="concept--workspace--mi-nueva-pagina",
    title="Mi Nueva Página",
    actor="edu",
    front_matter={"status": "active", "product": "workspace", ...},
    content="## Contenido aquí..."
)

Desde el editor del workspace

El workspace tiene un editor visual en workspace.crearack.com/wiki para crear y editar páginas. Usa el mismo MCP por debajo.

Skills disponibles para gestión de wikis

El Oráculo de EL

El Oráculo de EL es la barra de búsqueda inteligente del workspace. Está en el header de todas las páginas de workspace.crearack.com.

Cómo funciona

flowchart LR
    U["Usuario escribe\npregunta en el header"] --> FUSE["🔍 Búsqueda Fuse.js\n(fuzzy match en corpus indexado)"]
    FUSE --> R1{"¿Hay resultados\nrelevantes?"}
    R1 -- "Sí (score > 0.4)" --> LISTA["Lista de páginas\nordenadas por relevancia"]
    R1 -- "No / pregunta conversacional" --> LLM["💬 Chat con Gemma 4 26B\n(modo oracle multi-turno)"]
    LLM --> RESP["Respuesta sintetizada\ncon fuentes"]
    LISTA --> USER["✅ Resultado para el usuario"]
    RESP --> USER

El corpus del Oráculo incluye:

• Las 462 páginas de las 6 wikis del workspace
• Los 49 documentos del repo claude-method (reindexados diariamente)

Endpoint

POST /api/oraculo/ask
{ "query": "¿cómo funciona el sistema de backup?", "mode": "oracle" }

El modo oracle activa el chat multi-turno. Las conversaciones son efímeras (no se guardan entre sesiones).

Sync Cascade: propagación automática de cambios

Sync Cascade detecta cuando se modifica una página wiki que tiene otras páginas “espejo” y propone automáticamente actualizar las páginas vinculadas.

¿Cómo funciona?

Cuando una página tiene el campo mirrors: en el frontmatter apuntando a otros slugs, cualquier cambio en esa página dispara el workflow sync-cascade-detect.yml:

# Ejemplo: la página principal de onboarding tiene 3 mirrors
mirrors:
  - workspace--onboarding--edu
  - workspace--onboarding--dani
  - workspace--onboarding--txell

Si se actualiza el onboarding principal, Sync Cascade detecta los mirrors, propone los cambios usando Haiku 4.5 y abre un PR draft con las actualizaciones sugeridas para cada espejo.

Páginas sembradas con mirrors (actualmente)

Toggle de pausa

# Pausar Sync Cascade (p.ej. durante rebase masivo)
gh variable set SYNC_CASCADE_PAUSADO --body true --repo CreaRackSL/CreaRackSL-workspace

# Reanudar
gh variable set SYNC_CASCADE_PAUSADO --body false --repo CreaRackSL/CreaRackSL-workspace

La traducción automática ES→EN

Las páginas de ayuda al usuario (crearack--*) se traducen automáticamente del español al inglés para los usuarios internacionales. El workflow wiki-translate.yml corre diariamente a las 06:00 UTC:

• Detecta páginas .md en src/content/wiki/crearack--*.md más nuevas que su versión EN
• Las traduce con Gemma 4 26B vía Google AI Studio
• Guarda el resultado en src/content/wiki-en/
• Hace commit automático si algo cambió

Véase también

• [[concept—workspace—supercontexto-00-vision]] — Visión general del sistema completo
• [[concept—workspace—supercontexto-02-bibliotecario]] — El Bibliotecario que mantiene los drafts
• [[concept—workspace—supercontexto-05-crons]] — Horarios de todos los automatismos
• [[feature—supercontext—sync-cascade]] — Detalle técnico de Sync Cascade
• [[ia-tech—inventario-automatismos]] — Catálogo completo de automatismos IA