Guia de la Biblioteca — CreaRack Pro

Que es: Un sistema que sabe que documentos hay que actualizar cuando cambias codigo. Donde vive: En el workspace (workspace.crearack.com), como parte del MCP server. Quien la usa: Claude Code (automaticamente) y cualquier miembro del equipo via Claude.

Para que sirve

Hasta ahora, cuando modificabamos un archivo de codigo, teniamos que acordarnos de actualizar CLAUDE.md, CHANGELOG.md, la guia correspondiente, el task.md… y siempre se nos olvidaba algo.

La Biblioteca resuelve esto: tiene un mapa de todo el codigo (496 endpoints, 57 modelos, 106 documentos) y sabe que esta conectado con que. Cuando le preguntas “voy a modificar los modelos de monitoring”, te dice exactamente que documentos necesitan actualizacion.

Como funciona (para devs: Edu y Dani)

Obtener contexto antes de trabajar

En vez de buscar documentos manualmente, pregunta a la Biblioteca:

bib_context_query(topic="signage")

Respuesta: 11 modelos con sus campos, 79 endpoints, 15 documentos relacionados — todo en una llamada de 200ms.

Saber que docs actualizar antes de un commit

bib_impact_query(file_path="monitoring/models.py")

Respuesta: lista de 30 documentos que mencionan modelos de monitoring y que podrian necesitar actualizacion. Incluye CLAUDE.md, CHANGELOG.md, las guias de observatory, CNS, etc.

Avisar de un cambio despues de commitear

bib_report_change(file_path="monitoring/models.py", change_type="modified")

Esto marca los documentos vinculados como “pendientes de revision” para que no se olviden.

Buscar cualquier cosa

bib_search_nodes(query="Alert", node_type="model")

Respuesta: AlertEvent, MonitoringAlert, AgentAlertSchema… con su app, archivo y campos.

Ver el estado general

bib_stats()

Respuesta: ~3100 nodos, ~7500 relaciones, 168 docs, confidence stats, comunidades, ultima indexacion.

Trazar llamadas de una funcion (nuevo)

bib_call_graph(function_name="monitoring.services.alert_service.evaluate_rules")

Respuesta: quien llama a esa funcion (callers) y a que funciones llama (callees), con profundidad y confianza.

Ver comunidades de codigo (nuevo)

bib_get_community(node_qname="racks.models.Device")

Respuesta: la comunidad a la que pertenece Device, sus miembros, cohesion, nodos puente.

Detectar acoplamiento entre modulos (nuevo)

bib_coupling_report(app="monitoring")

Respuesta: pares de comunidades con mas edges cruzadas, bridge nodes, score de acoplamiento.

Como funciona (para Txell y perfil no-dev)

La Biblioteca no es algo que uses directamente en el navegador (aun). Es una herramienta interna que Claude utiliza automaticamente cuando trabajas con el.

Lo que cambia para ti: Cuando le pidas algo a Claude sobre CreaRack desde tu Claude Code (CLI), el puede consultar la Biblioteca para darte informacion mas precisa y rapida sobre el proyecto.

Ejemplo: Si le preguntas “que modulos tiene CreaRack Pro?”, en vez de buscar en archivos, Claude consulta el grafo y te da una respuesta precisa con los 7 modulos, sus endpoints y documentacion.

Que contiene la Biblioteca

Tipo	Cantidad	Que es
Endpoints	496	Todas las URLs de la API (GET /api/racks, POST /api/monitoring/alerts, etc.)
Schemas	198	Los formatos de datos de entrada/salida de la API
Modelos	79	Las tablas de la base de datos (Organization, Rack, Device, etc.)
Funciones	981	Funciones Python de todo el backend
Clases	308	Clases Python (services, views, forms, etc.)
Metodos	588	Metodos de clase
Modulos	256	Archivos .py organizados por app
Documentos	168	Todos los archivos .md de documentacion
Relaciones	~7500	Conexiones: llamadas entre funciones, imports, herencia, docs vinculados
Comunidades	auto	Clusters detectados automaticamente (Label Propagation)

Jerarquia de agentes

La Biblioteca tiene un equipo de agentes IA organizados por roles:

Bibliotecario (Sonnet) — Orquesta todo, responde consultas complejas
  |
  +-- Escriba de Docs (Sonnet) — Redacta y actualiza documentacion
  +-- Escriba de Codigo (Sonnet) — Analiza y documenta codigo
  +-- Librero Indexador (Haiku) — Indexa y clasifica (tareas mecanicas)
  +-- Librero Buscador (Haiku) — Busca y recupera informacion
  +-- dev-edu (Opus) — Claude Code de Edu
  +-- dev-dani (Opus) — Claude Code de Dani

Agente Usuario Final (Haiku) — Completamente aislado, sin acceso a internals

Regla de comunicacion: Los agentes pueden consultar a sus pares y subordinados, pero no a sus superiores. Siempre informan hacia arriba con verdad. El Agente de Usuario Final esta aislado para que nunca filtre informacion interna.

Tokens MCP

Cada miembro del equipo tiene un token para acceder al MCP del workspace:

Persona	Donde configurar
Edu	`.mcp.json` en CreaRack-Pro (ya configurado)
Dani	`.mcp.json` en su copia de CreaRack-Pro
Txell	`.mcp.json` en su Claude Code (CLI)

Los tokens se rotan manualmente cuando sea necesario. Se configuran en Cloudflare Pages como la variable MCP_TOKENS.

Preguntas frecuentes

Puedo romper algo usando la Biblioteca? No. La Biblioteca es de solo lectura para consultas. Las operaciones de escritura (indexar, registrar nodos) solo las ejecuta Claude Code durante sesiones de desarrollo. Los datos de la Biblioteca son independientes del codigo — si algo falla, se reindexan en 2 minutos.

Sustituye a la documentacion existente? No. La Biblioteca funciona en paralelo. Los archivos .md siguen existiendo y son la fuente de verdad para humanos. La Biblioteca es un indice inteligente que los conecta con el codigo.

Cada cuanto se actualiza? Se reindexo por primera vez el 13-04-2026. Se puede reindexar manualmente en cualquier momento. No es necesario hacerlo en cada commit — solo cuando se anaden modelos, endpoints o documentos nuevos.

Que pasa si la Biblioteca esta desactualizada? El tool bib_stale_report identifica nodos que no se han reindexado recientemente. Claude puede re-indexar los que falten. Mientras tanto, la Biblioteca sigue funcionando con los datos que tiene — simplemente podria faltar algun endpoint o modelo reciente.

Puedo ver la Biblioteca en el navegador? Aun no. En el futuro se anadira una pagina /biblioteca en el workspace con busqueda visual y grafos. Por ahora es accesible solo via MCP tools.

Referencia tecnica

Para detalles de implementacion, schema D1, y especificaciones de cada tool: Documentation/backend/BIBLIOTECA.md

Mantenido por: Claude (Anthropic) + Equipo CreaRack Última actualización: 21-05-2026 (s78 · alineación Claude Code CLI para los 3 miembros del staff)

Véase también

[[crearack-tech—backend—biblioteca]] — arquitectura interna de la Biblioteca
[[concept—biblioteca—supercontexto]] — modelo Supercontexto aplicado a la wiki
[[ia-tech—biblioteca—architecture]] — arquitectura de la Biblioteca
[[feature—biblioteca—graphify]] — feature de graphify (grafo inicial)
[[feature—biblioteca—escriba-drift]] — detección de drift en la wiki
[[crearack-tech—guides—agent-rules]] — reglas del agente IA
[[runbook—biblioteca—manual-reindex]] — runbook de reindex manual