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

| 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