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

75 lines
3.5 KiB
Markdown

# 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.