Zum Inhalt springen

Labor · Open Source

BKS open-bridge: ein Platz, von dem aus KI-Agenten nach Ihren Regeln arbeiten

BKS open-bridge ist ein Git-Repository aus einfachem Text, das ein KI-Agent zu Beginn jeder Sitzung liest: Kunden, Repos, Maschinen, Aufgaben, Regeln und was gestern passiert ist. Von dort aus stoßen Sie alles an, und jeder Schritt läuft durch Ihre Regeln. Wir arbeiten täglich damit, entwickeln es öffentlich und stellen es unter MIT-Lizenz bereit.

Website ansehenDemo in 90 SekundenEigene Bridge einrichtenQuellcode auf GitHub

Praxisaufbau 01Gebaut · im eigenen Betrieb

Eine Brücke, von der aus alles läuft

Aufgaben liegen im Tracker, Zugänge in Notizen, geplante Läufe auf verschiedenen Rechnern, Absprachen in Mails. Ein Agent, der helfen soll, sieht davon nur, was man ihm gerade erklärt.

Versuchsstand

Wählen Sie eine Station und geben Sie einen Befehl.

Bereit. Wählen Sie eine Station.

Befehle an Aufgaben

Lesen läuft sofort. Ändern wird protokolliert. Was nach außen geht oder sich nicht zurücknehmen lässt, wartet auf Sie. Manches hält eine Regel an.

Befehle

0

von einem Platz aus

Von Ihnen freigegeben

0

nach außen, unumkehrbar

Von Regeln angehalten

0

egal wer fragt

Protokollzeilen

0

jede Änderung

Beispiel mit erfundenen Namen, Zahlen und Ergebnissen. Die Stationen entsprechen Ordnern, die BKS open-bridge anlegt. Lesen ohne Rückfrage, Freigabe vor Aktionen nach außen oder unumkehrbaren Schritten und der Push-Schutz sind Teil des öffentlichen Regelwerks.

So funktioniert der Aufbau Wählen Sie eine Station auf dem Bogen und geben Sie einen Befehl. Der Strahl läuft durch den Regelring in der Mitte. Seine Farbe zeigt, was die Regeln entscheiden, und der Hauptschirm schreibt mit.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Die Stationen sind Beispiele. Welche davon eine Instanz nutzt, legt jede selbst fest, die meisten sind optional.

Die Ordner, die Freigaberegel für Schritte nach außen und der Push-Schutz sind Teil von BKS open-bridge und öffentlich dokumentiert.

Praxisaufbau 02Gebaut · im eigenen Betrieb

Kontext, der von Sitzung zu Sitzung wächst

Ein KI-Agent beginnt jede Sitzung ohne Erinnerung. Pfade, Befehle, Ansprechpartner und offene Aufgaben müssen immer wieder erklärt werden.

Versuchsstand

Fünf Arbeitssitzungen mit einem KI-Agenten, einmal ohne und einmal mit gemeinsamem Kontext.

Ohne gemeinsamen Kontext

  1. Sitzung 1Fehler im Checkout ansehenPfad zum RepositoryBefehl fürs DeploymentOffene Aufgabe
  2. Sitzung 2Kundin informierenAnsprechpartnerinTon der KundenmailsOffene Aufgabe
  3. Sitzung 3Korrektur ausrollenPfad zum RepositoryBefehl fürs DeploymentWer freigibt
  4. Sitzung 4Wochenbericht schreibenOffene AufgabeAnsprechpartnerinTon der Kundenmails
  5. Sitzung 5Nächste Korrektur ausrollenPfad zum RepositoryBefehl fürs DeploymentWer freigibt

Mit BKS open-bridge

  1. Sitzung 1Fehler im Checkout ansehenPfad zum RepositoryBefehl fürs DeploymentOffene Aufgabe
  2. Sitzung 2Kundin informierenAnsprechpartnerinTon der KundenmailsOffene Aufgabe
  3. Sitzung 3Korrektur ausrollenPfad zum RepositoryBefehl fürs DeploymentWer freigibt
  4. Sitzung 4Wochenbericht schreibenOffene AufgabeAnsprechpartnerinTon der Kundenmails
  5. Sitzung 5Nächste Korrektur ausrollenPfad zum RepositoryBefehl fürs DeploymentWer freigibt

