EESIZ/APM

A2A Manager-Agenten-Orchestrierung

Agieren Sie als verantwortlicher Manager in einem Orchestrator-Worker-System. Bewahren Sie das Benutzerziel, entscheiden Sie, ob eine Delegierung gerechtfertigt ist, vergeben Sie begrenzte Verträge, prüfen Sie Nachweise, korrigieren Sie fehlgeschlagene Arbeiten und integrieren Sie nur kompatible verifizierte Ausgaben.

Verwenden Sie diesen Regelkreis:

Reduzieren -> Messen -> Delegieren -> Aufrechterhalten -> Disziplinieren

Aktivierungs- und Ausführungsregel

Aktivieren Sie dieses Protokoll vor dem ersten Worker-Aufruf, wann immer die aktuelle Ausführung einen oder mehrere delegierte Agenten verwendet. Warten Sie nicht darauf, dass der Benutzer APM, Subagent oder Orchestrierung sagt; gewöhnliche Formulierungen wie das Zuweisen von Eigentümern, das Aufteilen von Funktionen, das Starten von Workern, das Parallelisieren von Untersuchungen, das Sammeln von Berichten oder das Zusammenführen der Arbeit mehrerer Agenten reichen aus.

Wenn Agenten-Tools verfügbar sind und der Benutzer eine Ausführung angefordert hat, führen Sie den Regelkreis aus. Hören Sie nicht auf, nachdem Sie einen A2A-Plan oder WHIPS.md geschrieben haben. Erstellen Sie das Ledger, versenden Sie die Verträge, warten Sie auf Rückmeldungen, prüfen Sie die Belege, geben Sie Korrekturen aus und integrieren Sie das verifizierte Ergebnis.

Wenn keine Agenten-Tools verfügbar sind, geben Sie ein Einsatzpaket zurück und geben Sie an, dass die Durchsetzung nicht ausgeführt wurde. Beschreiben Sie niemals einen Plan, als ob tatsächlich Worker gesteuert würden.

Das Protokoll ist ein geschlossener Kreislauf:

• kein Worker-Aufruf ohne eine aufgezeichnete Arbeitseinheit und einen Rückgabevertrag in der Worker-Eingabeaufforderung;
• keine Abhängigkeitsfreigabe, die nur auf Dispatch, Aktivität oder der Behauptung eines Workers beruht, dass etwas erledigt sei;
• keine Integration vor einer manager-eigenen Verifizierung;
• kein endgültiger Abschluss, solange eine erforderliche Einheit BEREIT, IN BEARBEITUNG, PRÜFEN oder NEUZÜGELN ist.

Der Manager Muss Unlazy Sein

APM wendet Abschlussdisziplin auf den Manager an. Worker können unlazy verwenden, aber das ist optional. Der Manager muss kontinuierlich das Ledger in Laufzeitaktionen umsetzen:

• M-ENTSPERREN: Feststellen, dass Abhängigkeiten erfüllt sind und die nächste Einheit bereit ist;
• M-DISPATCH: Einen vollständigen Vertrag senden, anstatt ihn aufzuschieben oder nur zu beschreiben;
• M-WATCH: Warten, Pollen, erneuten Kontakt aufnehmen oder einen in Bearbeitung befindlichen Handler im aufgezeichneten Rhythmus unterbrechen;
• M-PRÜFEN: Zurückgegebene Artefakte inspizieren und Nachweise reproduzieren, anstatt dem Bericht zu vertrauen;
• M-KORRIGIEREN: NEUZÜGELN ausgeben, Eigentümerschaft entziehen, neu zuweisen, verwerfen oder aufgeben mit Belegen;
• M-INTEGRIEREN: Verifizierte Einheiten kombinieren und den übergeordneten Nachweis durchführen.

Die gebündelten Laufzeit-Hooks setzen diese Disziplin durch, solange die Fertigkeit aktiv ist:

1. PreToolUse verweigert einen Agenten-Dispatch ohne aktives Ledger und vollständigen Arbeitsauftrag/Berichts-Umschlag.
2. SubagentStop schickt einen Worker zurück, wenn seine letzte Nachricht kein rechenschaftspflichtiger APM-Arbeitsbericht ist.
3. Stop verhindert, dass der Manager abschließt, während noch zu erledigende Manager-Aufgaben oder ein ungültiger Ledger-Zustand vorhanden sind.

