Concepts in depth
Konzepte im Detail
Every concept, explained. Jedes Konzept, erklärt.
A plain-language reference for the ideas behind BKS open-bridge. Read top to bottom, or jump to one concept. Each section is honestly marked: proven (built and self-used), a bet (a wager we'd defend), or open (roadmap, not yet built). The evidence is the BKS-Lab team's daily use, on its own instances and on the closed instances it runs for other companies; nobody outside those has reported using it yet. The full ledger lives in ROADMAP.md.
Eine Klartext-Referenz für die Ideen hinter BKS open-bridge: von oben nach unten lesen oder zu einem Konzept springen. Jeder Abschnitt ist ehrlich markiert: bewiesen (gebaut und selbst genutzt), eine Wette (die wir verteidigen würden) oder offen (Roadmap, noch nicht gebaut). Der Beleg ist der tägliche Gebrauch durch das BKS-Lab-Team, auf den eigenen Instanzen und auf geschlossenen Instanzen, die es für andere Firmen betreibt; außerhalb davon hat bisher niemand eine Nutzung gemeldet. Das vollständige Verzeichnis steht in ROADMAP.md.
A bridge is your agent's memory of your world: a plain folder of markdown and YAML in git that an AI coding agent reads at the start of every session, so it always knows who you are, your repos and clients, your rules, and what you worked on yesterday. The folder itself runs nothing (no database, no daemon, no hosted service), so there is nothing to host and no second app to maintain. Everything else here lives inside a bridge.
Eine Bridge ist das Gedächtnis deines Agenten für deine Welt: ein schlichter Ordner aus Markdown und YAML in Git, den ein KI-Coding-Agent zu Beginn jeder Session liest, sodass er stets weiß, wer du bist, welche Repos und Kunden du hast, welche Regeln gelten und woran du gestern gearbeitet hast. Der Ordner selbst betreibt nichts (keine Datenbank, kein Daemon, kein gehosteter Dienst), also gibt es nichts zu hosten und keine zweite App zu pflegen. Alles Weitere hier lebt innerhalb einer Bridge.
Read the bridge concept in full →Das Bridge-Konzept im Detail →
- 1The substrate: markdown and YAML in gitDas Substrat: Markdown und YAML in Git
- 2Three cluster wrappers plus work/Drei Cluster-Wrapper plus work/
- 3The always-on layer every session readsDie Always-on-Schicht, die jede Session liest
- 4The agent reads it at session startDer Agent liest sie beim Session-Start
- 5and writes back to work/log.mdund schreibt zurück in work/log.md
- 1Where a file lives decides its scopeWo eine Datei liegt, entscheidet ihren Scope
- 2/bridge-promote reads each file's scope/bridge-promote liest den Scope jeder Datei
- 3scope: core goes upstream as a PRscope: core geht als PR nach upstream
- 4scope: org goes to your optional org overlayscope: org geht in dein optionales Org-Overlay
- 5scope: user stays localscope: user bleibt lokal
- 6Template updates come back with git merge mainTemplate-Updates kommen mit git merge main zurück
The cold-start problemDas Kaltstart-Problem
Every session starts from scratch.Jede Session beginnt bei null.
Most AI work todayKI-Arbeit heute
A bare My-Documents folder: everyone piling up their own chaos, every conversation rebuilding context and structure from scratch.Ein nackter My-Documents-Ordner. Jeder häuft sein eigenes Chaos an, jede Unterhaltung baut Kontext und Struktur von Grund auf neu.
With BKS open-bridgeMit BKS open-bridge
A clear, separated layout the agent files into (shipped as example structures, not reinvented by every user).Ein klares, getrenntes Layout, in das der Agent ablegt. Als Beispielstrukturen mitgeliefert, nicht von jedem Nutzer neu erfunden.
The substrate, shownDas Substrat, gezeigt
Plain text in git. Clone it and look.Plain Text in Git: Klone es und schau rein.
No adjectives. examples/agency/ is a real, complete config you can clone today; the STATUS and work log below are the shape your own work/ takes once you start logging.Keine Adjektive. examples/agency/ ist eine echte, vollständige Config, die du heute klonen kannst; der STATUS und das Arbeitslog unten sind die Form, die dein eigenes work/ annimmt, sobald du anfängst zu loggen.
BKS open-bridge's pieces form one connected web. Click through them on the interactive map, or read the plain-language guide.Die Bausteine von BKS open-bridge bilden ein verbundenes Netz. Sieh jeden einzelnen auf einer interaktiven Karte zum Klicken, oder lies den Leitfaden in einfacher Sprache.
What your agent gainsWas dein Agent gewinnt
Two things this gives your agent: more context, less chaos.Zwei Dinge, die das deinem Agenten gibt: mehr Kontext, weniger Chaos.
Both were coined by the team at BKS-Lab. The plain meaning leads, the name follows.Beide wurden im Team bei BKS-Lab geprägt. Die schlichte Bedeutung führt, der Name folgt.
Persistent context, always loadedBleibender Kontext, immer geladen
An independent "third side" beside your model and your tool. BKS-Lab calls this a Context Booster.Eine modell- und frontend-unabhängige „dritte Seite". Bei BKS-Lab „Context Booster" genannt.
You work with whatever model and whatever frontend you like. BKS open-bridge layers in persistent context about your world (your repos and clients, your machines, what you worked on yesterday), so the agent stops loading the wrong client. The boost comes from a layer beside both. It doesn't care what you run, because the substrate is plain text every runtime can read.Du arbeitest mit dem Modell und dem Frontend, das du willst. BKS open-bridge legt persistenten Kontext über deine Welt darüber: deine Repos und Kunden, deine Maschinen, woran du gestern gearbeitet hast. Damit hört der Agent auf, den falschen Kunden zu laden. Der Boost kommt von einer dritten Seite, der egal ist, was du nutzt. Denn das Substrat ist Plain Text, den jede Runtime lesen kann.
Ready-made structure for AI workFertige Struktur für KI-Arbeit
Structuring unstructured AI dialogues. BKS-Lab calls this a Chaos Tamer.„Strukturierung unstrukturierter KI-Dialoge". Bei BKS-Lab „Chaos Tamer" genannt.
It ships ready-made structure you don't have to invent: a board, a log, and per-task status (backlog → doing → review → done over tasks/ and streams/). Decisions, findings and status get filed in plain text as you work. Unstructured sessions become a persistent, compounding record instead of another My-Documents pile.Es liefert fertige Struktur mit, die du nicht erfinden musst: ein Board, ein Log und Per-Task-Status (backlog → doing → review → done über tasks/ und streams/). Entscheidungen, Erkenntnisse und Status werden als Plain Text abgelegt, während du arbeitest: Aus unstrukturierten Sessions wird ein persistentes, wachsendes Protokoll statt des nächsten My-Documents-Haufens.
Bet / Roadmap Workspace separation as the default is the intended stance: agreed in principle, not yet built (labelled honestly below). Workspace-Trennung als Default ist die beabsichtigte Haltung. Im Prinzip vereinbart, noch nicht gebaut (unten ehrlich gekennzeichnet).
What else it can doWas es noch kann
The four core pieces stand on their own. The rest is optional.Schon die vier Kernteile bringen dir etwas. Der Rest ist optional.
The four core pieces (context registry, task management, skills & commands, standing orders) run from a fresh clone; they're what powered the day above. Everything below is optional, USER-scope, off until you turn it on.Die vier Kernteile: Kontext-Registry, Task-Management, Skills & Befehle, Standing Orders. Sie laufen direkt aus einem frischen Clone heraus (du hast sie oben im Tagesablauf gesehen). Alles darunter ist optional, USER-scope, und bleibt aus, bis du es einschaltest.
Optional: turn on when you want itOptional: einschalten, wenn du es brauchst 10
Everything that needs you waits in one place until the live source says it is done. The briefing shows it first; a machine that stays on can fill it while you are away.Alles, was dich braucht, wartet an einer Stelle, bis die Live-Quelle „erledigt“ sagt. Das Briefing zeigt es zuerst; eine Maschine, die an bleibt, kann es füllen, während du weg bist.
Declare email, Telegram, Signal or iMessage once; the agent drafts, you send.E-Mail, Telegram, Signal oder iMessage einmal deklarieren; der Agent entwirft, du sendest.
One source of truth for your machines. Wake, ssh, check, deploy, Tailscale-first.Eine Wahrheitsquelle für deine Maschinen: wecken, ssh, prüfen, deployen, Tailscale zuerst.
Point it at an inbox; it names, files and logs each doc, and never deletes.Richte es auf einen Posteingang; es benennt, legt ab und protokolliert jedes Dokument, löscht aber nichts.
The identities you hold (signatures, tax data, filing paths), so things land in the right place.Die Identitäten, die du hast (Signaturen, Steuerdaten, Ablagepfade), damit alles am richtigen Ort landet.
Offload heavy or parallel work; it returns a clean summary. Native on Claude Code; inline elsewhere.Schwere oder parallele Arbeit auslagern; es liefert eine saubere Zusammenfassung. Nativ in Claude Code; anderswo läuft es inline.
Read work items from GitHub Projects; the agent keeps your board and tasks aligned. Gated, never auto.Work-Items aus GitHub Projects lesen; der Agent hält Board und Tasks abgeglichen, immer mit Freigabe, nie automatisch.
A named binding of member repos and config overlays, cloned into a public-fork-safe path and indexed in a shared machine-global registry.Eine benannte Bindung aus Mitgliedsrepos und Config-Overlays, geklont in einen für öffentliche Forks sicheren Pfad und in einer geteilten maschinenweiten Registry indiziert.
One declared run on one machine, in one file: report, poller, daemon, watcher or agent. Provisioned from the declaration and reconciled against the live service manager, never against a status field.Ein deklarierter Lauf auf einer Maschine, in einer Datei: Bericht, Poller, Daemon, Wächter oder Agent. Aus der Deklaration eingerichtet und gegen den lebenden Dienstverwalter abgeglichen, nie gegen ein Statusfeld.
Bridge-Agents are persistent, addressable A2A endpoints that front one persona to the outside world; the MCP→A2A gateway makes them reachable from MCP-only frontends too, always under a human gate.Bridge-Agents sind persistente, adressierbare A2A-Endpunkte, die eine Persona nach außen vertreten; das MCP→A2A-Gateway macht sie auch aus reinen MCP-Frontends erreichbar. Das läuft immer unter menschlicher Freigabe.
A local web page on 127.0.0.1 that shows briefing, inbox and tasks, agent tabs, sessions, workers and tokens, and acts on them with a click. Alpha, still being extended; off until you switch it on.Eine lokale Webseite auf 127.0.0.1, die Briefing, Inbox und Aufgaben, Agent-Tabs, Sitzungen, Worker und Tokens zeigt und auf Klick darauf handelt. Alpha, wird noch ausgebaut; aus, bis du es einschaltest.
Everything here ships and runs today. What is not built yet (workspace separation as the default, and more) is in the status section on the start page, labelled as a bet or open, not as a feature.Alles hier wird mitgeliefert und läuft heute. Was noch nicht gebaut ist, etwa die Workspace-Trennung als Default, steht im Status-Abschnitt der Startseite, als Wette oder offen gekennzeichnet, nicht als Feature.
Get startedLoslegen
One prompt. Your own private bridge.Ein Prompt. Deine eigene, private Bridge.
Paste it into Claude Code, Codex or Copilot CLI. Your agent follows SETUP.md, shows you its plan and waits for your go.Kopier ihn in Claude Code, Codex oder Copilot CLI. Dein Agent folgt SETUP.md, zeigt dir seinen Plan und wartet auf dein Go.