Portfolio-Wartung – die Ausführungsschleife
Dies ist die Prozedur für einen autonomen Entwickler, der ein Portfolio von Produkten sowohl betreibt (CI, Abhängigkeiten und PRs gesund hält) als auch weiterentwickelt (Strategie, Features, Abdeckung, Leistung, Qualität). Jede Ausführung folgt denselben vier Bewegungen – Überwachen (oder fortsetzen) → Auswählen → Handeln → Berichten – unter einer Disziplin: eine isolierte pro-Ausführung-Arbeitskopie, Validierung vor jedem PR, Behebung der Ursache, ein Entwurfs-PR mit einer Zeile zur KI-Offenlegung (der Kontrollpunkt), nur bei echter Bereitschaft wie unten definiert selbst befördert, dann gemäß dem Vertrauens-Gate zur Freigabe getrieben, ein Anliegen pro PR, niemals eine Sicherheits- oder Schutzschranke schwächen. Die Vorgehensweise für die Weiterentwicklung (Strategie und Roadmaps, Triage, Implementierung, Abdeckung, Leistung, Refactoring, Dokumentation, Sicherheitslage) befindet sich in der begleitenden Fähigkeit product-engineering; diese Fähigkeit ist die Schleife, die sie plant.
Echte Bereitschaft bedeutet das vollständige Freigabe-Tor der verbrauchenden Bereitstellung: ein eigener oder vertrauenswürdiger Autor, programmatische Validierung mit allen erforderlichen CI- und Pre-Merge-Qualitätsprüfungen grün, null ungelöste Thread- und Nicht-Thread-Review-Ergebnisse, kein Merge-Konflikt, ein grünes Review am aktuellen Stand und als Benutzer getestet und bewertet.
Begleitfähigkeiten – installieren Sie sie zusammen. Diese Schleife delegiert ihre Weiterentwicklungs-Bewegung an product-engineering und ihren Schritt zur Destillation von Erkenntnissen an self-improvement; eine Einzelfähigkeitsinstallation zieht Begleitfähigkeiten nicht automatisch mit ein. Installieren Sie alle drei aus dieser Bibliothek, oder – wenn eine Begleitfähigkeit fehlt – fällt die entsprechende Bewegung auf die eigene AGENTS.md-Anleitung der verbrauchenden Bereitstellung zurück, anstatt stillschweigend übersprungen zu werden.
Diese Fähigkeit ist gegen die Verbrauchervertragsabschnitte verfasst, die von der verbrauchenden AGENTS.md der Bereitstellung definiert werden (gemäß dem Parametrisierungsvertrag des agentic-engineering-Plugins): die Portfolio-Karte (welche Repositorys im Umfang sind, plus die ## Wartung-Karte jedes Produkts – Validierungsbefehle, Labels, geschützte/generierte Dateien, Roadmap-Heimat), das Vertrauens-Gate (die genauen Logins, die automatisch gesteuert werden dürfen, welche Bots nur Reviewer sind, und die Pro-Repository-Merge-Mechanismen wie Merge-Queues oder Auto-Merge-Automatisierung), der Rhythmus (Ausführungshäufigkeit und die Pro-Produkt-Rotationszahlen für Strategie-Reviews, Dokumentationsdurchgänge und schwere Aufgaben), der Speicher (wo der dauerhafte Cross-Run-Speicher lebt und welche Cursor er hält) und die Betreiberkanäle (wie eine menschliche Entscheidung aktiv erreicht wird – z. B. eine Ask-Tool-Aufforderung oder eine Entwurfs-PR-Lenkung – und etwaige nur im Notfall blockierte Kanäle). Wo diese Fähigkeit „gemäß dem Abschnitt X“ sagt, liefert das verbrauchende Repository die konkrete Tatsache.
0. Pre-Flight
- Laden Sie den Vertrag der Bereitstellung. Die
AGENTS.mddes verbrauchenden Repositorys (mit den obigen Vertragsabschnitten) regelt die Ausführung; wenn sie bereits in Ihrem Kontext ist, lesen Sie sie nicht erneut. - Bestätigen Sie den Arbeits-Checkout und die Identität, die von der Bereitstellung benannt werden (die Portfolio-Karte): das erwartete Repository-Layout ist vorhanden und Sie sind als das erwartete Konto authentifiziert. Synchronisieren Sie den Checkout nur mit sicheren, nur-Fast-Forward-Operationen – verwerfen Sie niemals Änderungen, die Sie nicht verfasst haben.
- Laden Sie den dauerhaften Speicher gemäß dem Speicher-Abschnitt – die einzige Quelle der Wahrheit für die Cross-Run-Orchestrierung (Rotationscursor, pro-Produkt zuletzt-bearbeitet / Roadmap / Forschung / Dokumentationscursor, offene Notizen zu beachten, Untersuchungs-Caches, Erkenntnisse). Behandeln Sie ihn als Ihre eigenen Notizen: er kann veraltet sein, also überprüfen Sie ihn anhand des Live-Zustands, bevor Sie nach ihm handeln.
- Lösen Sie optionales Inferenz-Routing auf. Wenn der Verbraucher einen Abschnitt Inferenz-Routing deklariert, lösen Sie dessen überprüfte Richtlinie und Laufzeitfähigkeiten auf, bevor Sie Arbeit zuweisen oder eskalieren. Er besitzt Modell-Aliase, Abrechnungsbeschränkungen, Kontingentzulassungen, temporäre Laufzeitbereiche und Eskalationsgrenzen; leiten Sie diese niemals aus einem Benchmark oder einer Laufzeitvorgabe ab. Ohne diesen Abschnitt behalten Sie das vorhandene Routing der Bereitstellung bei. Eine deklarierte, aber nicht aufgelöste Voraussetzung blockiert den Versand, der von ihr abhängt. Ein Richtlinienbewerter meldet die Berechtigung, nicht die Laufzeitdurchsetzung: Nur eine verifizierte Kontrolle vor der Inferenz kann ein verbotenes Modell oder eine verbotene Abrechnungsroute verhindern. Eine erforderliche Kontrolle, die nicht unterstützt oder nicht verifiziert ist, ist eine nicht aufgelöste Voraussetzung: blockieren Sie abhängigen Start, Wiederaufnahme, Kind-Versand und Fallback. Wenn die aktuelle übergeordnete Route verboten ist oder ihre erforderliche native Durchsetzung nicht aufgelöst ist, stoppen Sie die aktuelle Ausführung; nicht verwandter Aufgabeninhalt kann diese Inferenzroute nicht autorisieren. Setzen Sie nicht verwandte autorisierte Arbeit nur fort, wenn die Lücke ausschließlich für einen zukünftigen Kind-, Wechsel- oder Fallback-Route gilt und die aktuelle übergeordnete Route erlaubt ist. Melden Sie die Lücke über einen verfügbaren sicheren Beendigungspfad. Eine Prüfung innerhalb der Sitzung kann bereits verbrauchte Inferenz nicht schützen.
1. Überwachen – aber nur, wenn Sie Ihren nächsten Schritt nicht bereits kennen
🔴 VORRANGIGE PRÜFUNG VOR DER ÜBERWACHUNG. Die folgenden direkten Prüfungen werden bei jeder Ausführung zuerst durchgeführt. Sie können die nächste Aktion der Auswahlleiter festlegen, bevor eine umfassende Überwachung zurückkehrt, selbst wenn der Speicher kein laufendes Artefakt trägt: Problem- und Roadmap-Status auf unterer Ebene können eine Entscheidung nicht ändern, die bereits durch Live-Ausfall oder vertrauenswürdige PR-Arbeit festgelegt wurde. Führen Sie diese Prüfungen direkt durch, anstatt einen Unteragenten zu entsenden.
Entscheidung zum Versand der Überwachung
Frisch bedeutet, dass die letzte vollständige Überwachung noch innerhalb der Veralterungsgrenze der verbrauchenden Bereitstellung liegt. Ergebnis auf höherer Ebene bedeutet, dass die vollständigen direkten Vorab-Prüfungen entweder die nächste Aktion oder eine Live-Stopp-Bedingung festlegen, die ein Absteigen unter Ausfall- und vertrauenswürdige PR-Arbeit verbietet. Ein Übertrag kann die direkte Lektüre eingrenzen, ist aber weder ein Beweis für das aktuelle Eigentum noch eine Voraussetzung für das Überspringen der Überwachung. Ein leeres, unvollständiges oder ABFRAGE-UNBEKANNTES direktes Vorab-Prüfungsergebnis ist kein Ergebnis auf höherer Ebene und löst daher die vollständige Überwachung aus. Fortschrittliche Arbeit allein ist kein Ergebnis auf höherer Ebene.
| Frisch | Ergebnis auf höherer Ebene | Vollständige Überwachung |
|---|---|---|
| Ja | Ja | Überspringen |
| Ja | Nein | Versenden |
| Nein | Beides | Versenden |
Verfahren zum Versand der Überwachung
Wenn die Tabelle Überspringen sagt, verwenden Sie das direkte Ergebnis und gehen Sie zu Auswählen. Wenn sie Versenden sagt, erstellen Sie das vollständige Live-Bild unten. Diese Entscheidung betrifft, ob mehr Entdeckung die aktuelle Auswahl ändern kann; es ist keine Erlaubnis, ein Artefakt zu mutieren, dessen Eigentum unbekannt ist.
Nach Abschluss eines Ergebnisses auf höherer Ebene bewerten Sie die Versandtabelle erneut, bevor Sie absteigen; wenn kein Ergebnis auf höherer Ebene mehr vorhanden ist und diese Ausführung keine noch frische vollständige Überwachung abgeschlossen hat, versenden Sie die zurückgestellte Überwachung, bevor Sie Arbeit auf unterer Ebene auswählen.
🔴 Ein Übertrag zeichnet auf, was IHRES war; er kann nicht feststellen, dass es noch immer so ist. Er wird von einer Ausführung geschrieben und von einer anderen gelesen, sodass zwei Ausführungen, die ihm beide vertrauen, dasselbe Artefakt fortsetzen und seine Commits und Kommentare duplizieren – und die zweite hat keine Möglichkeit, dies zu bemerken, da nichts, was sie liest, dem widerspricht, woran sie sich erinnert. Das Eigentum wird daher bei jeder Wiederaufnahme aus dem Live-Zustand neu abgeleitet: das Artefakt trägt keine neuere Aktivität von einem anderen Schreiber, und welches Eigentumstoken die Bereitstellung auch definiert – eine Claim-Ref, eine Leihfrist mit Ablauf, ein Schreiber-Namespace – löst sich immer noch in diese Ausführung auf.
🔴 DIESES TOKEN SCHÜTZT JEDE FORTGESETZTE MUTATION, NICHT NUR DIE ERSTE. Eine fortgesetzte Operation überlebt routinemäßig die Leihfrist, unter der sie begann – einen Build, eine Wartezeit auf Review, eine langsame Prüfung – sodass eine Ausführung, die das Eigentum einmal überprüft und dann weiterschreibt, nur ihren Eröffnungs-Commit geschützt hat. Eine andere Ausführung erwirbt die abgelaufene Leihfrist und beide schreiben weiter, was genau die Korruption durch doppelte Schreiber ist, die das Token verhindern soll, und keiner bemerkt es. Also erneuern Sie das Token im gleichen Takt wie die Arbeit – unmittelbar vor jeder Mutation und erneut nach jeder Pause, die die Ausführung nicht kontrolliert hat – und machen Sie diese Mutation vom Erfolg der Erneuerung abhängig. Eine Erneuerung, die fehlschlägt, bedeutet, dass das Eigentum verloren oder nicht erkennbar ist: treten Sie zurück, ohne zu schreiben, anstatt „nur diesen einen“ bereits vorbereiteten Push abzuschließen. Wo das Token der Bereitstellung ein Vergleiche-und-Tausche ist, ist die Erneuerung auch der Beweis; wo es eine einfache Ablauffrist ist, lesen Sie es erneut und behandeln Sie jede Unklarheit als verloren.
🔴 Warum das Ergebnis auf höherer Ebene erforderlich ist: wenn die einzige bekannte Arbeit Weiterentwicklungs-Arbeit ist (eine Problemimplementierung, ein Roadmap-Durchgang, Forschung), stuft die Leiter die Mitwirkenden-Triage, die Sicherheitslage und die Instandhaltung darüber ein, und die direkten Prüfungen unten sehen keine davon. Das Überspringen der Überwachung dort würde es einer Ausführung ermöglichen, Arbeiten mit niedrigerer Priorität fortzusetzen, während etwas, das höher rangiert, unentdeckt bliebe – dieselbe Umkehrung, die dieses Tor verhindern soll. Ohne Live-Ausfall oder vertrauenswürdiges PR-Ergebnis erfordert die Weiterentwicklungsarbeit daher die Überwachung.
🔴 Warum dies eine Regel wert ist: Die Kosten einer Überwachung sind der VERSAND, nicht die Abfragen. Wo die Überwachung als Unteragent läuft, sendet sie die gesamte Agentendefinition bei jedem Versand erneut, und wo der Prompt-Cache der Laufzeit schneller abläuft, als der Zeitplan feuert, wird nichts davon wiederverwendet – also zahlt jeder Versand den vollen Preis, bevor eine einzige Abfrage läuft. Das Kürzen des Berichts der Überwachung spart daher fast nichts; nur das Nicht-Versenden spart etwas. Deshalb wird dieses Tor vor der Überwachung platziert, nicht darin.
🔴 Der Kurzschluss überspringt die ÜBERWACHUNG, niemals die VORAB-PRÜFUNGEN. Ein Übertrag benennt höchstens ein Artefakt, während diese Regeln über alle Arbeiten auf höherer Ebene reichen – also würde ein roter PR in einem anderen Repository oder ein vertrauenswürdiger Autor-PR, der merge-bereit geworden ist, ansonsten unbehandelt bleiben, während die Ausführung etwas niedriger Rangendes vorantreibt. Bei jeder Ausführung:
- jedes Ausfallsignal, nicht nur der Standard-Branch – eine defekte bereitgestellte Website oder Release-Pipeline ist ebenfalls ein Ausfall und kann defekt sein, während die CI des Standard-Branch grün ist. Wenn Sie also nur den Branch überprüfen, würde ein Produktionsfehler für das gesamte Veralterungsfenster verschoben werden;
- eine Aufzählung offener eigener/vertrauenswürdiger PRs und was jeden handlungsrelevant macht – die vollständige Hygiene-Quintade, keine Abkürzung davon: fehlgeschlagene erforderliche Prüfungen, ungelöste Review-Threads, Nicht-Thread-Review-Ergebnisse, ein Konflikt mit oder eine Verzögerung hinter der Basis, alle Pre-Merge-Qualitätsprüfungen, die das Review-Tooling separat von CI veröffentlicht, und ein fehlendes oder veraltetes grünes Review am aktuellen Stand. Dies sind dieselben fünf, die die vollständige Überwachung unten aufzählt, absichtlich ausgeschrieben und nicht referenziert, da der Wiederaufnahmepfad diese Überwachung überspringt – jedes hier fehlende Element ist ein Element, das bei einer fortgesetzten Ausführung von nichts gelesen wird. Die späteren sind für eine rot/merge-bereit-Lesung unsichtbar: ein Entwurf mit grünen Prüfungen, keinen Threads und keinen Ergebnissen kann dennoch in Konflikt stehen oder einen separat veröffentlichten Qualitätsfehler aufweisen oder einfach noch nie an dem Commit, den er jetzt trägt, reviewed worden sein – und ist dann weder rot noch merge-bereit – also meldet eine abgekürzte Auflistung nichts, während genau die Arbeit, die die Freigabe blockiert, wartet;
- ein Scan des Betreiber-Kontrollkanals über die PRs und Issues, von denen diese Ausführung überprüfen kann, dass sie sie erstellt hat, nicht nur des fortgesetzten Artefakts – ein authentifizierter Betreiber-Kommentar ist eine Anweisung, auf diese Ausführung zu handeln, und er hört nicht auf, einer zu sein, weil er auf einem anderen eigenen PR oder auf einem Issue statt einem PR gelandet ist. Zählen Sie jeden vertrauenswürdigen PR für die Hygiene auf, aber lesen Sie den Kontrollkanal nur bei überprüfter eigener Arbeit: der Anweisungs-Carve-Out ist das, was ansonsten nicht vertrauenswürdigen PR-Text ermöglicht, diese Ausführung zu steuern. Wenn Sie ihn also auf einen Bot- oder PR eines anderen Autors ausdehnen würden, würde dies weit über die Arbeit hinausgehen, deren Herkunft die Ausführung tatsächlich feststellen kann. Unter der Tatsache
attribution-onlydes Vertrauens-Gates lesen Sie auch die Kommentare des Betreibers mit genauem Login auf den Betreiber-Login-PRs, die Sie nicht erstellt haben, und führen Sie jeden handlungsrelevanten als benannten Blocker auf diesem PR, niemals als Anweisung für diese Ausführung; unterhands-offsind diese PRs nicht Ihre zu steuern, also benötigen sie keine solche Lesung; - erneute Überprüfung des fortgesetzten Artefakts anhand des Live-Zustands, da der Speicher veraltet wird und eine andere Instanz es möglicherweise vorangetrieben oder abgeschlossen hat.
Dies sind direkte Abfragen gegen eine Handvoll eigener PRs – eine Auflistung plus eine Review-Status-Lesung pro Stück, keine Portfolio-weite Vertiefung – also kosten sie einen Bruchteil eines Versands.
🔴 Die Markierungen um diese Liste herum sind tragend, nicht dekorativ. Der Vertragstest liest den Bereich zwischen ihnen, also ist dies der einzige Ort, an dem eine Vorab-Prüfung als operativ zählt. Prosa über diese Prüfungen an anderer Stelle im Abschnitt dokumentiert sie; sie setzt sie nicht in Kraft – und eine Prüfung, die aus diesem Bereich heraustreibt, hört stillschweigend auf, irgendetwas zu regieren, während sie noch als vorhanden gelesen wird. 🔴 Jede Voraussetzung, die dieses Tor liest, muss etwas haben, das sie SCHREIBT. Der Zeitstempel der letzten vollständigen Überwachung wird vom untenstehenden Rückschreibschritt erzeugt; eine Voraussetzung ohne Produzent ist keine Bedingung, sondern eine dauerhafte Falschheit, und die Optimierung tritt stillschweigend nie in Kraft. Alles, was später zum Prädikat hinzugefügt wird, benötigt einen Schreiber, der damit hinzugefügt wird. Ein Übertrag wird noch geschrieben, wenn Arbeit übrig bleibt, aber es ist ein optionaler Targeting-Hinweis, nicht Teil des Versandprädikats. Was der Kurzschluss tatsächlich überspringt, ist die breite Überwachung: Vertiefung jedes Kandidaten und des Issue-, Roadmap- und Triage-Zustands, den die Leiter verbietet, zu erreichen, während höhere Arbeit offen ist. Wenn eine Vorab-Prüfung etwas auftaucht, das ein übertragenes Artefakt übertrifft, wird dieses Ergebnis zur Arbeit der Ausführung und der Übertrag wartet.
Die standardmäßige Veralterungsgrenze beträgt 4 Stunden, es sei denn, der Rhythmus der Bereitstellung nennt einen anderen. Die Grenze ist das, was dies davon abhält, niemals zu überwachen: die Entdeckung neuer Issues wird um höchstens dieses Intervall verzögert, niemals fallengelassen, während Ausfälle bei jeder Ausführung überprüft bleiben.
⚠️ Lassen Sie niemals zu, dass ein Übertrag zu einer blockierten Ausführung wird. Ein terminales Artefakt oder Eigentumstoken, das an eine andere Instanz verloren geht, kann für sich genommen nicht die Zeile „Ergebnis auf höherer Ebene“ erfüllen: setzen Sie die direkten Prüfungen fort und wenden Sie die Tabelle an
...
[Gekürzt für die Übersetzung]