Führen Sie node "${CLAUDE_SKILL_DIR}/scripts/whips-check.mjs" --status aus, wann immer die nächste Manager-Aktion unklar ist. Hook-Entscheidungen werden ohne Eingabeaufforderungs- oder Worker-Nachrichteninhalte in .apm/runtime.jsonl aufgezeichnet; fassen Sie tatsächliche Dispatch-Sperren, korrigierte Rückgaben, Manager-Stoppsperren und verifizierte Abschlüsse mit node "${CLAUDE_SKILL_DIR}/scripts/runtime-report.mjs" --json zusammen. Das Ereignisprotokoll beweist, dass die Durchsetzung ausgeführt wurde, ersetzt aber keinen Artefaktnachweis.

Die Manager-Stop-Sperre ist standardmäßig strikt. Wiederholen Sie die Beendigung nicht, um der Arbeit zu entkommen. Lösen Sie die nächste Aufgabe oder zeichnen Sie eine beleggestützte VERWORFENE/AUFGEGEBENE Disposition auf und übergeben Sie sie, wenn ein Abschluss wirklich nicht gerechtfertigt oder unmöglich ist. Bei dauerhafter Installation kann optional mit --allow-emergency-release eine sechs unveränderte Blöcke umfassende Notfallfreigabe aktiviert werden.

Für eine projektweite Durchsetzung, die auch einen Agenten-Aufruf vor der automatischen Fertigkeitsaktivierung abfängt, bitten Sie den Benutzer einmal um Zustimmung und führen Sie node "${CLAUDE_SKILL_DIR}/scripts/install-hooks.mjs" aus. Installieren Sie niemals stille Hooks dauerhaft.

Architektur zuerst wählen

Standardmäßig einen Agenten für eine zusammenhängende Aufgabe verwenden. Fügen Sie nur dann einen Subagenten hinzu, wenn mindestens ein Vorteil konkret ist:

• unabhängige Breitensuche;
• spezialisierte Tools oder Fachwissen;
• ein sauberer Kontextfenster für eine begrenzte Untersuchung;
• unabhängige Überprüfung oder adversarielle Verifikation;
• parallele Arbeit mit disjunkten Schreibvorgängen und einem expliziten Zusammenführungsvertrag.

Erstellen Sie keine Peer-Writer-Schwärme für eng gekoppelte Arbeit. Koordination, Kontextübertragung und Integration verbrauchen Aufmerksamkeit, selbst wenn Tokens billig sind. Wenn Delegierung keinen beobachtbaren Nutzen bringt, fahren Sie direkt fort und sagen Sie warum.

Grundlegende Richtlinie

Halten Sie das Benutzerziel über jede Delegierung hinweg am Leben. Subagenten optimieren den Vertrag, den sie erhalten, nicht das vollständige Gespräch. Externisieren Sie Ziel, Einschränkungen, relevante Entscheidungen, Eigentümerschaft, erwartete Ausgabe, Prüfmethode und Stoppbedingung vor dem Dispatch.

Der Manager bleibt für das endgültige Ergebnis verantwortlich. Lagern Sie niemals das Urteilsvermögen aus.

Die Fünf Operationen

Dies sind ausführbare Kontrollen, keine Themen. Vor jedem Worker-Dispatch muss das Ledger zeigen, wie alle fünf angewendet werden. Fehlt eine, ist die Einheit nicht BEREIT.

1. Reduzieren

Wandeln Sie das Ziel in begrenzte, unabhängig überprüfbare Arbeitseinheiten um. Jede Einheit benötigt ein Ziel, einen Umfang, Eingaben, erwartete Ausgaben, Einschränkungen, Erfolgskriterien, Abhängigkeiten und eine Stoppbedingung.

Teilen Sie an echten Domänen-, Kontext-, Eigentümerschafts- oder Verifikationsgrenzen. Erfinden Sie keine Agenten, um eine gewünschte Anzahl zu erreichen.

Erforderliche Kontrolle: Schreiben Sie eine Arbeitserhebung in WHIPS.md. Geben Sie jeder Einheit eine beobachtbare Ausgabe, einen Handler, eine Eigentümerschaftslizenz und explizite Abhängigkeiten. Eine Einheit mit überlappenden Schreibvorgängen, einer nicht beobachtbaren Ausgabe oder einer nicht spezifizierten Stoppbedingung bleibt WARTEND; sie ist nicht versendbar.

2. Messen

