Agentenrollen · Agentenwerk

Lernziele

Du ordnest jeder der sechs Rollen ihre Aufgabe, ihren Rhythmus und ihre Schreibrechte zu.
Du begründest, warum Löschen, Zusammenfassen und Taggen keine eigene Rolle bekommen.
Du liest eine Rollendatei und erkennst an der Zeile tools, was die Rolle verändern kann.

Bis hierher konntest du alles von Hand erledigen, nur langsam. Ab diesem Kapitel pflegt sich der Vault selbst, und er hängt nicht mehr an deiner Disziplin. Nach unserer Einschätzung ist das der Grund, warum er in sechs Monaten noch lebt.

Hier liegt auch das Risiko. Ein Agent mit Schreibrechten auf deine Notizen, der nachts nach Zeitplan läuft, ist genauso nützlich und genauso gefährlich, wie es klingt. Lies die Lektion Leitplanken, bevor du etwas einplanst.

Ein einzelner Agent für alles liefert nach unserer Einschätzung in jeder Aufgabe mittelmäßige Arbeit. Ein guter Ingestor und ein guter Reviewer brauchen verschiedene Anweisungen. Stehen beide in einem Prompt, verwässern sie sich gegenseitig.

Sechs Rollen decken einen Vault ab, vier davon lesen nur. Jede Rolle ist ein Subagent · engl. subagentEin Agent, den ein anderer Agent für eine Teilaufgabe startet. Er arbeitet in einem eigenen Kontextfenster und gibt nur sein Ergebnis zurück.Im Glossar mit eigener Datei in .claude/agents/. Die sechs Dateien stammen aus dem Werkzeugkasten des Kurses.

Rolle	Schreibt	Läuft
Ingestor	ja	wenn Material in `raw/` liegt
Linker	nur Links	nach Importen oder wöchentlich
Reviewer	nein	wöchentlich
Researcher	nein	bei Bedarf
Graph-Analyst	nein	monatlich
Kurator	nein	vierteljährlich

Ingestor

Der Ingestor liest raw/, schreibt Wiki-Seiten, verlinkt sie und aktualisiert Index und Log. Er schreibt mehr als jede andere Rolle. Von der Qualität seiner Seiten hängt alles ab, was danach kommt.

Seine Anweisungen sind absichtlich eng. Er beantwortet keine Fragen, baut bestehende Seiten nur durch neue Links um und löscht nichts. Ein Ingestor, der beim Import auch umorganisiert, liefert Läufe, die du nicht prüfen kannst. Inhaltliche und strukturelle Änderungen landen dann gemischt im selben Diff.

So sieht die Rollendatei aus:

---
name: ingestor
description: Processes new material in raw/ into linked wiki pages. Use when unprocessed sources are waiting.
tools: Read, Write, Edit, Glob, Grep
---

You process new sources. Follow the `second-brain-ingest` skill exactly.

You do not answer questions, restructure existing pages beyond adding links, or
delete anything. When a source is ambiguous, write what it says and note the
ambiguity on the page rather than resolving it yourself.

Die Zeile tools legt fest, welche Werkzeuge der Subagent bekommt. Write und Edit braucht nur der Ingestor. Die Beschreibung in description liest Claude Code, um zu entscheiden, wann es die Rolle einsetzt.

Linker

Der Linker findet Verbindungen zwischen bestehenden Seiten, die beim Import liegen geblieben sind. Er läuft nach Importen und wöchentlich. Er setzt Links, legt nichts an und schreibt nichts um. In seiner Datei steht deshalb tools: Read, Edit, Glob, Grep, ohne Write.

Die Trennung vom Ingestor hat einen Grund. Gutes Verlinken verlangt, breit über den ganzen Vault zu lesen. Der Ingestor liest dagegen eine Quelle genau.

Der Linker hat eine Regel: Jeder Link, den er setzt, muss einer sein, dem du zustimmst, wenn du beide Seiten nebeneinander liest. Ein Linker, der auf die Zahl der Links optimiert, verschlechtert den Graphen und wirkt dabei fleißig.

Reviewer

Der Reviewer liest nur. Er schreibt den regelmäßigen Rückblick: was sich geändert hat, wohin deine Aufmerksamkeit ging, was sich widerspricht und was du als Nächstes lesen solltest.

Das Nur-Lesen macht seinen Bericht verlässlich. Ein Reviewer mit Schreibrechten bessert unterwegs Kleinigkeiten aus. Sein Bericht beschreibt dann einen Vault, den es so nicht mehr gibt.

Researcher

