Namen und Aliase · Agentenwerk

Lernziele

Du vergibst kanonische Titel nach vier Regeln und trägst andere Namen sofort als Alias ein.
Du weist den Agenten an, Links immer auf den Dateinamen zu setzen und einen Alias nur als Anzeigetext zu nutzen.
Du benennst Seiten über ein festes Verfahren um, das jeden eingehenden Link mitnimmt und im Log steht.

Wikilinks finden ihr Ziel über den Namen. Der Name ist deshalb der Schlüssel, auf dem der ganze Graph aufbaut.

Obsidian sucht das Ziel eines Links über den Dateinamen. Für deinen Vault heißt das: Dateiname und Titel im Frontmatter sind gleich. Die Seite mit dem Titel „Retrieval augmented generation“ liegt als Retrieval augmented generation.md im Ordner wiki/concepts/, und ein Link auf sie lautet [[Retrieval augmented generation]].

Kanonische Titel

Eine Seite hat einen kanonischen Titel. Er ist der Name, den du im Gespräch mit jemandem aus dem Fach benutzen würdest.

Vier Regeln ersparen dir nach unserer Einschätzung den meisten Ärger:

Einzahl. Vektordatenbank, und Vektordatenbanken wird ein Alias.
Abkürzungen im Titel ausschreiben, die Abkürzung kommt in die Aliase. Der Titel ist für die Lesenden, der Alias für den Link.
Kein Datum und keine Version im Titel, es sei denn, die Seite handelt wirklich von einer Version. Eine Seite MCP-Spezifikation 2026-07 ist in einem Monat falsch. Eine Seite MCP mit einer Versionsgeschichte bleibt richtig.
Keine vault-eigenen Präfixe. Konzept - RAG macht die Link-Schreibweise umständlich und bringt nichts. Den Typ trägt das Feld type.

Taugt der Titel?

Prüf jeden Titel gegen die vier Regeln.

Noch offen (6)

Retrieval augmented generation (Alias: RAG)
Vektordatenbanken
MCP-Spezifikation 2026-07
Konzept - Abrufübung
Python (Programmiersprache)
RAG

Kanonisch (0)

Umbenennen (0)

Aliase

Alle anderen Namen für dieselbe Sache stehen im Frontmatter unter aliases. Obsidian erwartet die Eigenschaft als Liste:

title: Retrieval augmented generation
aliases:
  - RAG
  - retrieval-augmented generation

Aliase verhindern nach unserer Einschätzung, dass der Vault still drei Seiten für ein Ding anlegt. Ohne Alias legt eine Quelle, die „RAG“ schreibt, eine Seite RAG an. Eine Quelle, die den Begriff ausschreibt, legt eine zweite an, ohne von der ersten zu wissen. Mit Alias findet der Agent die bestehende Seite auch unter dem anderen Namen, bevor er eine neue anlegt.

Trag Aliase beim Anlegen ein. Bis dir das Doppel auffällt, haben beide Seiten schon eingehende Links.

Wie ein Link über einen Alias aussieht

Tippst du in Obsidian einen Alias in einen Link, schlägt Obsidian die Seite vor. Wählst du sie, entsteht [[Retrieval augmented generation|RAG]]. Das Ziel ist der Dateiname, „RAG“ nach dem senkrechten Strich ist nur der angezeigte Text. Obsidian setzt den Alias bewusst nicht als Ziel ein, damit Links mit anderen Programmen kompatibel bleiben, die Wikilinks lesen.

Ein Agent schreibt Dateien direkt und hat keine Vorschlagsliste. Schreibt er [[RAG]], sucht Obsidian eine Datei namens RAG.md. Gibt es sie nicht, zeigt der Link ins Leere. Deshalb gehört diese Zeile in deine CLAUDE.mdDie Anweisungsdatei, die Claude Code zu Beginn jeder Session liest. Claude Code lädt sie aus dem Startordner und aus jedem Ordner darüber und hängt die Inhalte aneinander.Im Glossar:

Links zeigen immer auf den Dateinamen der Zielseite. Einen anderen Namen
schreibst du als Anzeigetext dahinter: [[Retrieval augmented generation|RAG]].

Zwei Dinge mit gleichem Namen

