Quickstart

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

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 Code CLI are all preinstalled — no local setup required.

Wait for the Codespace to finish loading (the terminal prompt appears). You will see the project files in the editor on the left.

3. Run /bootstrap

In the Codespace terminal, start Claude Code:

claude

Then type:

/bootstrap

The bootstrap wizard guides you through four phases — product definition, technical architecture, agent configuration, and GitHub workflow setup. At the end you will have a configured project board, six specialized agents, and a Ready column waiting for your first ticket.

See /bootstrap for details on what each phase creates.

Prefer to install locally? You will need Git, Node.js 18+, and the Claude Code CLI (npm install -g @anthropic-ai/claude-code). Clone your generated repository, open a terminal in the project directory, run claude, and type /bootstrap. All four prerequisites (Git, Node.js, Claude Code CLI, a GitHub account) must be in place before the wizard can complete Phase 4.