Tag 1 · ca. 150 Minuten (zwei Blöcke)
Benennen · einordnen · abgrenzen. Bauen kommt an Tag 2 und 3.
Dauerwissen, immer im Kontext
Wissen, das nur bei Bedarf lädt
Abrufbares Verfahren mit Anleitung
Der Unterschied, der am meisten verwirrt
Arbeit in fremdem Kontext
Deterministische Automatik
Wie geantwortet wird
Anschluss an fremde Systeme
Das teilbare Bündel
Alle Primitive beantworten genau eine von vier Fragen. Wer die Frage kennt, findet das Werkzeug — nicht umgekehrt.
CLAUDE.md, Rules — Wissen, das die Session überlebt.
Skills, Commands — wiederholbare Verfahren auf Abruf.
Subagents, Hooks, Output Styles — Ausführung, Automatik, Form.
MCP, Plugins — fremde Systeme und teilbare Bündel.
cgsit-finance: CLAUDE.md im
Repo-Wurzelverzeichnis, .mcp.json daneben, sowie
.claude/settings.json, .claude/settings.local.json,
.claude/rules/ (9 Dateien), .claude/skills/ (11 Skills,
je SKILL.md), .claude/commands/ (4 Dateien),
.claude/agents/ (3 Dateien). — geprüft am 2026-07-21
Eine Markdown-Datei im Repo, die bei jedem Start automatisch in den Kontext geladen wird. Das Onboarding-Dokument für den neuen Kollegen aus Modul 1 — nur dass er es jeden Morgen neu liest.
Build- und Testbefehle, Architekturüberblick, verbindliche Konventionen, Workflow-Regeln, Verweise auf tiefere Doku.
Alles, was nur selten gebraucht wird. Jede Zeile kostet in jeder Session Tokens — auch in denen, in denen sie niemanden interessiert.
Regeldateien, die nicht immer geladen sind, sondern nur dann, wenn die Arbeit sie betrifft — typischerweise gesteuert über Datei-Muster im Kopf der Regeldatei.
| Regeldatei (Beispiel) | lädt bei | Inhalt |
|---|---|---|
java-conventions.md | **/*.java | Sprach- und Stilkonventionen |
migration-safety.md | **/db/migration/**/V*.sql | Regeln für riskante DB-Migrationen |
money-fx.md | **/*Fx*.java, **/Currency*.java, … | Geld-, Rundungs- und Währungsinvarianten |
cgsit-finance: 9 Dateien unter .claude/rules/, jede mit
einem globs:-Eintrag im YAML-Frontmatter (Liste von Glob-Mustern).
Die Zuordnung Datei → Globs ist zusätzlich in der
CLAUDE.md tabelliert. — geprüft am 2026-07-21
Ein Skill ist ein dokumentiertes Verfahren in einem eigenen Ordner: eine Beschreibung, wofür er da ist, plus die Anleitung, wie das Verfahren abläuft. Er liegt bereit — und wird geladen, wenn er gebraucht wird.
Wofür ist der Skill da? Daran erkennt der Agent, ob er passt.
Die eigentlichen Schritte — so ausführlich wie nötig, ohne Kontextkosten im Normalfall.
Ein Skill kann einschränken, womit er arbeiten darf.
cgsit-finance: Skills liegen als
.claude/skills/<name>/SKILL.md mit YAML-Frontmatter; verwendete
Schlüssel dort u. a. name, description,
allowed-tools, argument-hint, user-invocable.
Beispiel-Skills: rfcs, test, commit,
architecture-reviewer. — geprüft am 2026-07-21
Ich rufe etwas auf. Eine Textdatei, die ich per Schrägstrich-Aufruf als Prompt einsetze.
Immer von mir gestartet, nie vom Agenten. Kurz, ein Zweck, keine Auswahllogik.
Denkmodell: Tastenkürzel für einen Prompt.
Der Agent greift zu. Ein Verfahren mit Beschreibung, das der Agent selbst wählen kann — oder das ich anstoße.
Umfangreicher, mehrstufig, mit Regeln und Grenzen.
Denkmodell: Handbuch im Regal, mit Aufschrift auf dem Rücken.
Ein Subagent bearbeitet eine abgegrenzte Aufgabe in einem eigenen Kontext und liefert nur das Ergebnis zurück. Der ganze Suchlärm bleibt draußen.
Recherche, Testläufe mit viel Ausgabe, unabhängige Reviews, mehrere Perspektiven auf dieselbe Änderung.
Aufgaben, bei denen man den Weg mitlesen will — und alles, was den gesamten Gesprächsverlauf braucht. Der Subagent kennt ihn nicht.
cgsit-finance: drei Subagent-Definitionen unter
.claude/agents/ — researcher,
code-reviewer, test-engineer. Der
test-Skill lässt die Testausgabe bewusst im Subagenten laufen,
damit sie nicht in den Hauptkontext gerät. — geprüft am 2026-07-21
Ein Hook ist ein Programm, das an definierten Punkten des Ablaufs ausgeführt wird — vor oder nach einer Werkzeugnutzung. Es läuft immer, unabhängig davon, was das Modell gerade für richtig hält.
Formatieren, Linten, verbotene Muster abfangen, Nachweise erzwingen, gefährliche Befehle stoppen.
Alles, was ein Urteil erfordert. Ein Hook prüft, dass etwas da ist — nicht, ob es gut ist. Und: jeder Fehlalarm erzieht zum Ignorieren.
cgsit-finance hängen die Freigabe-Gates eines Planungsdokuments
an Disziplin: Status auf „Accepted" setzen darf nur, wer den Review auch
dokumentiert hat. Disziplin ist beim nicht-deterministischen Agenten keine
Zusicherung.
Lehre: Aus der Bitte wurde ein Prüfprogramm, das nach jeder
Dateiänderung läuft und ein fehlendes Nachweis-Artefakt zurückmeldet.
cgsit-finance/.claude/settings.json: unter
hooks registrierte Ereignisse PreToolUse
(matcher Bash) und PostToolUse
(matcher Edit|Write|MultiEdit), jeweils als Kommando
python3 "$CLAUDE_PROJECT_DIR/scripts/claude-hooks/<datei>.py".
Vorhandene Hook-Skripte: rfc-gate-guardrails.py,
postedit-guardrails.py, block-prod-compose-down.py,
block-parallel-docker-build.py.permissions.deny mit u. a.
Bash(git push --force *), Bash(git reset --hard*),
Bash(*DROP DATABASE*), Bash(aws rds delete-db-instance*).
— geprüft am 2026-07-21
Steuert, wie geantwortet wird, nicht was getan wird: Ausführlichkeit, Tonfall, Aufbau der Ausgabe.
Konsistente Darstellung über ein Team hinweg. Knappe Antworten für Geübte, erklärende Antworten für Einarbeitung und Lehre.
Fachliche Regeln, Verfahren oder Sicherheitsvorgaben. Wer Inhalt über den Stil steuern will, hat das falsche Werkzeug in der Hand.
Ein offenes Protokoll, über das ein Agent Werkzeuge und Daten außerhalb der Codebasis erreicht: Ticketsystem, Datenbank, Dokumentation, interne Dienste. Ein Server stellt bereit, der Client nutzt.
Systeme, für die es keine brauchbare Kommandozeile gibt — oder wo eine strukturierte Schnittstelle deutlich verlässlicher ist als Textausgabe.
Alles, was ein vorhandenes CLI schon kann. Jeder angebundene Server legt seine Werkzeugbeschreibungen in jeden Kontext — Modul 1 lässt grüßen.
cgsit-finance: eine .mcp.json im Repo-Wurzelverzeichnis
mit dem Schlüssel mcpServers und genau einem Eintrag
(Angular-Werkzeugserver, gestartet über npx). Ein Server, weil er
etwas kann, was die Kommandozeile dort nicht bietet. — geprüft am 2026-07-21
Ein Plugin verpackt mehrere Primitive — Skills, Commands, Agents, Hooks, MCP-Anbindung — zu einer installierbaren Einheit und macht sie über Repo-Grenzen hinweg verteilbar.
Was zusammengehört, wird gemeinsam installiert und gemeinsam versioniert.
Andere Teams bekommen den Arbeitsstand, ohne Dateien abzuschreiben.
Das Bündel wird gepflegt wie eine interne Bibliothek — mit Reviews und Releases.
| Ich will… | Werkzeug | weil… |
|---|---|---|
| …dass er unsere Build- und Testbefehle immer kennt | CLAUDE.md | gilt in jeder Session, ohne Auslöser |
| …Konventionen nur beim Anfassen bestimmter Dateien | Rule | lädt gezielt, spart Kontext |
| …ein mehrstufiges Verfahren, das er selbst erkennt | Skill | Beschreibung macht ihn auffindbar |
| …einen Prompt, den ich täglich selbst auslöse | Command | ich bin der Auslöser, immer |
| …Recherche oder Testlauf ohne Kontextmüll | Subagent | eigener Kontext, nur Ergebnis kommt zurück |
| …eine Garantie, dass etwas passiert | Hook | Code statt Bitte — deterministisch |
| …dass ein Befehl nie ausgeführt wird | Permissions (deny) | harte Grenze vor der Ausführung |
| …knappere oder erklärendere Antworten | Output Style | betrifft die Form, nicht die Sache |
| …Zugriff auf ein System außerhalb des Repos | MCP | strukturierte Schnittstelle statt Textparsen |
| …all das an andere Teams weitergeben | Plugin | ein Bündel, versioniert und installierbar |
| Primitiv | Vertiefung | Dort geht es um… |
|---|---|---|
| CLAUDE.md | Modul 7 | Aufbau, Umfang, Pitfalls, agent-ready Codebase |
| Subagents | Modul 5 | Parallel Agent Development, Review-Loops |
| Skills, Rules, Commands, Hooks | Modul 8 | selbst bauen, pro Workflow-Phase |
| MCP | Modul 8 | Server, Tools, Resources — und MCP vs. CLI |
| Permissions & Grenzen | Modul 9 | Blast Radius, Security-Gates in der CI |
| Plugins | Modul 10 | Team-Asset, Versionierung, Konsolidierung |
Ordnet jedem der folgenden Szenarien genau ein Primitiv zu und schreibt einen Satz Begründung dazu:
(a) Jeder Agent soll wissen, wie unser Projekt gebaut und getestet wird · (b) Vor jedem Commit soll garantiert formatiert werden · (c) Beim Bearbeiten von SQL-Migrationen gelten Sonderregeln · (d) Unser Release-Ablauf hat zwölf Schritte, die niemand auswendig kann · (e) Ich starte jeden Morgen dieselbe Statusabfrage · (f) Eine Bibliotheksrecherche soll den Hauptkontext nicht zumüllen · (g) Der Agent soll unser Ticketsystem lesen können · (h) Ein zweites Team will unseren kompletten Arbeitsstand übernehmen
Dauer ca. 20 Minuten · Partnerarbeit, danach 10 Minuten Auflösung im Plenum
Alle Rechte vorbehalten
Diese Schulungsunterlagen sind urheberrechtlich geschützt. Vervielfältigung, Weitergabe oder kommerzielle Nutzung — auch in Auszügen — nur mit ausdrücklicher schriftlicher Genehmigung der CGS IT Solutions GmbH.
cgsit-claude-training · Modul 2 · v0.1.0