Build: Den Graphen in den Loop holen

Teil drei. Der Graph existiert und beantwortet Fragen. Jetzt soll der AgentAgentEin System, in dem ein Sprachmodell seinen nächsten Schritt selbst wählt: Es ruft Werkzeuge auf, wertet das Ergebnis aus und macht weiter, bis das Ziel erreicht ist.Im Glossar ihn erreichen, ohne dass du dazwischenstehst. Die Schnittstelle ist ein Skript, das Text ausgibt, ganz ohne MCPMCP · 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-Server und Framework. Claude Code ruft Skripte ohnehin auf, und diese Schnittstelle übersteht jeden Wechsel des Frameworks.

Ein Slash-Befehl statt eines Servers

Lege im Vault die Datei .claude/commands/connects.md an:

---
description: Was zwei Seiten verbindet
---

Erzeuge die Kantenliste neu mit `python3 scripts/graph_export.py . edges.csv`.
Führe dann `python3 scripts/graph_query.py connects` mit den beiden
Seitennamen aus $ARGUMENTS aus, jeden in Anführungszeichen. Erkläre die
Kette in einem kurzen Absatz und nenne dabei die Kantentypen. Verbindet
nichts die beiden Seiten, sag das klar.

Mit /connects "Nelson Liu" "Neo4j" bekommt der Agent eine berechnete Kette, die er erklären soll, und muss keine Verbindung erfinden. Wie Befehle und SkillsSkill · 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 zusammenspielen, steht in Skills und Befehle. Im Test-Vault lief der Slash-BefehlSlash-Command · engl. slash commandEin Befehl, den du in Claude Code mit einem Schrägstrich aufrufst, etwa /ingest. Eigene Befehle sind Markdown-Dateien im Projektordner .claude/.Im Glossar mit Claude Code 2.1.322 und dem Modell Haiku in zwei Runden für 0,006 USD (Stand: Nov. 2026). Die Antwort nannte alle fünf Etappen mit ihren Typen.

Der Export am Anfang ist wichtig. Der Agent ändert ständig Seiten, und eine Abfrage über die CSV-Datei von gestern beantwortet Fragen zum Vault von gestern. Die typisierten Kanten veralten langsamer. Lass den Durchgang aus Den Graphen extrahieren einmal im Monat laufen und zusätzlich nach jedem großen Import.

Die größere Änderung steckt in den dauerhaften Anweisungen des Agenten. Ergänze in der CLAUDE.mdCLAUDE.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 des Vaults diese Zeilen:

Bevor du eine Frage beantwortest, wie zwei Themen zusammenhängen, führe
scripts/graph_query.py connects mit beiden Seitennamen aus und stütze
die Antwort auf die Kette, die das Skript liefert. In der Kette heißt
„A <-[typ]- B“, dass die Kante von B nach A zeigt.

Damit wird der Graph von einem Werkzeug, das der Agent nutzen könnte, zu einem, das er nutzt. Das ist der Unterschied zwischen einem Nachschlagewerk im Regal und einem, aus dem du zitierst. Den letzten Satz haben wir nach dem Test ergänzt. Ohne ihn rief Haiku auf die Frage „Wie hängt Jerry Liu mit dem Paper Lost in the Middle zusammen?“ zwar selbst connects auf, las RAG <-[links-to]- Lost in the Middle aber falsch herum. Mit dem Satz las es die Richtung richtig.

Der wöchentliche Graph-Check

Graphen verrotten, und Warum Wissensgraphen sagt deutlich: Ein veralteter Graph ist schlechter als keiner. Deshalb bekommt der Graph eine Pflegeschleife wie alles andere im Vault. Lass diesen Auftrag einmal pro Woche laufen, von Hand oder nach Zeitplan wie in Zeitpläne:

Führe python3 scripts/graph_export.py . edges.csv aus, dann
python3 scripts/graph_query.py communities. Berichte drei Dinge:

1. Waisen: Seiten unter wiki/, die in keiner Kante vorkommen
   (vergleiche die Dateinamen mit den Knoten in edges.csv, Kanten
   von index und log zählen nicht). Schlag für jede eine Seite vor,
   die auf sie verlinken sollte, oder markiere sie zum Löschen.
2. Schwache Cluster: Communities mit drei Seiten oder weniger, die
   nicht aus dem Import dieser Woche stammen. Sag, ob jede an einen
   größeren Cluster angebunden werden oder weiter wachsen soll.
3. Eine Brücke, die sich lohnt: die beiden größten Communities ohne
   typisierte Kante dazwischen und die Seite oder der Link, die sie
   verbinden würden.

Halte den Bericht bei zehn Zeilen. Ändere nichts, ohne zu fragen.

WaisenWaise · engl. orphanEine Seite, auf die keine andere Seite verlinkt. Wer Links folgt, erreicht sie nie.Im Glossar sind Fehler beim Erfassen, schwache Cluster sind Themen, die nie Fuß gefasst haben. Die fehlende BrückeBrücke · engl. bridgeEine Seite, die zwei sonst getrennte Bereiche des Graphen verbindet. Sie liegt auf vielen kürzesten Wegen zwischen anderen Seiten.Im Glossar ist meist die interessanteste Zeile im Bericht: zwei Wissensbereiche, die dir gehören und sich noch nie begegnet sind. Die Regel „nur lesen“ zählt. Ein Check, der still Links umbaut, macht den Vault nach und nach zu etwas, das nicht mehr deins ist.

Im Test-Vault kostete der Check 0,015 USD. Er fand die Waise „Notiz Zettel“, meldete keine schwachen Cluster und keine fehlende Brücke, weil GraphRAG -[extends]-> RAG die beiden Communities schon verbindet. Den Hinweis auf index und log haben wir nach dem ersten Lauf in Zeile 5 und 6 ergänzt. Ohne ihn taucht jede Waise als Knoten in edges.csv auf, weil der Index auf sie verlinkt.

Wann du umsteigst

Drei Signale zeigen, dass die Schicht aus CSV und NetworkX nicht mehr reicht. Sie kommen meist in dieser Reihenfolge:

1. Abfragen brauchen Geschichte, etwa „Was habe ich im März geglaubt?“. Flache Kanten haben keine Zeitstempel.
2. Mehrere Agenten schreiben gleichzeitig, und weil der letzte Schreibvorgang gewinnt, gehen in der CSV-Datei Kanten verloren.
3. Das Neuladen dauert Sekunden statt Millisekunden. Nach unserer Einschätzung passiert das irgendwo jenseits von einigen zehntausend Knoten.

Jedes Signal entspricht einer Stufe auf der Leiter aus Graph-Stores. Der Umzug dauert nach unserer Einschätzung einen Nachmittag, weil gängige Graphdatenbanken eine Kantenliste importieren können. Solange kein Signal eintritt, bleibst du, wo du bist. Die ganze Schicht besteht aus zwei Skripten, einem Prompt und zwei CSV-Dateien, und du kannst jeden Teil davon lesen.

Was du jetzt hast

Einen Extraktor, ein Abfrage-Werkzeug, einen Slash-Befehl und eine Pflegeschleife: ein funktionierendes GraphRAG im Kleinen über deinen eigenen Notizen, für den Aufwand eines Abends. Wächst der Appetit, bauen die Frameworks aus Werkzeuge dieselbe Form in größer.

Prüf dich selbst