trading-system-docs/red-queen-architecture/EXTERNAL_REVIEW_CONTRACT.md

3.5 KiB

EXTERNAL_REVIEW_CONTRACT — Externe Review (Rain) & Ausschluss (Alice)

Geltungsbereich: Red Queen Autonomous Engineering System v1 Status: Verbindlicher Vertrag für externe Beteiligung Sprache: Deutsch (verbindlich)


1. Rolle von Rain

Rain ist ausschließlich für spezielle, externe Fälle vorgesehen:

  • External Second Opinion (unabhängige zweite Meinung zu einem schwierigen Problem).
  • Recovery (Wiederherstellung nach Block/Circuit Breaker, wo interne Mittel erschöpft sind).
  • Independent Reviewer (unabhängige Begutachtung, unabhängig von Red-Queen-internen Prüfern).

Rain ist NICHT Teil des normalen Graphen. Rain wird nicht automatisch delegiert und hat keinen normalen Stellenwert in der Mission-Ausführung.

2. Wichtige Ausschlüsse / Limits

  • Keine automatische Delegation an Rain: Rain wird nur manuell (durch Christian) oder auf klaren Eskalations-Pfad einbezogen.
  • Keine Root/SSH-Aufträge an Rain. Rain bekommt keine Remote-/Systemzugriffs-Aufträge, keine Secrets, keine privilegierten Befehle.
  • Rain arbeitet nur auf Basis einer klaren, begrenzten Frage (nicht Vollzugriff auf System).
  • Alice ist ausgeschlossen: keine Integration, keine Abhängigkeit, keine Delegation an Alice.

3. Format: "EXTERNAL REVIEW REQUIRED"

Bevor externe Hilfe (Rain) angefordert wird, erstellt Red Queen einen strukturierten Antrag:

EXTERNAL REVIEW REQUIRED
MISSION: <Missions-ID / Kurzname>
TASK: <TASK_ID / WP-ID>
REASON: <Grund: komplex / recovery / unabhängige Prüfung>
EVIDENCE: <objektive Belege: Logs, Fehler-Signatur, Ledger-Auszug>
ATTEMPTS: <bisherige Versuche / Zählerstand gemäß SAFETY_CONTRACT>
CURRENT STATE: <aktueller Zustand laut MISSION_STATE_MACHINE>
RISK: <Risiko / was kann schiefgehen>
WHAT NEEDS REVIEWED: <konkret welcher Teil geprüft werden muss>
RECOMMENDED QUESTION FOR RAIN: <präzise, einzelne Frage an Rain>

4. Ablauf / Freigabe-Gate

  1. Red Queen (oder Sub-Agent über Red Queen) erkennt Notwendigkeit der externen Review.
  2. Red Queen erstellt den Antrag im oben genannten Format.
  3. STOPP / WAIT FOR CHRISTIAN — Red Queen wartet auf Christian-Entscheidung, ob Rain einbezogen wird. Kein Selbst-Start der externen Review.
  4. Christian entscheidet über Rain (Freigabe/Nein). Nur mit christlicher Freigabe darf Rain einbezogen werden.
  5. Rain erhält die begrenzte, konkrete Frage (keine Root/SSH, keine Secrets).
  6. Ergebnis → Christian → Red Queen integriert nach Validierung.
  • WHO: Red Queen erstellt Antrag; Christian genehmigt; Rain antwortet auf die Frage.
  • WHEN: nur bei Escalation (nicht im normalen Arbeitsfluss).
  • WHERE: über den strukturierten Kanal; Rain wird über Christian koordiniert.
  • STATE: Bei externer Review → Mission/WP wird i. d. R. ESCALATED/BLOCKED und wartet.
  • SAFETY GATE / STOP: Ohne Christian-Genehmigung keine Rain-Einbindung (STOPP).

5. Regeln für Sub-Agenten

  • Sub-Agenten dürfen nicht direkt Rain kontaktieren oder externe Überprüfung anstoßen.
  • Kein Sub-Agent delegiert eigenständig an Rain.
  • Kein Root/SSH/Secret an Rain (unabhängig vom Anfragetext).
  • Alice: keinerlei Einbindung (Abstimmung nur über Christian bei Bedarf, ansonsten aus).

6. Auswirkungen auf den Betrieb

  • Der normale Graph bleibt ohne Rain/Alice: Red Queen + interne Sub-Rollen (PLANNER/MAKER/ CHECKER/DEBUGGER/TESTER/KNOWLEDGE).
  • Externe Review ist eine Ausnahme, nie die Regel.