Persistent context for your AI coding agentBleibender Kontext für deinen KI-Coding-Agenten

Stop re-explaining your project to your AI agent. It already knows your repos.

Erklär deinem KI-Agenten nicht jedes Mal alles neu. Er kennt deine Repos schon.

Your repos, clients, conventions, last week's decisions — your coding agent reads them at the start of every session, so context compounds instead of resetting. Just plain markdown and YAML in git, any model or frontend.Deine Repos, Kunden, Konventionen, die Entscheidungen von letzter Woche — dein Coding-Agent liest sie zu Beginn jeder Session wieder ein, damit Kontext wächst, statt sich zurückzusetzen. Nur Plain-Markdown und YAML in Git, egal welches Modell oder Frontend.

examples/agency · shipped demo workspacemitgelieferter Demo-Workspace
> good morning Morning. You're mid-incident on bigcorp: Stripe webhook retries are failing in prod (P1, opened yesterday) — root cause traced to the webhook secret; next step is the retry fix. startupxyz onboarding: email-verification wired, 6 tests green. Board: 2 doing · 1 review · cart-a11y waits on PR #214.
> guten morgen Morgen. Auf bigcorp läuft ein P1: Stripe-Webhook-Retries schlagen in prod fehl — Root Cause gestern gefunden (Webhook-Secret); nächster Schritt ist der Retry-Fix. startupxyz-Onboarding: E-Mail-Verifikation steht, 6 Tests grün. Board: 2 doing · 1 review · cart-a11y wartet auf PR #214.

This is the shipped demo workspace answering — run it yourself in 2 minutes. Das ist der mitgelieferte Demo-Workspace — führ ihn in 2 Minuten selbst aus.

open-bridge is one shared CORE framework — skills, agents, protocols, schemas — bridged to your private USER instance, which holds your projects, clients, conventions and work log. CORE ships down; your knowledge promotes up. The full detailed view is below. open-bridge ist ein gemeinsames CORE-Framework — Skills, Agenten, Protokolle, Schemas — verbunden mit deiner privaten USER-Instanz, die deine Projekte, Kunden, Konventionen und dein Arbeitslog hält. CORE kommt runter, dein Wissen wandert hoch. Die ausführliche Ansicht steht weiter unten.

CORE ⟷ USER — one framework, bridged to your world. CORE ⟷ USER — ein Framework, verbunden mit deiner Welt. See the full picture → Ganzes Bild →

Public·MIT·clone & read it yourself·runs our company daily Public·MIT·selbst klonen & lesen·betreibt täglich unsere Firma

Newly public — hit a rough edge? Tell us.Frisch öffentlich — irgendwo hakt es? Sag's uns.

The cold-start problemDas Kaltstart-Problem

Every session starts from scratch.Jede Session beginnt bei null.

Re-explain your conventions to the agent, again.Dem Agenten deine Konventionen wieder neu erklären.
Load the wrong client's context and only notice halfway through.Den falschen Kunden-Kontext laden und es erst auf halbem Weg merken.
No record of what you decided last week.Kein Protokoll dessen, was du letzte Woche entschieden hast.

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.

examples/agency/2 separated clients2 getrennte Kunden
examples/agency/ ├── ecosystem.yaml # repo + client registry ├── bridge-config.yaml ├── identity/ │ ├── accounts/ # cloud/mail inventory │ └── mandants/ # recipient groups ├── workflow/ │ ├── calendars/ │ └── contexts/webapp/ # per-engagement world ├── infra/ │ ├── channels/ remotes/ backups/ └── .claude/agents/ # ops-officer, code-analyst …
work/tasks/bigcorp-migration/STATUS.mdverbatim from the READMEwortgetreu aus dem README
+# STATUS — bigcorp-migration
+status: doing
+context: bigcorp
+last: Migrated the invoice pipeline to the new schema; one test still red.
+next: Fix the failing UBL-validation case, then open the PR.
work/log.md$ cat work/log.md
## Fri 20.06
| 14:22 | Decision | bigcorp | Pinned the schema to v2 — v3 breaks the old exports. |

That row is in the repo six months from now, in a diff, readable by any agent. (Copied character-for-character from the README.)Diese Zeile steht in sechs Monaten noch im Repo, in einem Diff, lesbar von jedem Agenten. (Zeichengenau aus dem README.)

