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

Major Changes

• claude-flow → Ruflo v3.5 — Single npx ruflo@latest init replaces 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/adventurewavelabs/turbo-flow --ide vscode

# Codespaces
# Push to GitHub → Open in Codespace → runs automatically

# Manual
git clone https://github.com/adventurewavelabs/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

Step 2: Claude Code + Ruflo v3.5

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

Step 4: UI UX Pro Max Skill

Step 5: GitNexus (Codebase Knowledge Graph)

Step 6: Beads (Cross-Session Memory)

Step 7: Workspace + Agent Teams

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)

Removed Plugins (9)

Key Commands

turbo-status         # Check all components
turbo-help           # Complete command reference
rf-doctor            # Ruflo health check
rf-plugins           # List installed plugins

rf-wizard            # Interactive setup
rf-swarm             # Hierarchical swarm (8 agents max)
rf-mesh              # Mesh swarm
rf-ring              # Ring swarm
rf-star              # Star swarm
rf-spawn coder       # Spawn a coder agent
rf-daemon            # Start background workers
rf-status            # Ruflo status

bd-ready             # Check project state (session start)
bd-add               # Record issue/decision/blocker
bd-list              # List beads
ruv-remember K V     # Store in AgentDB
ruv-recall Q         # Query AgentDB
mem-search Q         # Search ruflo memory
mem-stats            # Memory statistics

wt-add agent-1       # Create worktree for agent
wt-remove agent-1    # Clean up worktree
wt-list              # Show all worktrees
wt-clean             # Prune stale worktrees

aqe-generate         # Generate tests (Agentic QE plugin)
aqe-gate             # Quality gate
os-init              # Initialize OpenSpec in project
os                   # Run OpenSpec

hooks-train          # Deep pretrain on codebase
hooks-route          # Route task to optimal agent
neural-train         # Train neural patterns
neural-patterns      # View learned patterns
gnx-analyze          # Index repo into knowledge graph
gnx-serve            # Start local server for web UI
gnx-wiki             # Generate repo wiki from graph

Migrating from v3.x

1. Your old cf-* aliases are gone — use rf-* instead
2. Slash commands (/sparc, etc.) are gone — Ruflo auto-activates skills
3. Run bd init in your project repos to enable Beads memory
4. Run npx gitnexus analyze in your repos to build the knowledge graph
5. The v3/ directory preserves everything — nothing was deleted

Repository Structure

turbo-flow/
├── V3/                          ← archived v3.0-v3.4.1 (Claude Flow era)
├── .claude/                     ← skills, agents, settings
├── devpods/
│   ├── setup.sh                 ← main setup script
│   ├── post-setup.sh            ← post-setup verification
│   └── context/                 ← devpod context files
├── scripts/
│   └── generate-claude-md.sh
├── CLAUDE.md                    ← workspace context (active)
└── README.md

Post-Setup

# 1. Reload shell
source ~/.bashrc

# 2. Verify installation
turbo-status

# 3. Get help
turbo-help

# 4. Run post-setup verification (13 checks)
# ./devpods/post-setup.sh

Version History

Resources

License

MIT — Copyright (c) 2025-2026 Adventure Wave Labs

Built & Presented by Adventure Wave Labs

Turbo Flow v4.0 — Ruflo v3.5. 215+ MCP tools. 6 plugins. Beads. GitNexus. Worktrees. One command.