svenhorvath/obsidian-brain

Obsidian Brain — Second Brain

Verwalte das persoenliche Obsidian Brain nach dem PARA + Zettelkasten Hybrid-Prinzip.

Brain-Pfade

Pfade aus ~/.claude/vaultkeeper.local.md lesen (YAML-Frontmatter Feld brain_path).

Fallback-Erkennung:

• Mac: /Users/svenhorvath/Library/CloudStorage/OneDrive-RegionVorderland-Feldkirch/SvenBrain
• Windows: C:\Users\horvaths\OneDrive - Region Vorderland-Feldkirch\SvenBrain

Brain-Struktur

SvenBrain/
├── 00-Inbox/          # Ungefilterte Captures
├── 01-Projects/       # Aktive Projekte mit Endpunkt
├── 02-Areas/          # Laufende Verantwortungsbereiche
├── 03-Resources/      # Referenzwissen
├── 04-Archive/        # Abgeschlossenes
├── 05-Zettelkasten/   # Atomare Wissensnotizen (1 Idee = 1 Notiz)
│   └── INDEX.md       # Zentrale Uebersicht aller Zettel
├── 06-People/         # Personen-Notizen
├── 07-Templates/      # Obsidian Templater-Vorlagen
├── 08-Daily/          # Tagesnotizen
└── 09-Meetings/       # Protokolle

Zettel anlegen

Beim Anlegen eines neuen Zettels:

1. Dateiname: Kebab-Case, keine Umlaute (shadow-ai-risiko.md, nicht Shadow AI Risiko.md)
2. Frontmatter: Immer vollstaendig:

   ---
   type: zettel
   tags: [max 3-5, hierarchisch z.B. ki/llm, bav/governance]
   created: YYYY-MM-DD
   updated: YYYY-MM-DD
   source: [woher die Erkenntnis stammt]
   ---
   

3. Inhalt: Kernidee (3-5 Saetze), Kontext
4. Links mit Kontext:
   • Inline-Links im Fliesstext wo ein direkter inhaltlicher Bezug besteht (z.B. "der [[yes-if-framework|'Yes, if'-Ansatz]] bietet dafuer einen Rahmen")
   • "Verwandte Zettel (Vorschlag)"-Abschnitt am Ende mit max 3 Eintraegen, jeder mit 1 Satz Begruendung warum relevant
   • Kein festes Minimum/Maximum — so viele Links wie inhaltlich sinnvoll (typisch 3-5)
   • KEIN nackter [[link]] ohne Kontext — jeder Link braucht eine Erklaerung durch Platzierung im Satz oder Begruendung
   • Obsidians automatisches Backlinks-Pane uebernimmt Rueckverweise — keine manuellen "Backlinks"-Abschnitte
5. INDEX.md aktualisieren: Neue Zeile oben in die Tabelle einfuegen (neueste zuerst): | YYYY-MM-DD | dateiname | Titel | tags |

Universelle Linking-Regel

Gilt fuer JEDEN Notiz-Typ (Zettel, Daily Note, Meeting, Person, Ressource, MOC):

Vor dem Schreiben bestehende Brain-Eintraege scannen (05-Zettelkasten/INDEX.md, 06-People/, 01-Projects/, 02-Areas/, 03-Resources/) und Treffer als [[dateiname|Anzeigename]] im Text verlinken. Nur verlinken wenn der Eintrag tatsaechlich existiert.

Details in references/vault-conventions.md.

CLI-Integration

Pruefen ob Obsidian CLI verfuegbar ist (via Bash: obsidian version oder /Applications/Obsidian.app/Contents/MacOS/Obsidian version).

• Erfolgreich: CLI-Commands fuer Suche, Tags und Frontmatter verwenden (praeziser, schneller)
• Fehlgeschlagen: File-basiert arbeiten (Read/Write/Grep Tools)

Fuer Details zur CLI-Nutzung: references/cli-usage.md lesen.

Zettel-Typen und Tags

| Typ | Tag | Wann | |---|---|---| | ADR | #adr | Architektur-Entscheidung getroffen (warum X statt Y) | | Pattern | #pattern | Wiederverwendbares Muster identifiziert (2+ Projekte) | | Lesson Learned | #lessons-learned | Aus Fehler/Ueberraschung gelernt | | Workaround | #workaround | Offizieller Weg geht nicht, Alternative dokumentiert | | Allgemein | (thematisch) | Nicht-offensichtliche Erkenntnis |

Fuer ADR-Format: references/adr-template.md lesen. Fuer Pattern-Format: references/pattern-conventions.md lesen.

Wann Zettel anlegen

Zettel werden ausschliesslich innerhalb von /vaultkeeper:brain-sync angelegt, nie direkt. Der brain-sync Skill entscheidet anhand dieser Kriterien was angelegt wird:

• Eine Architektur-Entscheidung getroffen wird → ADR-Zettel
• Ein bewaehrtes Pattern identifiziert wird → Pattern-Zettel
• Eine nicht-offensichtliche Erkenntnis entsteht → Zettel mit thematischen Tags
• Ein Workaround noetig ist → Workaround-Zettel + Vault-Hinweis

Keinen Zettel anlegen bei:

• Temporaerem, offensichtlichem oder trivialem Wissen
• Dingen die bereits als Code-Kommentar dokumentiert sind
• Informationen die nur in der aktuellen Session relevant sind

Brain vs. Vault — wann was wohin

Das Brain ist "Sven 2.0" — ALLES gehoert hier rein. Das Vorderland Vault ist eine Teilmenge des Brains: nur operatives Fach- und Systemwissen fuer den technischen Support.

Nach dem Anlegen eines Zettels immer pruefen:

• Wuerde ein Kollege das fragen? → Auch vault-relevant, Hinweis geben: "Dieser Zettel waere auch fuer das Vault relevant (/vaultkeeper:vault)"
• Wuerde Sven das in 3 Jahren nachschlagen? → Auch vault-relevant
• Ist es Reflexion, Strategie, Meta-Wissen, persoenliche Haltung? → Nur Brain, nicht Vault

Vault-relevante Wissensdomaenen: V-DOK, WebOffice, VertiGIS FM, Power Platform, SharePoint, n8n, DKM, Bauamt-Prozesse, Workarounds/Troubleshooting.

Brain durchsuchen

Zum Suchen im Brain:

1. Obsidian CLI nutzen (wenn verfuegbar): obsidian search query="suchbegriff" oder obsidian search:context query="suchbegriff"
2. Sonst: Grep ueber 05-Zettelkasten/ und INDEX.md
3. Ergebnisse mit Kontext zurueckgeben

Weitere Referenzen

• references/vault-conventions.md — Detaillierte Linking-Regeln, Tag-Hierarchie, Frontmatter-Varianten
• references/cli-usage.md — Obsidian CLI-Commands und deren Einsatz im Brain
• references/adr-template.md — MADR-Format fuer Architektur-Entscheidungen
• references/pattern-conventions.md — Wie Patterns als Zettel dokumentiert werden