Unterscheide sie im Titel, mit einer Klammer, die jemand auch tippen würde:

Python (Programmiersprache)
Python (Schlange)

Dann trägst du das bloße Wort „Python“ als Alias bei der Seite ein, die in deinem Vault überwiegt. Oder du trägst es bei keiner ein, wenn beide wichtig sind. Dann muss der Agent ausdrücklich wählen und kann nicht raten.

Dasselbe gilt für Personen mit gleichem Namen und für eigene Projekte, die wie ein bekanntes Produkt heißen.

Umbenennen

Benennst du eine Datei in Obsidian um, passt Obsidian die Links an. Die Einstellung dafür heißt „Automatically update internal links“ unter Settings → Files and links. Benennt der Agent eine Datei direkt um, passt niemand die Links an. Das ist nach unserer Einschätzung die häufigste Ursache für kaputte Links in einem Vault, den ein Agent pflegt.

Die Regel für die CLAUDE.md: Umbenennen läuft über ein festes Verfahren. Der Befehl /vault-rename folgt dem Skill · engl. skillEin Ordner mit einer Datei SKILL.md, die einem Agenten eine wiederkehrende Aufgabe beschreibt. Claude Code lädt den Skill, wenn die Aufgabe passt oder du ihn mit seinem Namen aufrufst.Im Glossar second-brain-rename, der es in sechs Schritten beschreibt. Er heißt so, weil Claude Code /rename selbst belegt. Alle Schritte oder keiner.

Neuen Namen prüfen. Kollidiert er mit einer bestehenden Seite oder einem Alias, entsteht eine Mehrdeutigkeit, die der Graph nicht auflöst.
Datei umbenennen und title im Frontmatter anpassen.
Alten Namen als Alias eintragen. So funktionieren Verweise von außen, dein Gedächtnis und jeder übersehene Link weiter.
Jeden eingehenden Link anpassen, im ganzen Vault einschließlich index.md. Wo der alte Name als Text stehen soll, wird er zum Anzeigetext: [[Neuer Name|Alter Name]].
Ins Log schreiben: alter Name, neuer Name, Zahl der angepassten Links.
Prüfen mit einem Link-Check.

/vault-rename "RAG" -> "Retrieval augmented generation"

Der Skill rät außerdem: Benenne eine Seite mit vielen eingehenden Links nicht aus Geschmacksgründen um. Der Aufwand ist echt, der Nutzen kosmetisch. Ist der richtige Name unklar, fragt der Agent nach, bevor er wählt. Ein zweites Umbenennen stört mehr als das erste.

Merksätze

Obsidian findet Linkziele über den Dateinamen. Dateiname und Titel sind deshalb gleich.
Titel in der Einzahl, Abkürzungen ausgeschrieben, ohne Datum und ohne Präfix.
Aliase kommen beim Anlegen ins Frontmatter, damit der Agent bestehende Seiten unter jedem Namen findet.
Links zeigen auf den Dateinamen. Ein Alias steht nur als Anzeigetext hinter dem senkrechten Strich.
Umbenennen heißt: Datei, Titel, Alias, alle Links, Log und Prüfung, in einem Durchgang.

Prüf dich selbst

Denkfrage

Warum trägst du Aliase beim Anlegen ein und nicht erst, wenn ein Doppel auffällt?

Denkfrage

Der Agent hat eine Datei direkt von RAG.md in Retrieval augmented generation.md umbenannt. Was fehlt?

Namen im Vault

0 von 5 erledigt

Die vier Titelregeln stehen in der CLAUDE.md.
Die CLAUDE.md sagt: Dateiname gleich Titel, Links auf den Dateinamen, Alias nur als Anzeigetext.
Der Agent trägt Abkürzungen, Mehrzahl und andere Schreibweisen beim Anlegen als Alias ein.
Umbenennen läuft nur über /vault-rename, das steht in der CLAUDE.md.
In Obsidian ist „Automatically update internal links“ eingeschaltet.

Quellen

Obsidian Help: Aliases · Obsidian, Stand: Nov. 2026
Aliase als Liste, Link-Format mit Alias als Anzeigetext.
Obsidian Help: Internal links · Obsidian, Stand: Nov. 2026
Automatically update internal links unter Files and links.