Praxisprojekt Second Brain · Fehlerbehebung
Häufige Fragen
Lernziele
- Du entscheidest, welche Teile du zum Start brauchst und welche erst später dazukommen: MCP, Obsidian, lokales Modell, Importer.
- Du richtest einen Vault so ein, dass auch andere Agenten seine Anweisungen und Skills lesen.
- Du nennst die Stelle, an der du erfundene Angaben im Vault zuerst suchst.
Diese Lektion sammelt die Fragen, die bei fast jedem Vault auftauchen. Die Antworten sind kurz und verweisen auf die Lektion, in der das Thema ausführlich steht.
Brauchst du das zum Start?
Ordne jeden Baustein zu: Gehört er von Anfang an dazu, oder kommt er erst bei Bedarf?
Noch offen (6)
- Ein Ordner mit Markdown-Dateien
- Eine Anweisungsdatei wie CLAUDE.md
- Ein MCP-Server für Obsidian
- Obsidian
- Ein lokales Modell
- Das Plugin Importer
Von Anfang an (0)
Erst bei Bedarf (0)
Werkzeuge
Brauche ich MCP? Nein. Claude Code, im Vault-Ordner gestartet, liest und schreibt die Dateien direkt. MCP · engl. Model Context ProtocolEin offenes Protokoll, über das ein Agent Tools aus externen Servern einbindet, etwa für GitHub, Slack oder eine Datenbank. Jeder Server bringt eigene Tool-Definitionen mit.Im Glossar gibt Sitzungen Zugriff auf den Vault, die nicht in diesem Ordner laufen. Das zählt vor allem für geplante Aufgaben. Mehr dazu in MCP für Obsidian.
Funktioniert das mit anderen Agenten als Claude Code?
Ja. Jedes Werkzeug, das Dateien in einem Ordner lesen und schreiben kann, kann den Vault pflegen. Die Seiten sind Markdown. Die 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 liegen als SKILL.md im offenen Format Agent Skills, das auch andere Agenten lesen. Anpassen musst du vor allem den Namen der Anweisungsdatei:
| Werkzeug | Anweisungen | Skills |
|---|---|---|
| Claude Code | CLAUDE.md, ohne sie AGENTS.md |
ja |
| Codex | AGENTS.md |
ja |
| Cursor | AGENTS.md und eigene Regeln |
ja |
| Gemini CLI | GEMINI.md, umstellbar auf AGENTS.md |
ja |
Stand: Nov. 2026. Wo jedes Werkzeug die Skill-Ordner sucht, steht in seiner Dokumentation. Arbeitest du mit mehreren Agenten, schreib die Anweisungen in eine AGENTS.mdEine Textdatei im Wurzelverzeichnis eines Repositorys mit kurzen Regeln für Coding-Agenten: Aufbau, Testbefehl, Verbote. Der Agent liest sie zu Beginn jeder Session.Im Glossar. Claude Code liest sie ab Version 2.1.277 von selbst, solange es im Ordner keine CLAUDE.md gibt. Brauchst du doch eine CLAUDE.md, bindet die Zeile @AGENTS.md darin die gemeinsame Datei ein.
Brauche ich Obsidian? Nein. Der Vault ist ein Ordner mit Markdown-Dateien. Obsidian ist ein guter Betrachter für den Graphen und bringt den Web Clipper mit. Der Clipper ist nach unserer Einschätzung der stärkste praktische Grund für Obsidian. Foam für VS Code oder ein einfacher Editor funktionieren auch. Bei Logseq arbeitet nur die Dateiversion Logseq OG mit einem Ordner aus Markdown-Dateien. Die neue Version 2 speichert in einer Datenbank (Stand: Nov. 2026).
Kann ich ein lokales Modell nutzen? Für den Import von sensiblem Material ja, mit geringerer Qualität. Lokale Modelle sind schwächer bei den Urteilen, auf die es hier ankommt: was eine eigene Seite verdient und wann sich zwei Quellen wirklich widersprechen. Eine brauchbare Aufteilung ist ein lokales Modell für privates Material und ein großes Cloud-Modell für alles andere. Die Einrichtung zeigt Datenschutz.
Umstieg und Abgrenzung
Ich habe schon ein Notion oder Evernote voller Notizen. Was nun?
Nimm das offizielle Plugin Importer. Es holt Notizen unter anderem aus Notion, Evernote, Roam Research, Bear und Apple Notes. Behandle das Ergebnis als Rohmaterial in raw/ und arbeite es ein, das Älteste zuerst. Rechne mit einem unordentlichen Export. Repariere die Extraktion vor dem Import und verlass dich nicht darauf, dass der Agent damit zurechtkommt. Wie du einen großen Bestand in Etappen einarbeitest, steht in Altbestand nachholen.
Was unterscheidet das von einer Memory-Funktion? Eine Memory · engl. memoryWissen, das ein Agent über mehrere Sessions hinweg behält. Es besteht aus extrahierten Fakten wie Vorlieben und Entscheidungen, die ein Modell aus Gesprächen herauszieht und mit dem Bestand abgleicht.Im Glossar-Funktion merkt sich Fakten über dich über Sitzungen hinweg und gehört zum Werkzeug. Der Vault ist ein Wissensbestand, der dir als Dateien gehört. Er überdauert das Werkzeug, und du kannst ihn selbst lesen, bearbeiten und veröffentlichen. Die Abgrenzung steht ausführlich in Was ein Second Brain ist.
Vertrauen
Erfindet der Agent etwas? Das kann passieren. Deshalb drehen sich die Regeln aus Strukturieren um Zuordnung: Behauptungen als Behauptungen festhalten, Quellen anhängen, Lücken offen benennen. Achte vor allem auf eine konkrete Zahl ohne Quelle dahinter. In unserem Test schrieb der Agent zwei eigene Schlussfolgerungen in eine Konzeptseite. Er nannte sie erst, als wir nachfragten, siehe Der Agent schreibt Unbrauchbares.
Ist die Graphansicht nützlich oder nur hübsch? Die globale Ansicht ist nach unserer Einschätzung vor allem hübsch. Der lokale Graph taugt als Qualitätsprüfung für jede Seite in fünf Sekunden. Wie du ihn liest, steht in Die Graphansicht in Obsidian lesen.
Kosten und Zeit
Was kostet der Betrieb? Das hängt ganz von der Menge ab. Ein täglicher Import von ein paar Artikeln kostet wenig: Unsere Testimporte eines einzelnen Artikels mit Haiku lagen bei rund zwei bis drei Cent (Stand: Nov. 2026). Ein einmaliger Import von tausend Quellen kostet deutlich mehr. Deshalb besteht Altbestand nachholen auf Etappen, bei denen du die Kosten jeder Etappe siehst.
Wann lohnt es sich? Den ersten echten Nutzen spürst du nach unserer Einschätzung in der zweiten bis vierten Woche. Den Zustand, den alle als den eigentlichen Gewinn beschreiben, erreichst du nach etwa sechs Monaten. Den Zeitplan im Einzelnen zeigt Wie gut aussieht.
Merksätze
- Zum Start brauchst du einen Ordner mit Markdown, eine Anweisungsdatei und einen Agenten. MCP, Obsidian und ein lokales Modell kommen bei Bedarf dazu.
- Andere Agenten lesen dieselben Seiten und Skills. Für mehrere Agenten schreibst du die Anweisungen in eine
AGENTS.md. - Ein Umzug aus Notion oder Evernote läuft über den Importer und landet als Rohmaterial in
raw/. - Erfundenes findest du am ehesten bei konkreten Zahlen ohne Quelle.
- Der erste Nutzen kommt nach zwei bis vier Wochen, der volle nach etwa sechs Monaten.
Prüf dich selbst
Denkfrage
Du willst den Vault abwechselnd mit Claude Code und Codex pflegen. Wie richtest du die Anweisungen ein?
Schreib sie in eine AGENTS.md im Vault. Codex liest sie direkt, Claude Code ab Version 2.1.277 auch, solange es keine CLAUDE.md gibt. Brauchst du zusätzlich eine CLAUDE.md, bindest du die gemeinsame Datei darin mit @AGENTS.md ein. So pflegst du die Regeln an einer Stelle.
Denkfrage
Warum soll ein Export aus Notion erst in raw/ landen und nicht direkt in wiki/?
Ein Export ist unordentlich: zerrissene Tabellen, fremde Formatierung, Seiten ohne Zusammenhang. In raw/ bleibt er als Original liegen, und der Agent arbeitet ihn nach deinen Regeln ein. Landet er direkt in wiki/, stehen Seiten im Vault, die keinem Seitenvertrag folgen.
Prüf dich selbst
Quellen
- Agent Skills
Offenes Format für SKILL.md-Ordner.
- How Claude remembers your project
AGENTS.md wird gelesen, wenn keine CLAUDE.md existiert, ab v2.1.277. Import mit @AGENTS.md.
- AGENTS.md
Gemeinsames Format für Anweisungen an Coding-Agenten.
- Gemini CLI: GEMINI.md
Dateiname über context.fileName änderbar.
- Gemini CLI: Agent Skills
- Codex: Build skills
- Cursor: Skills
- Obsidian Importer
Version 3.2.0, Liste der unterstützten Formate.
- Obsidian Web Clipper
- Foam
Erweiterung für VS Code, Version 0.48.0 vom November 2026.
- Logseq OG
Dateiversion von Logseq, Version 1.0.0 vom April 2026. Logseq 2.0 (Beta) speichert in einer Datenbank.