index.md und log.md · Agentenwerk

Lernziele

Du lässt den Agenten einen Index führen, gruppiert nach Typ und Thema, mit einer Zeile Beschreibung pro Seite und den Lücken am Ende.
Du liest log.md, um herauszufinden, welcher Lauf eine Seite geändert hat oder wohin eine Seite verschwunden ist.
Du hältst beide Dateien schlank und sorgst dafür, dass sie im selben Lauf wie die Arbeit aktualisiert werden.

Zwei Dateien im Ordner wiki/ enthalten selbst kein Wissen. Ohne sie ist das Wissen aber schwer zu erreichen und unmöglich nachzuprüfen.

index.md

Der Katalog: jede Seite, gruppiert nach Typ, die Lücken am Ende.

Seine eigentliche Aufgabe ist sparsamer Abruf. Bekommt der Agent eine Frage, liest er zuerst den Index. Daraus weiß er, was es gibt und welche Seiten sich zu öffnen lohnen. Die Alternative wäre eine Volltextsuche durch alle Seiten. Die ist langsamer, kostet mehr Kontextfenster · engl. context windowAlles, was das Modell bei einem Aufruf liest: Anweisungen, Verlauf, Dateien, Tool-Ergebnisse. Was dort fehlt, existiert für das Modell nicht.Im Glossar und übersieht Seiten, die das Thema mit anderen Wörtern beschreiben als die Frage.

Halte den Index navigierbar und gliedere ihn nach Themen:

## Konzepte

### Abruf
- [[Retrieval augmented generation]] - Chunking, Embeddings, wann es ein Wiki schlägt
- [[GraphRAG]] - Entitätsgraph plus Zusammenfassungen pro Cluster

### Agenten
- [[Agent harness]] - der Loop rund um ein Modell

Eine Zeile Beschreibung pro Eintrag. Anhand dieser Zeile entscheidet der Agent, ob er die Seite öffnet. Die Tokens dafür lohnen sich nach unserer Einschätzung. Der Befehl /index baut den Index aus dem tatsächlichen Inhalt von wiki/ neu auf, nach Typ und Thema gruppiert, mit den Lücken am Ende.

Lücken

Ganz unten im Index stehen die Seiten, auf die Links zeigen und die es noch nicht gibt.

Nach unserer Einschätzung ist dieser Abschnitt das Nützlichste im ganzen Vault. Er listet, worauf dein eigenes Material immer wieder verweist und was noch auf keiner Seite steht. Damit zeigt er dir meist ziemlich genau, was du als Nächstes lesen solltest.

## Lücken

- [[Testing-Effekt]] - verlinkt von 3 Seiten
- [[Interleaving]] - verlinkt von 2 Seiten

log.md

Eine Zeile pro Operation, angehängt, die neueste unten.

2026-09-07 ingest raw/karpathy-gist.md -> 1 source, 2 concepts, 1 entity, 9 links
2026-09-07 merge [[RAG]] <- [[Retrieval-augmented generation]]
2026-09-08 lint -> 3 broken links fixed, 2 orphans flagged

Erst das Log macht einen Vault, den ein Agent pflegt, prüfbar. Wundert dich eine Aussage auf einer Seite, zeigt dir das Log, welcher Lauf sie geschrieben hat. Verschwindet etwas, unterscheidet das Log eine nachvollziehbare Zusammenführung von einem Rätsel.

Das Log ist auch das Rohmaterial für den Wochenrückblick mit /review. Was sich diese Woche geändert hat, liest der Agent aus dem Log, ohne Zeitstempel von Dateien deuten zu müssen.

Index, Lücken oder Log?

Wohin schreibt der Agent diese Zeile?

Noch offen (5)

Eine neue Konzeptseite „Abrufübung“ mit einer Zeile Beschreibung
Ein Link auf „Testing-Effekt“, für den es noch keine Seite gibt
2026-11-11 ingest raw/lernpausen-interview.md -> 1 source, 1 concept, 4 links
2026-11-11 merge [[Abrufübung]] <- [[Retrieval Practice]]
Eine Entitätsseite „Lern-App“, verlinkt von vier Quellen

index.md: Katalog (0)

index.md: Lücken (0)

log.md (0)

Beide schlank halten

Der Index wächst mit dem Vault, das ist in Ordnung. Flache Listen werden nach unserer Einschätzung aber ab etwa zweihundert Einträgen unübersichtlich. Gliedere nach Themen. Hat ein Thema mehr als etwa dreißig Einträge, bekommt es eine eigene Indexseite, und der Hauptindex verlinkt sie.

Das Log wächst immer weiter, und alte Einträge liest niemand. Fass Einträge, die älter als ein paar Monate sind, zu einer Zeile pro Monat zusammen, oder verschieb sie in eine Archivdatei mit Datum im Namen. Neues bleibt im Detail, Altes wird verdichtet.

Die Regel, die zählt

Beide Dateien werden im selben Lauf aktualisiert wie die Arbeit, die sie beschreiben.

Ein Index, der hinterherhinkt, ist schlimmer als gar keiner. Der Agent vertraut ihm und sucht nicht nach Seiten, die dort fehlen. Ein Log, das später geschrieben wird, bleibt eine Rekonstruktion. Die CLAUDE.md aus dem Werkzeugkasten des Kurses nennt einen nachhinkenden Index das erste Zeichen dafür, dass das System auseinanderläuft.

Mit dieser Lektion endet das Kapitel. Im nächsten Kapitel Graphen zahlen sich diese Strukturen aus.

Merksätze

index.md listet jede Seite nach Typ und Thema mit einer Zeile Beschreibung. Der Agent liest ihn vor jeder Suche.
Die Lücken am Ende des Index zeigen, worauf dein Material verweist und was noch fehlt: deine Leseliste.
log.md bekommt eine Zeile pro Operation, die neueste unten, und macht jede Änderung nachvollziehbar.
Ab etwa dreißig Einträgen bekommt ein Thema eine eigene Indexseite. Alte Log-Einträge werden pro Monat verdichtet.
Index und Log ändern sich im selben Lauf wie die Arbeit. Ein nachhinkender Index ist schlimmer als keiner.

Prüf dich selbst

Denkfrage

Warum soll der Agent vor einer Antwort zuerst den Index lesen?

Denkfrage

Warum ist ein veralteter Index schlimmer als gar keiner?

Index und Log

0 von 5 erledigt

index.md gliedert nach Typ und Thema, mit einer Zeile Beschreibung pro Seite.
Am Ende von index.md stehen die Lücken, und du hast sie einmal als Leseliste gelesen.
log.md hat eine Zeile pro Operation, die neueste unten.
Die CLAUDE.md verlangt, dass Index und Log im selben Lauf wie die Arbeit aktualisiert werden.
Du weißt, ab wann ein Thema eine eigene Indexseite bekommt und wie alte Log-Einträge verdichtet werden.