What you write today, it reads in six months.

Was du heute schreibst, liest es in sechs Monaten.

Agents can cat a file, but they can't hold an API key. Because the whole thing is plain text in git, there is no migration, no second app, no proprietary store your data has to outlive — it is inspectable, diff-able, and yours. The constellation on the Explore page is this same knowledge base as a graph; the STATUS and log to the left are one real row of it.Agenten können eine Datei catten, aber keinen API-Key halten. Weil das Ganze Plain Text in Git ist, gibt es keine Migration, keine zweite App, keinen proprietären Speicher, den deine Daten überleben müssten — es ist einsehbar, diff-bar und deins. Die Konstellation auf der Explore-Seite ist genau diese Wissensbasis als Graph; der STATUS und das Log links sind eine echte Zeile davon.

no databasekeine Datenbank no SaaSkein SaaS no daemonkein Daemon

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.

How it worksSo funktioniert es

At session start the agent reads the substrate — and the record compounds. Bei Session-Start liest der Agent das Substrat — und das Protokoll wächst.

Plain text in git. The agent reads it before answering, then writes back what happened — so day two starts where day one ended. Plain Text in Git. Der Agent liest es, bevor er antwortet, und schreibt zurück, was passiert ist — Tag zwei beginnt dort, wo Tag eins aufhörte.

Session start · readSession-Start · gelesen
CLAUDE.md2.1 KB
ecosystem.yaml1.4 KB
work/board.md0.8 KB
work/log.md3.6 KB
STATUS.md
status: doing
context: bigcorp
owner: ops-officer
work/log.md · written backwork/log.md · zurückgeschrieben
| 09:14 | Decision bigcorp | scoped the inbound pipeline
| 11:02 | Fix startupxyz | retry on 429, backoff added
| 14:22 | Decision bigcorp | Pinned the schema to v2 — v3 breaks the old exports.
work/board.mdwork/board.md
backlog1
webhook auth
doing1
inbound pipe
review1
retry/backoff
done1
env bootstrap
1

Day oneTag eins You explain the world once. The agent writes it down as it works. Du erklärst die Welt einmal. Der Agent schreibt sie auf, während er arbeitet.

2

Day twoTag zwei It reads the record at session start — and already knows your repos, clients and last decisions. Er liest das Protokoll beim Start — und kennt schon deine Repos, Kunden und letzten Entscheidungen.

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.

Context BoosterContext Booster

An independent "third side" beside your model and your tool — coined "Context Booster" at BKS-Lab.Eine modell- und frontend-unabhängige „dritte Seite" — bei BKS-Lab als „Context Booster" geprägt.

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 der Agent aufhört, den falschen Kunden zu laden. Der Boost kommt von einer dritten Seite, der egal ist, was du nutzt — weil das Substrat Plain Text ist, den jede Runtime lesen kann.

Chaos TamerChaos Tamer

Structuring unstructured AI dialogues — coined at BKS-Lab.„Strukturierung unstrukturierter KI-Dialoge" — bei BKS-Lab geprägt.

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 — so 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).

A day with itEin Tag damit

Say it plainly — get the work, already in context.Sag es schlicht — hol dir die Arbeit, schon im Kontext.

good morning, briefingguten Morgen, Briefing

Get today's board, the day's git activity and what's gone stale — and it already knows which repos and which client you're on.Hol dir das heutige Board, die Git-Aktivität des Tages und was liegen geblieben ist — und es weiß schon, welche Repos und welcher Kunde dran sind.

where was I on the bigcorp migration?wo war ich bei der bigcorp-Migration?

Get the task's exact state read back — "last: migrated the invoice pipeline, one test still red. next: fix the failing case, then open the PR" — so you resume mid-thought.Lass dir den genauen Stand der Aufgabe zurücklesen — „zuletzt: Invoice-Pipeline migriert, ein Test noch rot. als Nächstes: den fehlschlagenden Fall fixen, dann den PR öffnen" — und steig mitten im Gedanken wieder ein.

switch to startupxyzwechsle zu startupxyz

