Skip to main content
subagent CX Codex

repo-architect — Claude Code subagent: repo structure, how to install

repo-architect maps how your repositories are laid out and proposes a cleaner shape: a shared project template plus file sync across repos through GitHub MCP.

no license ★ 850 updated 2026-10-26

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

What repo-architect does

The agent inspects repository layout and comes back with a restructuring plan: where packages belong, which files should move into a shared template, what to keep in sync between related repos. It spreads the work across a claude-flow swarm with analyst, architect, optimizer and coordinator roles.

Hooks ride on npx ruv-swarm. One runs a structure pass before the task starts, one checks edits afterwards, one assembles recommendations at the end, and a notification hook fires separately. So ruv-swarm has to resolve through npx on the machine running Claude.

On the tool side it has file work (Bash, Read, Write, Edit, Glob, WebFetch, Task) plus GitHub MCP calls for creating, forking and searching repositories and pushing files. Those calls only land when the github and claude-flow MCP servers are connected, otherwise it can touch local files and nothing more.

What it helps with

  • align the layout of several repositories to one template
  • place packages sensibly before they pile up in the root
  • keep CI configs identical across related repos
  • spin up a new repository from a ready-made template
  • get a written list of structural problems

Example prompts for the agent

  • Walk the structure of this repo and tell me what to move so new packages stop landing in the root.
  • Build a project template with .claude/config.json and CLAUDE.md, then push it to a fresh repo using mcp__github__create_repository.
  • Compare the layout of claude-code-flow and ruv-swarm and sync the files they share.

How to install repo-architect

Manually: put the files in place

.claude/agents/repo-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 repo-architect

How do I install repo-architect in Claude Code?

Put the agent file at .claude/agents/repo-architect.md. That is the whole install; the subagent is then available in your session.

What does repo-architect do?

It reads repository structure, manages project templates and keeps shared files in sync across related repos. A claude-flow swarm splits the job between roles.

Which MCP servers does it need?

github for repository operations and claude-flow for the swarm calls. The hooks also shell out to npx ruv-swarm, so that package must be reachable.

Similar subagents

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

From the same set76

The whole set →
pagerank-analyzer The pagerank-analyzer subagent computes PageRank and examines graph structure. Use it to find influential nodes or assess connections across a network. CX Codex ★ 850repo stars production-validator production-validator — a subagent that hunts leftover mocks and stubs in your code, then runs the tests against a real database, cache and payment API before you deploy. CX Codex ★ 850repo stars multi-repo-swarm multi-repo-swarm coordinates AI swarms across multiple repositories with the GitHub CLI and ruv-swarm. Useful for cross-project updates. CX Codex +1 ★ 850repo stars coder The coder subagent implements and refactors code, designs APIs, and handles errors. Use it for development tasks that call for tests and follow-up checks. CX Codex ★ 850repo stars code-review-swarm code-review-swarm deploys coordinated AI review agents against pull requests via the GitHub CLI. It flags security flaws and architecture drift before merging. CX Codex ★ 850repo stars supabase-admin supabase-admin — a Claude command that puts the agent in charge of Supabase: Postgres schemas, RLS policies, auth and storage buckets, all through the MCP server rather than the CLI. CX Codex +1 ★ 850repo stars ml-developer ml-developer — a dedicated subagent for training machine learning models, exploring hyperparameter spaces, and editing Jupyter notebooks. CX Codex ★ 850repo stars Load Balancing Coordinator The Load Balancing Coordinator subagent assigns work according to agent load and task priority. Use it to manage queues or move work away from overloaded agents. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open