Agents Bridge

Deutsch — Offizielle Deutsch-Version / Documento Oficial en Deutsch.

AGENTS-BRIDGE — the Lifeboat, auch: Time Capsule (Deutsch)

Beinamen „Lifeboat" (dt. Rettungsboot) und „Time Capsule": agents-bridge IST das Wiederherstellungs-Set der Agenten-Regeldateien (CLAUDE.md/ GEMINI.md/GPT.md/AGENTS.md) — trug diese Funktion bisher nur ohne erkennbaren Namen. „Lifeboat" passt in die nautische Namensfamilie um die Bridge-Metapher (Wheelhouse, Deep-Diver, Lower Decks); „Time Capsule" betont die zweite Seite derselben Funktion — ein versiegelter, hash-verifizierter Zustand, der spaeter unversehrt wiederhergestellt werden kann. Kein Rename: der technische Name bleibt agents-bridge, beide Beinamen sind sprechende Synonyme.

Nutze diesen Skill, um ein kleines dateibasiertes Multi-Provider-System zu erfassen, zu prüfen, zu übertragen oder wiederherzustellen. Pro Instanz gibt es genau eine ausdrücklich gewählte Hauptanbieterdatei. Kein Anbieter, Dateiname, Host oder Cloud-Verzeichnis ist implizit kanonisch.

Workflow & Vorgehen

1. Lies alle lokalen Anweisungen, Locks und Datenschutzregeln für Quelle und Ziel. Bewahre fremde Änderungen.

2. Führe python scripts/bridge.py discover --root <instanz> aus. discover darf nur einen eindeutigen Marker agents-bridge-primary: true übernehmen. Bei keinem oder mehreren Claims stoppt der Workflow mit einem Decision-Briefing; es gibt keinen Dateinamen-Default.

3. Lege ein Profil gemäß references/profile-v3.schema.json an. Es benennt Hauptfläche, Anbieterflächen, Wahrheitsquellen, Pointergraph, Recovery, Memory-Silos, Messenger, Presence, Locks sowie Privacy-Includes/-Excludes.

4. Prüfe das Profil und erfasse die Instanz ohne Quellmutation:

   python scripts/bridge.py profile-validate --profile <profil.json>
   python scripts/bridge.py capture --profile <profil.json> --root <quelle> --output <neues-paket>
   

5. Prüfe das Paket mit doctor und erzeuge mit plan oder restore ohne --apply eine Vorschau. Bestehende Dateien werden nie blind überschrieben.

6. Wende den Restore erst nach Prüfung mit --apply --yes --backup-dir <backup> --receipt <receipt.json> an. Danach folgen verify und ein echter nativer Lesetest für Claude, Codex/GPT, Gemini oder den neutralen Anbieter.

7. Bei Fehlern: Drift klären oder den exakten Receipt mit rollback --yes zurückrollen. Ein zweiter Restore muss idempotent melden.

8. Nutze message send|ack|status, memory, presence und lock claim|release|status nur als kleine Dateiverträge. Messenger ersetzt weder Ticket-Master noch Scheduler; Memory-Silos werden nie automatisch zusammengeführt.

Sicherheitsgrenzen

• Ein Loader oder Redirect ist bevorzugt. Eine Projektion ist nur zulässig, wenn native Referenzen nicht funktionieren; sie enthält Quellhashes, Provenienz, generated_at und eine Driftkennung. Kontrollierte Regeneration erfolgt nur in ein neues Paket mit capture --regenerate-projections.
• Alle Profilpfade sind UTF-8-kodiert, relativ und plattformneutral. Exporte sind manifestiert und auf Includes/Excludes begrenzt.
• Secrets, Credentials und persönliche absolute Pfade werden fail closed abgewiesen oder bei explizitem redact-Modus protokolliert ersetzt.
• Bei vorhandenem Controlroom bleibt dieser Koordinationsautorität. agents-bridge ist dann ausschließlich Bootstrap-, Recovery- und Dateiadapter und dupliziert keine zentrale Runtime.

Verträge und Beispiele stehen in references/contracts.de.md, references/truth-topologies.md, references/inventory-contract.md und references/migration-2-to-3.de.md. Die englische Fassung ist SKILL.en.md.