Agentenwerkby Masiar Ighani · powered by skillbyte

Praxisprojekt Second Brain · Import

Altbestand nachholen

Lektion 7/710 Min. LesezeitEinsteiger

Lernziele

  • Du planst einen großen Import in Stapeln von zehn Quellen, ältestes zuerst, und begründest die Reihenfolge.
  • Du prüfst den ersten Stapel vollständig und korrigierst die CLAUDE.md, bevor du weitermachst.
  • Du hältst die Kosten klein, findest tote Links vorab und setzt einen abgebrochenen Lauf über log.md fort.

Irgendwann willst du alles hineinholen: den Lesezeichenordner, den Download-Ordner, drei Jahre Chatverlauf und die Später-lesen-Liste mit achthundert ungelesenen Einträgen.

Bei diesem Lauf geht am meisten schief. Er ist teuer, er dauert Stunden, und in der falschen Reihenfolge entsteht ein Wiki, das wie ein Haufen wirkt. Derselbe Lauf macht den Vault aber auch in einer einzigen Sitzung wirklich nützlich. Deshalb lohnt es sich, ihn sorgfältig anzugehen.

Die Reihenfolge zählt

Arbeite das Älteste zuerst ein.

Spätere Quellen sollen die Seiten aktualisieren, die frühere Quellen angelegt haben. Läuft der Import in dieser Richtung, hält das Wiki fest, wie sich dein Verständnis entwickelt hat: erst die frühe Seite zu einem Thema, dann die Korrektur, dann der aktuelle Stand.

Ältestes zuerst

  • Ablauf: jede neue Quelle ergänzt oder korrigiert eine ältere Seite
  • Ergebnis: die Seite zeigt frühe Sicht, Korrektur und aktuellen Stand
  • Arbeit des Agenten: einarbeiten und verlinken

Neuestes zuerst

  • Ablauf: jede alte Quelle trifft auf eine Seite, die schon die letzte Antwort enthält
  • Ergebnis: die Geschichte steht auf dem Kopf
  • Arbeit des Agenten: vor allem Widersprüche auflösen

Läuft es andersherum, kommt jede alte Quelle als Widerspruch zu einer Seite an, die das Endergebnis schon kennt. Der Agent verbringt seine Zeit mit dem Auflösen von Widersprüchen, und die Geschichte kommt verkehrt heraus. Damit verlierst du nach unserer Einschätzung das, was diese Struktur einem Suchindex voraus hat.

Immer in Stapeln

Zehn Quellen pro Stapel. Nach jedem Stapel passiert dasselbe:

  1. Einarbeiten. Der Agent arbeitet zehn Quellen ein, die älteste zuerst.
  2. Index und Log. Er aktualisiert index.md und hängt eine Zeile an log.md an.
  3. Commit. Er committet mit dem Bereich des Stapels in der Commit-Nachricht.
  4. Bericht. Er meldet, was neu ist, was er geändert und was er übersprungen hat.
  5. Pause. Er wartet auf dein Okay für den nächsten Stapel.
/backfill raw/archive/2024

Der Befehl /backfill arbeitet genau so und hält zwischen den Stapeln an. Er 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-backfill, der jeden Stapel mit einem kurzen Bericht abschließt: Stapelnummer, Bereich, eingearbeitete Quellen, neue und geänderte Seiten, Links, Übersprungenes und der nächste Stapel.

Die Stapel haben drei Gründe. Die Kosten bleiben sichtbar, solange du noch aufhören kannst. Die Qualität bleibt prüfbar: Eine schlechte Seitenvorgabe fällt dir schon auf Seite zehn auf, lange vor Seite vierhundert. Und ein Absturz kostet dich höchstens einen Stapel.

Den ersten Stapel gründlich prüfen

Lies jede Seite, die der erste Stapel erzeugt hat. Alle.

Jetzt erkennst du Fehler, die sich durch den ganzen Lauf ziehen würden: Seiten, die zusammenfassen und nichts erklären, Konzepte, die zu kleinteilig sind, Links, die nur Dekoration sind, und falsches 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. Korrigier die 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 und lass den Stapel neu laufen, bevor du weitermachst.

Ein Fehler, den du im ersten Stapel durchlässt, steckt am Ende in vierhundert Seiten. Ihn nachträglich zu beheben kostet mehr als der ursprüngliche Lauf. Den Stapel setzt du mit Git zurück, wie in der Lektion Git, Sync und Backups beschrieben.

Kosten im Griff

Tausend Quellen nachzuholen ergibt eine echte Rechnung. So hältst du sie im Rahmen:

  • Erst filtern. Die meisten Archive bestehen nach unserer Einschätzung zur Hälfte aus toten Links und Dingen, die du gespeichert und nie geöffnet hast. Lass den Agenten zuerst die Titel sichten, bevor er irgendetwas einarbeitet.
  • Stapelgröße begrenzen. Schau dir an, was die ersten Stapel kosten, bevor du hochskalierst.
  • Archivstufe nutzen. Nicht alles braucht eine Wiki-Seite. Was in raw/ liegen bleibt, kann der Agent bei Bedarf trotzdem durchsuchen.