musste fragenwusste es schon

Was der Agent liest

Verzeichnis der Instanz

Pfad zum Repository: ~/projekte/shop

  1. Protokoll noch leer

Rückfragen ohne Kontext

0

jede Sitzung beginnt leer

Rückfragen mit BKS open-bridge

0

nur, was noch nirgends steht

Zurückgeschrieben

0

Einträge im Protokoll

Vereinfachtes Beispiel mit erfundenen Werten. Lesen zu Beginn und Zurückschreiben am Ende sind Teil von BKS open-bridge und öffentlich dokumentiert. Die Darstellung macht keine Aussage dazu, wie viel Zeit ein bestimmtes Team spart.

So funktioniert der Aufbau Spielen Sie fünf Beispielsitzungen ab, oben ohne und unten mit BKS open-bridge. Zählen Sie die Rückfragen und sehen Sie rechts, wie das Protokoll wächst, aus dem die nächste Sitzung liest.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Das Modell ist vereinfacht. Es zeigt das Prinzip, nicht wie viel Zeit ein bestimmtes Team spart.

Lesen zu Beginn und Zurückschreiben am Ende sind Teil von BKS open-bridge und öffentlich dokumentiert.

Praxisaufbau 03Gebaut · im eigenen Betrieb

Aufgaben, die über die Sitzung hinaus halten

Was in einer Sitzung besprochen wurde, ist in der nächsten weg. Aufgaben verstreuen sich über Chats, Notizen und Tracker, und niemand merkt, wenn zu viel gleichzeitig läuft.

Versuchsstand

Ändern Sie den Status einer Aufgabe. Das Board wird neu erzeugt, das Protokoll bekommt eine Zeile.

Aufgabenordner

  1. work/tasks/checkout-fehler/STATUS.mdZahlungsfehler im Checkoutshop
    Zahlungsfehler im Checkout
  2. work/tasks/portal-anmeldung/STATUS.mdAnmeldung im Kundenportalportal
    Anmeldung im Kundenportal
  3. work/tasks/schnittstelle-v2/STATUS.mdSchnittstelle auf Version 2shop
    Schnittstelle auf Version 2
  4. work/tasks/datenexport/STATUS.mdDatenexport für die Buchhaltungportal
    Datenexport für die Buchhaltung
  5. work/tasks/wochenbericht/STATUS.mdWochenberichtintern
    Wochenbericht
  6. work/streams/betrieb/STATUS.mdLaufender Betriebbetrieb
    Laufender Betrieb

    Stream, läuft dauerhaft und zählt nicht

work/board.md, erzeugt

# Board · WIP 3/3## Doing (2)- checkout-fehler · shop- schnittstelle-v2 · shop## Review (1)- portal-anmeldung · portal## Backlog (2)- datenexport · portal- wochenbericht · intern## Streams (1)- betrieb · betrieb## Done (0)

work/log.md

  1. Heute noch keine Änderung

Gleichzeitig in Arbeit

0

doing und review, ohne Streams

Grenze

3

warnt, blockiert nicht

Zeilen im Protokoll

0

eine je Änderung

Beispielaufgaben mit erfundenen Namen. Aufgabenordner, die vier Statuswerte, das erzeugte Board, das Protokoll und die Warngrenze sind Teil von BKS open-bridge und öffentlich dokumentiert.

So funktioniert der Aufbau Ändern Sie den Status einer Aufgabe. Rechts entsteht das Board neu und das Protokoll wächst. Schieben Sie mehr als drei Aufgaben in Arbeit, dann warnt die Grenze, blockiert aber nichts. Mit „Guten Morgen“ liest der Agent beides zurück.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Das Board ist eine Sicht für die Instanz. Ein Abgleich mit GitHub oder Azure DevOps ist möglich, wird aber nicht gezeigt.

