Skip to main content
subagent CX Codex

v3-integration-architect — Claude Code subagent: what it does, install

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.

no license ★ 850 updated 2026-10-26

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/v3-integration-architect.md
Open on GitHub

What v3-integration-architect 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.

What it helps with

  • 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 for the agent

  • 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.

How to install v3-integration-architect

Manually: put the files in place

.claude/agents/v3-integration-architect.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about v3-integration-architect

How do I install v3-integration-architect in Claude Code?

Put the subagent file at .claude/agents/v3-integration-architect.md inside your project.

What does v3-integration-architect do?

It runs the ADR-001 migration so claude-flow stops re-implementing agentic-flow and extends it instead, taking 10,000+ duplicated lines out along the way.

What does the subagent need to run?

agentic-flow@alpha reachable through npx. The first hook checks the version and only warns when the package is missing.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

From the same set76

The whole set →
examples The examples command presents pair-programming sessions for JWT auth, Node.js debugging, TDD, refactoring, React performance, and Express APIs. CX Codex +1 ★ 850repo stars base-template-generator base-template-generator writes the starting file set for a new component, endpoint or project config, then reuses templates that worked before. CX Codex ★ 850repo stars planner planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory. CX Codex ★ 850repo stars researcher The researcher subagent examines code, documentation, and module relationships, then organizes findings into a research summary. Use it to map an unfamiliar project or spot gaps in its docs. CX Codex ★ 850repo stars sync-coordinator sync-coordinator aligns versions, dependencies, and docs across linked repositories. It orchestrates agent swarms using GitHub CLI and MCP tools. CX Codex +1 ★ 850repo stars architecture architecture designs system structure from specifications and pseudocode, covering components, interfaces, technology choices, and deployment. CX Codex ★ 850repo stars repo-architect repo-architect optimizes repository layouts and synchronizes files across projects using agent swarms. Helpful when setting up standard templates and multi-repo workflows. CX Codex +1 ★ 850repo stars swarm-pr swarm-pr coordinates agents working on a GitHub pull request, from diff analysis and review to reporting results back to the PR. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open