Praxisprojekt Second Brain · Pflege
Den Vault linten
Lernziele
- Du nennst die sechs Prüfungen eines Lint-Laufs und unterscheidest bei kaputten Links Tippfehler von echten Lücken.
- Du trennst Reparaturen, die der Agent selbst ausführt, von Entscheidungen, die er dir vorlegt.
- Du startest
/lintauf einem sauberen Git-Stand und liest die Ausgabe als Trend über Wochen.
Ein Vault verfällt still. Keine Fehlermeldung erscheint, nichts stürzt ab. Der Vault · engl. vaultDer Ordner mit allen Markdown-Dateien deines Second Brain, so wie Obsidian ihn öffnet. Jede Seite ist eine eigene Textdatei.Im Glossar beantwortet Fragen nur langsam schlechter, weil ein Drittel seiner Seiten unerreichbar geworden ist und niemand es bemerkt hat.
Ein Lint · engl. lintEine automatische Prüfung der Struktur, etwa auf kaputte Links, Seiten ohne eingehende Links und fehlendes Frontmatter. Der Begriff kommt aus der Programmierung.Im Glossar-Lauf macht diesen Verfall sichtbar. Der Name kommt aus der Programmierung: Ein Linter prüft Code auf Fehler, die beim Ausführen nicht auffallen. Im Vault prüft er die Struktur.
Was ein Lint prüft
Kaputte Links. Ein Link zeigt auf eine Seite, die es nicht gibt. Dafür gibt es zwei Ursachen. Ein Tippfehler oder eine Umbenennung wird repariert. Eine echte Lücke kommt in index.md unter „Lücken“, denn dein Material verweist auf etwas, das noch fehlt.
Waisen. Seiten, auf die nichts verlinkt. Der Agent findet die Stelle, an die sie gehören, und setzt den Link. Gibt es keine, wird die Seite ein Kandidat zum Löschen. Mehr zum Begriff in Verlinkungsregeln.
Stummel. Seiten unter etwa vierzig Wörtern ohne Links. Meist ist das ein gescheiterter Import. Der Lint markiert sie, und der Agent arbeitet sie aus dem Original in raw/ neu ein.
Verstöße gegen das Schema. Frontmatter fehlt, type hat einen falschen Wert, ein Tag steht nicht im Vokabular. Das Schema kennst du aus Frontmatter-Schema.
Beinahe-Dubletten. Ähnliche Titel, überlappende Aliase, dieselben eingehenden Links. Wie du zwei Seiten zusammenführst, zeigt Doppelte Seiten zusammenführen.
Abweichungen im Index. Seiten fehlen in index.md, oder ein Eintrag zeigt ins Leere.
Erst melden, dann reparieren
Mechanische Fehler repariert der Agent selbst. Alles, was ein Urteil braucht, schlägt er vor und wartet auf dich.
Diese Grenze trägt den ganzen Lint. Ein Linter, der Seiten nach eigenem Urteil verschmilzt, zerstört Arbeit, vielleicht eine Seite, die du von Hand geschrieben hast. Ein Linter, der nur meldet, erzeugt eine Liste, die nach unserer Einschätzung niemand abarbeitet. Kaputte Links und Schemafehler sind mechanisch. Verschmelzen und Löschen brauchen dein Urteil.
Selbst reparieren oder vorlegen?
Diese Befunde kamen aus unserem Test-Vault. Ordne jeden zu: Darf der Agent ihn selbst beheben, oder legt er ihn dir vor?
Noch offen (6)
- [[Abrufuebung]] zeigt ins Leere, die Seite heißt Abrufübung.
- Eine Seite trägt das Tag sleep, im Vokabular steht schlaf.
- Drei Seiten fehlen in index.md.
- Spaced Repetition und Verteiltes Wiederholen beschreiben dieselbe Idee.
- Der Index nennt [[Testeffekt]], die Seite gibt es nicht.
- Feynman-Methode hat acht Wörter, und in raw/ liegt kein Original.
Repariert selbst (0)
Legt dir vor (0)
Den Lint starten
/lintDer Befehl kommt aus dem Werkzeugkasten des Kurses und ruft den Skill second-brain-lint auf. Wie Befehle und Skills zusammenhängen, steht in Skills und Slash-Commands.
Lass den Lint wöchentlich laufen und nach jedem Import von mehr als etwa zwanzig Quellen. Nach jedem einzelnen Import kostet er nach unserer Einschätzung mehr, als er findet.
Starte ihn auf einem sauberen Git-Stand: Alles ist committet, git status zeigt nichts an. Dann machst du eine falsche Reparatur mit einem Befehl rückgängig. Welche Befehle das sind, zeigt Versionieren mit Git.
Wir haben /lint auf einem Test-Vault mit elf Seiten laufen lassen. Darin steckten ein Tippfehler-Link, eine echte Lücke, zwei Waisen, ein Stummel, ein falsches Tag, eine Beinahe-Dublette und ein Indexeintrag ohne Seite:
- Du/lint
Claude Code 2.1.322 mit Haiku, rund dreieinhalb Cent (Stand: Nov. 2026). Die Interleaving-Lücke ließ der Agent stehen, denn sie stand schon unter „Lücken“. Nichts wurde gelöscht oder verschmolzen.
In Obsidian deckt das Plugin Find orphaned files and broken links zwei der Prüfungen ab. Es bringt die Befehle „Find orphaned files“ und „Find broken links“ mit (Version 1.11.0, Stand: Nov. 2026).
Für einen schnellen Blick ohne Agent gibt es ein Skript aus dem Werkzeugkasten:
python3 scripts/link_check.py ~/brainDas Skript meldet kaputte Links, Links auf einen Alias, Waisen und Stummel. Es zählt wie der Lint: Ein Stummel hat weniger als vierzig Wörter Text und keine Links. Links aus index.md und log.md zählen nicht als eingehend, eine Seite, die nur im Index steht, ist also eine Waise. Die Waisenquote des Skripts entspricht damit der zweiten Zahl des Agenten, der Quote ohne Index.
Die Ausgabe lesen
Die Zahlen zählen mehr als die einzelnen Befunde. Drei kaputte Links nach einer Woche sind nach unserer Einschätzung normal. Vierzig heißen, dass sich in den Import-Anweisungen etwas geändert hat. Der Agent erzeugt dann Links auf Seiten, die er nie anlegt.
Verfolge die Quoten über die Zeit. Die absoluten Zahlen wachsen mit dem Vault: Zehn kaputte Links in 200 Seiten sind fünf Prozent, in 2.000 Seiten ein halbes. Die vier Kennzahlen dafür stehen in Kennzahlen, die sich lohnen.
Merksätze
- Ein Lint prüft kaputte Links, Waisen, Stummel, Schemafehler, Beinahe-Dubletten und den Index.
- Ein kaputter Link ist ein Tippfehler, der repariert wird, oder eine Lücke, die in den Index kommt.
- Mechanisches repariert der Agent selbst. Verschmelzen und Löschen legt er dir vor.
- Der Lint läuft wöchentlich und nach großen Importen, immer auf einem sauberen Git-Stand.
- Du liest die Quoten über Wochen. Ein plötzlicher Sprung zeigt auf geänderte Import-Anweisungen.
Prüf dich selbst
Denkfrage
Der Lint findet den Link [[Interleaving]], aber keine Seite dazu. Was passiert damit?
Erst klärt der Agent, ob es ein Tippfehler oder eine Umbenennung ist. Gibt es keine passende Seite unter anderem Namen, ist es eine echte Lücke. Sie kommt in index.md unter „Lücken“, und der Link bleibt als Markierung stehen. Steht sie dort schon, ändert der Lint nichts.
Denkfrage
Warum soll ein Lint keine Seiten auf eigene Faust verschmelzen, wenn er doch sicher erkennt, dass zwei Seiten dasselbe meinen?
Verschmelzen ändert Inhalt, Links und Aliase, und eine der beiden Seiten hast du vielleicht von Hand geschrieben. Ein Fehler kostet dann Arbeit, die nicht der Agent gemacht hat. Mit einem Vorschlag liest du einmal kurz und entscheidest.
Prüf dich selbst
Quellen
- Find orphaned files and broken links
Version 1.11.0 vom Juli 2026, Befehle Find orphaned files und Find broken links.
- Run Claude Code programmatically
claude -p, --permission-mode, --allowedTools.