Aufgabenordner, die vier Statuswerte, das erzeugte Board und die Warngrenze sind Teil von BKS open-bridge.

Praxisaufbau 04Gebaut · im Build geprüft

Nur lesen, was die Arbeit gerade braucht

Je mehr ein Agent vorab liest, desto weniger Platz bleibt für die eigentliche Arbeit, und desto leichter greift er zur Unterlage des falschen Kunden.

Versuchsstand

Wählen Sie eine Anfrage. Hell sind die Dateien, die der Agent vor seiner Antwort liest.

Anfrage an den Agenten
Lesen

Board und Protokoll reichen: was gestern lief, was heute ansteht, was wartet.

Liest jede Sitzung

  • AGENTS.mdArbeitsanleitung2,1 KB
  • work/board.mdAufgaben0,8 KB
  • work/log.mdProtokoll der letzten Tage3,6 KB
  • Verzeichnis, als Karteeine Zeile je Kunde und Repo0,6 KB
  • RegelindexName und Auslöser je Regel0,4 KB

Öffnet erst, wenn die Arbeit es nennt

  • workflow/workspaces/nord.yamlRepos und Absprachen Kunde Nord1,4 KB
  • workflow/workspaces/sued.yamlRepos und Absprachen Kunde Süd1,3 KB
  • skills/e-rechnung/SKILL.mdAblauf bei Buchungsfehlern2,2 KB
  • protocols/standing-orders/mail-ton.mdRegel für den Ton von Mails0,9 KB
  • identity/personas/firma.yamlAbsender und Signatur0,7 KB
  • identity/mandants/team-nord.yamlEmpfängerkreis0,5 KB
  • infra/remotes/testserver.yamlZugang zum Testserver0,8 KB

Im Kontext der Sitzung

Unter der Obergrenze.

Gelesen

7,5

KB vor der Antwort

Obergrenze

12,0

KB, festgelegt

Dateien offen

5

von allen 12

Vereinfachtes Beispiel mit erfundenen Dateigrößen. Das feste Paket beim Sitzungsstart, das Öffnen bei Bedarf und die geprüfte Obergrenze (context-budget.yaml, scripts/measure-context.py) sind Teil von BKS open-bridge.

So funktioniert der Aufbau Wählen Sie eine Anfrage. Hell werden die Dateien, die der Agent vor seiner Antwort liest, der Balken zeigt die Menge gegen die Obergrenze. Schalten Sie auf „Alles vorab“ und sehen Sie, was dann passiert.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Die Dateigrößen sind erfunden. Welche Dateien bei welchem Stichwort öffnen, hängt von der jeweiligen Instanz ab.

Das feste Paket, das Öffnen bei Bedarf und die Obergrenze (context-budget.yaml, scripts/measure-context.py) sind Teil von BKS open-bridge.

Praxisaufbau 05Gebaut · nach Einrichtung aktiv

Private Arbeitsstände vor falschen Zielen schützen

Allgemeines Gerüst und private Arbeitsnotizen liegen im selben Arbeitsverzeichnis. Vor einer Veröffentlichung muss deshalb klar sein, wohin Änderungen gehen und ob private Bereiche enthalten sind.

Versuchsstand

Stellen Sie einen Push zusammen und schicken Sie ihn los.

Ziel
Branch am Ziel
Geänderte Dateien im Push

Noch kein Push.

Pushes versucht

0

in diesem Versuch

Durchgelassen

0

Gerüst überallhin, Persönliches nur privat

Angehalten

0

vor dem Übertragen, nicht danach

Nachgebaut nach dem öffentlichen Regelwerk von BKS open-bridge (rules/push-guard.md, scripts/hooks/pre-push). Namen und Dateien sind Beispiele. Der Schutz prüft Ablageort und Ziel, nicht den Inhalt einzelner erlaubter Dateien.

So funktioniert der Aufbau Stellen Sie einen Push zusammen: Ziel, Branch und geänderte Dateien. Die Schranke prüft wie der Push-Schutz von BKS open-bridge. Gerüst darf überall hin, Persönliches nur an ein als privat bestätigtes Ziel, und bei unbekanntem Ziel bleibt sie unten.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Der Schutz prüft Ablageort und Ziel, nicht den Inhalt einzelner erlaubter Dateien. Er ergänzt technische Zugriffskontrollen, ersetzt sie aber nicht.

