marcuspat / turbo-flow

Turbo Flow v4.0 — The Ruflo Migration **Complete Agentic Development Environment — Ruflo v3.5 + Beads + Worktrees + Agent Teams** Quick Start • Installation • Plugins • Commands • Migration • Resources --- 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 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) • , , , → 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 --- Quick Start DevPod Installation macOS Windows Linux Launch --- What Gets Installed The script installs the complete stack in **10 automated steps**: Step 1: System Prerequisites | Package | Purpose | |:--------|:--------| | | C/C++ compiler (gcc, g++, make) | | | Python runtime | | | Version control | | | HTTP client | | | JSON processor (required for statusline) | | | JavaScript runtime (required by Ruflo v3.5) | Step 2: Claude Code + Ruflo v3.5 | Component | Purpose | |:----------|:--------| | | Anthropic's agentic coding CLI | | | 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 | |:----------|:--------| | | Design system skill — component patterns, accessibility, responsive layouts, design tokens | Step 5: GitNexus (Codebase Knowledge Graph) | Component | Purpose | |:----------|:--------| | | Indexes dependencies, call chains, execution flows | | GitNexus MCP | Registered as MCP server — blast-radius detection | Step 6: Beads (Cross-Session Memory) | Component | Purpose | |:----------|:--------| | | Git-native JSONL project memory — issues, decisions, blockers | Step 7: Workspace + Agent Teams | Component | Purpose | |:----------|:--------| | Directories | | | Agent Teams | enabled | Step 8: Statusline Pro v4.0 3-line statusline with 15 components: 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: , , , , , , , , , , , --- Plugins (6) | Plugin | MCP Tools | Purpose | |:-------|:----------|:--------| | **Agentic QE** | 16 | 58 QE agents, TDD, coverage, security, chaos engineering | | **Code Intelligence** | — | Code analysis, patterns, refactoring | | **Test Intelligence** | — | Test generation, gaps, flaky tests | | **Perf Optimizer** | — | Profiling, bottlenecks, optimization | | **Teammate Plugin** | 21 | Agent Teams ↔ Ruflo swarms bridge, semantic routing | | **Gastown Bridge** | 20 | WASM orchestration, Beads sync, convoys | Removed Plugins (9) | Plugin | Reason | |:-------|:-------| | healthcare-clinical | Domain-specific (HIPAA/FHIR) — not needed | | financial-risk | Domain-specific (PCI-DSS/SOX) — not needed | | legal-contracts | Domain-specific — not needed | | cognitive-kernel | Redundant with Ruflo's neural system | | hyperbolic-reasoning | Redundant with RuVector WASM hyperbolic embeddings | | quantum-optimizer | Redundant with Ruflo's EWC++ and RVFOptimizer | | neural-coordination | Redundant with Ruflo's swarm coordination | | prime-radiant | Niche — mathematical interpretability | | ruvector-upstream | Redundant — RuVector bundled in Ruflo v3.5 | --- Key Commands Status & Help Orchestration (Ruflo) Memory Isolation Quality & Testing Intelligence --- Migrating from v3.x • Your old aliases are gone — use instead • Slash commands ( , etc.) are gone — Ruflo auto-activates skills • Run in your project repos to ena…