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
.claude/commands/repo-architect.mdWhat 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.mdCall it with /repo-architect. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/repo-architect.mdCall it with /prompts:repo-architect. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/repo-architect.prompt.mdManually: put the files in place
.gemini/commands/repo-architect.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
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.