Skip to main content
command CX Codex

repo-architect — Claude Code command: what it does, how to install

repo-architect optimizes repository layouts and synchronizes files across projects using agent swarms. Helpful when setting up standard templates and multi-repo workflows.

no license ★ 850 updated 2026-10-26

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

What repo-architect does

This command orchestrates agent swarms to evaluate project directory layouts and manage multiple repositories simultaneously. It spins up specialized agents such as analysts, architects, and coordinators. These agents inspect folders using local filesystem calls and research architecture patterns via the gh command-line tool.

File updates and remote changes run through mcp__github__* and mcp__claude-flow__* MCP functions. The workflow handles new repository initialization, template creation with files like CLAUDE.md, and multi-project synchronization for shared GitHub Actions workflows. Without the GitHub and claude-flow MCP servers active in your environment, the command cannot interact with remote repositories or dispatch swarm tasks.

What it helps with

  • inspect repository layout and recommend structural improvements
  • generate standard project templates with Claude Code configurations
  • sync shared GitHub Actions workflow files across multiple repositories
  • coordinate multi-agent architectural reviews across workspaces

Example prompts for the agent

  • /repo-architect analyze workspace layout and suggest a cleaner project structure
  • /repo-architect generate a standard repository template with ruv-swarm configuration
  • /repo-architect synchronize integration workflows across target repositories

How to install repo-architect

Manually: put the files in place

.claude/commands/repo-architect.md

Call it with /repo-architect. For all projects use ~/.claude/commands/

Questions about repo-architect

How to install repo-architect in Claude Code?

Save the command file directly to .claude/commands/repo-architect.md within your project.

What does repo-architect do?

It coordinates specialized agents to review repository layouts, set up standardized project templates, and align configuration files across multiple repositories.

What tools does repo-architect require?

It depends on active MCP servers for GitHub and claude-flow, alongside the gh CLI tool for pattern discovery.

Similar slash commands

All slash commands for Git and GitHub →

From the same set76

The whole set →
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 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. 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 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 code-review-swarm code-review-swarm sends a pull request through several review agents at once: security, performance, style, architecture. Handy when a plain diff and a linter no longer catch the trouble. CX Codex +1 ★ 850repo stars swarm-issue swarm-issue is a Claude Code command that connects GitHub Issues to swarm work by splitting tasks into subtasks, suggesting agents, and tracking progress. It supports workflows managed through GitHub Issues. CX Codex +1 ★ 850repo stars project-board-sync project-board-sync keeps a GitHub Projects board in step with a claude-flow agent swarm: cards, statuses, sprint metrics. Useful when several agents touch one repo. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open