El Supercontexto: visión general del sistema

Esta página es el punto de entrada a la colección. Si solo puedes leer una, lee esta. Para el detalle de cada capa, sigue los enlaces al final de la página.

Colección completa: [[concept—workspace—supercontexto-00-vision]] · [[concept—workspace—supercontexto-01-biblioteca]] · [[concept—workspace—supercontexto-02-bibliotecario]] · [[concept—workspace—supercontexto-03-wiki]] · [[concept—workspace—supercontexto-04-harness]] · [[concept—workspace—supercontexto-05-crons]]

¿Para qué sirve todo esto?

Cuando el equipo trabaja en CreaRack-Pro, Claude Code necesita saber qué existe, dónde vive y qué hay documentado para no inventarse cosas, no duplicar código y no escribir documentación desactualizada.

El problema: un proyecto de 500+ endpoints y 460+ páginas de documentación no cabe en la memoria de ninguna IA. Así que construimos un sistema que:

1. Indexa el código — extrae funciones, modelos y endpoints, y los guarda como un grafo navegable.
2. Indexa la documentación — divide las wikis en trozos pequeños con búsqueda semántica.
3. Automatiza la calidad — detecta documentación desactualizada, promueve conocimiento nuevo, detecta contradicciones.
4. Lo mantiene fresco solo — bots que corren cada noche sin que nadie tenga que acordarse.

A todo esto lo llamamos Supercontexto. Y en el centro de todo está la Biblioteca, un grafo de conocimiento que conecta código con documentación.

Los cinco bloques del sistema

graph TD
    subgraph EQUIPO["👥 Equipo (Edu · Dani · Txell)"]
        A["💻 Claude Code\ncon harness configurado"]
    end

    subgraph SUPERCONTEXTO["🧠 Supercontexto"]
        B["📚 Biblioteca\n(grafo de conocimiento)"]
        C["📋 6 Wikis\n(460+ páginas)"]
        D["🗄️ D1 Cloudflare\n(base de datos del grafo)"]
    end

    subgraph AUTOMATISMOS["🤖 Automatismos"]
        E["GitHub Actions\n(16 workflows)"]
        F["Crons Hetzner Stage\n(4 tareas nocturnas)"]
    end

    subgraph PLATAFORMA["🌐 workspace.crearack.com"]
        G["Biblioteca UI\n& Pulse"]
        H["Oráculo de EL\n(search + chat IA)"]
        I["Wiki pública"]
    end

    A -- "bib_ask / bib_report_change" --> B
    A -- "wiki_create_page / wiki_update_page" --> C
    B --> D
    C --> D
    E -- "Ingest · Curator · Lint · Reindex" --> D
    F -- "drift · lint · curator · AST" --> D
    D --> G
    D --> H
    C --> I
    G --> A

Los cinco bloques, explicados en una frase

El ciclo de vida de un commit

La imagen más útil para entender el sistema es lo que ocurre cuando alguien hace git push:

sequenceDiagram
    participant Dev as 👩‍💻 Dev
    participant Hook as 🔗 Pre-commit hook
    participant BibMCP as 📚 Biblioteca MCP
    participant GitHub as 🐙 GitHub Actions
    participant Ingest as 🤖 Ingest Bot
    participant D1 as 🗄️ D1

    Dev->>Hook: git commit -m "feat: nueva feature"
    Hook->>BibMCP: bib_report_change(archivo.py)
    BibMCP->>D1: marca docs vinculadas "revisar"
    Hook-->>Dev: ✅ commit OK (no bloqueado)
    
    Dev->>GitHub: git push origin main
    GitHub->>Ingest: dispara post-merge-ingest
    Ingest->>Ingest: Haiku 4.5 lee el diff del commit
    Ingest->>D1: actualiza grafo (nodos · edges · confidence)
    Ingest->>D1: crea concept_page en status:draft (si hay conocimiento nuevo)
    
    Note over D1: Esa noche...
    D1->>D1: Curator revisa drafts y decide publicar/descartar
    D1->>D1: Lint detecta docs con >60 días sin tocar
    D1->>D1: Drift detecta código que diverge de su doc

Dónde ver el estado del sistema en tiempo real

¿Por qué lo construimos?

Antes del Supercontexto:

• Claude Code no sabía qué existía → duplicaba código y sobreescribía cosas que ya funcionaban.
• La documentación se desactualizaba a los pocos días del código que describía.
• No había forma de buscar en toda la documentación a la vez.
• Cada miembro del equipo arrancaba sesión sin contexto del estado del proyecto.

Con el Supercontexto:

• Claude consulta el grafo antes de actuar → cero duplicados, cero cosas rotas por ignorancia.
• El Bibliotecario detecta automáticamente qué docs se quedan atrás del código.
• El Oráculo de EL permite buscar en toda la base de conocimiento en lenguaje natural.
• Cada sesión arranca con el contexto ya cargado (hook SessionStart).

Los 6 documentos de esta colección

Véase también

• [[concept—workspace—supercontexto-01-biblioteca]]
• [[concept—workspace—supercontexto-02-bibliotecario]]
• [[concept—workspace—supercontexto-03-wiki]]
• [[concept—workspace—supercontexto-04-harness]]
• [[concept—workspace—supercontexto-05-crons]]
• [[ia-tech—inventario-automatismos]]