Skip to content

v0.1.0

Latest
Latest

Choose a tag to compare

View all tags
@CodeName-666 CodeName-666 released this 19 Apr 15:10
v0.1.0
e60102e

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
Assets 2
Loading