Get that client's repos, conventions and open tasks loaded from its own workspace — so the agent works from startupxyz's facts, not bigcorp's.Hol dir die Repos, Konventionen und offenen Aufgaben dieses Kunden aus seinem eigenen Workspace — der Agent arbeitet mit den Fakten von startupxyz, nicht denen von bigcorp.

why did we pin the schema to v2?warum haben wir das Schema auf v2 gepinnt?

Get the answer pulled from a dated log row you wrote back then — "v3 breaks the old exports" — still in the repo, in plain text, months on.Hol dir die Antwort aus einer datierten Log-Zeile, die du damals geschrieben hast — „v3 bricht die alten Exporte" — Monate später noch im Repo, als Plain Text.

draft a status mail to the bigcorp leadentwirf eine Status-Mail an den bigcorp-Lead

Get a ready message in your voice, with your signature, the facts pulled from the task — you read it and send; the agent never sends for you.Hol dir eine fertige Nachricht in deiner Stimme und mit deiner Signatur, die Fakten aus der Aufgabe gezogen — du liest sie und sendest; der Agent sendet nie für dich.

/archive/archive

Get the week's log rolled into a dated summary and a fresh log started — a paper trail that compounds week over week instead of evaporating.Lass dir das Wochen-Log zu einer datierten Zusammenfassung verdichten und ein frisches Log starten — eine Spur, die Woche für Woche wächst, statt zu verdampfen.

Jobs, not featuresAufgaben, keine Features

What people run on it.Was darauf läuft.

Org-aware without forkingOrg-bewusst ohne Fork

One /overlay add <git-url> gives every teammate your org's skills and configs on a vanilla clone — no per-person fork to maintain.Ein /overlay add <git-url> gibt jedem im Team die Org-Skills und -Configs auf einem unveränderten Clone — kein Fork pro Person.

Client status updatesKunden-Status-Updates

Turn a board item into a styled status email to the right recipient group — the sender is always you, nothing sends itself.Mach aus einem Board-Item eine gestylte Status-Mail an die richtige Empfängergruppe — Absender bist immer du, nichts sendet sich selbst.

Meeting → protocol → tasksMeeting → Protokoll → Tasks

Meeting notes become classified insights and board-mapped tasks you approve — decisions stop evaporating after the call.Meeting-Notizen werden zu klassifizierten Erkenntnissen und board-zugeordneten Tasks, die du freigibst — Entscheidungen verdampfen nach dem Call nicht mehr.

Document intake & filingDokumenten-Intake & Ablage

Point it at inboxes and flagged mail — every document gets renamed, tagged and filed by your routing rules, and never deleted.Richte es auf Inboxen und geflaggte Mails — jedes Dokument wird umbenannt, getaggt und nach deinen Routing-Regeln abgelegt, und nie gelöscht.

Multi-instance data isolationMulti-Instanz-Datentrennung

One bridge per client or org — separate clones, some strictly local-only, indexed in a registry so data never cross-contaminates.Eine Bridge pro Kunde oder Organisation — getrennte Clones, manche strikt lokal, in einer Registry indiziert, damit sich Daten nie vermischen.

Knowledge that grows itselfWissen, das sich selbst aufbaut

File-based memory plus a learning loop — postmortems propose improvements, a curator consolidates patterns, the system compounds.Dateibasiertes Gedächtnis plus Lernschleife — Postmortems schlagen Verbesserungen vor, ein Kurator konsolidiert Muster, das System wächst.

Cross-tool skills, private by defaultTool-übergreifende Skills, privat per Default

One skills tree serves Claude Code, Copilot CLI, Codex, Cursor and Gemini — scope-routing keeps private content local while CORE flows upstream.Ein Skills-Baum bedient Claude Code, Copilot CLI, Codex, Cursor und Gemini — Scope-Routing hält Privates lokal, während CORE upstream fließt.

All eight jobs, with the primitives behind each →Alle acht Aufgaben, mit den Primitiven dahinter →

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 — 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

ChannelsChannelsdocs →

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.

RemotesRemotesdocs →

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.

Document filingDokumente ablegendocs →

Point it at an inbox; it names, files and logs each doc — never deletes.Richte es auf einen Posteingang; es benennt, legt ab und protokolliert jedes Dokument — löscht nie.

PersonasPersonasdocs →

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.

