Zum Inhalt springen
Bernhard GötzendorferAutomatisierung mit KI, die allein läuft · Wien
UnterbauHinter den Kulissen

Die Lead-Session übernimmt die Nachtschicht

Eine Lead-Session koordiniert meine parallelen Coding-Sessions mit Leases, Auflagen und einer Merge-Reihenfolge. Offene Fragen landen gesammelt bei mir.

TL;DR

Am 7. Oktober um 19:53 gebe ich einer Lead-Session die Nacht. Sie koordiniert meine Coding-Sessions mit einer Lease, Auflagen und einem Zug für die Merges. Um 06:30 hält der Zug, um 07:03 übergibt sie an die nächste Lead-Session. Was schiefging, steht im Bericht gleich neben dem, was lief. Das Werkzeug liegt inzwischen als lead-session-orchestrator auf npm.

Nachtschicht ab 19:53

Es ist der 7. Oktober, 19:53. Eine frische Lead-Session hat gerade von ihrer Vorgängerin übernommen. Ich schreibe ihr einen kurzen Auftrag. Sie soll „alles übernehmen“ und „Tempo in alle Projekte“ bringen. Der letzte Punkt lautet: „Nachtschicht übernehmen“.

Die Lead-Session ist eine Claude-Code-Session mit einer eigenen Rolle. Den Code schreiben andere Sessions und kopflose Läufe in meinen Repos. Sie hält den Überblick, ordnet die Merges und sammelt, was ich entscheiden muss. Gebaut habe ich dafür den Navigator. Wie er tagsüber mit Sven und session-orchestrator zusammenspielt, steht in Vom iPhone zur Coding-Session.

Kurz vor zehn schicke ich noch einen Nachtrag. Die Oberfläche von FotoDrop, meinem Familienalbum, soll rasch aufpoliert werden. Ab dann soll die Lead-Session ohne mich auskommen.

Am Morgen will ich zwei Dinge sehen. Was gelaufen ist, mit Beleg. Und was nur ich entscheiden kann, gesammelt an einer Stelle.

Dafür braucht es keinen klügeren Agent. Es braucht einen, der ohne Regel nichts darf.

Wer führt, hält eine Lease

Bevor eine Lead-Session etwas startet, braucht sie eine Lease. Das ist ihr Anspruch auf die Rolle. Es gibt immer nur einen Lead. Die Lease wird erworben, regelmäßig erneuert, übergeben und am Ende freigegeben. Ohne gültige eigene Lease startet ein Lead nichts und gibt kein Zeichen für einen Merge.

Damit kann es nie zwei Leads geben, die einander widersprechen. Bleibt nach einem Absturz eine verwaiste Sperre zurück, lässt sie sich gezielt entfernen.

Die anderen Sessions melden sich beim Start an. Dafür schreiben sie einen Check-in. Zurück bekommen sie Auflagen. Darin steht, wie in ihrem Repo gemergt wird und welche Pipeline zählt. Außerdem, was in der Flotte gerade Vorrang hat und wo sie einer anderen Session in die Quere kommen.

Kommt keine Auflage, wartet keine Session ewig. Nach zehn Minuten arbeitet sie mit vorsichtigen Standardwerten weiter. Lead und Sessions reden nur über Dateien miteinander. Niemand blockiert, weil er auf die Nachricht eines anderen wartet.

Eine Nachricht einer anderen Session ist dabei nie eine Freigabe. Die kommt aus meinem Auftrag oder aus einer signierten Autoritätsdatei. Die legt pro Repository fest, welche Aktionen frei sind, welche jedes Mal mich brauchen und welche nie passieren. Was dort nicht ausdrücklich erlaubt ist, gilt als nicht erlaubt.

Der Zug fährt nach Regeln, nicht nach Nachfragen

In dieser Nacht läuft der Zug. So nenne ich die Reihenfolge, in der Merge Requests nach main gehen. Eine Session ist fertig und schickt ihre Ansage: Merge Request, Head-SHA, Pipeline und Diff. Der Lead prüft und gibt sein Zeichen. Erst dann wird gemergt.

Für diese Nacht gelten vier Regeln. Vor jedem Zeichen muss der Branch den aktuellen Stand von main enthalten. Zieht eine Session einen Konflikt nach, kommt danach ein neues Review. Vor dem nächsten Zeichen wird die Produktion zurückgelesen. Und um 06:30 hält der Zug.

Niemand muss also nachts fragen, ob er darf. Die Regeln beantworten das vorher. Eine Session aus einem Website-Audit für BuchhaltGenie brachte so fünf Merge Requests nacheinander in Produktion. Jeder davon wurde danach per Health-Check nachgemessen. Ab Mitte der Nacht legte diese Session jeden Review-Bericht als Datei ab.

Vor jedem Merge in Produktion soll ein Review mit Opus laufen. Das hat in dieser Nacht echte Fehler gefangen. Ein Merge Request im Navigator selbst hätte Laufdaten still gelöscht. Bei FotoDrop hätte ein einzelner Ladefehler die ganze Zeitleiste gekippt. Und eine Fehlergrenze hätte Render-Fehler verschluckt, ohne sie an Sentry zu melden.

