repo-architect — субагент для Claude Code
Субагент repo-architect смотрит на структуру репозиториев и предлагает, как её выровнять: единый шаблон проекта и синхронизация общих файлов через GitHub MCP.
лицензия не указана ★ 850 обновлён 2026-10-26
.claude/agents/repo-architect.mdЧто делает repo-architect
Агент разбирает, как устроен репозиторий, и предлагает план перестройки: где разложить пакеты, какие файлы вынести в шаблон, что синхронизировать между связанными репозиториями. Работает не один: через claude-flow поднимает swarm и раздаёт роли — аналитик структуры, архитектор, оптимизатор, координатор нескольких репозиториев.
Хуки висят на npx ruv-swarm: перед задачей идёт разбор структуры, после правок проверка изменений, в конце сбор рекомендаций, плюс отдельное оповещение. Значит, ruv-swarm должен запускаться через npx на машине, где работает Claude.
Инструменты — файловые (Bash, Read, Write, Edit, Glob, WebFetch, Task) и MCP-вызовы GitHub: создать репозиторий, форкнуть, найти, залить файлы. Если серверы github и claude-flow не подключены, эти вызовы не сработают, и останутся только локальные файлы.
Какие задачи решает
- выровнять структуру нескольких репозиториев под один шаблон
- разложить пакеты по папкам, пока они не осели в корне
- синхронизировать CI-конфиги между связанными репозиториями
- создать новый репозиторий из готового шаблона через GitHub MCP
- получить список мест в структуре, которые мешают развитию
Примеры запросов агенту
- Разбери структуру этого репозитория и скажи, что переставить, чтобы новые пакеты не тонули в корне.
- Собери шаблон проекта с
.claude/config.jsonиCLAUDE.md, потом залей его в новый репозиторий черезmcp__github__create_repository. - Сравни, как устроены
claude-code-flowиruv-swarm, и синхронизируй файлы, которые у них общие.
Как установить repo-architect
Вручную: положить файлы
.claude/agents/repo-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/repo-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/repo-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о repo-architect
Как установить repo-architect в Claude Code?
Положите файл агента по пути .claude/agents/repo-architect.md. Это единственный шаг: после этого субагент доступен в сессии.
Что делает repo-architect?
Разбирает структуру репозиториев, готовит шаблоны проектов и синхронизирует общие файлы между связанными репозиториями. Роли внутри задачи распределяет swarm из claude-flow.
Что нужно для работы кроме самого файла агента?
Подключённые MCP-серверы github и claude-flow, а также ruv-swarm, который хуки вызывают через npx. Без них агент упрётся в локальные файлы.