Sub-agentsSub-Agentendocs →

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.

Tracker syncTracker-Syncdocs →

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.

WorkspacesWorkspacesdocs →

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.

AgentsAgentsdocs →

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 — immer unter menschlicher Freigabe.

And the full layout — every path, the CORE/USER split, the rest — is in the docs →Und das ganze Layout — jeder Pfad, der CORE/USER-Split, der Rest — steht in den Docs →

Everything here ships and runs today. Roadmap items — workspace separation as the default, and more — live in the honesty board below, labelled as bets, not features.Alles hier wird mitgeliefert und läuft heute. Roadmap-Punkte — Workspace-Trennung als Default und mehr — stehen unten im Status-Board, als Wetten gekennzeichnet, nicht als Features.

The honest objectionDer ehrliche Einwand

Why not just a CLAUDE.md and a folder of my own?Warum nicht einfach eine CLAUDE.md und ein eigener Ordner?

A dotfile of instructionsEin Dotfile mit Anweisungen

  • One flat instruction sheet, re-read each session.Ein flaches Anweisungsblatt, jede Session neu gelesen.
  • No persistent record of what happened last week.Kein persistentes Protokoll dessen, was letzte Woche passierte.
  • One context bleeds into another; you separate it by hand.Ein Kontext sickert in den nächsten durch; du trennst von Hand.
  • You invent the structure yourself, from a blank folder.Du erfindest die Struktur selbst, aus einem leeren Ordner.

A structured workspaceEin strukturierter Workspace

  • +Separate per-context worlds — identity, workflow, work.Getrennte Kontext-Welten — identity, workflow, work.
  • +A work log + task board that survive across sessions.Ein Arbeitslog + Task-Board, die über Sessions hinweg bestehen.
  • +Shipped example structures — relief, not a blank page.Mitgelieferte Beispielstrukturen — Entlastung, kein leeres Blatt.
  • +A CORE/USER split — shared templates update without ever clobbering your private data.Ein CORE/USER-Split — geteilte Templates aktualisieren sich, ohne je deine privaten Daten zu überschreiben.

Not for a single-repo project or ad-hoc one-off scripting — the coordination layer is overhead you won't use.Nicht für ein Single-Repo-Projekt oder Ad-hoc-Einmal-Scripting — die Koordinationsschicht ist Overhead, den du nicht brauchst.

The evidence boundaryDie Beweis-Grenze

What's proven, what's a bet, what's open.Was bewiesen ist, was eine Wette ist, was offen ist.

BKS open-bridge runs the company that builds it — every feature exists because we needed it on a real workday. You're early: it's newly public, no external users yet. The ledger below says exactly what that means.BKS open-bridge betreibt die Firma, die es baut — jedes Feature existiert, weil wir es an einem echten Arbeitstag gebraucht haben. Du bist früh dran: frisch öffentlich, noch ohne externe Nutzer. Was genau das heißt, steht ehrlich im Status-Board.

Provenbuilt · self-used N=1gebaut · selbst genutzt N=1
  • The three-cluster layout (identity / infra / workflow), the Task-Management system (board, log, per-task STATUS), the CORE/USER branch split, personas, standing orders, and the skills layer all run from a fresh clone today.Das Drei-Cluster-Layout (identity / infra / workflow), das Task-Management (Board, Log, Per-Task-STATUS), der CORE/USER-Branch-Split, Personas, Standing Orders und die Skills-Schicht laufen heute direkt aus einem frischen Clone heraus.
  • Scope-routing works in practice: each file carries a scope (core / org / user); /promote routes per scope — demonstrated, not theoretical.Scope-Routing funktioniert in der Praxis: jede Datei trägt einen Scope (core / org / user); /promote routet pro Scope — demonstriert, nicht theoretisch.
  • GitHub task sync works for our own use — the agent already knows whether a task also exists in GitHub and syncs it. Jira is untested.GitHub-Task-Sync funktioniert für unseren Eigengebrauch — der Agent weiß bereits, ob ein Task auch in GitHub existiert, und syncht ihn. Jira ist ungetestet.