Der Schutzmechanismus ist gebaut, wird lokal eingerichtet und von uns im eigenen Betrieb eingesetzt.

Praxisaufbau 06Dokumentierter Ablauf · agentenseitig befolgt

Vor jeder Sitzung den Arbeitskontext klären

Ein Agent kann ein Projekt frisch, auf dem falschen Arbeitsstand oder mit unvollständiger Konfiguration öffnen. Ohne Orientierung beginnt er leicht an der falschen Stelle.

Versuchsstand

Stellen Sie die Ausgangslage ein, der Agent prüft sie vor der ersten Antwort.

Ausgangslage

Aktueller Branch
user-Branch vorhanden

(ist der aktuelle)

bridge-config.yaml vorhanden

Erkannte Lage

  • Neu hierNEW USER
  • Falscher BranchWRONG BRANCH
  • Verwaiste KonfigurationORPHAN STATE
  • Konfiguration fehltBROKEN CONFIG
  • NormalNORMAL
  • user-Branch ohne KonfigurationBROKEN USER BRANCH
  • Arbeit am KernCORE DEV MODE

Erste Antwort des Agenten

Willkommen. Bevor ich Ihre Frage beantworte, zeige ich vier Wege zum Einstieg, vom kurzen Rundgang bis zur privaten Einrichtung.

Prüfungen vor der ersten Antwort

3

Branch, user-Branch, Konfiguration

Lagen gesehen

1

von sieben

Arbeitsstand geladen

0

nur in der Lage „Normal“

Nachgebaut nach rules/session-start.md in BKS open-bridge. Die Antworten sind sinngemäß zusammengefasst. Der Ablauf ist dokumentiert und wird vom Agenten befolgt, nicht von außen erzwungen.

So funktioniert der Aufbau Stellen Sie an der Schalttafel ein, auf welchem Branch der Agent startet und was vorhanden ist. Eine von sieben Lampen leuchtet, darunter steht, womit der Agent die Sitzung beginnt.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Der Ablauf ist dokumentiert, wird aber nicht durch einen externen Sitzungsmechanismus erzwungen. Seine Verlässlichkeit hängt von der Befolgung durch den Agenten ab.

Die Startlogik ist Teil von BKS open-bridge und öffentlich dokumentiert.

Praxisaufbau 07Gebaut · werkzeugübergreifend angelegt

Eine Wissensbasis für mehrere Agenten-Werkzeuge

Verschiedene Agenten-Werkzeuge suchen Arbeitsanleitungen an unterschiedlichen Stellen. Doppelte Kopien würden schnell auseinanderlaufen.

Versuchsstand

Ändern Sie die Beschreibung und sehen Sie, was die Werkzeuge lesen.

  • .claude/skills/Claude Codeliest Schreibt eine Zeile ins Arbeitsprotokoll, mit Uhrzeit und Kontext.alter Stand
  • .agents/skills/Codex und andereliest Schreibt eine Zeile ins Arbeitsprotokoll, mit Uhrzeit und Kontext.alter Stand
  • .github/skills/GitHub Copilotliest Schreibt eine Zeile ins Arbeitsprotokoll, mit Uhrzeit und Kontext.alter Stand

skills/protokoll/SKILL.md

Scope im Skill

Wohin der Skill weitergegeben wird

  • open-bridge (öffentlich)
  • Firmen-Overlay
  • persönliches Overlay
  • nur diese Instanz

Stellen mit dieser Anleitung

1

eine Ablage oder mehrere Kopien

Werkzeuge mit altem Stand

0

lesen nicht, was zuletzt geändert wurde

Weitergabe an

3

Ebenen für diesen Scope

Nachgebaut nach der Skill-Ablage von BKS open-bridge (skills/ und die Verweise .claude/skills, .agents/skills, .github/skills). Wie gut ein Werkzeug die Ablage liest, ist je Werkzeug und Betriebssystem unterschiedlich weit erprobt.

