themsquared/brain-linking

Brain Linking

Ein Vault ist ein Graph. Eine Notiz ohne Links ist verloren. Jede Notiz, die du schreibst, muss mit mindestens zwei bestehenden Seiten verknüpft sein, und mindestens eine bestehende Seite sollte auf sie zurückverweisen.

Dieses Skill ist für jeden Obsidian-Vault oder jede Markdown-Wissensdatenbank gedacht, die [[Wikilinks]] verwendet. Es ist nicht an die Dateien einer einzelnen Person gebunden.

Bevor du schreibst

1. Lies das Vault-Schema im Stammverzeichnis. Übliche Namen: CLAUDE.md, AGENTS.md, README.md. Folge dieser Datei, falls sie existiert.
2. Suche nach dem, was bereits existiert: rg -il '<Thema oder Name>' --glob '*.md'.
3. Wenn eine Seite zu diesem Thema existiert, ergänze sie (oder lege eine Inbox-Notiz an, die darauf verweist). Erstelle kein Fast-Duplikat.

Jede Notiz muss Folgendes enthalten

• Einen Aufwärts-Link: einen [[Link]] zu ihrem übergeordneten Hub. Beispiele: eine Personen- oder Projekt-[[index]] oder [[status]], eine [[concepts/...]]-Seite, ein Projekt-Hub oder ein Bereichs-Hub.

• Querverweise: mindestens einen [[Link]] zu einer verwandten Person, einem verwandten Projekt, Produkt, Konzept oder Meeting, die/das bereits existiert.

• Personen und Dinge als Links, nicht als Klartext: Wenn eine Person, ein Produkt oder ein Projekt eine Seite hat, schreibe [[Name]]. Wenn es eine haben sollte, aber noch nicht hat, verlinke es trotzdem. Obsidian zeigt den hängenden Link an, und der Betreuer erstellt die Seite.

• Frontmatter: about, area, source, suggested_home, date, agent. Verwende area-Werte, die der Vault bereits verwendet (oft Arbeit vs. Leben oder die eigene Bereichsliste des Vaults).

• Einen Abschnitt „Verwandtes“ am Ende:

  ## Verwandtes
  - [[übergeordneter-hub]]
  - [[geschwister-oder-person]]
  

Link-Ziele

• Verwende den genauen bestehenden Dateinamen (kebab-case). Überprüfe dies mit rg --files | rg <slug>, bevor du einen Link setzt.
• Bevorzuge wenige starke Links anstelle vieler schwacher. Verlinke das, worauf ein Leser als Nächstes klicken würde.
• Verlinke niemals nur auf eine Datumsseite, eine tägliche Notiz oder einen Tag. Diese verbinden keine Themen.

Meeting- und Aufzeichnungsnotizen

Eine Meeting- oder Aufzeichnungsnotiz verlinkt auf:

• die Person, das Team oder das Projekt, um das es ging
• jeden Teilnehmer, der eine Seite hat
• jedes Konzept oder jede Entscheidung, die daraus hervorging

Ein Transkript ohne Links ist der häufigste Grund für isolierte Notizen.

Rohquellen

Dateien in _raw/ (oder dem entsprechenden Erfassungsordner des Vaults) werden niemals bearbeitet. Füge keine Links in ihnen hinzu. Stattdessen verlinkt die Zusammenfassung oder Meeting-Seite, die sie zitiert, auf die Rohdatei, sodass sie über diese Seite in den Graphen eingebunden wird.

Schreiben in einen freigegebenen Posteingang (Bots)

• Wenn der Vault vorgibt, nur in _agents/inbox/ (oder einen anderen Inbox-Pfad) zu schreiben, tue das.
• Die obigen Link-Regeln gelten weiterhin für Inbox-Notizen, und suggested_home muss eine reale Seite nennen.

Niemals in den Vault legen

• Anmeldedaten, Token oder Geheimnisse
• Private Kontaktdaten, die nicht in einen freigegebenen Graphen gehören
• Medizinische Aufzeichnungen oder andere sensible persönliche Daten
• Vertrauliches Material Dritter, das du nicht speichern darfst

Schnellcheck vor dem Abschluss

• Mindestens ein Aufwärts-Link und ein Querverweis, alle auf reale Dateien (oder bewusst neue Seiten)
• Namen von Personen, Produkten und Projekten sind verlinkt
• Abschnitt „Verwandtes“ vorhanden
• Kein Duplikat einer bestehenden Seite