v0.2.0
First public-preview release of open-bridge, the open-source layer of the
two-pole Bridge setup (open-bridge ↔ your private Bridge, with an optional
org overlay).
- Cluster-wrapper layout (
identity/,infra/,workflow/) with
default-to-folder per config type. - Agent-agnostic skill discovery (
.claude/skills,.agents/skills,
.github/skills) — Claude Code, Codex, Gemini CLI, Copilot CLI, Cursor. - Work system (board, log, STATUS), protocols, named sub-agents, themes,
project registry, onboarding wizard. - OSS governance stack: MIT License (code and content), DCO, trademark
policy, security policy, code of conduct. - Removed the legacy crew-role taxonomy (eight fixed roles as
crew_rolesin protocols,agents.default_rolesin bridge-config,
role vocabularies in themes). Protocols now declareagents:— a
list of concrete sub-agent names with ageneral-purposefallback;
themes map user-facing labels only. - Removed the unused situational-protocol/alert dispatch layer
(standing orders remain): the ten example protocols inprotocols/,
protocols/_templates/, thebridge-alertandbridge-mission
skills,docs/protocol-catalog.md,docs/orchestrator.md,
docs/observe-protocol.md, thework/active-protocol.yaml
mechanic, and thealerts:vocabulary block in themes. Standing
orders, the work system, briefing/debrief/archive, and the
calendar/mandants/channels/remotes surfaces are the core narrative.
Added
bridge-contributeskill — dedicated/contributeentry point for the
community: scans your branch, enforces the mandatory two-layer
content-safety gate, and opens a fork-based PR back to
bks-lab/open-bridge(split out ofbridge-promote).work/templates/week-summary.md— the weekly-summary template/archive
builds from now ships.work/_learning/_schema.proposal.yaml— proposal frontmatter schema
(mirrors the producer schema intask-close-postmortem).- Example instances for every config type:
examples/agency/gained
identity/accounts/cloud-provider.yamlandinfra/backups/topology.yaml;
rules/file-creation.mdpeer-example column now points only at files
that ship. - Top-level
imports/drop-zone ships (.gitkeep), matching.gitignore
anddocs/structure.md.
Changed
- README: directory structure now matches the shipped tree (
scripts/,
bin/, root policy files, realwork/contents), skill tree updated. bridge-promoteis now strictly commit-level; file-level contribution
flow moved tobridge-contribute.- Documentation truth pass: docs no longer reference files that are not
shipped. Visualization HTML variants are documented as rendered on
demand (not committed);build-constellation.pynow explains the
missing-render case instead of crashing; the calendar fire-loop and
Bridge-Deck integrations are consistently framed as optional companion
features (not yet public);bridge-audit's agent-identity check matches
the templates-only shipping design; briefing's backup-health step works
fromtopology.yaml/_state.yamldirectly; rename-registry and
leak-check vocabulary entries repaired and pruned to shipped paths. - Genericization pass: internal roadmap dates, personal device/channel
names, and a personal job-application pipeline removed from shipped docs
and example lists; placeholder examples (lab-device,news-digest,
router,network-reconcile) used instead.
Removed
- Documentation reduction pass (fewer docs over more docs): deleted the
pointer-onlydocs/promote-rules.md(rules live inrules/operations.mdrules/promote-safety.md),docs/work-system.md(CLAUDE.md § Work
System is the source of truth),DESIGN-md-guide.md(condensed into
DESIGN.md § Maintaining this file), and two unreferenced HTML templates.
docs/bridge-deck.mdreduced to a coming-soon stub;docs/remotes.mdand
docs/channels.mdtrimmed to concept + pointers (schemas/workflows live
in templates and skills); experimental v3 UI narrative removed from the
bridge-explorer reference.
cloudflare-opsskill (provider tooling without Bridge relevance).playwright-fanoutskill (generic test tool without Bridge relevance).- All bridge-deck references in the README (the renderer repo is not yet
public — internal docs keep a "coming soon" note).
Early and evolving — no stability guarantees yet. Pin a release tag for
reproducibility.