Zum Inhalt

Wahrheitsschichten

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

Zweck

Diese Seite erklärt, welche Schicht in AWX welche Aufgabe hat. Sie ist eine Lesefassung für Robert und Agenten; sie ersetzt keine kanonische Datei.

Die vier relevanten Schichten

Source of Truth

Bindende Regeln und aktueller Projektstand.

Beispiele:

/Users/mschky/AEGIS_WORKSPACE/README.md
/Users/mschky/AEGIS_WORKSPACE/STRUCTURE.md
/Users/mschky/AEGIS_WORKSPACE/vBRAIN.md
/Users/mschky/AEGIS_WORKSPACE/ENTITY_INDEX.md
/Users/mschky/AEGIS_WORKSPACE/AEGIS/README.md
/Users/mschky/AEGIS_WORKSPACE/UPLINK/PROTOCOL.md
repo- oder kundenlokale STATE.md / DECISIONS.md / RUNBOOK.md

Wenn etwas wichtig oder bindend ist, muss es in der zuständigen Source-of-Truth-Datei stehen.

Wiki

Dieses Wiki erklärt, verdichtet und verlinkt. Es ist Lesefläche, nicht neue Autorität.

Das Wiki darf:

  • Zusammenhänge verständlich machen.
  • stabile Regeln aus kanonischen Quellen erklären.
  • kurze Orientierung für Robert und Agenten liefern.
  • auf Source-of-Truth-Dateien zurückverweisen.

Das Wiki darf nicht:

  • die kanonischen Dateien ersetzen.
  • Rohdaten, Secrets, Runtime-Dumps oder breite Exporte aufnehmen.
  • durch schöne Formulierungen neue Governance-Wahrheit erfinden.

UPLINK transportiert Agentenkommunikation.

Merksatz:

A schreibt B -> Datei in UPLINK/inbox/B/
Outbox -> Archiv/Receipt, kein Broadcast

UPLINK ist kein Memory, keine Source of Truth und kein Task-Bus. Handlungsrelevante Kommunikation liegt in der Ziel-Inbox.

Context Capsule

Die AWX Context Capsule ist ein kompakter Snapshot für Agenten:

/Users/mschky/AEGIS_WORKSPACE/UPLINK/context/awx/current.md

Sie ist nützlich für schnellen Überblick, aber nicht bindend. Bei Widerspruch gewinnt die zuständige Source-of-Truth-Datei.

Konfliktregel

Wenn Schichten widersprechen:

  1. zuständige Source-of-Truth-Datei gewinnt.
  2. repo-/kundenlokale Truth-Datei gewinnt für ihren Scope.
  3. Wiki erklärt nur und wird nachgezogen.
  4. UPLINK transportiert nur Handoffs/Antworten.
  5. Capsule wird aktualisiert, wenn sie offensichtlich stale ist.

AWX Root-Git Boundary

Der AWX Root-Git versioniert kuratierte Governance-/Kontextwahrheit. Er ist kein Vollbackup.

Versioniert werden typischerweise:

  • Root-Bootstrap-Dateien.
  • AEGIS/.
  • UPLINK/context/awx/ und ausgewählte AEGIS-Governance-Dokumente.
  • Markdown-Kundenakten unter backoffice/.
  • templates/.
  • UPLINK/PROTOCOL.md, UPLINK/templates/, UPLINK/context/.

Nicht versioniert werden Masse, Runtime und Risiko:

  • eigene Repos unter repos/.
  • maschke-vdna/ als eigenes Git-Repo.
  • UPLINK Live-inbox/ und outbox/.
  • Secrets, Credentials, Vaults, .env.
  • Rohdaten, Exports, Medien, Logs, Datenbanken, Caches, Runtime-State.

Kanonische Quellen

/Users/mschky/AEGIS_WORKSPACE/STRUCTURE.md
/Users/mschky/AEGIS_WORKSPACE/ENTITY_INDEX.md
/Users/mschky/AEGIS_WORKSPACE/UPLINK/PROTOCOL.md
/Users/mschky/AEGIS_WORKSPACE/UPLINK/context/awx/current.md