Der Skill second-brain-backfill schlägt ab etwa zweihundert Quellen von sich aus einen Filter vor, bevor er die vollen Kosten nennt.

Alte Lesezeichen-Exporte stecken voller Seiten, die es nicht mehr gibt. Prüf sie vor dem Einarbeiten. Sonst stößt der Agent mitten im Lauf darauf.

Ein Python-Einzeiler, der nur urllib.request importiert, reicht dafür nicht. Wir haben einen solchen getestet: Er ruft keine einzige Seite ab und gibt nur die Eingabe wieder aus. Dieses kurze Skript prüft wirklich. Es braucht nur die Standardbibliothek, liest eine URL pro Zeile und gibt den HTTP-Status davor aus:

import sys, urllib.request as u, urllib.error as e
def status(url, ua={"User-Agent": "Mozilla/5.0 (linkcheck)"}):
    for m in ("HEAD", "GET"):  # erst HEAD, bei Fehlern GET
        try:
            with u.urlopen(u.Request(url, method=m, headers=ua), timeout=10) as r:
                return r.status
        except e.HTTPError as x:
            if m == "GET": return x.code
        except Exception as x:
            if m == "GET": return f"ERR {type(x).__name__}: {x}"
for line in sys.stdin:
    if (url := line.strip()): print(status(url), url, flush=True)

Speichere es als linkcheck.py außerhalb des Vaults und ruf es mit python3 linkcheck.py < urls.txt auf. Weiterleitungen folgt es von selbst, angezeigt wird der Status der Zielseite. Alles mit 404 oder ERR sortierst du aus oder suchst es im Archiv.

Ist etwas Wertvolles verschwunden, hat die Wayback Machine des Internet Archive meist eine Kopie. Speichere die Seite von dort und vermerke im Frontmatter, dass das Original tot ist. Eine Quellenseite, deren URL nur noch einen 404-Fehler liefert, kannst du ein Jahr später nicht mehr prüfen.

Fortsetzen

Halte den Fortschritt laufend in log.md fest, eine Zeile pro Stapel mit dem Ordner und dem Bereich, den er abgedeckt hat. Bricht der Lauf mittendrin ab, setzt du ihn anhand des Logs fort und musst nicht raten, welche Dateien schon fertig sind.

2026-11-11 backfill raw/archive/2024 Stapel 3/12 -> 10 Quellen (2024-03-02 bis 2024-04-18), 4 neue Seiten, 9 geändert, 31 Links

Die Zeile folgt dem Muster der CLAUDE.md aus diesem Kurs: Datum, Vorgang, Pfad, Ergebnis. Die Zahlen sind Beispielwerte.

Nach dem Nachholen

Lass zum Schluss einen vollständigen Lint laufen. Ein großer Import hinterlässt immer Seiten ohne eingehende Links, Beinahe-Doppel und kaputte Links.

/lint

Dann lass den Agenten mit /review zusammenfassen, was der Vault jetzt enthält. Nach dem Nachholen weiß er Dinge, von denen du vergessen hast, dass du sie gespeichert hast. Dieser Moment ist nach unserer Einschätzung der Lohn für die ganze Übung. Lint und Review vertieft das Kapitel Pflege.

Merksätze

  • Ältestes zuerst, damit spätere Quellen frühere Seiten fortschreiben und das Wiki deine Entwicklung zeigt.
  • Zehn Quellen pro Stapel, danach Index, Log, Commit, Bericht und Pause.
  • Den ersten Stapel liest du vollständig und korrigierst die CLAUDE.md, bevor es weitergeht.
  • Filtern, kleine Stapel und eine Archivstufe in raw/ halten die Kosten klein.
  • Eine Log-Zeile pro Stapel macht einen abgebrochenen Lauf fortsetzbar, ein Lint räumt am Ende auf.

Prüf dich selbst

Denkfrage

Warum arbeitest du ein Archiv ältestes zuerst ein?

Denkfrage

Der erste Stapel hat zehn Seiten erzeugt, alle sind bloße Zusammenfassungen. Was tust du?

Prüf dich selbst

  1. 1Wie viele Quellen verarbeitet ein Stapel beim Nachholen?
  2. 2Was passiert, wenn du ein Archiv neuestes zuerst einarbeitest?
  3. 3Welche Seiten des ersten Stapels liest du?
  4. 4Der Lauf bricht nach Stapel 5 von 12 ab. Wie findest du den Wiedereinstieg?

Bereit für den großen Import

0 von 7 erledigt

Quellen

  1. Wayback Machine · Internet Archive, Stand: Nov. 2026
Dein Fortschritt bleibt nur in diesem Browser gespeichert.