Wheelhouse

Wheelhouse

A standing agent fleet, over a shared work graph, installable on any project.

The shape: a **commander** session where you argue direction, a **designer** that turns direction into implementable work, **workers** that implement one unit at a time on isolated branches, and a **reviewer** that gates every diff with evidence and never reviews what it wrote. Work lives in a graph, not in chat. Nothing merges on a claim.

This repo is the template. It ships the contracts those roles share, one worked example, and a bootstrap procedure that installs the whole thing into a project by interviewing you about that project.

Prerequisites

• a git repository you want the fleet to work on. The wheelhouse installs into a project you already have; it does not start one for you.
• Claude Code. Every seat is a Claude Code session, and the install is itself a Claude Code session.
• four command-line tools on your PATH: git, bd, bash, awk. Three of those ship with macOS and every Linux. bd is the work graph, and is the one you probably have to install: brew install beads, or see https://github.com/gastownhall/beads.

You do not have to check the four by hand. Step 0 of the install is a dependency preflight that checks all of them, and for each one that is missing prints what the wheelhouse needs it for and how to install it, then stops before anything has been written.

Install

Open a Claude Code session in your project root and paste the block below into that session.

**Paste the whole block into Claude; you run none of it yourself.** The block is addressed to Claude, and the shell command inside it is Claude's to execute — which is why it opens with a sentence rather than a command, and why pasting the block into a terminal fails on its first line.

Install the wheelhouse in this repo.

Clone the template somewhere temporary and read its BOOTSTRAP.md, then follow it
exactly:

  TEMPLATE=$(mktem