Werkzeugkasten · Agentenwerk

Schnellstart

Entpack das ZIP in deinen Home-Ordner. Die Befehle in den Lektionen gehen von ~/werkzeugkasten aus.

cd ~/Downloads && unzip werkzeugkasten.zip -d ~

werkzeugkasten/
  LIESMICH.md            Schnellstart, dieselben Schritte wie auf dieser Seite
  vault-template/        Start-Vault auf Deutsch: CLAUDE.md, Ordner, Seitenvorlagen
  skills/                18 Skills für das Praxisprojekt Second Brain
  commands/              72 Slash-Commands
  agents/                6 Subagents
  hooks/                 Prüf-Hook für das Frontmatter und seine settings.json
  scripts/               Python-Skripte ohne Abhängigkeiten
  plugins/agents-course/ das Kursplugin
  .claude-plugin/        macht den Ordner zum Plugin-Marktplatz „agentenwerk“
  handbuch/              der Code aus den Bau-Lektionen der Handbücher

Skills, Befehle und Subagents sind auf Englisch formuliert, weil Modelle englische Anweisungen nach unserer Einschätzung am zuverlässigsten befolgen. Die CLAUDE.md im Start-Vault legt fest, dass der Agent auf Deutsch schreibt.

Das Kursplugin

Das Plugin agents-course bringt die Praxis-Lektionen der Kursmodule 1 bis 5 als Skills in jedes Repository. Der Ordner werkzeugkasten ist zugleich ein Plugin-Marktplatz:

claude plugin marketplace add ~/werkzeugkasten
claude plugin install agents-course@agentenwerk

Werkzeug	Aufruf	Was es tut	Lektion
Kontext-Audit	`/agents-course:context-audit`	Misst die vier Orte, findet Cache-Killer und aufgeblähte Kontextfenster.	Kontext in der Praxis
Zieltest	`/agents-course:goal-test`	Macht aus einer Aufgabe ein prüfbares Ziel und erzeugt Skript und begrenzte Schleife.	Loop in der Praxis
Gate-Check	`/agents-course:gate-check`	Findet Entscheidungen, die kein großes Modell brauchen, und schlägt Gates vor, die im Zweifel schließen.	Gate in der Praxis
Harness-Audit	`/agents-course:harness-audit`	Geht die vier Ringe durch, benennt den Schadensradius und ordnet die Härtung.	Harness in der Praxis
Evals-Start	`/agents-course:evals-bootstrap`	Macht aus echten Fehlern Testfälle und erzeugt den Trace-Prüfer.	Evals in der Praxis
Loop-Kritiker	`Subagent agents-course:loop-critic`	Prüft das Ergebnis einer Schleife in frischem Kontext gegen das Ziel.	Die vier Teile eines Loops

Die Skills sind einfache SKILL.md-Dateien. Sie laufen auch, wenn du sie nach ~/.claude/skills/ kopierst.

Second Brain einrichten

Der Start-Vault, die Skills, Befehle, Subagents, der Hook und die Skripte gehören zum Praxisprojekt. Sie kommen in den Vault, damit sie mit deinen Notizen versioniert werden:

cp -r ~/werkzeugkasten/vault-template ~/brain
mkdir -p ~/brain/.claude
cp -r ~/werkzeugkasten/skills   ~/brain/.claude/skills
cp -r ~/werkzeugkasten/commands ~/brain/.claude/commands
cp -r ~/werkzeugkasten/agents   ~/brain/.claude/agents
cp -r ~/werkzeugkasten/hooks    ~/brain/.claude/hooks
cp ~/werkzeugkasten/hooks/settings.json ~/brain/.claude/settings.json
cp -r ~/werkzeugkasten/scripts  ~/brain/scripts
cd ~/brain && claude

Hast du schon eine .claude/settings.json, überschreib sie nicht. Übernimm den Eintraghooks aus hooks/settings.json von Hand oder ruf im Vault /install auf. Die einzelnen Schritte erklärt Obsidian und der erste Vault. Unter Windows heißt der Befehl python.

Der Start-Vault

vault-template/ enthält die Ordner raw/, wiki/ mit Index und Log,output/, projects/ mit einem Beispielprojekt und vier Seitenvorlagen intemplates/. Die CLAUDE.md regelt Sprache, Ordner, Seitenverträge, Namen, Verlinkung, Widersprüche, Stil und Log. Wie du sie an deine Arbeitsweise anpasst, steht inDeine CLAUDE.md.

Skills

Jeder Skill beschreibt einen Arbeitsablauf. Zwei tragen das System: second-brain-ingest mit der Regel zum Verlinken und second-brain-query mit der Regel zum Belegen. Wie Skills und Befehle zusammenhängen, erklärt Skills und Befehle.

