================================================================
WORKSHOP ROLE: The Bridge Builder
Version: 1.2
Date: 2026-07-16
================================================================

This file is an instruction to a Cowork agent.
The agent installs the described role into the person's
Workbench. The human reader does not need to understand this
file — the agent carries it out.

================================================================
TO THE INSTALLING AGENT
================================================================

You are now installing a workshop role: the Bridge Builder.
It builds any cloud connection for non-technical people, without
them ever coming into contact with tech. For that to work on the
person's computer, you bring not just the role but also the build
kit (toolchain).

Follow this guide step by step. Keep the person posted with
short, NON-technical status messages.

================================================================
CACHE — ALWAYS LOAD FRESH (MANDATORY)
================================================================

Before you fetch any holderbaum.io/werkstatt URL, append a fresh
cache-buster: ?cb=<current unix time>  (date +%s). Fresh per
fetch, never a fixed number. Otherwise you risk a stale, cached
version.

================================================================
DOWNLOAD CHECK (MANDATORY)
================================================================

Every downloaded file ends with an end-marker as its last line:
`===== HOLDERBAUM WERKSTATT · FILE FULLY LOADED =====`
(for script files with a `#` in front). After each download,
check that this marker is present. If it's missing, the file is
incomplete (truncated or summarized) — abort, write nothing, run
nothing.

================================================================
STEP 1 — DOWNLOAD THE ROLE FILES
================================================================

Download and save relative to the Workbench root (the directory
that holds CONTEXT.md):

  Workbench/Roles/BridgeBuilder/SYSTEM.md
    ← https://holderbaum.io/werkstatt/en/rollen/bridge-builder/SYSTEM.md

  Workbench/Roles/BridgeBuilder/build-guide.md
    ← https://holderbaum.io/werkstatt/en/rollen/bridge-builder/build-guide.md

Create the directory if it doesn't exist:
  Workbench/Roles/BridgeBuilder/

Also create the empty register — NO download, you create the
file fresh with EXACTLY this content:

  Workbench/Roles/BridgeBuilder/connections.md
  ----------------------------------------------------------------
  # My connections

  Register of every connection the Bridge Builder has built for
  you. The Bridge Builder keeps this itself — you don't have to
  do anything here.

  | Program | What it does (goal) | Capabilities | Status | Version |
  |---------|---------------------|--------------|--------|---------|
  | _none yet_ | | | | |
  ----------------------------------------------------------------

Tell the person: "Bridge Builder role set up."

================================================================
STEP 2 — SET UP THE BUILD KIT (toolchain)
================================================================

The role builds connections from a template with a central build
script. A small installer sets up both. The installer is plain
text and creates all needed files itself — it fetches nothing and
needs no network.

  Download the installer (text, not an archive):
    ← https://holderbaum.io/werkstatt/en/rollen/bridge-builder/install.txt

  Save it locally as install.sh (extension .sh, not .txt) and run
  it from the Workbench root (the directory that holds CONTEXT.md):
    bash install.sh

  The installer creates and self-checks for completeness:
    Workbench/Connectors/bin/build-bundle.sh   (made executable)
    Workbench/Connectors/_vorlage/   (package.json, tsconfig.json,
                                      manifest.json, .mcpbignore,
                                      src/, KONTEXT.md)

  If the installer finishes with "✓ Build kit installed", this
  step is done. If it aborts with "✗", report the error — do not
  continue.

Quietly check whether node and npm are present (node --version,
npm --version). If not: do NOT block now — the role solves that
non-technically on the first build. Just note it internally.

Tell the person: "Build kit installed."

================================================================
STEP 3 — UPDATE CONTEXT.MD
================================================================

Open CONTEXT.md in the Workbench root. Find the ## Roles section
(the table of role triggers).

Add the following line to the roles table:

| Bridge Builder | "Bridge Builder", "I want to get at [product]", "connect me to [product]", "hook up [product]", "can Claude access [product]", "I want to use [product] in Claude", "grab something from [product] for me", "put something into [product] for me", or context: someone wants Claude to access a cloud program/SaaS (Trello, Google Sheets, accounting tool …) during the conversation — read data from it or create/enter something in it when they ask Claude — without programming themselves, OR extend/change an existing connection ("can it also", "it should also"). NOT here: background automations that run on their own ("as soon as X, then Y", "every morning automatically") — that's an automation/n8n topic the Bridge Builder (v1) doesn't build. | [[Workbench/Roles/BridgeBuilder/SYSTEM.md]] |

Tell the person: "CONTEXT.md updated — the Bridge Builder is in
the roles index."

================================================================
STEP 4 — CONFIRMATION
================================================================

Check:
1. Workbench/Roles/BridgeBuilder/SYSTEM.md exists and is not
   empty (min. length 100 lines).
2. Workbench/Roles/BridgeBuilder/build-guide.md exists.
3. Workbench/Roles/BridgeBuilder/connections.md exists.
4. Workbench/Connectors/bin/build-bundle.sh exists and is
   executable.
5. Workbench/Connectors/_vorlage/ exists with manifest.json.
6. CONTEXT.md contains "Bridge Builder" in the roles index.

If all checks pass, tell the person:

"The Bridge Builder is installed. In a new session, say 'I want
to get at [program]' — for example Trello, Google Sheets or your
accounting tool. The Bridge Builder asks what you want to
achieve and builds you the connection. You don't need to program
anything — at the end you double-click and restart Claude once."

================================================================
END OF INSTALLATION GUIDE
================================================================