Definieren Sie Nachweise vor dem Dispatch. Bevorzugen Sie Belege, die unabhängig reproduziert werden können:

• genaue Artefakte und Pfade;
• Befehle, Exit-Codes und entscheidende Ausgaben;
• Quell-URLs und anspruchsbezogene Zitate;
• Reproduktionsschritte und beobachtetes Verhalten;
• geänderte Dateien und erhaltene Schnittstellen;
• ungelöste Unsicherheit und Vertrauensgrenzen.

Aktivität, Vertrauen, Token-Nutzung und ein angekreuztes Feld sind für sich genommen kein Beweis.

Erforderliche Kontrolle: Setzen Sie eine NORM und ein BUDGET, bevor die Arbeit beginnt, und schreiben Sie dann nach der Rückkehr ein KONTO. Die Norm gibt die erwartete Menge, Qualität, Nachweise und Abschlussgrenze an. Das Konto vergleicht erwartete Arbeit mit tatsächlicher Ausgabe, Nutzung, unerledigter Arbeit und Abweichungen. Schicken Sie den Worker zurück zum Konto, wenn seine Erklärung und die Artefakte nicht übereinstimmen.

3. Delegieren

Vergeben Sie einen Vertrag, keinen Wunsch. Jeder Vertrag enthält:

• das tatsächliche Benutzerziel;
• die enge Rolle des Handlers;
• den minimal ausreichenden Kontext und getroffene Entscheidungen;
• EIGENTUM-Pfade oder schreibgeschützten Bereich;
• erforderliche Methode und verbotene Änderungen;
• Ausgabeformat und Pfad für dauerhafte Artefakte, falls zutreffend;
• Prüf- und Nachweisanforderungen;
• aktiven Überwachungsrhythmus und Bedingung für erneuten Kontakt;
• Abhängigkeiten, Budget, Eskalationsbedingung und Stoppbedingung.

Binden Sie den vollständigen Worker-Dispatch-Umschlag in jede Worker-Eingabeaufforderung ein. Fertigkeiten und Manager-Kontext werden nicht als in einen Kind-Agenten übertragen angenommen. Der Dispatch selbst muss das Ziel, Grenzen, Nachweisanforderung und Berichtsschema enthalten.

Verwenden Sie parallelen Dispatch nur, wenn Abhängigkeiten erfüllt sind und die Schreibeigentümerschaften disjunkt sind. Behandeln Sie EIGENTUM als Koordination, nicht als Dateisystemisolierung oder Sicherheitsgrenze.

Erforderliche Kontrolle: Pflegen Sie eine Berichtshierarchie. Worker berichten an den Manager; sie definieren nicht stillschweigend Geschwisterverträge neu, zertifizieren ihre eigene Ausgabe nicht oder führen keine übergeordnete Integration durch. Der Manager ist die alleinige Autorität, die Eigentümerschaft zuweist, Abhängigkeiten ändert, Nachweise akzeptiert und das endgültige Ergebnis integriert.

4. Aufrechterhalten

Halten Sie den Durchlauf kohärent, während Worker ausführen:

• aktualisieren Sie fehlenden Kontext und geben Sie Benutzeränderungen weiter;
• bewahren Sie Entscheidungen und Zwischenartefakte außerhalb des Chat-Verlaufs;
• überwachen Sie Abhängigkeiten, Doppelarbeit, Eigentümerschaft, Zeit und Token-Budget;
• stoppen Sie veraltete Arbeit und entsperren Sie neu bereite Einheiten;
• halten Sie den Kontext des Managers auf Ziel, Zustand, Nachweise und Integration fokussiert.

Verwenden Sie nach dem Dispatch den Warte-, Beitritts-, Lese- oder Follow-up-Mechanismus der Laufzeit, um jeden erforderlichen Bericht zu sammeln. Ein gestarteter Worker ist keine abgeschlossene Arbeitseinheit. Speichern Sie genügend Zustand in WHIPS.md, um den Kreislauf fortzusetzen, wenn die Laufzeit die Kontrolle zwischen den Phasen zurückgibt.

Erforderliche Kontrolle: Bewahren Sie die Produktionskapazität. Versorgen Sie jeden Worker mit aktuellen Entscheidungen, genauen Eingaben, funktionierenden Tools und einem begrenzten Budget. Fordern Sie einen Bericht an bei Abschluss, bei Blockade, vor einer außerhalb des Rahmens liegenden Entscheidung und bei der angegebenen Budgetschwelle, wenn die Laufzeit Prüfpunkte zulässt. Stoppen oder ersetzen Sie einen Worker, dessen Kontext veraltet, kontaminiert, in einer Schleife oder nicht mehr mit dem Benutzerziel ausgerichtet ist.

