Construyendo un Sistema de Conocimiento Automejorable con Claude Code y Obsidian

Resumen de la Arquitectura

Un desarrollador creó un sistema de conocimiento que se mejora a sí mismo y ejecuta 25 herramientas automatizadas cada hora para resolver el problema de amnesia de sesión de Claude Code. El sistema conecta Claude Code a una bóveda de Obsidian (~350 notas) con búsqueda semántica local, grafos de conocimiento y procesamiento automatizado.

Pila Técnica

• Bóveda de Obsidian como almacén de conocimiento
• Claude Code (Opus) como la IA que lee/escribe la bóveda
• Ollama + bge-m3 (incrustaciones de 1024 dimensiones, RTX 3080) para búsqueda semántica local
• SQLite (better-sqlite3) para índice de búsqueda, base de datos de grafos, índice de código base
• Servidor Express para un panel de control React
• 2 servidores MCP que dan a Claude acceso nativo a la bóveda + grafos
• Programador de Tareas de Windows ejecutando todo cada hora

Capas de Herramientas y Funciones

Capa 1: Recopilación de Datos

• vault-live-sync.mjs: Supervisa sesiones JSONL de Claude Code en tiempo real, las convierte en notas de Obsidian
• vault-sync.mjs: Sincronización horaria de estadísticas de Supabase, estado de AutoPost, actividad git, contexto del proyecto
• vault-voice.mjs: Voz-a-bóveda con transcripción Whisper + resumen Sonnet de archivos de audio
• vault-clip.mjs: Recorte web desde feeds RSS + monitoreo de temas en Brave Search + resumen de IA
• vault-git-stats.mjs: Métricas de Git incluyendo rachas de commits, puntos calientes de archivos, distribución horaria

Capa 2: Procesamiento e Inteligencia

• vault-digest.mjs: Resumen diario que agrega todas las sesiones en una página legible
• vault-reflect.mjs: Usa Sonnet para extraer decisiones clave de las sesiones, promueve automáticamente a MEMORY.md
• vault-autotag.mjs: Etiquetado automático con IA donde Sonnet sugiere etiquetas + conexiones de wikienlaces
• vault-schema.mjs: Validador de frontmatter con 10 tipos de notas, informes de cumplimiento, modo de corrección automática
• vault-handoff.mjs: Genera handoff.json legible por máquinas (sobrevive mejor a la compactación que markdown)
• vault-session-start.mjs: Ensambla el paquete de contexto óptimo para nuevas sesiones de Claude

Capa 3: Búsqueda y Recuperación

• vault-search.mjs: Búsqueda FTS5 + semántica por fragmentos (fragmentos de 512 caracteres, bge-m3 1024-dim). Las banderas incluyen --semantic, --hybrid, --scope, --since, --between, --recent. Incluye registro de recuperación + mapa de calor.
• vault-codebase.mjs: Indexa 2,011 archivos fuente: exportaciones, rutas, importaciones, JSDoc
• vault-graph.mjs: Grafo de conocimiento con 375 nodos, 275 aristas, centralidad de intermediación, detección de comunidades, sugerencias de enlaces
• vault-graph-mcp.mjs: Grafo como servidor MCP con 6 herramientas (búsqueda, vecinos, rutas, común, puentes, comunidades) que Claude puede usar de forma nativa

Capa 4: Automejora

• vault-patterns.mjs: Patrones semanales incluyendo puntuación de impulso (1-10), % de atención del proyecto, tendencias de velocidad, consumo de tokens ($), detección de bloqueos, seguimiento de frustración/energía, riesgo de agotamiento
• vault-spaced.mjs: Repetición espaciada (FSRS) con 348 notas rastreadas, programación de revisión basada en prioridad
• vault-prune.mjs: Puntuación de descomposición caliente/templado/frío, archiva automáticamente notas obsoletas, marca notas nunca recuperadas
• vault-contradict.mjs: Detección de contradicciones con reglas basadas (referencias obsoletas, desviación de métricas, conflictos de fechas) + impulsada por IA (Sonnet compara documentos relacionados)
• vault-research.mjs: Investigación autónoma con Brave Search + Sonnet, monitoreo programado de temas

Capa 5: Visualización y Monitoreo

• vault-canvas.mjs: Genera automáticamente archivos de Obsidian Canvas desde el grafo de conocimiento (5 modos: mapa completo, por proyecto, centrado en hub, comunidades, diario)
• vault-heartbeat.mjs: Agente proactivo que recopila estado de todos los servicios, usa Sonnet para razonar sobre qué necesita atención

El sistema fue construido por el propietario de una agencia de desarrollo individual que ejecuta 4 proyectos interconectados, gestiona 64K leads comerciales y realiza cientos de sesiones de Claude Code por semana. Todas las herramientas son módulos ES de Node.js sin dependencias externas más allá de lo que ya está en el repositorio.