Skill	Was er tut
`second-brain-ingest`	Eine Quelle einarbeiten: Quellenseite, Konzepte, Entitäten, Links, Index und Log.
`second-brain-query`	Fragen nur aus dem Vault beantworten, jede Aussage mit Seite belegt.
`second-brain-backfill`	Einen alten Bestand in kontrollierten Portionen nachladen.
`second-brain-chat-import`	Einen Chat-Verlauf sichten: einarbeiten, nur ablegen oder verwerfen.
`second-brain-transcript`	Ein Transkript von Video, Podcast oder Sprachnotiz bereinigen.
`second-brain-lint`	Den Vault prüfen und mechanische Fehler reparieren.
`second-brain-merge`	Doppelte Seiten zusammenführen, Links umbiegen.
`second-brain-rename`	Eine Seite umbenennen: Datei, Titel, Alias, alle Links, Log.
`second-brain-graph`	Den Graphen analysieren: Hubs, Brücken, Inseln, Waisen.
`second-brain-metrics`	Kennzahlen mit Datum festhalten und den Verlauf zeigen.
`second-brain-review`	Rückblick: was der Vault gelernt hat und was hakt.
`second-brain-changed-my-mind`	Nachzeichnen, wo sich eine Position geändert hat.
`second-brain-write`	Aus den eigenen Seiten schreiben, mit Belegen.
`second-brain-report`	Einen Recherchebericht aus dem Vault schreiben.
`second-brain-quiz`	Dich mit Fragen aus deinen eigenen Seiten abfragen.
`second-brain-publish`	Prüfen, was sich veröffentlichen lässt.
`second-brain-privacy`	Prüfen, was nicht in den Vault gehört.
`second-brain-project`	Ein Projekt mit eigener CLAUDE.md und Pipeline anlegen.

Befehle

Jeder Befehl ist eine kurze Datei, die einen Skill aufruft und den Umfang festlegt. Die meisten nehmen ein optionales Argument. Ohne Argument nehmen sie das Ganze: /lint prüft den ganzen Vault,/ingest nimmt alles, was in raw/ wartet.

Import · Modul 3: Import

Befehl	Was er tut
`/ingest`	Neues Material aus raw/ ins Wiki einarbeiten
`/ingest-url`	Eine Webseite speichern und einarbeiten
`/ingest-youtube`	Transkript eines Videos oder Podcasts einarbeiten
`/ingest-pdf`	Ein PDF einarbeiten
`/ingest-paper`	Ein wissenschaftliches Paper einarbeiten
`/ingest-chats`	Einen exportierten Chat-Verlauf importieren
`/ingest-voice`	Eine Sprachnotiz einarbeiten
`/ingest-newsletter`	Newsletter ohne Dubletten einarbeiten
`/ingest-highlights`	Markierungen aus Büchern oder Artikeln einarbeiten
`/backfill`	Ein Archiv in Portionen nachladen

Strukturieren · Modul 4: Strukturieren

Befehl	Was er tut
`/link`	Fehlende Verbindungen finden und setzen
`/dedupe`	Fast gleiche Seiten finden
`/merge`	Zwei Seiten zusammenführen
`/vault-rename`	Eine Seite umbenennen und jeden Link anpassen
`/split`	Eine überladene Seite teilen
`/retype`	Den Typ einer Seite korrigieren
`/schema`	Frontmatter gegen das Schema prüfen
`/tags`	Das Tag-Vokabular prüfen
`/aliases`	Fehlende Aliase finden
`/contradictions`	Offene Widersprüche auflisten
`/index`	Den Index neu aufbauen

Graph · Modul 5: Graphen

Befehl	Was er tut
`/graph`	Die Form des Graphen beschreiben
`/graph-export`	Den Graphen für Analysen außerhalb exportieren
`/orphans`	Unerreichbare Seiten finden
`/hubs`	Seiten finden, die den Graphen an sich ziehen
`/bridges`	Seiten finden, die den Graphen zusammenhalten
`/clusters`	Zeigen, worum es im Vault tatsächlich geht
`/typed-links`	Beziehungstypen setzen, wo sie zählen
`/stale`	Konzeptseiten finden, die lange niemand angefasst hat

Abfragen · Modul 7: Abfragen

Befehl	Was er tut
`/ask`	Eine Frage nur aus dem Vault beantworten
`/know`	Was weiß ich über ein Thema
`/connect`	Den Weg zwischen zwei Ideen finden
`/compare`	Zwei Dinge aus den eigenen Quellen vergleichen
`/sources`	Zeigen, worauf eine Aussage beruht
`/gaps`	Was in meinem Verständnis fehlt
`/contradicts`	Gegen meine Position argumentieren
`/timeline`	Wie sich meine Quellen über die Zeit entwickelt haben
`/trace`	Zeigen, welche Seiten eine Antwort genutzt hat
`/changed-my-mind`	Was ich revidiert habe

Pflege · Modul 9: Pflege

Befehl	Was er tut
`/lint`	Struktur prüfen und Mechanisches reparieren
`/health`	Schneller Gesundheitscheck
`/metrics`	Kennzahlen mit Datum festhalten
`/vault-review`	Rückblick: was der Vault gelernt hat
`/weekly`	Der Wochenrückblick
`/monthly`	Der Monatsrückblick zur Struktur
`/prune`	Finden, was sicher weg kann
`/archive`	Kaltes Material aus dem Wiki nach archive/ verschieben
`/commit`	Den Stand mit einer brauchbaren Nachricht committen

