Turbo Flow v4.0 — The Ruflo Migration
Complete Agentic Development Environment — Ruflo v3.5 + Beads + Worktrees + Agent Teams
Built & Presented by Adventure Wave Labs
Quick Start • Installation • Plugins • Commands • Migration • Resources
About Adventure Wave Labs
Adventure Wave Labs is the team behind Turbo Flow a complete agentic development environment built for the Claude ecosystem. We design, build, and maintain the tooling that brings together orchestration, memory, codebase intelligence, and agent isolation into a single streamlined workflow.
What's New in v4.0.0
| Metric | v3.4.1 | v4.0.0 | Change |
|---|---|---|---|
| Installation Steps | 15 | 10 | -5 (consolidated) |
| Core Packages | 4 separate | 1 (Ruflo) | -75% |
| MCP Tools | 175+ | 215+ | +23% |
| Agents | 60+ | 60+ | — |
| Plugins | 15 | 6 | -9 (redundant removed) |
| Cross-session Memory | None | Beads | New |
| Agent Isolation | None | Git Worktrees | New |
| Codebase Graph | None | GitNexus | New |
| UI/UX Skill | Yes | Yes | Kept |
| Statusline | Yes | Yes | Updated to 4.0 |
Major Changes
- claude-flow → Ruflo v3.5 — Single
npx ruflo@latest initreplaces 4 separate installs - Beads — Cross-session project memory via git-native JSONL
- GitNexus — Codebase knowledge graph with MCP server and blast-radius detection
- Native Git Worktrees — Per-agent isolation with auto PG Vector schema namespacing
- Native Agent Teams — Anthropic's experimental multi-agent spawning
- 6 focused plugins — 9 redundant/domain-specific plugins removed
- OpenSpec — Spec-driven development kept
- UI UX Pro Max — Design skill kept
- Statusline Pro v4.0 — Updated with TF 4.0 branding
Removed (redundant with Ruflo v3.5 or out of scope)
claude-flow@alpha,@ruvector/cli,@ruvector/sona,@claude-flow/browser→ bundled in Ruflo- 9 plugins: healthcare-clinical, financial-risk, legal-contracts, cognitive-kernel, hyperbolic-reasoning, quantum-optimizer, neural-coordination, prime-radiant, ruvector-upstream
- Claudish, Agentic Jujutsu, Spec-Kit, agtrace, PAL MCP → bundled or redundant
- HeroUI + Tailwind + TypeScript scaffold → out of scope
- Ars Contexta, OpenClaw Secure Stack → out of scope
Architecture
+------------------------------------------------------------------+
| TURBO FLOW v4.0 — Adventure Wave Labs |
+------------------------------------------------------------------+
| INTERFACE |
| +---------------+ +---------------+ +---------------+ |
| | Claude Code | | Open WebUI | | Statusline | |
| | CLI | | (4 instances)| | Pro v4.0 | |
| +---------------+ +---------------+ +---------------+ |
+------------------------------------------------------------------+
| ORCHESTRATION: Ruflo v3.5 |
| 60+ Agents | 215+ MCP Tools | Auto-activated Skills |
| AgentDB v3 | RuVector WASM | SONA | 3-Tier Model Routing |
| 59 MCP Browser Tools | Observability | Gating |
+------------------------------------------------------------------+
| PLUGINS (6) |
| +--------------------------------------------------------------+ |
| | Agentic QE | Code Intel | Test Intel | Perf | Teammate | Gas | |
| +--------------------------------------------------------------+ |
+------------------------------------------------------------------+
| CODEBASE INTELLIGENCE: GitNexus |
| Knowledge Graph | Blast Radius Detection | MCP Server |
+------------------------------------------------------------------+
| MEMORY (Three-Tier) |
| +---------------+ +---------------+ +---------------+ |
| | Beads | | Native Tasks | | AgentDB | |
| | project/git | | session | | + RuVector | |
| | JSONL | | ~/.claude/ | | WASM accel | |
| +---------------+ +---------------+ +---------------+ |
+------------------------------------------------------------------+
| ISOLATION |
| Git Worktrees per Agent | PG Vector Schema per Worktree |
| Auto GitNexus Indexing | Agent Teams (experimental) |
+------------------------------------------------------------------+
| SKILLS |
| UI UX Pro Max | OpenSpec | 36+ Ruflo Auto-activated Skills |
+------------------------------------------------------------------+
| INFRASTRUCTURE |
| DevPod | Codespaces | Rackspace Spot |
+------------------------------------------------------------------+
Quick Start
DevPod Installation
brew install loft-sh/devpod/devpod
choco install devpod
curl -L -o devpod "https://github.com/loft-sh/devpod/releases/latest/download/devpod-linux-amd64"
sudo install devpod /usr/local/bin
Launch
# DevPod (recommended)
devpod up https://github.com/adventurewave-labs/turbo-flow --ide vscode
# Codespaces
# Push to GitHub → Open in Codespace → runs automatically
# Manual
git clone https://github.com/adventurewave-labs/turbo-flow -b main
cd turbo-flow
chmod +x devpods/setup.sh
./devpods/setup.sh
source ~/.bashrc
turbo-status
What Gets Installed
The devpods/setup.sh script installs the complete stack in 10 automated steps:
Step 1: System Prerequisites
| Package | Purpose |
|---|---|
build-essential |
C/C++ compiler (gcc, g++, make) |
python3 |
Python runtime |
git |
Version control |
curl |
HTTP client |
jq |
JSON processor (required for statusline) |
Node.js 20+ |
JavaScript runtime (required by Ruflo v3.5) |
Step 2: Claude Code + Ruflo v3.5
| Component | Purpose |
|---|---|
Claude Code |
Anthropic's agentic coding CLI |
Ruflo v3.5 |
Orchestration engine — replaces claude-flow@alpha |
| Ruflo MCP | Registered as MCP server in Claude Code |
| Ruflo Doctor | Auto-diagnostic and fix pass |
Ruflo v3.5 bundles: AgentDB v3, RuVector WASM, SONA, 215 MCP tools, 60+ agents, skills system, 3-tier model routing, 59 browser automation MCP tools, observability, gating
Step 3: Ruflo Plugins (6) + OpenSpec
| Plugin | Purpose |
|---|---|
| Agentic QE | 58 QE agents — TDD, coverage, security scanning, chaos engineering |
| Code Intelligence | Code analysis, pattern detection, refactoring suggestions |
| Test Intelligence | Test generation, gap analysis, flaky test detection |
| Perf Optimizer | Performance profiling, bottleneck detection |
| Teammate Plugin | Bridges Native Agent Teams with Ruflo swarms (21 MCP tools) |
| Gastown Bridge | WASM-accelerated orchestration, Beads sync (20 MCP tools) |
| OpenSpec | Spec-driven development (independent npm package) |
Step 4: UI UX Pro Max Skill
| Component | Purpose |
|---|---|
uipro-cli |
Design system skill — component patterns, accessibility, responsive layouts, design tokens |
Step 5: GitNexus (Codebase Knowledge Graph)
| Component | Purpose |
|---|---|
GitNexus |
Indexes dependencies, call chains, execution flows |
| GitNexus MCP | Registered as MCP server — blast-radius detection |
Step 6: Beads (Cross-Session Memory)
| Component | Purpose |
|---|---|
@beads/bd |
Git-native JSONL project memory — issues, decisions, blockers |
Step 7: Workspace + Agent Teams
| Component | Purpose |
|---|---|
| Directories | src/ tests/ docs/ scripts/ config/ plans/ |
| Agent Teams | CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 enabled |
Step 8: Statusline Pro v4.0
3-line statusline with 15 components:
LINE 1: [Project] name | [Model] Sonnet | [Git] branch | [TF] 4.0 | [SID] abc123
LINE 2: [Tokens] 50k/200k | [Ctx] #######--- 65% | [Cache] 42% | [Cost] $1.23 | [Time] 5m
LINE 3: [+150] [-50] | [READY]
Step 9: CLAUDE.md Generation
Generates workspace context file with:
- 3-tier memory protocol (Beads → Native Tasks → AgentDB)
- Isolation rules (one worktree per agent)
- Agent Teams rules (max 3 teammates, recursion depth 2)
- Model routing tiers (Opus/Sonnet/Haiku)
- Plugin reference
- Cost guardrails ($15/hr)
Step 10: Aliases + Environment + MCP Registration
50+ aliases across families: rf-*, ruv-*, mem-*, bd-*, wt-*, gnx-*, aqe-*, os-*, hooks-*, neural-*, turbo-status, turbo-help
Plugins (6)
| Plugin | MCP Tools | Purpose |
|---|---|---|
| *Agentic QE |