Auch das Vorsichtsprinzip hielt. Ein Push ohne Pre-Push-Prüfung wurde abgelehnt. Eine Runde, die nichts messen konnte, hat auch nichts geschrieben.

Am Morgen ist die neue Oberfläche von FotoDrop live. Der Health-Check meldet denselben Commit wie main.

Was über Nacht schiefging

Im Bericht vom Morgen steht auch, was nicht lief. Ich lese diesen Teil zuerst.

Um 23:02 endet die Schleife, die die Lease des Leads erneuert. Sie läuft in ein Timeout, mitten in einer Speicherkrise auf meinem Mac. Zwei Stunden und zwanzig Minuten lang läuft die Erneuerung nicht. Läuft die Lease ab, darf der Lead nichts mehr starten. Daraus wurde ein Issue: Nach einem Timeout soll die Schleife neu anlaufen.

Der Lead selbst lag auch mehrmals daneben. Einen Befund aus einem Audit las er falsch. Gemeint war, eine Nummer zu streichen, er gab „ergänzen“ weiter. Die Lehre steht jetzt im Bericht: Befundtexte wörtlich lesen, nicht nacherzählen.

Ein anderes Mal vermutete er, ein Test sei gewachsen. Die Session hat nachgemessen: 1,3 Sekunden lokal.

Auch das Review war nicht unfehlbar. Es meldete, an einer Stelle fehle ein Alarm. Der Aufrufer meldete den Fehler aber längst. Der Fix dazu wurde verworfen.

Zweimal kam eine Ansage nur mit einer Selbstprüfung oder einem Erstreview durch ein anderes Modell. Die Reviews mit Opus wurden nachgeholt. Die Lehre für die nächsten Nächte: Das Erstreview mit Opus gehört vor jede Ansage für Produktion.

Neue Issues im Navigator halten die Lehren fest, die Code oder Regeln brauchen. Erledigt sind sie damit noch nicht.

Übergabe um sieben

Um 07:03 übergibt die Lead-Session an die nächste. Die Übergabe ist eine Datei mit dem Stand und den offenen Fäden.

So eine Datei ist ein Entwurf, noch kein Wechsel. In dieser Nacht galt noch: Das Mandat wechselt erst, wenn ich es in der abgebenden Session bestätige. Die übernehmende Session nennt dafür meinen Wortlaut. Seit dem 19. Oktober bestätige ich geplante Wechsel einmal im Voraus. Selbst ernennen kann sich eine Lead-Session trotzdem nicht.

Für mich liegt am Morgen ein Bericht bereit. Darin steht, was gemergt und nachgemessen ist. Was nur ich entscheiden kann, wartet gesammelt in der Owner-Queue, mit Optionen und Empfehlung. Den Chatverlauf der Nacht muss ich dafür nicht lesen.

Das taugt mir an dieser Nacht am meisten. Ich muss sie nicht mitlesen, um am Morgen zu wissen, was passiert ist und warum.

Was davon auf npm liegt

Seit dem 5. Oktober gibt es den Navigator als lead-session-orchestrator auf npm. Das Paket steht unter MIT-Lizenz, Version 0.x, getestet auf macOS. Am 24. Oktober ist Version 0.4.0 aktuell. Das Quell-Repo ist privat. Die Produktseite liegt unter session-orchestrator.com/lead.

Im Terminal heißt der Befehl kurz lso, navigator funktioniert weiter als zweiter Name.

Das Paket kommt in drei Stufen. Wer allein ein paar Sessions laufen hat, braucht nur die Inbox. Laut README dauert die Einrichtung etwa fünf Minuten. Dann stehen alle offenen Entscheidungen in einem eigenen Bereich im Terminal. Stufe zwei ist ein eigener Lead-Tab, der die anderen koordiniert. Stufe drei ist die Flotte: signierte Autoritätsdateien, kopflose Läufe in Worktrees und Merge-Tore auf GitLab.

Die Grenzen stehen ebenfalls im README. Es gibt nur GitLab, noch keine Tore für GitHub. Alles läuft auf einem Rechner. Einen Daemon oder einen offenen Port gibt es nicht. Befehle und Formate können sich in 0.x noch ändern.

Auch das Paket gibt nie eine Freigabe. Eine Antwort in der Inbox hält eine Entscheidung fest. Einen Merge oder ein Release erlaubt sie nicht.

session-orchestrator bleibt der Motor innerhalb einer Session. Beide laufen auch allein. Zusammen teilen sie Lease, Auflagen und Check-in. Was session-orchestrator inzwischen über seine eigenen Zahlen weiß, steht in Mein Orchestrator zählt nur noch, was wirklich lief.

Wenn du mehr als eine Coding-Session gleichzeitig laufen hast, fang mit der Inbox an. Die Nachtschicht kommt später, mit Regeln, die du vorher selbst festlegst.

lead-session-orchestrator

Viele Sessions, eine davon führt, und was nur du entscheiden kannst, liegt in einer Inbox.

Das Sprachmodell
führt als Lead-Session: Es liest die Lage, ordnet die Merges und bündelt deine Entscheide.
Der Code
setzt die Grenzen: immer nur ein Lead, eine Regeldatei je Repository, und was er nicht messen kann, lässt er stehen.

session-orchestrator.com/lead (öffnet eine andere Website)Steckbrief zu lead-session-orchestratorWas ich für dich baue