Ergebnisse · Modul 8: Ergebnisse

Befehl	Was er tut
`/outline`	Eine Gliederung aus den Konzeptseiten
`/draft`	Einen Entwurf aus dem Vault schreiben
`/report`	Einen Recherchebericht schreiben
`/publish`	Prüfen, was sich veröffentlichen lässt
`/vault-export`	Eine Seite oder eine Gruppe von Seiten exportieren
`/quiz`	Dich mit den eigenen Seiten abfragen
`/explain`	Erklären lassen und die Lücken finden
`/ingest-mine`	Die eigenen fertigen Texte einarbeiten

Projekte · Projekte abgrenzen

Befehl	Was er tut
`/project`	Ein Projekt anlegen
`/project-status`	Wo ein Projekt steht
`/decisions`	Getroffene Entscheidungen auflisten
`/commitments`	Offene Zusagen auflisten
`/handoff`	Eine Übergabe vorbereiten
`/scope`	Wissen aus dem Vault in ein Projekt holen

Sicherheit · Leitplanken

Befehl	Was er tut
`/privacy`	Prüfen, was nicht in den Vault gehört
`/secrets`	Nach Zugangsdaten suchen
`/dry-run`	Einen Lauf ohne Schreiben durchspielen
`/rollback`	Den letzten Lauf rückgängig machen
`/audit`	Prüfen, was ein Agent getan hat

Einrichtung · Modul 2: Einrichtung

Befehl	Was er tut
`/vault-init`	Einen neuen Vault anlegen
`/claude-md`	Die CLAUDE.md aufbauen oder aktualisieren
`/install`	Skills, Befehle, Subagents und Hook installieren
`/vault-doctor`	Prüfen, ob die Einrichtung funktioniert
`/vault-schedule`	Geplante Pflegeläufe einrichten

Subagents

Vier der sechs Rollen lesen nur. Ein misslungener Recherche- oder Analyselauf kann den Vault so nicht beschädigen, und jede inhaltliche Änderung in der Git-Historie geht auf einen Import oder einen Linkdurchgang zurück. Mehr in Agentenrollen.

Subagent	Schreibt	Läuft
`ingestor`	ja	wenn Material in raw/ landet
`linker`	nur Links	nach Importen oder wöchentlich
`reviewer`	nein	wöchentlich
`researcher`	nein	bei Bedarf
`graph-analyst`	nein	monatlich oder wenn die Navigation schwer wird
`curator`	nein	vierteljährlich

Skripte und Hook

Die Skripte brauchen nur Python 3 ohne weitere Pakete. Die drei Prüfskripte zählen gleich: index.mdund log.md gelten als Navigation, ein Link auf einen Alias löst wie in Obsidian nicht auf und wird mit der passenden Schreibweise gemeldet, archive/ bleibt außen vor.

Datei	Was sie tut	Lektion
`scripts/link_check.py`	Kaputte Links, Links auf Aliase, Waisen und Stummel.	Den Vault linten
`scripts/vault_stats.py`	Seiten nach Typ, Links pro Seite, Waisenquote, meistverlinkte Seiten.	Verlinkungsregeln
`scripts/graph_export.py`	Den Linkgraphen als CSV oder GraphML exportieren.	Den Graphen exportieren
`scripts/chat_export_to_md.py`	Exporte von Claude und ChatGPT in eine Datei pro Gespräch umwandeln.	Chat-Exporte
`scripts/publish.py`	Nur Seiten mit publish: true in einen Ordner außerhalb des Vaults kopieren.	Veröffentlichen und exportieren
`hooks/check_frontmatter.py`	Blockt eine Wiki-Seite ohne Frontmatter, bevor sie geschrieben wird.	Hooks

Code der Handbücher

Die Bau-Lektionen der Handbücher zeigen ihren Code vollständig. Im Ordner handbuch/ liegt derselbe Code als Dateien, damit du ihn nicht abtippen musst.

Ordner	Inhalt
`handbuch/wissensgraphen/`	Extraktions- und Prüf-Prompt, Graph-Abfrage
`handbuch/gates/`	Entscheidungs-Endpunkt, Router, Jev-Tausch mit Schattenbetrieb und Bericht
`handbuch/harness/`	Agent-Schleife und Leitplanken in rund 190 Zeilen
`handbuch/loop-engineering/`	Zieltest-Schleife, Kritiker-Schleife, Nachtlauf
`handbuch/eval-engineering/`	Demo-Produkt, Trace-Sammler, Eval-Suite, Kalibrierung, CI-Gate

Lizenz

Teile des Werkzeugkastens beruhen auf Material unter der MIT-Lizenz. Der Lizenztext liegt alsLIZENZ.txt im ZIP und steht auf der Seite Lizenz.