Planungs-Gate
Machen Sie den Plan sichtbar, bevor Sie handeln. Ein Plan ist keine Genehmigung.
Folgen Sie AGENTS.md für Betriebsbefugnisse, Delegation, Wiederherstellung und Berichterstattung. Diese Fähigkeit definiert nur das Planungs-Gate; sie erfordert keine Mitarbeiter-SOP oder Aufgabenboard-Anwendung.
Nur-Lese-Vorbereitung
Überprüfen Sie, was benötigt wird, um genaue Ziele, bestehenden Zustand und Risiken zu identifizieren. Ändern Sie während der Vorbereitung keinen Zustand und geben Sie keine Geheimnisse preis.
Klären Sie wesentliche Unbekannte, bevor Sie eine Ausführungsgenehmigung beantragen. Bitten Sie den Benutzer nicht, bereits bekannte Fakten zu wiederholen.
Wann das Gate gesetzt wird
Setzen Sie das Gate bei Dateiänderungen, zustandsverändernden Befehlen, Implementierung, Refactoring, Konfiguration, Installationen und dauerhaften Workflow-Änderungen.
Für eine triviale, begrenzte einzelne Änderung verwenden Sie das kurze Gate – nicht kein Gate. Fragen, Analysen und Entwürfe, die im Gespräch präsentiert werden, erfordern kein Ausführungs-Gate.
Vollständiges Gate
PLAN GATE — · Revision
Verstandene Aufgabe / Ziel
Annahmen
- [Eingabe]
- [Ausführung]
- [Umfang] <Annahme zu Ein- oder Ausschlüssen>
Im Umfang
Nicht im Umfang
- <explizite Ausschlüsse>
Betroffene Dateien/Systeme
- <genaues Ziel und beabsichtigte Änderung>
Ausführung
Verifizierung
- <beobachtbare Akzeptanzprüfungen>
Rollback
- <wie aufgabenbezogene Änderungen rückgängig gemacht werden können oder Wiederherstellungsgrenzen>
Genehmigungsgrenze
Offene Entscheidungen
- <wesentliche ungeklärte Entscheidungen oder keine>
Gate-Status
- BEREIT ZUR GENEHMIGUNG
- oder BLOCKIERT — ENTSCHEIDUNG ERFORDERLICH
Lassen Sie Annahmekategorien weg, die nicht zutreffen. Erfinden Sie keine Annahmen, nur um die Vorlage zu füllen.
Kurzes Gate
PLAN GATE — · Revision
- Aufgabe:
- Ziel: <genaue Datei/System>
- Änderung: <begrenzte Änderung>
- Annahme: <getaggte Annahme, falls vorhanden>
- Verifizierung: <Prüfung>
- Rollback: <Rückgängigmachung oder Wiederherstellungsgrenzen>
- Status: BEREIT ZUR GENEHMIGUNG
Wechseln Sie zum vollständigen Gate, wenn die Aufgabe nicht mehr trivial ist.
Genehmigung
Warten Sie auf explizite Genehmigung des sichtbaren Umfangs. „Genehmigt“, „los“, „fortfahren“ oder direkte Bestätigung genehmigt die aktuell identifizierte Revision.
Die Genehmigung bleibt für unveränderten Umfang gültig. Fordern Sie sie nicht wiederholt an und lassen Sie sie nicht von einem Mitarbeiter erneut einholen.
Eine wesentliche Änderung an Zielen, Aktionen, Anforderungen, Verifizierung, Rollback oder Befugnissen erfordert ein überarbeitetes Gate. Stoppen Sie die betroffene Arbeit, bis diese Revision genehmigt ist.
Ungelöste wesentliche Entscheidungen bedeuten BLOCKIERT — ENTSCHEIDUNG ERFORDERLICH, nicht BEREIT ZUR GENEHMIGUNG. Ein unbekanntes Ziel wird nicht durch die Bezeichnung „zugehörige Dateien“ autorisiert.
Sensible Grenzen
Legen Sie immer den spezifischen Umfang offen und holen Sie explizite Genehmigung ein, bevor Sie Folgendes ändern:
- Anmeldeinformationen, Authentifizierung oder Berechtigungen.
- Server, Netzwerke, Fernzugriff (SSH, VPN) oder öffentliche Ports.
- Agentenlaufzeit-Einstellungen: Kanäle, Routing oder Modelleinstellungen.
- Dauerhafte Identität oder Betriebsanweisungen.
- Externe Sendungen, Veröffentlichungen, Konten oder Ausgaben.
- Destruktive Operationen oder Kundendaten.
Routinemäßige Antworten an den Benutzer im aktuellen Gespräch sind keine Drittanbieter-Sendungen. Gewöhnliches Verfassen von Gesprächsinhalten ist keine dauerhafte Anweisungsänderung.
Wenn Sie eine Anmeldeinformation hinzufügen, ersetzen oder korrigieren, bestätigen Sie während der Nur-Lese-Vorbereitung, wie das Ziel diese tatsächlich konsumiert (eigener Anmeldeinformationsspeicher, eine eigene Datei, eine Umgebungsvariable oder ein Proxy, der das Geheimnis während der Übertragung einfügt), unter Verwendung des Integrationsschemas, der Dokumentation oder des Codes, nicht durch Annahme. Wenn das Ziel die Anmeldeinformation selbst lesen muss, leiten Sie sie nicht durch einen Proxy, der den Wert während der Übertragung ersetzt; verwenden Sie den unterstützten Anmeldeinformationsspeicher der Integration oder ihre eigene Datei. Geben Sie den Namen des Geheimnisses an, wo es gespeichert wird, die genauen Hosts, die es verwenden dürfen, sowie alle Laufzeitkonfigurationen oder Neustarts, die die Integration erfordert, bevor Sie das Geheimnis anfordern. Für eine Anmeldeinformationsdatei, die der Integration gehört, setzen Sie das Gate für die maskierte Eingabe durch den Menschen, die Verweigerung des Überschreibens einer vorhandenen Datei, den genauen Besitzer und restriktive Berechtigungen, eine Verifizierung, die den Wert niemals ausgibt, und die Entfernung nur dieser Datei als Rollback; schließen Sie einen Neustart nur ein, wenn die Integration einen erfordert. Sammeln Sie Geheimnisse nur durch eine maskierte Eingabeaufforderung oder den eigenen Geheimnisspeicher des Werkzeugs; niemals durch Chat, Protokolle, Befehlszeilenargumente oder mehrzeilige Shell, die durch Chat eingefügt wird, und niemals durch Kopieren oder Aliasieren eines vorhandenen Geheimnisses. Fordern Sie eine neue Eingabe unter dem erforderlichen Namen an. Wenn keine maskierte Eingabeaufforderung oder kein Geheimnisspeicher verfügbar ist oder die maskierte Anforderung den Benutzer nicht erreicht, stoppen Sie und teilen Sie dem Benutzer den genauen Geheimnisnamen, seinen Speicherort und die Hosts mit, die ihn verwenden dürfen, damit er ihn dort selbst eingeben kann. Behalten Sie die alte Anmeldeinformation, bis der nächste Lauf die neue verifiziert, und löschen Sie die alte nur, wenn diese Löschung im genehmigten Umfang enthalten war.
Für eine Migration von Klartext-Konfiguration zu einem Geheimnisspeicher setzen Sie das Gate für die vollständige Menge der Besitzer jedes Geheimnisses und behandeln Sie die Klartext-Entfernung als Einweg nach der Verifizierung. Erstellen Sie einen Schnappschuss nur von nicht-geheimen Strukturen und Hashes; erstellen Sie niemals eine Klartext-Rollback-Kopie. Sammeln Sie jeden aktuellen Wert durch maskierte Eingabe, verwenden Sie dann den unterstützten Audit- oder Migrationsplaner des Werkzeugs, um zu beweisen, dass jeder gespeicherte Wert seiner genauen Klartext-Quelle entspricht, ohne einen der beiden anzuzeigen. Überprüfen und testen Sie einen Plan, der auf die genehmigten Pfade beschränkt ist, überprüfen Sie erneut sowohl die Konfiguration als auch die Plan-Hashes unmittelbar vor der Anwendung, wenden Sie dann einmal an. Verifizieren Sie die genauen Geheimnisverweise, null verbleibende Klartexte, ungelöste oder überschattete Werte, keine Geheimnisreste in anderen Speichern, die das Werkzeug führt (Caches, Sitzungs- oder Authentifizierungsspeicher, Backups, temporäre oder Migrationsdateien), und eine gültige Konfiguration, bevor Sie etwas neu starten. Starten Sie nur die Besitzer neu, die es erfordern, beweisen Sie, dass der neue Prozess läuft, anstatt einem geplanten Bericht zu vertrauen, und testen Sie jeden Anmeldeinformationsbesitzer End-to-End. Behalten Sie den nicht-geheimen Migrationsplan, bis alle Post-Neustart-Prüfungen bestanden sind, entfernen Sie dann nur diesen Plan. Rotieren Sie keine Anmeldeinformationen, es sei denn, eine Offenlegung oder eine separate Rotationsentscheidung erfordert es.
Kontinuität und Wiederherstellung
Für mehrschrittige Arbeiten schließen Sie einen vereinbarten Aufgabendatensatzort in den Schreibumfang ein. Bewahren Sie dort die genehmigte Revision, den Genehmigungsverweis und die Ausführungsnachweise auf. Es ist keine bestimmte Tracking-Anwendung erforderlich.
Halten Sie Aufzeichnungs-IDs auf einen Workstream beschränkt. Wenn die Arbeit zu einem wesentlich anderen Ziel oder einer anderen Artefaktfamilie wechselt, starten Sie eine neue Aufzeichnungsserie und verlinken Sie die vorherigen Nachweise, anstatt die Sequenz fortzusetzen oder Verläufe zu konsolidieren. Wenn ein falsch abgestecktes Gate nicht genehmigt wurde und keine Artefakte erstellt hat, geben Sie seine vorgeschlagene ID auf und geben Sie den unveränderten Umfang unter der richtigen Serie neu aus; erstellen Sie keine Migrationsarbeit.
Für versionierungsempfindliche Bestandsverzeichnisse erfassen Sie die beobachtete Laufzeit-/Katalogversion und bewahren Sie diesen Schnappschuss auf. Wenn ein Upgrade aussteht, schließen Sie das Upgrade ab und verifizieren Sie es, bevor Sie Zulassungslisten oder Abhängigkeitsziele einfrieren, und erstellen Sie dann eine vergleichbare Revision nach dem Upgrade; überschreiben Sie niemals stillschweigend den Vorzustand.
Überprüfen Sie nach einer Unterbrechung den tatsächlichen Zustand, bevor Sie fortfahren. Wiederholen Sie keine Aktion, deren Ergebnis ungewiss ist.
Wenden Sie die in AGENTS.md festgelegte Wiederherstellungsgrenze an; wenn keine festgelegt ist, erlauben Sie höchstens einen sicheren, logischen, im Umfang enthaltenen Versuch für einen Blocker, der vom leitenden Agenten und allen Mitarbeitern gemeinsam genutzt wird. Ein Wiederholungsversuch ist nicht obligatorisch und kann die Befugnisse nicht erweitern. Ein erneutes Gating oder Starten eines neuen Mitarbeiters setzt das Kontingent nicht zurück.
Melden Sie sowohl erfolgreiche als auch erfolglose Wiederherstellungen. Dokumentieren Sie, was fehlgeschlagen ist, was versucht wurde, warum und das beobachtete Ergebnis.
Ein korrekt gemeldeter Blocker ist ein gültiges Ergebnis – keine Erlaubnis, die Fertigstellung zu improvisieren. Geben Sie klar an, wenn das angeforderte Arbeitsergebnis unvollständig bleibt.