
V3 Deep Integration
Architect claude-flow as an agentic-flow@alpha extension so solo builders cut duplicate agent/swarm code and wire SONA, Flash Attention, and AgentDB without maintaining two parallel stacks.
Overview
V3 Deep Integration is an agent skill for the Build phase that turns claude-flow into a specialized extension of agentic-flow@alpha to eliminate massive duplicate agent-orchestration code.
Install
npx skills add https://github.com/ruvnet/ruflo --skill v3-deep-integrationWhat is this skill?
- Implements ADR-001-style deep integration: claude-flow as extension of agentic-flow@alpha, not a fork.
- Maps 80%/70%/60%/50% overlap targets across SwarmCoordinator, AgentManager, TaskScheduler, and SessionManager for dedupl
- Parallel Task() workstreams for SONA (5 learning modes), Flash Attention (2.49x–7.47x), and AgentDB (150x–12,500x search
- Explicit line-count target: under 5,000 lines versus 15,000+ in a parallel implementation.
- Quick-start invokes v3-integration-architect for adapter-layer and feature integration tasks.
- Targets elimination of 10,000+ duplicate lines via deep integration.
- Overlap reduction targets: 80% swarm, 70% agent lifecycle, 60% tasks, 50% sessions.
- Line budget under 5,000 versus 15,000+ in parallel implementation.
Adoption & trust: 625 installs on skills.sh; 58.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You maintain claude-flow and agentic-flow@alpha side by side and duplicate swarm, agent, task, and session logic instead of sharing one foundation.
Who is it for?
Solo builders already on agentic-flow@alpha who need to collapse claude-flow overlap before scaling SONA, attention, or AgentDB features.
Skip if: Greenfield projects with no existing claude-flow fork, or teams that only need a single chat agent with no swarm coordination.
When should I use this skill?
You are implementing ADR-001 deep integration between claude-flow and agentic-flow@alpha and need architect Task() patterns for adapter and feature layers.
What do I get? / Deliverables
You get an adapter-layer integration plan with parallel architect tasks and a sub-5,000-line target that replaces 15,000+ lines of overlapping implementation.
- Integration architecture and adapter-layer design
- Deduplication map for overlapping coordinator and manager modules
- Task breakdown for SONA, Flash Attention, and AgentDB wiring
Recommended Skills
Journey fit
Deep integration and adapter-layer design happen while you are assembling agent runtimes and orchestration—not during launch SEO or post-ship monitoring. Agent-tooling is the canonical shelf for skills that reshape how coding agents coordinate, schedule tasks, and share sessions with a host framework.
How it compares
Use for structural framework integration, not for one-off API glue or a generic refactoring checklist without ADR-style extension design.
Common Questions / FAQ
Who is V3 Deep Integration for?
Indie and solo developers running agentic-flow@alpha who inherited or built a parallel claude-flow stack and need deduplication without losing swarm and session behavior.
When should I use V3 Deep Integration?
During Build → agent-tooling when overlap across coordinators and schedulers is blocking velocity; also when you are about to wire SONA, Flash Attention, or AgentDB and cannot afford two codepaths.
Is V3 Deep Integration safe to install?
Treat it like any third-party agent skill: review the Security Audits panel on this Prism page and inspect the repo before letting an agent run Bash or broad refactors on your monorepo.
SKILL.md
READMESKILL.md - V3 Deep Integration
# V3 Deep Integration ## What This Skill Does Transforms claude-flow from parallel implementation to specialized extension of agentic-flow@alpha, eliminating massive code duplication while achieving performance improvements and feature parity. ## Quick Start ```bash # Initialize deep integration Task("Integration architecture", "Design agentic-flow@alpha adapter layer", "v3-integration-architect") # Feature integration (parallel) Task("SONA integration", "Integrate 5 SONA learning modes", "v3-integration-architect") Task("Flash Attention", "Implement 2.49x-7.47x speedup", "v3-integration-architect") Task("AgentDB coordination", "Setup 150x-12,500x search", "v3-integration-architect") ``` ## Code Deduplication Strategy ### Current Overlap → Integration ``` ┌─────────────────────────────────────────┐ │ claude-flow agentic-flow │ ├─────────────────────────────────────────┤ │ SwarmCoordinator → Swarm System │ 80% overlap (eliminate) │ AgentManager → Agent Lifecycle │ 70% overlap (eliminate) │ TaskScheduler → Task Execution │ 60% overlap (eliminate) │ SessionManager → Session Mgmt │ 50% overlap (eliminate) └─────────────────────────────────────────┘ TARGET: <5,000 lines (vs 15,000+ currently) ``` ## agentic-flow@alpha Feature Integration ### SONA Learning Modes ```typescript class SONAIntegration { async initializeMode(mode: SONAMode): Promise<void> { switch(mode) { case 'real-time': // ~0.05ms adaptation case 'balanced': // general purpose case 'research': // deep exploration case 'edge': // resource-constrained case 'batch': // high-throughput } await this.agenticFlow.sona.setMode(mode); } } ``` ### Flash Attention Integration ```typescript class FlashAttentionIntegration { async optimizeAttention(): Promise<AttentionResult> { return this.agenticFlow.attention.flashAttention({ speedupTarget: '2.49x-7.47x', memoryReduction: '50-75%', mechanisms: ['multi-head', 'linear', 'local', 'global'] }); } } ``` ### AgentDB Coordination ```typescript class AgentDBIntegration { async setupCrossAgentMemory(): Promise<void> { await this.agentdb.enableCrossAgentSharing({ indexType: 'HNSW', speedupTarget: '150x-12500x', dimensions: 1536 }); } } ``` ### MCP Tools Integration ```typescript class MCPToolsIntegration { async integrateBuiltinTools(): Promise<void> { // Leverage 213 pre-built tools const tools = await this.agenticFlow.mcp.getAvailableTools(); await this.registerClaudeFlowSpecificTools(tools); // Use 19 hook types const hookTypes = await this.agenticFlow.hooks.getTypes(); await this.configureClaudeFlowHooks(hookTypes); } } ``` ## Migration Implementation ### Phase 1: Adapter Layer ```typescript import { Agent as AgenticFlowAgent } from 'agentic-flow@alpha'; export class ClaudeFlowAgent extends AgenticFlowAgent { async handleClaudeFlowTask(task: ClaudeTask): Promise<TaskResult> { return this.executeWithSONA(task); } // Backward compatibility async legacyCompatibilityLayer(oldAPI: any): Promise<any> { return this.adaptToNewAPI(oldAPI); } } ``` ### Phase 2: System Migration ```typescript class SystemMigration { async migrateSwarmCoordination(): Promise<void> { // Replace SwarmCoordinator (800+ lines) with agentic-flow Swarm const swarmConfig = await this.extractSwarmConfig(); await this.agenticFlow.swarm.initialize(swarmConfig); } async migrateAgentManagement(): Promise<void> { // Replace AgentManager (1,736+ lines) with agentic-flow lifecycle const agents = await this.extractActiveAgents(); for (const agent of agents) { await this.agentic