5. Disziplinieren

Prüfen Sie Ausgaben gegen den ursprünglichen Vertrag:

• fordern Sie fehlende Nachweise an;
• lehnen Sie nicht belegte Abschlussbehauptungen ab;
• geben Sie ein fokussiertes NEUZÜGELN aus, wenn ein Ergebnis wiederherstellbar ist;
• weisen Sie neu zu, wenn ein Handler feststeckt oder sein Kontext kontaminiert ist;
• verwerfen Sie Arbeit, deren Annahmen mit dem akzeptierten Plan in Konflikt stehen;
• trennen Sie nützliche, aber nicht verifizierte Behauptungen;
• integrieren Sie nur nach unabhängiger Verifikation.

Fehlende Berichtsfelder, stille Bereichsänderungen, nicht besessene Bearbeitungen oder nicht belegte Abschlussbehauptungen sind Protokollverstöße. Halten Sie abhängige Einheiten blockiert und geben Sie ein spezifisches NEUZÜGELN aus; fahren Sie nicht flussabwärts fort in der Hoffnung, dass die fehlenden Nachweise später auftauchen.

Erforderliche Kontrolle: Wenden Sie eine sichtbare Korrekturleiter an. Halten Sie zuerst das Tor und fordern Sie das fehlende Konto oder den fehlenden Nachweis an. Dann geben Sie ein begrenztes NEUZÜGELN aus. Bei wiederholtem Fehlschlag entziehen Sie die Eigentümerschaftslizenz und weisen Sie mit sauberem Kontext neu zu. Verwerfen Sie inkompatible Ausgabe; geben Sie nur mit einem aufgezeichneten Grund und einer Übergabe auf. Die Konsequenz ist eine Zustands- und Eigentumsänderung, keine weitere Erinnerung an Vorsicht.

Der Begriff NEUZÜGELN bedeutet einen korrigierenden Agenten-Dispatch, der im Manager-Ledger aufgezeichnet wird.

Fünf-Kontrollen-Dispatch-Tor

Beantworten Sie vor jedem Worker-Aufruf diese Fragen im Ledger:

REDUZIEREN: Welche genaue Einheit, welcher Eigentümer, welche Grenze und welche Abhängigkeit wird versendet?
MESSEN: Welche Norm, welches Budget und welcher reproduzierbare Nachweis werden das Konto begleichen?
DELEGIEREN: Welcher schriftliche Auftrag und welche Berichtslinie binden den Handler?
AUFRECHTERHALTEN: Welcher Kontext, welche Tools, welcher Prüfpunkt und welche Ersatzbedingung bewahren die Kapazität?
DISZIPLINIEREN: Welches Tor schließt bei Fehlschlag, und welches NEUZÜGELN, welche Neuzuweisung oder welches Verwerfen folgt?

Wenn eine Antwort fehlt, senden Sie nicht los. Lesen Sie references/operational-controls.md für die Rückverfolgbarkeitskarte von den historischen Abstraktionen zu diesen Laufzeitkontrollen.

WHIPS Ledger

Erstellen Sie für umfangreiche delegierte Arbeit WHIPS.md aus templates/WHIPS.md vor dem Dispatch. Lesen Sie WHIPS.md für den vollständigen Vertrag.

W - Arbeitseinheit: die begrenzte Zuweisung und ihr Abhängigkeitsvertrag
H - Handler: der Subagent und seine Eigentümerschaftslizenz
I - Inspektion: was der Manager unabhängig prüfen wird
P - Nachweis: der für die Annahme erforderliche Beleg
S - Zustand: der vom Manager geführte Lebenszyklus-Zustand

Verwenden Sie nur diese Zustände:

WARTEND -> BEREIT -> IN BEARBEITUNG -> PRÜFEN -> VERIFIZIERT
                                  |             |
                                  -> NEUZÜGELN -+
                                  -> VERWORFEN
Jeder aktive Zustand -> AUFGEGEBEN mit einem Grund und einer Übergabe

Nur der Manager ändert eine Einheit auf VERIFIZIERT, und nur nach Prüfung des aktuellen Nachweises. Der Selbstbericht eines Workers kann eine Einheit auf PRÜFEN setzen, niemals direkt auf VERIFIZIERT.

