KursinhaltModul 1 · Lektion 1
Wofür der Session Orchestrator da ist und was du brauchst
Du siehst, was das Plugin zu Claude Code hinzufügt, wo seine Grenzen liegen und was du für den Einstieg mitbringen musst.
MODUL 1 / EINSTIEG
Hinweis: Stand und Prüfgrundlage
Stand: session-orchestrator 5.20.0 vom 14. November 2026. Die Abläufe sind am Quelltext dieser Version geprüft, nicht in einer frischen Installation durchgespielt. Weicht dein Stand ab, gelten README und User Guide des Projekts (Repository mit README und Changelog).
Eine lange Unterhaltung mit Claude Code driftet
Wenn du mit Claude Code schon an echten Aufgaben gearbeitet hast, kennst du den Verlauf. Du beschreibst ein Feature, der Agent legt los, und nach vielen Nachrichten ist die Arbeit weit weg vom ersten Satz. Meist fehlt dann eines von diesen Dingen:
- Ein Plan. Welche Dateien gehören zur Aufgabe, was gilt als fertig? Das steht höchstens verstreut im Chatverlauf.
- Prüfungen zwischen den Schritten. Tests, Typecheck und Lint laufen am Ende oder gar nicht. Ein Fehler aus Schritt zwei fällt erst in Schritt acht auf.
- Ein Stand, der bleibt. Schließt du das Fenster, ist der Stand weg, und die nächste Unterhaltung beginnt bei null.
An diesen Stellen setzt das Plugin session-orchestrator an. Es ist ein kostenloses Open-Source-Plugin für Claude Code unter MIT-Lizenz. Claude Code bleibt dein Werkzeug, das Plugin legt einen festen Ablauf um deine Arbeit.
Der Ablauf in fünf Stationen
Du tippst drei Befehle, dazwischen arbeitet das Plugin. Einen solchen Durchlauf von /session bis /close nennt der Kurs eine Session.
Drei weitere Begriffe brauchst du ab hier. Eine Welle ist eine Runde, in der mehrere Agenten gleichzeitig arbeiten, jeder mit seiner eigenen Dateiliste. Ein Gate ist eine Prüfung, über die allein der Exit-Code eines Kommandos entscheidet, also die Zahl, die ein Programm beim Beenden zurückgibt. 0 heißt bestanden, jeder andere Wert durchgefallen. Das Full Gate ist die große Prüfung aus Typecheck, Tests, Lint und einer Suche nach liegengebliebenen Debug-Resten.
Die Stationen im Einzelnen:
/sessionliest den Zustand deines Repos und schlägt einen Schwerpunkt vor. Ohne deine Bestätigung entsteht kein Plan.- Der Plan listet je Welle die Agenten, ihre Dateien und die Akzeptanzkriterien. Er endet mit der Aufforderung,
/gozu tippen. /goführt den Plan aus. Neu geplant wird dabei nicht.- Nach den Implementierungswellen laufen Tests und Typecheck als Gate. Nach der Quality-Welle läuft das Full Gate.
/closeist der Abschluss. Das Plugin gleicht das Ergebnis mit dem Plan ab, lässt noch einmal das Full Gate laufen, committet und schreibt einen Abschlussbericht mit den Entscheidungen, die bei dir liegen.
Wo das Plugin aufhört
- Es braucht kein Konto und keinen Server. Die Arbeit läuft auf deinem Rechner.
- Laut README ändert es keinen Code ohne deine Zustimmung.
- Es ist keine Sandbox. Die eingebauten Schutzmechanismen, etwa die Liste erlaubter Pfade je Welle, beschreibt die Projektdoku als "an accident guard for a cooperating agent, not a containment boundary". Das ist ein Unfallschutz für einen Agenten, der mitspielt, und keine Sicherheitsgrenze. Behandle dein Repo und deine Zugangsdaten so, als gäbe es diesen Schutz nicht.
- Es ist unabhängig von Anthropic. Das Projekt beschreibt seine Pflege als "best-effort maintenance and no SLA", also nach bestem Bemühen und ohne zugesagte Verfügbarkeit.
- Zur Last auf deinem Claude-Tarif macht die Doku keine Aussage. Das Plugin misst Token-Summen in einer Logdatei, mehr dazu in Lektion 5.
Die Skills des Plugins laufen auch in Codex, Cursor und Pi. Dort unterscheiden sich die Hooks, also die Skripte, die bei bestimmten Aktionen automatisch mitlaufen. Der Kurs bleibt bei Claude Code.
Was du mitbringen musst
- Node.js ab Version 24.
- Git. Das Repository für den Kurs legst du in Lektion 2 an.
- Claude Code. Eine Mindestversion nennt die Doku nicht.
- Optional:
glabodergh, die Kommandozeilen von GitLab und GitHub. Das Plugin nutzt sie für Issues und Merge Requests auf der jeweiligen Plattform. Der Kurs richtet sie nicht ein. Lektion 3 zeigt, was ohne sie passiert.
Ein Update-Check fragt bei npm nach neuen Versionen, du kannst ihn abschalten. Telemetrie ist laut Doku aus, bis du zustimmst. Wann danach gefragt wird, steht in Lektion 3.
Was der Kurs zur Projektdoku dazugibt
Die Projektdoku ist ein englisches Nachschlagewerk. Der Kurs ergänzt sie an vier Stellen:
- Die Doku erklärt Befehle und Optionen. Der Kurs gibt dir eine Übungsaufgabe mit prüfbarem Ergebnis.
- Die Doku beschreibt, was jede Welle tut. Der Kurs zeigt typische Fehlschläge und was du dann tust.
- Die Doku führt alle Config-Schlüssel auf. Der Kurs nennt die drei Einstellungen, die am ersten Tag zählen.
- Die Doku ist englisch. Der Kurs ist deutsch und baut Lektion für Lektion aufeinander auf.
An einigen Stellen widersprechen sich die Dokumente des Projekts selbst, etwa beim Standardtyp einer Session. Dort legt sich der Kurs nicht fest. Den Sessiontyp gibst du deshalb im ganzen Kurs immer ausdrücklich an, dann hängt nichts von einem Standardwert ab.
Antwortet ein Befehl bei dir anders als hier beschrieben, liegt das wahrscheinlich an einer neueren Version. Was sich geändert hat, steht im Changelog des Projekts.
Probe
Du kannst weiter zu Lektion 2, wenn das stimmt:
node --versionzeigtv24oder eine höhere Hauptversion.git --versionundclaude --versionantworten jeweils mit einer Versionsnummer.- Du schreibst die fünf Stationen aus dem Diagramm aus dem Gedächtnis auf und markierst die Stellen, an denen du entscheidest. Vergleiche dann mit dem Text oben: Du bestätigst den Schwerpunkt bei
/session, du gibst den Plan mit/gofrei, und du liest die offenen Entscheidungen im Abschlussbericht von/close.
Wissenscheck