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

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 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/commands/github/repo-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/commands/repo-architect

## What it 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.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/repo-architect.md` — Call it with /repo-architect. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/repo-architect.md` — Call it with /prompts:repo-architect. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/repo-architect.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/repo-architect.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

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/commands/github/repo-architect.md

## When to use it
- 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
- /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

## Similar
- [om-verify-in-repo](https://affpapa.org/en/nevibecode/skills/om-verify-in-repo.md) — skill · 3500 installs
- [repo-init](https://affpapa.org/en/nevibecode/commands/repo-init.md) — command · ★ 763 repo stars
- [make-repo-contribution](https://affpapa.org/en/nevibecode/skills/make-repo-contribution.md) — skill · 11073 installs
- [repo-standardizer](https://affpapa.org/en/nevibecode/skills/repo-standardizer.md) — skill · 33 installs
- [github-repo-health-wasp-drone](https://affpapa.org/en/nevibecode/agents/github-repo-health-wasp-drone.md) — subagent · ★ 96 repo stars
- [github-project-management](https://affpapa.org/en/nevibecode/skills/github-project-management.md) — skill · 1400 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
