Kaputte Links und Waisen

Lernziele

Du schreibst eine Regel für Umbenennungen in die CLAUDE.md: Links anpassen, Alias setzen, im Log vermerken.
Du trennst kaputte Links in Tippfehler, die repariert werden, und echte Lücken, die in den Index kommen.
Du ordnest eine Waise einem von drei Fällen zu und weißt, was jeweils zu tun ist.

Den schnellen Überblick gibt das Skript aus dem Werkzeugkasten des Kurses:

python3 scripts/link_check.py ~/brain

Es zählt Seiten, Links, kaputte Links, Waise · engl. orphanEine Seite, auf die keine andere Seite verlinkt. Wer Links folgt, erreicht sie nie.Im Glossar und Stummel. Wie du seine Zahlen liest und wo es Fehlalarme gibt, steht in Den Vault linten.

Warum Umbenennen Links bricht

Benennst du eine Datei in Obsidian um, passt Obsidian die Links an. Dafür sorgt die Einstellung „Automatically update internal links“ unter Settings → Files and links. Ein Agent, der die Datei direkt umbenennt, geht an Obsidian vorbei. Das ist nach unserer Einschätzung die häufigste Ursache für kaputte Links in einem Vault, den ein Agent pflegt.

Verhindere das mit einer Regel in der CLAUDE.md:

## Umbenennen
- Passe jeden eingehenden Link auf den neuen Namen an.
- Trag den alten Namen als Alias der Seite ein.
- Vermerke die Umbenennung in log.md.

Wir haben einen Agenten ohne diese Regel eine Seite umbenennen lassen: „Vergessenskurve“ wurde zu „Ebbinghaus-Kurve“. Haiku suchte von sich aus nach allen Vorkommen, passte die drei Links an und schrieb einen Eintrag ins Log. link_check.py fand danach keinen neuen kaputten Link. Den alten Namen trug der Agent nicht als Alias · engl. aliasEin weiterer Name für dieselbe Seite, eingetragen in der Eigenschaft aliases. Obsidian schlägt die Seite beim Verlinken auch unter diesem Namen vor.Im Glossar ein. Wer in Obsidian nach „Vergessenskurve“ sucht, findet die Seite über den Namen nicht mehr. Mit der Regel hängt das Ergebnis nicht davon ab, was der Agent in diesem Lauf von sich aus tut. Wie Aliase funktionieren, zeigt Namen und Aliase.

Massenhaft reparieren

Kaputte Links fallen in zwei Gruppen, und beide behandelst du verschieden.

Tippfehler und Umbenennungen werden repariert: Der Link zeigt danach auf die richtige Seite. Das kannst du gefahrlos automatisieren.

Echte Lücken, deren Ziel es nie gab, kommen in index.md unter „Lücken“. Leg keine leeren Seiten an, nur damit der Link aufgeht. Eine leere Seite schadet mehr als eine vermerkte Lücke, denn sie sieht aus wie Wissen, das es nicht gibt.

Arbeite immer auf einem sauberen Git-Stand. Dann machst du eine falsche Massenreparatur mit einem Befehl rückgängig.

Waisen

Waisen sind Seiten, auf die nichts verlinkt. Es gibt drei Fälle.

Sie sollte verlinkt sein und ist es nicht. Such die Seiten, die auf sie verweisen müssten, und setz die Links. Das ist der häufigste Fall nach einem großen Import.

Sie steht wirklich für sich. Das kommt nach unserer Einschätzung kaum vor und heißt meist, dass das Material nicht ins Wiki gehört. Nachschlagematerial und Checklisten gehören in einen Projektordner, siehe Projekte abgrenzen.

Der Import ist gescheitert. Ein Stummel, der nie verbunden wurde. Arbeite ihn aus dem Original in raw/ neu ein.

Was tust du damit?

Ordne jeden Befund der passenden Reparatur zu.

Noch offen (5)

[[Spaced Repitition]] zeigt ins Leere, die Seite heißt Spaced Repetition.
[[Elaboration]] wird verlinkt, aber dazu gibt es weder Seite noch Quelle.
Nach dem Import von 200 Artikeln hat die Seite „Interleaving“ keinen eingehenden Link, obwohl drei Seiten davon handeln.
Die Seite „Feynman-Methode“ hat acht Wörter, das Original liegt in raw/.
Eine Packliste für die nächste Konferenz liegt in wiki/ und ist mit nichts verbunden.

Link korrigieren (0)

Unter Lücken eintragen (0)

Eingehende Links setzen (0)

Aus raw/ neu einarbeiten (0)

Aus dem Wiki nehmen (0)

Beides beim Import verhindern

Eine Regel erspart den größten Teil dieser Arbeit: Nichts gilt als importiert, bevor es verlinkt ist, in beide Richtungen und im selben Lauf.

Ein Import, der mit unverlinkten Seiten endet, ist nicht fertig. Setz das im Import-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 durch. Dann musst du nicht jede Woche aufräumen. Der Skill second-brain-ingest aus dem Werkzeugkasten enthält die Regel schon als Kernregel. Wie er aufgebaut ist, steht in Skills und Slash-Commands.

Nach einem großen Import

Lass danach immer den Lint laufen. Ein großer Import hinterlässt zuverlässig Waisen und Beinahe-Dubletten, weil der Agent schnell durch Material geht, das sich überschneidet.

Plane das ein. Auf einen Import von tausend Quellen folgen ein Lint-Lauf und eine Prüfung der vorgeschlagenen Zusammenführungen. Wer diesen Schritt auslässt, behält nach unserer Einschätzung einen dauerhaft unordentlichen Vault. Wie du den Import in Etappen aufteilst, steht in Altbestand nachholen.

Nach einem großen Import

0 von 5 erledigt

Der Import ist committet, git status zeigt nichts an.
/lint ist gelaufen, und die Reparaturen sind als eigener Commit gesichert.
Echte Lücken stehen in index.md unter „Lücken“, ohne leere Platzhalter-Seiten.
Jede Waise ist einem der drei Fälle zugeordnet: verlinken, neu einarbeiten oder aus dem Wiki nehmen.
Die vorgeschlagenen Zusammenführungen sind gelesen und einzeln entschieden.

Merksätze

Benennt der Agent eine Datei direkt um, passt Obsidian keine Links an. Die Regel in der CLAUDE.md übernimmt das.
Zur Umbenennung gehören angepasste Links, der alte Name als Alias und ein Eintrag im Log.
Tippfehler werden repariert. Echte Lücken kommen in den Index, ohne leere Seiten.
Eine Waise wird verlinkt, neu eingearbeitet oder aus dem Wiki genommen.
Ein Import ist erst fertig, wenn alles in beide Richtungen verlinkt ist. Nach großen Importen läuft immer der Lint.

Prüf dich selbst

Denkfrage

Der Agent hat bei einer Umbenennung alle Links angepasst. Warum soll er trotzdem einen Alias setzen?

Denkfrage

Warum ist eine leere Seite für eine Lücke schlechter als ein Eintrag unter „Lücken“?

Quellen

Obsidian Help: Internal links · Obsidian, Stand: Nov. 2026
Automatically update internal links unter Files and links.