Construindo um Sistema de Conhecimento Autossuficiente com Claude Code e Obsidian

Visão Geral da Arquitetura

Um desenvolvedor criou um sistema de conhecimento de autoaprimoramento que executa 25 ferramentas automatizadas por hora para resolver o problema de amnésia de sessão do Claude Code. O sistema conecta o Claude Code a um cofre Obsidian (~350 notas) com busca semântica local, grafos de conhecimento e processamento automatizado.

Stack Técnico

• Cofre Obsidian como armazenamento de conhecimento
• Claude Code (Opus) como a IA que lê/escreve no cofre
• Ollama + bge-m3 (embeddings de 1024 dimensões, RTX 3080) para busca semântica local
• SQLite (better-sqlite3) para índice de busca, banco de dados gráfico, índice de base de código
• Servidor Express para um painel React
• 2 servidores MCP dando acesso nativo ao cofre + gráfico para o Claude
• Agendador de Tarefas do Windows executando tudo por hora

Camadas de Ferramentas e Funções

Camada 1: Coleta de Dados

• vault-live-sync.mjs: Monitora sessões JSONL do Claude Code em tempo real, converte para notas Obsidian
• vault-sync.mjs: Sincronização horária de estatísticas Supabase, status AutoPost, atividade git, contexto de projeto
• vault-voice.mjs: Voz-para-cofre com transcrição Whisper + resumo Sonnet de arquivos de áudio
• vault-clip.mjs: Recorte web de feeds RSS + monitoramento de tópicos Brave Search + resumo por IA
• vault-git-stats.mjs: Métricas Git incluindo sequências de commit, pontos quentes de arquivos, distribuição horária

Camada 2: Processamento & Inteligência

• vault-digest.mjs: Resumo diário agregando todas as sessões em uma página legível
• vault-reflect.mjs: Usa Sonnet para extrair decisões-chave das sessões, promove automaticamente para MEMORY.md
• vault-autotag.mjs: Autoetiquetagem por IA com Sonnet sugerindo tags + conexões de wikilink
• vault-schema.mjs: Validador de frontmatter com 10 tipos de nota, relatório de conformidade, modo de correção automática
• vault-handoff.mjs: Gera handoff.json legível por máquina (sobrevive melhor à compactação que markdown)
• vault-session-start.mjs: Monta pacote de contexto ideal para novas sessões do Claude

Camada 3: Busca & Recuperação

• vault-search.mjs: FTS5 + busca semântica em blocos (blocos de 512 caracteres, bge-m3 1024-dim). Sinalizadores incluem --semantic, --hybrid, --scope, --since, --between, --recent. Inclui registro de recuperação + mapa de calor.
• vault-codebase.mjs: Indexa 2.011 arquivos fonte: exportações, rotas, importações, JSDoc
• vault-graph.mjs: Grafo de conhecimento com 375 nós, 275 arestas, centralidade de intermediação, detecção de comunidades, sugestões de links
• vault-graph-mcp.mjs: Grafo como servidor MCP com 6 ferramentas (busca, vizinhos, caminhos, comum, pontes, comunidades) que o Claude pode usar nativamente

Camada 4: Autoaprimoramento

• vault-patterns.mjs: Padrões semanais incluindo pontuação de momentum (1-10), % de atenção do projeto, tendências de velocidade, queima de tokens ($), detecção de bloqueio, rastreamento de frustração/energia, risco de burnout
• vault-spaced.mjs: Repetição espaçada (FSRS) com 348 notas rastreadas, agendamento de revisão baseado em prioridade
• vault-prune.mjs: Pontuação de decaimento quente/morno/frio, arquiva automaticamente notas obsoletas, sinaliza notas nunca recuperadas
• vault-contradict.mjs: Detecção de contradições com base em regras (referências obsoletas, desvio de métricas, conflitos de data) + alimentada por IA (Sonnet compara documentos relacionados)
• vault-research.mjs: Pesquisa autônoma com Brave Search + Sonnet, monitoramento programado de tópicos

Camada 5: Visualização & Monitoramento

• vault-canvas.mjs: Gera automaticamente arquivos Obsidian Canvas a partir do grafo de conhecimento (5 modos: mapa completo, por projeto, centrado em hub, comunidades, diário)
• vault-heartbeat.mjs: Agente proativo que coleta estado de todos os serviços, usa Sonnet para raciocinar sobre o que precisa de atenção

O sistema foi construído por um proprietário de agência solo que executa 4 projetos interconectados, gerencia 64K leads de negócios e conduz centenas de sessões Claude Code por semana. As ferramentas são todos módulos ES Node.js sem dependências externas além do que já está no repositório.