Betfalsifiable wagersfalsifizierbare Wetten
  • Markdown + YAML + git is the substrate each new generation of agent runtimes keeps reading natively, because models read text, not a vendor API. Falsified if the dominant stack forces a vendor schema (Notion-MCP / Linear-MCP) as the standard.Markdown + YAML + Git ist das Substrat, das jede neue Generation von Agenten-Runtimes nativ weiterliest, weil Modelle Text lesen, keine Vendor-API. Falsifiziert, wenn der dominante Stack ein Vendor-Schema (Notion-MCP / Linear-MCP) als Standard erzwingt.
  • A lean, opinionated, MIT-OSS method beats a vendor workflow-builder for users who want to switch models freely. Falsified if Cursor/Anthropic ship a first-class markdown-in-git mode.Eine schlanke, meinungsstarke MIT-OSS-Methode schlägt einen Vendor-Workflow-Builder für Nutzer, die Modelle frei wechseln wollen. Falsifiziert, wenn Cursor/Anthropic einen erstklassigen Markdown-in-Git-Modus liefern.
  • Workspace separation as a hard default — once built — is the right call for most users, not an opt-in switch (the default itself is still on the roadmap; see Open).Workspace-Trennung als harter Default — sobald gebaut — ist für die meisten Nutzer die richtige Wahl, kein Opt-in-Schalter (der Default selbst steht noch auf der Roadmap; siehe Open).
Openunsolvedungelöst
  • Zero external users today — newly public, not yet adopted. Until real users arrive, every statement about a target audience is a hypothesis, not a market test.Heute null externe Nutzer — frisch öffentlich, noch nicht verbreitet. Bis echte Nutzer kommen, ist jede Aussage über eine Zielgruppe eine Hypothese, kein Markttest.
  • Workspace-separation-as-default and the "ask if unplaceable" rule are not yet built into BKS open-bridge; the hard-silo vs soft-folder default is unresolved.Workspace-Trennung-als-Default und die „frage, wenn unzuordenbar"-Regel sind noch nicht in BKS open-bridge eingebaut; harter Silo vs. weicher Ordner ist ungeklärt.
  • First-session value is thin: a fresh clone gives little reward until work/log.md is filled.Der Erst-Session-Wert ist dünn: ein frischer Clone gibt wenig zurück, bis work/log.md gefüllt ist.
  • Terminology cleanup is pending (work-task → Task-Management; the work/ folder made unambiguous).Begriffs-Bereinigung steht aus (work-task → Task-Management; der work/-Ordner eindeutig gemacht).

If this resonates: star the repo and 👍 the ROADMAP issues you want most — that's literally the signal priorities are decided by.Wenn dich das anspricht: Stern aufs Repo und 👍 auf die ROADMAP-Issues, die du am dringendsten willst — genau daraus entsteht die Priorisierung.

The concept, in briefDas Konzept, kurz

A bridge — and you can run many, safely.Eine Bridge — und du kannst viele betreiben, sicher.

A bridge is your agent's memory of your world — plain markdown and YAML in git it reads at session start. You can run many: one per client or context, all on one shared CORE — one foundation, separate private rooms. It compounds safely because your data and the shipped templates live on different paths.Eine Bridge ist das Gedächtnis deines Agenten für deine Welt — Plain-Markdown und YAML in Git, das er zum Session-Start liest. Du kannst viele betreiben: eine pro Kunde oder Kontext, alle auf einem gemeinsamen CORE — ein Fundament, getrennte private Räume. Es wächst sicher, weil deine Daten und die mitgelieferten Templates auf verschiedenen Pfaden liegen.

Improvements go upstream with /promote. And it's runtime-agnostic: one skills/ tree symlinks into each tool — tested on Claude Code, working via AGENTS.md elsewhere, honestly labelled.Verbesserungen gehen mit /promote nach upstream. Und es ist runtime-unabhängig: ein skills/-Baum wird per Symlink in jedes Tool eingebunden — getestet auf Claude Code, anderswo via AGENTS.md, ehrlich gekennzeichnet.

The runtime matrix and the full CORE/USER routing live in the concept guide and the interactive map.Die Runtime-Matrix und das vollständige CORE/USER-Routing stehen im Konzept-Leitfaden und in der interaktiven Karte.

Get startedLoslegen

Try it now, or adopt it properly.Jetzt ausprobieren — oder richtig übernehmen.

