In Plan Studio arbeiten

Diese Anleitung zeigt dir, wie du mit Plänen in Plan Studio arbeitest. Was Orchestrierungen und Plandokumente sind, steht unter Orchestrierung und Planmodus nutzen.

Einen Plan öffnen

Ein Plan gehört zu dem Gespräch, das ihn erzeugt hat, und dort erreichst du ihn normalerweise: Die Planzeile im Gespräch hat die Aktion Öffnen, und Plan Studio öffnet sich als Editor-Tab neben dem Gespräch.

Die Seite listet drei Abschnitte:

Aktive Pläne — Orchestrierungen, vorgeschlagene zuerst, mit Status, Schrittzahl und Revisionsnummer.
Plandokumente — Pläne, die ein einzelner Agent mit submit_plan im Planmodus eingereicht hat, solange sie vorgeschlagen oder freigegeben sind.
Playbooks — gespeicherte, parametrisierte Planvorlagen.

Klicke eine Karte, um sie in Plan Studio zu öffnen. Die Route ist /workspaces/<workspace-id>/plans/<kind>/<plan-id>, wobei kind orchestration oder document ist. So verlinkst du auch einen einzelnen Plan direkt.

Hast du eine Orchestrierung geöffnet, siehst du die bearbeitbare Leinwand, die Versionszeitleiste und die Freigabeleiste. Hast du ein Plandokument geöffnet, erscheint derselbe Graph nur lesend. Plandokumente schreibt der Agent; du prüfst sie, schätzt sie und gibst sie frei oder lehnst sie ab. Ein freigegebenes Dokument zeigt den aktuellen Laufstatus je Knoten aus der Orchestrierung, in die es kompiliert wurde.

Den DAG bearbeiten

Bearbeitungen sind an einer Orchestrierung möglich, solange sie proposed ist. Alles auf der Leinwand steuerst du über die Tastatur:

Klicke die Leinwand an und bewege die Auswahl mit den Pfeiltasten.
Drücke n, um einen Schritt hinzuzufügen. Er erscheint ausgewählt als „Neuer Schritt“; benenne ihn im Knoteninspektor rechts um.
Drücke e auf dem Schritt, der zuerst laufen muss, und klicke dann den abhängigen Schritt (oder wähle ihn und drücke Enter), um eine Abhängigkeit zu verbinden. Esc verwirft eine offene Verbindung.
Drücke x, um die neueste Abhängigkeit des gewählten Schritts zu durchtrennen, oder schalte die exakten Abhängigkeiten im Abhängigkeitseditor des Knoteninspektors um.
Drücke Delete, um den gewählten Schritt zu entfernen. Verweise auf ihn verschwinden aus den Abhängigkeiten der übrigen Schritte.

Im Knoteninspektor bearbeitest du außerdem Beschreibung, Rolle und Ausgabeschema des Schritts. Nach einer kurzen Pause speichert sich die Bearbeitung automatisch als neue Revision. Ein Validierungsfehler in der Freigabeleiste blockiert das Speichern, bis du ihn behebst.

Nur Arbeitsschritte sind bearbeitbar. Strukturknoten — Recherche, Diskussion und Synthese — sind schreibgeschützt, und ebenso jeder Schritt, dessen Arbeit schon gelaufen ist. Er ist mit „Bereits ausgeführt“ markiert, weil eine Bearbeitung den Plan ab hier verzweigen würde.

Das Speichern ist optimistisch nebenläufig und gebunden an die Revision, von der du ausgegangen bist. Plant der Orchestrator unter dir neu, wird dein Speichern mit „the plan moved on“ abgelehnt, statt zusammengeführt oder still überschrieben zu werden. Lies die aktuelle Revision neu und wiederhole die Bearbeitung. Von Agenten angestoßene Neuplanungen sind selbst auf eine alle zwei Minuten begrenzt, deshalb bleibt das selten.

Kosten, Zeit und Risiko schätzen

Drücke Schätzen in der Freigabeleiste.

Jeder Schritt auf der Leinwand bekommt ein Badge mit einem Kostenbereich und der Stichprobengröße dahinter, oder „Noch kein Verlauf“, wenn die Rolle des Schritts noch nie gelaufen ist. Wähle einen Schritt für das volle Detail im Knoteninspektor: Kostenbereich mit Stichprobengröße, ein Dauerbereich und ein Wirkungsradius (Dateien und Symbole) aus der Herkunft des Schritts — oder „unbekannt“, wenn der Schritt keine Herkunft trägt.
Die Freigabeleiste zeigt die Plansumme: einen Gesamtkostenbereich, einen Dauerbereich für den kritischen Pfad (parallele Zweige überlappen sich, das ist also nicht die Summe) und den Kostendeckel, sofern der Plan einen setzt.
Haben nur manche Schritte Historie, ist die Summe mit teilweise markiert und umfasst nur die schätzbaren Schritte. Liegt das obere Ende der Schätzung über dem Kostendeckel, wird die Summe rot und zeigt die Warnung „über Budget“.