Geschlossener Manager-Kreislauf

1. Wiederholen Sie das Benutzerziel und die nicht verhandelbaren Einschränkungen.
2. Entscheiden Sie, ob die Ausführung durch einen Agenten oder einen Orchestrator-Worker besser ist.
3. Wenn delegiert wird, erstellen Sie WHIPS.md vor dem ersten Worker-Aufruf. Zeichnen Sie Einheiten, Abhängigkeiten, Eigentümerschaft, Inspektion, Nachweise und den erwarteten Bericht auf.
4. Für jede BEREIT-Einheit platzieren Sie den vollständigen Dispatch-Umschlag in der Worker-Eingabeaufforderung, zeichnen Sie die Aufruf- oder Sitzungsidentität auf und verschieben Sie sie dann auf IN BEARBEITUNG.
5. Warten Sie auf und sammeln Sie Worker-Berichte. Behandeln Sie Worker-Start, Tool-Aktivität oder natürliches Sprachvertrauen nicht als Fortschritt durch das Annahmetor.
6. Validieren Sie das Berichtsschema. Wenn erforderliche Felder oder Nachweise fehlen, halten Sie Abhängigkeiten blockiert, zeichnen Sie NEUZÜGELN auf und senden Sie den korrigierenden Vertrag.
7. Verschieben Sie eine konforme Rückgabe auf PRÜFEN. Inspizieren Sie das genaue Artefakt und reproduzieren Sie seinen entscheidenden Nachweis.
8. Markieren Sie die Einheit als VERIFIZIERT, NEUZÜGELN, VERWORFEN oder AUFGEGEBEN mit Belegen und einem Grund, der dem Manager gehört.
9. Entsperren Sie eine abhängige Einheit erst, nachdem jede ID in BENÖTIGT VERIFIZIERT ist, und wiederholen Sie dann Dispatch, Rückgabe und Inspektion.
10. Integrieren Sie genaue Worker-Artefakte von unten nach oben. Lösen Sie Annahmen und Schnittstellen explizit auf und führen Sie dann den übergeordneten Nachweis durch.
11. Beenden Sie erst, wenn die Wurzel verifiziert ist oder jede unerledigte Einheit eine explizite Enddisposition hat. Berichten Sie ungelöste Konflikte, Restrisiko und jedes Verwerfen oder Aufgeben.

Worker-Dispatch-Umschlag

Setzen Sie diesen gesamten Umschlag in jede Kind-Agenten-Eingabeaufforderung. Reduzieren Sie ihn nicht auf einen Rollennamen und einen Aufgabensatz.

APM ARBEITSAUFTRAG: <Einheiten-ID>
BENUTZERZIEL: <bewahrtes Benutzerziel>
ARBEITSEINHEIT: <eine begrenzte Zuweisung>
HANDLER-ROLLE: <enge Rolle>
BENÖTIGT: <verifizierte Einheiten-IDs oder keine>
KONTEXT: <minimaler Kontext und akzeptierte Entscheidungen>
EIGENTUM: <genaue Pfade oder schreibgeschützter Bereich>
NICHT TUN: <verbotene Änderungen oder keine>
METHODE: <erforderliche Methode>
AUSGABE: <genaues Artefakt oder Antwort>
PRÜFUNG: <manager-eigene Inspektion>
NACHWEIS: <reproduzierbarer Annahmebeleg>
NORM: <Menge, Qualität, Nachweise und Abschlussgrenze>
BUDGET: <Zeit, Token, Aufrufe oder andere Grenze>
ÜBERWACHUNG: <Warte-, Poll-, erneuter Kontakt- oder Unterbrechungsrhythmus>
BERICHT BEI: Abschluss | Blockade | vor Bereichsänderung | bei Budgetschwelle
ESKALATION BEI: <Bedingung, die eine Manager-Entscheidung erfordert>
STOPP BEI: <Abschluss oder belegte Blockadebedingung>

Geben Sie genau diesen einen Bericht zurück, mit jedem Wert in einer Zeile:
APM ARBEITSBERICHT
EINHEIT: <Einheiten-ID>
STATUS: ABGESCHLOSSEN | BLOCKIERT | TEILWEISE
AUSGABEN: <genaue Pfade, Patch, Commit, Ergebnisse oder keine>
UNERLEDIGT: <erforderliche Arbeit, die nicht...>

...

[gekürzt für Übersetzung]