Try — 2 minutes, throwawayAusprobieren — 2 Minuten, wegwerfbar

The shipped demo workspace: two clients, a filled board, two days of log, a P1 mid-flight. Don't push — this clone points at the public repo.Der mitgelieferte Demo-Workspace: zwei Kunden, ein gefülltes Board, zwei Tage Log, ein P1 mittendrin. Nicht pushen — dieser Clone zeigt aufs öffentliche Repo.

git clone https://github.com/bks-lab/open-bridge.git cd open-bridge/examples/agency claude # or: codex, copilot

Needs an agent CLI on your machine — e.g. npm install -g @anthropic-ai/claude-code.Braucht eine Agent-CLI auf deinem Rechner — z. B. npm install -g @anthropic-ai/claude-code.

Then ask:Dann frag: good morning · where was I on the payment retry? · why is the cart task in review?

Everything it answers is read from plain markdown sitting in that folder — open work/log.md next to it and watch the trick disappear. That's the product.Alles, was es antwortet, liest es aus purem Markdown in diesem Ordner — öffne daneben work/log.md und sieh zu, wie der Trick verschwindet. Genau das ist das Produkt.

Adopt — private origin firstÜbernehmen — erst ein privates Origin

This is a public repo, so step 1 gives your data a private home: clone it, then re-home the remotes at once. Your repo becomes origin; BKS open-bridge stays a read-only upstream, so a stray push can't publish your branch.Das ist ein öffentliches Repo, darum gibt Schritt 1 deinen Daten ein privates Zuhause: klonen, dann sofort die Remotes umziehen. Dein Repo wird origin; BKS open-bridge bleibt ein read-only upstream — ein versehentlicher Push kann deinen Branch nicht veröffentlichen.

# 1. Clone, then re-home the remotes at once: open-bridge becomes a read-only # upstream, your own private repo becomes origin. git clone https://github.com/bks-lab/open-bridge.git my-bridge cd my-bridge git remote rename origin upstream gh repo create <you>/my-bridge --private --source=. --remote=origin --push # 2. Let the push guard classify your new origin offline: printf 'repo: <you>/my-bridge\nis_public: false\n' > .bridge-origin # 3. Arm the guard and repair the cross-tool discovery symlinks: ./bin/setup # 4. Onboard in Claude Code — writes to a user/{name} branch on YOUR private origin: /bridge-onboard

/bridge-onboard then sets everything up and arms the pre-push guard before your user/{name} branch exists. On native Windows, run bin/setup.ps1 instead of ./bin/setup./bridge-onboard richtet dann alles ein und schaltet den pre-push-Guard scharf, bevor dein user/{name}-Branch existiert. Unter nativem Windows bin/setup.ps1 statt ./bin/setup ausführen.

The "Use this template" button works too — private from the first second. But GitHub gives that copy a fresh history, so your first CORE update needs git merge --allow-unrelated-histories upstream/main once; every merge after that is ordinary.Der Knopf „Use this template" geht auch — privat ab der ersten Sekunde. GitHub gibt dieser Kopie aber eine frische History, deshalb braucht dein erstes CORE-Update einmalig git merge --allow-unrelated-histories upstream/main; jeder weitere Merge ist gewöhnlich.

Or hand it to your agentOder gib es deinem Agenten

One prompt — it plans, builds your private copy, verifies the guard, and onboards you.Ein Prompt — er plant, baut deine private Kopie, verifiziert den Guard und onboardet dich.

