Zum Inhalt

UPLINK in kurz

Status: current Owner: AEGIS Last reviewed: 2026-05-25 Source: /Users/mschky/AEGIS_WORKSPACE/UPLINK/PROTOCOL.md

Merksatz

UPLINK ist einfache Agent-zu-Agent-Kommunikation:

A schreibt B → Datei in UPLINK/inbox/B/
B antwortet A → neue Datei in UPLINK/inbox/A/
B dokumentiert für sich → optional in UPLINK/outbox/B/

Outbox ist Archiv/Receipt, kein Broadcast.

  • Fallback- und Handoff-Kanal für Agenten und Robert.
  • Markdown-Dateien mit klarer Ziel-Inbox.
  • Zustellfläche für handlungsrelevante Nachrichten.
  • Protokollierter Ort für Handoffs, wenn Gateway/API/CLI nicht der Primärkanal ist.
  • Kein Primärchat.
  • Kein Memory-Ersatz.
  • Keine Source of Truth.
  • Kein Message-Bus.
  • Keine Task-Queue.
  • Kein Broadcast-System über Outboxen.
  • Kein Ort für Secrets, Tokens, Cookies, Auth-Dumps oder Runtime-Rohdaten.

Inbox vs. Outbox

Inbox

UPLINK/inbox/<zielagent>/ ist Zustellung.

Wenn ein Agent etwas lesen oder tun soll, muss eine neue Markdown-Datei in seiner Inbox liegen.

Outbox

UPLINK/outbox/<absender>/ ist Antwort-/Ablageprotokoll des Absenders.

Eine Datei in einer Outbox stellt nichts an andere Agenten zu. Wenn aus einer Outbox-Nachricht echte Arbeit für einen anderen Agenten entsteht, wird eine neue Datei in die Ziel-Inbox geschrieben. Das Original bleibt unangetastet.

Pflicht-Header für neue Handoffs

Von:
An:
Datum:
Status:
Priorität:
Scope:

Empfohlene Statuswerte:

  • new — neue Nachricht oder neues Handoff.
  • reply — Antwort an Zielagent.
  • info — reine Status-/FYI-Meldung ohne direkten Arbeitsauftrag.
  • done — erledigtes Record / Receipt.
  • blocked — Rückfrage, Risiko oder fehlende Voraussetzung.
  • proposal — Vorschlag ohne Ausführungsfreigabe.
  • legacy — Altbestand oder nicht-kanonische Datei.
  • unclear — Ziel, Header oder Zuständigkeit nicht eindeutig.
  • superseded — durch spätere Nachricht, Doku oder Entscheidung ersetzt.

Cleanup-Grenze

Aktiv dokumentiert ist V2 Soft-Move, aber weitere produktive Apply-Läufe stehen auf Transport-Hold.

Erlaubt nach V2-Klassifikation:

  • keine Deletes
  • keine Rewrites / keine Inhaltsänderung bestehender Nachrichten
  • keine Kompression als Standard
  • eindeutig geschlossene, ersetzte, reine Info- oder Legacy-Handoffs dürfen nach UPLINK/archive/YYYY/MM/<agent>/<inbox|outbox>/ verschoben werden
  • jede Bewegung braucht ein Manifest mit Pfad, Grund, Klassifikation, Hash vor/nach und Verifikation

Bleibt aktiv in inbox/:

  • new, reply, blocked, proposal, unclear
  • offene Robert-Entscheidungen
  • Auth-/Admin-/Credential-/Public-Exposure-/Cutover-Themen
  • laufende Git-Closeout-, Runtime- oder Kundenkommunikationsblocker

Aktueller Hold: Nach dem ersten Robert-Inbox-V2-Apply liegen 15 archivierte Robert-Handoffs auf aktiven Oberflächen wieder/noch in UPLINK/inbox/robert/. AEGIS macht keine weiteren produktiven V2-Apply-Läufe, bis ARCUS die move-aware Transport-/Mirror-Semantik oder eine äquivalente Markierung verifiziert.

Ownership

  • AEGIS besitzt UPLINK-Semantik, Statuswerte, Cleanup-/Archiv-Regeln, Dispatcher-Zielbild und Governance-Auswertung.
  • ARCUS besitzt Transport, Sync, Permissions, Bridge, Hermes/Gateway/Runtime und Secrets/Env.
  • Robert wird nur für echte Grenzentscheidungen einbezogen: Deletes, Moves, Renames, physische Archivierung, Public Exposure, Credentials/Auth, Policy-Neuland oder produktive Restarts/Cutovers.

Kanonische Quelle

Für bindende Regeln gilt:

/Users/mschky/AEGIS_WORKSPACE/UPLINK/PROTOCOL.md