# v3-integration-architect

v3-integration-architect — a Claude subagent that carries out ADR-001: folding claude-flow into agentic-flow@alpha as an extension and cutting 10,000+ duplicated lines.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/v3/v3-integration-architect.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/v3-integration-architect

## What it does

This subagent exists for one refactor. claude-flow and `agentic-flow@alpha` grew two copies of the same machinery, and ADR-001 says to keep one of them. claude-flow becomes a thin layer on top of the library instead of a rival implementation.

The work is split into phases running from week 7 to week 10: an adapter layer first, the core move second, removal of the compatibility shim last. It builds on parts that already exist in `agentic-flow@alpha` — SONA learning modes, Flash Attention, shared AgentDB memory over HNSW, 213 MCP tools and 19 hook types. Each overlapping pair comes with a number: SwarmCoordinator against Swarm System at 80%, AgentManager against Agent Lifecycle at 70%.

Two shell hooks bracket a run. The first asks `npx agentic-flow@alpha --version` and prints the overlap table. The second files whatever pattern came out of the task into memory with `npx agentic-flow@alpha memory store-pattern`. No package installed, and the version check falls through to a warning. Paths like `services/agentic-flow-hooks/` and `src/core/SwarmCoordinator.ts` belong to the agentic-flow repo, so on an unrelated codebase there is nothing to migrate.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/v3-integration-architect.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/v3-integration-architect.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/v3-integration-architect.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/v3/v3-integration-architect.md

## When to use it
- strip duplicated code shared by claude-flow and agentic-flow
- port SwarmCoordinator and AgentManager onto the shared classes
- wire SONA modes and Flash Attention into existing code
- move task and session handling onto the agentic-flow layer
- record integration patterns in agent memory after each task

## Example prompts
- Map the overlap with `agentic-flow@alpha` and lay out the ADR-001 steps.
- Move `SwarmCoordinator` onto the Swarm System from `agentic-flow@alpha` and mark the old file for deletion.
- Plan the task and session migration phase by phase, then list what breaks once the compatibility layer goes.

## Similar
- [V3 Deep Integration](https://affpapa.org/en/nevibecode/skills/v3-deep-integration.md) — skill · 1100 installs
- [Swarm Orchestration](https://affpapa.org/en/nevibecode/skills/swarm-orchestration.md) — skill · 2100 installs
- [architect](https://affpapa.org/en/nevibecode/skills/backnotprop-architect.md) — skill · 10600 installs
- [Context Architect](https://affpapa.org/en/nevibecode/agents/context-architect.md) — subagent · ★ 41430 repo stars
- [loop-architect](https://affpapa.org/en/nevibecode/skills/loop-architect.md) — skill · ★ 141 repo stars
- [powershell-module-architect](https://affpapa.org/en/nevibecode/agents/powershell-module-architect.md) — subagent · 183 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