Schätzungen sind ehrlich, oder sie fehlen. Ein Schritt, dessen Rolle keine Historie abgeschlossener Läufe hat, meldet eine Stichprobengröße von null und gar keine Bereiche. Er erscheint als unbekannt, statt geschätzt zu werden. Behandle „Noch kein Verlauf“ als „weiß niemand“, nicht als „günstig“.

Der Kostendeckel ist ein Vergleich nur in der Anzeige, gegen diese Schätzung. Sobald der Plan läuft, erzwingt ihn nichts — siehe Kosten verwalten für die Steuerungen, die Ausgaben wirklich stoppen.

Eine Revision mit einem früheren Vorschlag vergleichen

Jede Bearbeitung und jede Neuplanung durch den Orchestrator hängt an eine Revisionszeitleiste an, die nur wächst. Sie steht im Panel Versionen links an einem Orchestrierungsplan.

Klicke eine Revision, um sie mit dem aktuellen Vorschlag zu vergleichen. Ohne Auswahl vergleicht das Panel die vorherige Revision mit der aktuellen.
Lies den Diff in der unteren Hälfte des Panels: Schritte, die zwischen den beiden Revisionen hinzugefügt, entfernt oder geändert wurden.
Ist der Plan noch proposed, klicke das Zurückspulen-Symbol an einer Revision, um dorthin zurückzugehen. Zurückspulen speichert diesen Vorschlag als neue Revision — verloren geht nichts.

propose_orchestration und der Editor lehnen Änderungen ab, sobald der Plan nicht mehr proposed ist. Ein laufender Lauf übernimmt deshalb keine Neuplanung mitten in der Ausführung.

Einen Plan genehmigen, ablehnen oder erweitern

In der App ist ein vorgeschlagener Plan eine einzige Entscheidung, und sie gilt für den ganzen Plan: Plan genehmigen oder Ablehnen in der Freigabeleiste. Plan genehmigen genehmigt immer jeden Schritt. Eine Teilmenge lässt sich vorher nicht wählen. Die Freigabe bleibt gesperrt, solange der Vorschlag Validierungsfehler hat. Sie stehen neben den Schaltflächen.

Freigeben ist dem Menschen vorbehalten. Ein MCP-Tool dafür gibt es nicht. Ein Agent kann einen Plan vorschlagen und überarbeiten, freigeben kann er ihn nicht.

Sobald eine Orchestrierung läuft, ändert sich die Leiste:

Hat ein Schritt mitten im Lauf angehalten, um nachzufragen, wähle ihn und drücke Knoten fortsetzen, um ihn wieder aufzunehmen.
Drücke Auswahl genehmigen, um eine Teilfreigabe auf den gewählten Schritt und alles zu erweitern, wovon er transitiv abhängt (ein Schritt lässt sich nie ohne seine Abhängigkeiten freigeben). Die Steuerung sitzt bei jeder Orchestrierung auf der Ausführungsleiste. War der Plan als Ganzes freigegeben, tut sie nichts.
Drücke Lauf abbrechen, um die ganze Orchestrierung zu stoppen.

Schritte außerhalb einer teilweise freigegebenen Menge erscheinen als zurückgestellt und laufen erst, wenn du die Menge erweiterst.

Ein Playbook mit Parametern ausführen

Ein Playbook ist eine gespeicherte Planvorlage mit typisierten Platzhaltern {{param}} im Ziel, in den Schritttiteln, in den Beschreibungen und in den Prompts. Die Ersetzung ist wörtlich, eine Ausdruckssprache gibt es nicht. Brauchst du Logik, nimm eine Pipeline.

Drücke im Abschnitt Playbooks der Seite Ausführen am Playbook (oder öffne die ⌘K-Befehlspalette und wähle das Playbook dort).
Fülle die Parameter aus. Aufzählungsparameter erscheinen als Dropdowns; Repo- und Agentenparameter nehmen eine Repo- oder Agentenreferenz; optionale Parameter fallen auf ihren Standard zurück.
Wähle das Anker-Ticket, gegen das der Plan vorgeschlagen wird, und bestätige dann.

Ein Playbook auszuführen schlägt nur einen Plan vor. Die instanziierte Orchestrierung öffnet sich in Plan Studio als proposed, und ausgeführt wird nichts, bis du sie dort freigibst. Um ein Playbook zu entfernen, drücke das Papierkorb-Symbol auf seiner Karte.

Agenten legen Playbooks mit den MCP-Tools create_playbook und run_playbook an und führen sie damit aus; siehe MCP-Tools.