Quickstart

Three steps. No local install required. About five minutes.

Simpler since v1.6.0 — setup requires one less org resource (no GitHub project board), one less PAT scope (no project), and one fewer wizard failure mode. The beads tracker replaces the GitHub project board end-to-end.

1. Clone the repo

Open the Gemba Flow template on GitHub and click Use this template:

https://github.com/vibeacademy/gembaflow/generate 

This creates your own copy of the template under your GitHub account (or organization). Give it a name that matches your project. Leave visibility as private unless you intend to open-source it.

2. Open in a Codespace

Inside your new repository, click Code → Codespaces → Create codespace on main. GitHub spins up a browser-based development environment in about 30 seconds. Git, Node.js, and the Claude extension are all preinstalled — no local setup required.

Wait for the Codespace to finish loading. You will see the project files in the editor on the left.

3. Run /bootstrap

In the Codespace, open the Claude extension — click the Claude icon in the VS Code activity bar (left sidebar) to open the chat panel.

In the Claude chat, type:

/bootstrap

The bootstrap wizard guides you through four phases — product definition, technical architecture, agent configuration, and workflow setup. At the end you will have a configured beads tracker, seven specialized agents, and bd ready populated with your first tickets.

You need a GitHub personal access token with repo and workflow scopes. You do not need the project scope — beads requires none.

Next: Ship Your First PR walks through running /work-ticket to ship the first agent-authored PR end-to-end.

See /bootstrap for details on what each phase creates.

Prefer to install locally? You will need Git, Node.js 18+, and the Claude extension (install it in VS Code from the marketplace, or use the Claude Code CLI — npm install -g @anthropic-ai/claude-code — if you prefer the terminal). Clone your generated repository, open it in VS Code, open the Claude chat, and type /bootstrap. All four prerequisites (Git, Node.js, Claude, a GitHub account) must be in place before the wizard can complete Phase 4.