Die Fehler, die alle machen

Lernziele

Du ordnest ein Symptom deines Vaults einer von vier Ursachen zu: Erfassung, Seitenvertrag, Index oder Verlinkung.
Du schützt von Hand geschriebene Seiten mit maintained_by: human und einer Regel in der CLAUDE.md.
Du prüfst, ob der Import vor dem Schreiben index.md liest.

Dieser Abschnitt sammelt konkrete Fehler und ihre Lösungen. Jeder davon kommt häufig vor. Zeigt dein Vault · engl. vaultDer Ordner mit allen Markdown-Dateien deines Second Brain, so wie Obsidian ihn öffnet. Jede Seite ist eine eigene Textdatei.Im Glossar eines dieser Bilder, hast du ihn trotzdem nicht unrettbar falsch eingerichtet. Jeder Fehler hier lässt sich mit einem Handgriff beheben, und die Ursache liegt fast immer an einer von vier Stellen.

Der Vault stockt nach zwei Wochen

Meist liegt es an der Erfassung. Das Ablegen eines Artikels kostet drei Klicks statt einem, oder vom Handy führt kein Weg in den Vault. Dann kommt kein Material mehr an, und der Agent hat nichts zu verarbeiten.

Repariere den Weg hinein und lass den Vault selbst in Ruhe. Die Wege für jede Art von Material stehen in Material importieren, der schnellste für Webseiten in Web-Artikel.

Die zweite Ursache ist Ungeduld. Bei dreißig Seiten gibt es noch nichts zu verbinden. Den realistischen Zeitplan von der ersten Woche bis zum sechsten Monat zeigt Wie gut aussieht.

Seiten fassen Zusammenfassungen zusammen

Die Quellenseite fasst den Artikel zusammen, die Konzeptseite fasst die Quellenseiten zusammen. Jede Schicht verliert Information, und gelesen wird am Ende die unterste.

Die Ursache ist ein Seitenvertrag, in dem irgendwo „zusammenfassen“ steht. Eine Konzeptseite erklärt eine Idee in einfacher Sprache, in deinen Worten, und steht für sich. Schreib den Vertrag in der 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 um und arbeite zur Probe ein paar Quellen neu ein. Was jeder Seitentyp enthält, steht in Die vier Seitentypen.

Der Agent schreibt Handarbeit um

Das ärgert und lässt sich verhindern. Markiere Seiten, die du selbst schreibst, im Frontmatter · engl. frontmatterEin Block mit Metadaten im YAML-Format ganz oben in einer Markdown-Datei, zwischen zwei Zeilen mit drei Bindestrichen. Obsidian zeigt ihn als Eigenschaften der Seite an.Im Glossar:

maintained_by: human

In die CLAUDE.md kommt die passende Regel: Seiten mit maintained_by: human schreibt der Agent nie um. Er hängt nur Links an und vermerkt Probleme für dich.

Wir haben das in einem Test-Vault geprüft. Die Seite „Abrufübung“ war von Hand geschrieben und markiert. Ein neuer Artikel zum selben Thema kam per Ingest · engl. ingestDer Arbeitsschritt, in dem der Agent eine neue Quelle aus raw/ liest, daraus Wiki-Seiten schreibt oder ergänzt, sie verlinkt und den Lauf in index.md und log.md festhält.Im Glossar dazu. Der Agent (Claude Code 2.1.322 mit Haiku, rund zweieinhalb Cent, Stand: Nov. 2026) ließ jeden bestehenden Satz stehen und hängte nur dies an:

 Siehe [[Roediger 2006]], [[Spaced Repetition]].
+
+Siehe auch [[Effekt des erfolglosen Abrufs]], [[Freies Erinnern]], [[Artikel Abrufübung 2026]].
+
+## Hinweise für dich
+- Der Überblicksartikel [[Artikel Abrufübung 2026]] nennt keine Autoren und keine einzelnen Studien. Seine Befunde sind dadurch schwer zu prüfen.

Der Hinweis war berechtigt: Unser Testartikel nannte tatsächlich keine Autoren. Dieselbe Markierung bremst auch das Zusammenführen von Dubletten, siehe Doppelte Seiten zusammenführen.

Die Import-Qualität sinkt mit der Größe

Das passiert wirklich, und die Ursache ist meist der Kontext. In einem Vault mit dreihundert Seiten muss der Agent vor dem Schreiben prüfen, was es schon gibt. Tut er das nicht, legt er neue Seiten an, statt bestehende zu ergänzen.

Prüf, ob der Import vor dem Schreiben index.md liest. Dieser eine Schritt hält die Qualität stabil, während der Vault wächst. In unserem Testlauf las der Agent als Erstes index.md und log.md, weil die CLAUDE.md es verlangte. Wozu die beiden Dateien dienen, steht in index.md und log.md.

Alles hängt mit allem zusammen

Ein paar Hub · engl. hubEine Seite mit auffällig vielen Links. Läuft fast alles über sie, verbindet der Graph zwar alles, sagt aber wenig über einzelne Zusammenhänge.Im Glossar-Seiten haben jeden Link an sich gezogen, und der Graph sagt nichts mehr. Teile diese Hubs in die einzelnen Ideen auf, auf die die Links eigentlich zeigen. Wie das geht, zeigt Verlinkungsregeln.

Du öffnest ihn nicht mehr

Das ist der ehrlichste Fehler. Meist ist die Erfassung schon vor Monaten gebrochen, und der Vault steht still. Oder der Rückblick ist zu lang zum Lesen. Wie ein kurzer Rückblick aussieht, steht in Rückblicke im Takt.

Beides lässt sich beheben. Der Impuls ist, mit einem anderen Werkzeug neu anzufangen. Das kostet nach unserer Einschätzung jedes Mal einen weiteren Monat und behebt keine der beiden Ursachen.

Wo liegt die Ursache?

Ordne jedes Symptom der Stelle zu, die du zuerst prüfst.

Noch offen (6)

Seit zehn Tagen liegt nichts Neues in raw/.
Du speicherst Artikel am Handy, aber sie landen nie im Vault.
Eine Konzeptseite liest sich wie eine Inhaltsangabe von drei Quellenseiten.
Nach dem Import gibt es „Abrufübung“ und „Retrieval Practice“ als zwei Seiten.
Eine Seite „Lernen“ hat 140 eingehende Links.
In der Graphansicht hängt jede Seite an jeder anderen.

Erfassung (0)

Seitenvertrag (0)

Index lesen (0)

Verlinkung (0)

Merksätze

Ein Vault, der nach zwei Wochen stockt, hat meist ein Problem bei der Erfassung.
Steht „zusammenfassen“ im Seitenvertrag, verlieren die Seiten mit jeder Schicht Information.
maintained_by: human plus eine Regel in der CLAUDE.md schützen deine Handarbeit.
Ein Import, der vorher index.md liest, ergänzt bestehende Seiten.
Aufgeben und das Werkzeug wechseln behebt keine der Ursachen.

Prüf dich selbst

Denkfrage

Dein Vault hat nach drei Wochen vierzig Seiten, und du hast das Gefühl, er bringt nichts. Was prüfst du?

Denkfrage

Du hast eine Seite von Hand geschrieben und markiert. Ein Import bringt eine Quelle, die ihr widerspricht. Was darf der Agent tun?