Der Researcher liest nur. Er beantwortet Fragen aus dem Vault, nennt die Seiten, auf die er sich stützt, und sagt, was fehlt.

Mit dieser Rolle sprichst du am häufigsten. Sie braucht am dringendsten die Regel, nicht auf allgemeines Wissen auszuweichen. Diese Regel steht im Skill second-brain-query, mehr dazu im Kapitel Abfragen.

Graph-Analyst

Der Graph-Analyst liest nur. Einmal im Monat berechnet er die Kennzahlen, findet Hubs, Brücken und Cluster und erklärt, was die Zahlen für die Suche im Vault bedeuten. Die Kennzahlen kennst du aus Kennzahlen, die sich lohnen.

Er ist vom Linter getrennt, weil Analyse und Reparatur gegensätzliche Haltungen brauchen. Die eine soll alles bemerken, die andere so wenig wie möglich anfassen.

Kurator

Der Kurator liest nur. Einmal im Quartal schlägt er vor, was gekürzt, archiviert oder zusammengeführt werden kann.

Er macht ausschließlich Vorschläge. Löschen ist die eine Operation, die du nicht durch das Lesen eines Diffs rückgängig machen kannst. Deshalb bleibt sie eine Entscheidung von dir. Seine Datei sagt zusätzlich: Eine Seite, auf die fünf andere verlinken, ist nie ein Kandidat. Im Zweifel schlägt er Archivieren vor, denn Archiviertes kann zurückkommen.

Rollen ohne Nutzen

Drei Rollen liegen nahe und lohnen sich nach unserer Einschätzung nicht.

Ein Löscher. Löschen soll eine Entscheidung sein, die du triffst und die mit einem Eintrag ausgeführt wird. Der Kurator schlägt vor, du entscheidest.

Ein Zusammenfasser. Zusammenfassungen von Seiten, die selbst schon Zusammenfassungen sind, ergeben eine Schicht, die weniger stimmt als das, was darunter liegt. Gelesen wird dann trotzdem diese Schicht.

Ein Tagger. Ein Tag ist eine Entscheidung von fünf Sekunden, die der Ingestor mit vollem Kontext trifft. Ein eigener Durchlauf hat weniger Kontext und vergibt schlechtere Tags.

Welche Rolle übernimmt das?

Ordne jede Aufgabe der Rolle zu, die sie bekommt. Drei Aufgaben bekommen absichtlich keine eigene Rolle.

Noch offen (7)

Drei neue Artikel aus raw/ in Wiki-Seiten verwandeln
Beim Import einer Quelle die passenden Tags setzen
Nach einer Importwoche fehlende Links zwischen alten Seiten ergänzen
Vorschlagen, welche kalte Seite ins Archiv kann
Seiten löschen, die seit einem Jahr niemand geöffnet hat
Zu jeder Konzeptseite eine Kurzfassung schreiben
In einem eigenen Durchlauf alle Seiten nachtaggen

Ingestor (0)

Linker (0)

Kurator (0)

Keine eigene Rolle (0)

Übergaben

Die Rollen sprechen über den Vault miteinander. Der Ingestor trägt Lücken in index.md ein, also Seiten, auf die schon ein Link zeigt, die es aber noch nicht gibt. Der Linker liest diese Lücken. Der Ingestor protokolliert seinen Lauf in log.md, der Reviewer liest das Log.

Übergaben über Dateien: Jede Rolle schreibt und liest nur Dateien im Vault. Keine Rolle ruft eine andere auf.

Diese Form ist gewollt. Wenn Dateien die Schnittstelle sind, lässt sich jeder Lauf hinterher nachlesen. Eine Rolle lässt sich austauschen, ohne die anderen anzufassen.

Merksätze

Ein Agent für alles verwässert seine Anweisungen. Sechs Rollen mit engen Aufgaben decken einen Vault ab.
Nur Ingestor und Linker schreiben, und gerade sie haben die engsten Anweisungen. Reviewer, Researcher, Graph-Analyst und Kurator lesen nur.
Die Zeile tools in der Rollendatei legt fest, was eine Rolle verändern kann.
Löschen, Zusammenfassen und Taggen bekommen keine eigene Rolle.
Rollen übergeben über index.md und log.md. So bleibt jeder Lauf nachlesbar.

Prüf dich selbst

Denkfrage

Warum soll der Reviewer keine Schreibrechte haben, auch nicht für kleine Korrekturen?

Denkfrage

Dein Ingestor räumt beim Import gleich die Ordnerstruktur auf. Was ist daran das Problem?

Quellen

Create custom subagents · Anthropic, Stand: Nov. 2026
Rollendateien in .claude/agents/ mit name, description und tools.