Set up BKS open-bridge for me — https://github.com/bks-lab/open-bridge It is a plain-text memory layer (markdown + YAML in a git repo) that an AI coding agent reads at the start of every session. First, before you touch anything: check that git is installed, check whether the GitHub CLI (gh) is authenticated, ask me what to call my private copy (default: my-bridge), then show me your plan and wait for my go. Then, in this order: 1. Clone it and give it a PRIVATE home. The public repo ends up as a read-only "upstream", my own private repo as "origin": git clone https://github.com/bks-lab/open-bridge.git <name> cd <name> git remote rename origin upstream gh repo create <me>/<name> --private --source=. --remote=origin --push Use this order rather than GitHub's "Use this template" button: a template copy starts a fresh history, and the documented update path (git merge upstream/main) then refuses to run. No gh? Stop and ask me to create an empty PRIVATE repo on github.com, then continue with: git remote add origin <url> && git push -u origin main 2. Everything below runs inside <name>. Arm the safety hooks: ./bin/setup # native Windows: bin/setup.ps1 3. Record that my new origin is private. Without this the push guard cannot classify the target offline, and it refuses my first legitimate push: printf 'repo: <me>/<name>\nis_public: false\n' > .bridge-origin Do this only because the repo you created in step 1 is private. 4. Show me all three proofs: git remote -v # origin must be MY private repo git config core.hooksPath # must be scripts/hooks cat .bridge-origin 5. Stop here and tell me to restart you inside <name>. A session loads this repo's skills and instructions from the folder it starts in, so /bridge-onboard cannot exist in your current session — that folder did not exist when it began. 6. In the new session it should greet me and offer the setup lanes by itself. If it does not, run /bridge-onboard. No slash commands? Read skills/bridge-onboard/SKILL.md, then skills/bridge-onboard/references/workflow.md, and run the phases with me inline. Hard rules: never push anything to bks-lab/open-bridge; my user/* branch goes only to my private origin; never write a secret into a file; ask me before anything destructive.
Richte BKS open-bridge für mich ein — https://github.com/bks-lab/open-bridge Das ist eine Plain-Text-Gedächtnisschicht (Markdown + YAML in einem Git-Repo), die ein KI-Coding-Agent zu Beginn jeder Session liest. Zuerst, bevor du irgendetwas anfasst: prüfe, ob git installiert ist, prüfe, ob die GitHub CLI (gh) eingeloggt ist, frag mich, wie meine private Kopie heißen soll (Default: my-bridge), zeig mir deinen Plan und warte auf mein Go. Dann, in dieser Reihenfolge: 1. Klone es und gib ihm ein PRIVATES Zuhause. Das öffentliche Repo wird zum read-only "upstream", mein eigenes privates Repo zum "origin": git clone https://github.com/bks-lab/open-bridge.git <name> cd <name> git remote rename origin upstream gh repo create <ich>/<name> --private --source=. --remote=origin --push Nimm diesen Weg statt GitHubs "Use this template"-Knopf: eine Template-Kopie beginnt eine frische History, und der dokumentierte Update-Pfad (git merge upstream/main) verweigert danach den Dienst. Kein gh? Halt an und bitte mich, ein leeres PRIVATES Repo auf github.com anzulegen, dann weiter mit: git remote add origin <url> && git push -u origin main 2. Alles Weitere läuft in <name>. Aktiviere die Safety-Hooks: ./bin/setup # natives Windows: bin/setup.ps1 3. Halte fest, dass mein neues origin privat ist. Ohne das kann der Push-Guard das Ziel offline nicht einordnen und verweigert meinen ersten legitimen Push: printf 'repo: <ich>/<name>\nis_public: false\n' > .bridge-origin Mach das nur, weil das in Schritt 1 angelegte Repo privat ist. 4. Zeig mir alle drei Nachweise: git remote -v # origin muss MEIN privates Repo sein git config core.hooksPath # muss scripts/hooks sein cat .bridge-origin 5. Halt hier an und sag mir, dass ich dich in <name> neu starten soll. Eine Session lädt die Skills und Anweisungen dieses Repos aus dem Ordner, in dem sie startet — /bridge-onboard kann es in deiner jetzigen Session nicht geben, weil dieser Ordner bei ihrem Start noch nicht existierte. 6. In der neuen Session sollte es mich begrüßen und die Setup-Wege von selbst anbieten. Falls nicht, führe /bridge-onboard aus. Keine Slash-Commands? Lies skills/bridge-onboard/SKILL.md, dann skills/bridge-onboard/references/workflow.md, und geh die Phasen interaktiv mit mir durch. Harte Regeln: niemals irgendetwas nach bks-lab/open-bridge pushen; mein user/*-Branch geht nur auf mein privates origin; niemals ein Secret in eine Datei schreiben; vor allen destruktiven Aktionen nachfragen.

Found a rough edge? Open an issue — the most useful thing you can do right now.Irgendwo hakt es? Öffne ein Issue — das Nützlichste, was du gerade tun kannst.