# Workflow Beads Rollout

> Set up many projects for one shared Beads Dolt-native playbook across a machine or pair of machines. Invoke with /workflow beads-rollout.

- Skill: `lev-os/workflow-beads-rollout` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lev-os/workflow-beads-rollout`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lev-os/workflow-beads-rollout/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: lev-os (https://skillmd.com/u/lev-os)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/lev-os/workflow-beads-rollout

---


# Workflow: Beads Rollout

## Trigger

Use when you want to standardize many repos onto one Beads playbook instead of fixing each project manually.

## Inputs

- One or more root directories to scan for repos with `.beads/`
- Machine role:
  - `primary` for push-first machine
  - `secondary` for pull-first machine

## Steps

1. Upgrade and verify `bd` on the machine.
2. Scan all target roots for repos with `.beads/`.
3. For each repo:
   - derive deterministic Dolt database name
   - set `database`, `host`, and `port`
   - patch config to shared-server mode
   - start local Dolt server access
4. Sync:
   - `primary` -> `bd dolt push`
   - `secondary` -> `bd dolt pull`
5. Verify with `bd dolt show` and `bd ready`.

## Team

| Role | Responsibility |
|------|---------------|
| operator | chooses roots and machine role |
| workflow | runs the rollout helper and reports failures |

## Outputs

- JSON rollout report per repo
- Deterministic DB name per repo
- Shared-server Beads config stamped into each repo

## Validation

- `bd dolt show --json` succeeds for each repo
- `bd ready --json` succeeds for each repo
- config shows shared-server semantics and port `3308`

## Canonical Command

```bash
# audit only
python3 $HOME/.agents/skills/beads-dolt-native/scripts/beads_rollout.py scan --roots $HOME/digital

# primary machine
python3 $HOME/.agents/skills/beads-dolt-native/scripts/beads_rollout.py apply --roots $HOME/digital --sync push

# secondary machine
python3 $HOME/.agents/skills/beads-dolt-native/scripts/beads_rollout.py apply --roots $HOME/digital --sync pull
```