Vaultkeeper

Persoenliches Wissensmanagement-Plugin fuer Claude Code.

Zwei Richtungen, ein System:

• SvenBrain (Obsidian) — Wissen sammeln (Second Brain)
• Vorderland Vault — Wissen teilen (Team-Wissensdatenbank auf Qdrant)

Installation

# Plugin-Verzeichnis klonen
git clone git@github.com:svenhorvath/vaultkeeper.git

# In Claude Code registrieren (einmalig)
claude plugins add /pfad/zu/vaultkeeper

Setup pro Geraet

Beim ersten Start erkennt Vaultkeeper automatisch das Betriebssystem und legt ~/.claude/vaultkeeper.local.md an. Alternativ manuell erstellen:

---
brain_path: "C:\\Users\\horvaths\\OneDrive - Region Vorderland-Feldkirch\\SvenBrain"
vault_inbox: "C:\\Users\\horvaths\\OneDrive - Region Vorderland-Feldkirch\\Claude\\Dev\\vorderland-vault\\docker\\shared\\inbox"
konflikt_archive_path: "C:\\Users\\horvaths\\OneDrive - Region Vorderland-Feldkirch\\Claude\\Dev\\Obsidian\\_konflikt-archive"
---

konflikt_archive_path (optional): Ablage fuer OneDrive-Konflikt-Files die brain-sync automatisch auslagert. Liegt ausserhalb des Brain, damit archivierte Konflikte den aktiven Claude-Kontext, Obsidian Graph-View und BRAIN_MAP-Statistiken nicht verfaelschen. Ohne Setzung wird der Pfad automatisch aus brain_path abgeleitet: <parent>/Claude/Dev/Obsidian/_konflikt-archive/.

Commands

Command	Beschreibung
/vaultkeeper:brain-init [name]	Neues Projekt im Brain anlegen + CLAUDE.md + optionale Projekt-Vorlage (Code/Doku) anwenden
/vaultkeeper:brain-sync	Session-Erkenntnisse extrahieren und ins Brain schreiben (Zettel, MOCs, Daily Notes, Brain Map)
/vaultkeeper:brain-health	Brain-Gesundheitscheck: verwaiste Zettel, Tag-Audit, Link-Qualitaet, Drift
/vaultkeeper:vault [inhalt]	Wissen ins Vorderland Vault pushen
/vaultkeeper:vault-scan	Brain nach team-relevanten Inhalten durchsuchen
/vaultkeeper:prepare-dokument [datei]	Dokumente (PDF, XLSX, DOCX) fuer Vault aufbereiten
/vaultkeeper:feedback-review	Offene Chat-Feedbacks aus Vault reviewen und markieren

Wie es funktioniert

Dokument-Aufbereitung (prepare-dokument)

Claude liest Dokumente selbst (multimodal) — kein Python-Script, kein Informationsverlust. PDF, XLSX, DOCX, Bilder werden nativ gelesen und als .json in die Inbox geschrieben.

Jede JSON-Datei enthaelt Text und Metadaten zusammen:

{
  "title": "Dokumenttitel",
  "document_type": "anleitung",
  "bereich": "v-dok",
  "content": "Der vollstaendige extrahierte Text..."
}

n8n holt die JSON aus der Inbox, chunked den Text, embedded und speichert in Qdrant.

Vault Push

Wissen direkt aus dem Chat ins Vault pushen — Claude erstellt die JSON automatisch.

Vault Scan

Brain nach team-relevanten Zetteln durchsuchen, User bestaetigt, dann als JSON in die Inbox.

Skills

Skill	Trigger
obsidian-brain	"Zettel anlegen", "Brain durchsuchen", automatisch bei Erkenntnissen
vorderland-vault	"Vault:", "ins Vault pushen", "Dokument vorbereiten"

Hooks

SessionStart (session-brain-check.js):

• Injiziert die Brain Map (SvenBrain Topologie) als Routing-Tabelle
• Erinnert an /vaultkeeper:brain-init falls CLAUDE.md ohne Brain-Kontext
• Detektiert lose Dateien im Top-Level wenn das Projekt eine ## Ordnerstruktur in CLAUDE.md hat — Claude schlaegt Verschiebung vor (Phase 1: Top-Level)

UserPromptSubmit (session-end-trigger.js):

• Erkennt Verabschiedungen und triggert die Session-Ende-Routine

PreToolUse auf Write|Edit (brain-write-guard.js):

• Blockiert direkten Schreibzugriff auf SvenBrain ausserhalb von brain-sync

Projekt-Vorlagen

brain-init wendet auf Wunsch eine Vorlage aus Dev/_templates/ an:

Variante	Inhalt
code/	README.md.tpl, .gitignore, docs/, scripts/
doku/	README.md.tpl, 01_Output/, 02_Quellen/, 03_Notizen/ + Anleitungs-READMEs pro Sub-Ordner

Idempotent — bestehende Dateien werden nicht ueberschrieben. CLAUDE.md bekommt eine ## Ordnerstruktur Sektion mit verbindlicher Ablage-Regel fuer Claude.

CLI-Integration

Fuer erweiterten Brain-Zugriff (Suche, Tags, Frontmatter, Tasks):

1. Obsidian v1.12.4+ installieren
2. In Obsidian: Settings → General → Advanced → CLI aktivieren → "Register CLI"

Vaultkeeper erkennt automatisch ob das CLI verfuegbar ist und nutzt es.

Voraussetzungen

• Claude Code CLI
• Obsidian v1.12.4+ mit aktiviertem CLI