v0.1.0

Release Notes – v0.1.0

Diese Version macht obsidian-second-brain deutlich robuster als installierbares Cross-Tool-Setup für Codex CLI und Claude Code. Der Fokus liegt auf klarerer Installation, sauberer Vault-Anbindung, portablen Trigger-Templates und einem konsistenteren Projektkontext zwischen Sessions.

Highlights

• Das Setup wurde zu einem klaren, reproduzierbaren Installationsfluss ausgebaut, inklusive Installer, Vault-Bootstrap, Trigger-Templates und Verifikation.
• Das Second Brain folgt jetzt explizit einem Drei-Stufen-Modell für Projektkontext: 05 Daily Notes/ für Session-Deltas, die kanonische Projektnotiz als Wahrheit und ein optionaler Projektkompass.md als abgeleiteter Cache.
• Die Integration für Codex CLI und Claude Code wurde vereinheitlicht, sodass beide Tools denselben Vault-Kontext und dieselben Routing-Regeln nutzen.
• Trigger-Templates werden nicht mehr als globale CLI-Dateien erzwungen, sondern sauber im Vault abgelegt und projektweise bewusst übernommen.

Added

• Neuer root-basierter Einstiegspunkt über install.py.
• Modularisierte Setup-Logik unter scripts/setup_tasks/.
• Gebündelte installierbare Quellen unter src/, inklusive src/claude/, src/codex/, src/init/, src/shared/, src/references/ und src/scripts/.
• Installierbare Runtime-Helfer für Projektkontext:
  • load_project_context.py
  • persist_project_delta.py
  • rebuild_project_kompass.py
  • project_context.py
  • resolve_vault_context.py
• Abschließender Verify-Step zur Prüfung von Vault-Struktur, Skill-Installation, config.json und Trigger-Templates.
• README-Dokumentation mit visuellem Banner und englischer Projektbeschreibung.

Changed

• Der Wizard erklärt jetzt vor jedem Prompt-Step und vor jedem Task, wofür der jeweilige Schritt dient.
• Beim Vault-Setup wird jetzt zuerst zwischen neuem Vault und bestehendem Vault unterschieden.
• Wenn bei einem bestehenden Vault Brain.md fehlt, fragt der Installer jetzt explizit nach, ob die Datei erzeugt werden soll.
• configure-clis schreibt keine globalen ~/.claude/CLAUDE.md oder ~/.codex/AGENTS.md mehr als primären Integrationspfad.
• Stattdessen werden die Trigger-Templates unter <vault>/04 Ressourcen/Skills/obsidian-second-brain/CLAUDE.md und AGENTS.md abgelegt.
• Alte global verwaltete Managed-Blocks werden bei Bedarf aus bestehenden CLI-Dateien bereinigt.
• Die Trigger-Templates haben jetzt eine einzige Quelle im Repo: src/init/CLAUDE.md und src/init/AGENTS.md.
• Der Vault-Pfad lebt nicht mehr in den Templates, sondern ausschließlich in der installierten config.json.
• configure-skill-config schreibt jetzt sowohl Windows- als auch POSIX-Pfade, damit Windows- und WSL-Setups parallel unterstützt werden.
• Die Skill-Beschreibung wurde als gemeinsame, kanonische Quelle über src/shared/skill-body.md konsolidiert.

Project Context Model

• Die kanonische Projektnotiz bleibt ausdrücklich die einzige Wahrheitsquelle für Status und dauerhafte Entscheidungen.
• Projektkompass.md ist jetzt klar als abgeleiteter Cache definiert und nie als Truth Source gedacht.
• Ein Projektkompass ist nur für größere, bereits migrierte Projekte vorgesehen.
• Ein Projektkompass muss Metadaten wie truth_source: false, note_role: project_digest und write_policy: consolidate_only tragen.
• Routine-Edits und Persistenzbefehle wie merk dir das schreiben nicht in den Projektkompass, sondern in Daily Notes oder die kanonische Projektnotiz.

Documentation

• Das README wurde umfassend überarbeitet und für externe Nutzer deutlich verständlicher strukturiert.
• Die Installationsdokumentation unter docs/install-process.md beschreibt jetzt den vollständigen Setup-Ablauf inklusive Tasks, Outputs und Repair-Flows.
• Die Einstiegstexte und Trigger-Templates wurden auf den aktuellen Cross-Tool-Workflow ausgerichtet.
• Das README beginnt jetzt direkt mit dem Projektbanner.
• Die README wurde ins Englische übersetzt.

Upgrade Notes

• Bestehende Nutzer sollten die Skill-Konfiguration und Trigger-Templates einmal aktualisieren, damit der neue Vault-zentrierte Flow aktiv ist.
• Wer bisher globale Managed-Blocks in ~/.claude/CLAUDE.md oder ~/.codex/AGENTS.md genutzt hat, sollte auf die Vault-Templates umsteigen.
• Die projektlokale Aktivierung bleibt bewusst manuell: CLAUDE.md oder AGENTS.md werden aus dem Vault in das jeweilige Projekt kopiert.
• Für bestehende Installationen empfiehlt sich mindestens folgender Update-Lauf:

python install.py \
  --task install-skills \
  --task configure-skill-config \
  --task configure-clis \
  --task verify-setup