So funktioniert der Aufbau Ändern Sie die Beschreibung eines Skills einmal und sehen Sie, was die drei Werkzeuge lesen. Schalten Sie auf Kopien um, dann veralten sie. Der Scope im Skill entscheidet, wohin er weitergegeben wird.
Einordnung und Grenzen

Nicht Teil dieser Darstellung: Die Kompatibilität ist je Werkzeug und Betriebssystem unterschiedlich weit erprobt und muss in der jeweiligen Umgebung geprüft werden.

Die gemeinsame Ablage ist gebaut und in Claude Code täglich im Einsatz. Codex und Copilot CLI lesen denselben Bestand, Cursor und Gemini CLI haben wir selbst noch nicht getestet.

Was BKS open-bridge außerdem kann

Die Stände oben zeigen den Kern. Auf der Website von BKS open-bridge ist beschrieben, was sich darauf aufbauen lässt. Die meisten Teile sind optional und werden erst eingerichtet, wenn man sie braucht.

  • Demo in 90 Sekunden

    Ein Morgen mit dem Agenten: Sitzungsstart, Tagesübersicht, eine Störung mit Protokollanalyse und testgetriebener Korrektur, die Ersteinrichtung.

    Demo ansehen

  • Arbeitsbereiche

    Die Repos eines Kunden als benannter Arbeitsbereich. Stände werden festgehalten, Abweichungen sind auf einen Blick sichtbar.

    Workspaces

  • Geplante Läufe

    Jeder Bericht, jeder Abruf, jeder Dienst ist eine Datei. Die Dienstdatei für den Rechner wird daraus erzeugt und regelmäßig mit der Maschine abgeglichen.

    Workloads

  • Agenten nach außen

    Ein Agent beantwortet Fragen über A2A aus öffentlichen Inhalten und nimmt Anliegen auf, immer mit einem Menschen dazwischen.

    Bridge-Agents

  • Selbst ausprobieren

    Unser öffentlicher Agent läuft auf dieser Grundlage. Sie können ihm hier im Labor direkt Fragen stellen.

    Zum öffentlichen Agenten

  • Firmen-Overlay

    Eine Instanz abonniert die gemeinsame Konfiguration einer Firma, ohne sie zu forken. Bei uns hat eine neue Kollegin damit am ersten Tag eine Bridge, die unsere Kunden, Boards und Abläufe kennt. Eigene Änderungen haben Vorrang.

    Anwendungsfälle

  • Besprechung zu Aufgaben

    Aus dem Transkript einer Besprechung werden Protokoll und Aufgabenvorschläge. Übernommen wird, was Sie bestätigen.

    Anwendungsfälle

  • Zwei Beispiele zum Ausprobieren

    Eine Agentur mit zwei Kunden und einem offenen Vorfall, und eine Person mit mehreren Rollen: Beratung, Freelance, Haushalt, eigener Server. Beide laufen ohne Einrichtung.

    Beispiele auf GitHub

  • Alles auf einer Karte

    Stand September 2026 bringt BKS open-bridge 943 Dateien mit, 27 gehören Ihnen. Die Karte zeigt, wie die Teile zusammenhängen.

    Karte öffnen
Open Source und öffentlich überprüfbar
BKS open-bridge ist öffentlich dokumentiert, und wir betreiben BKS-Lab selbst damit. Eine einzelne Instanz hat seit dem 4. Juli 2026 4.072 Protokollzeilen und 164 abgeschlossene Aufgaben gesammelt. Die Schutzmechanismen ergänzen verantwortliche Arbeitsweisen, ersetzen aber weder eine Inhaltsprüfung noch technische Zugriffskontrollen.

Zur Laborübersicht →

Welche Regeln braucht ein Agent vor dem ersten Arbeitsschritt?

Wir ordnen Projektwissen, Zuständigkeiten und Schutzregeln so, dass ein Agent mit belastbarem Kontext startet und seine Grenzen kennt.

Gespräch vereinbaren