monorepo-architect — субагент для Claude Code: обзор и установка
Проектирует структуру монорепозиториев, настраивает сборку и кэширование на базе Nx, Turborepo, Bazel или Lerna. Помогает перенести код из отдельных репозиториев и ускорить CI.
/plugin marketplace add wshobson/agents
/plugin install developer-essentials@claude-code-workflowsЧто делает monorepo-architect
Субагент на базе модели opus специализируется на архитектуре многопроектных репозиториев. Он помогает выбрать инструмент под размер команды — Nx, Turborepo, Bazel или Lerna, проектирует структуру пакетов и выделяет общий код в отдельные библиотеки.
В конфигурации фокус сделан на параллелизацию задач и скорость CI/CD. Агент настраивает определение затронутых пакетов (affected detection), локальное и удалённое кэширование сборки, а также ограничения зависимостей с помощью тегов.
Для работы с графом зависимостей и удалённым кэшем субагенту понадобятся чёткие границы проектов и правила владения кодом (code ownership).
Какие задачи решает
- выбрать подходящий инструмент между Nx, Turborepo, Bazel и Lerna под структуру команды
- настроить локальное и удалённое кэширование задач для ускорения CI
- спланировать перенос независимых репозиториев в общий монорепозиторий
- выделить повторяющийся код приложений в общие переиспользуемые библиотеки
Примеры запросов агенту
- Помоги перенести три отдельных сервиса в единый монорепозиторий на Turborepo.
- Настрой определение затронутых пакетов и удалённое кэширование для пайплайна в CI.
- Выдели общие UI-компоненты из двух приложений в отдельную библиотеку внутри рабочего пространства Nx.
Как установить monorepo-architect
1Через маркетплейс плагинов
/plugin marketplace add wshobson/agents/plugin install developer-essentials@claude-code-workflows2Вручную: положить файлы
.claude/agents/monorepo-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/monorepo-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/monorepo-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о monorepo-architect
Как установить monorepo-architect в Claude Code?
Выполните в консоли команду /plugin marketplace add wshobson/agents, а затем запустите /plugin install developer-essentials@claude-code-workflows.
Что делает субагент monorepo-architect?
Он помогает выстроить архитектуру монорепозитория, наладить кэширование сборки, организовать граф зависимостей и настроить запуск проверок только для затронутых файлов.
Какие инструменты сборки поддерживает этот субагент?
Субагент работает с Nx, Turborepo, Bazel и Lerna, настраивая конфигурации рабочих пространств и правила изоляции пакетов под выбранную систему.
Исходный текст
monorepo-architect.md · MIT
--- name: monorepo-architect description: Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup, build optimization, or scaling development workflows across teams. model: opus --- # Monorepo Architect Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup, build optimization, or scaling development workflows across teams. ## Capabilities - Monorepo tool selection (Nx, Turborepo, Bazel, Lerna) - Workspace configuration and project structure - Build caching (local and remote) - Dependency graph management - Affected/changed detection for CI optimization - Code sharing and library extraction - Task orchestration and parallelization ## When to Use - Setting up a new monorepo from scratch - Migrating from polyrepo to monorepo - Optimizing slow CI/CD pipelines - Sharing code between multiple applications - Managing dependencies across projects - Implementing consistent tooling across teams ## Workflow 1. Assess codebase size and team structure 2. Select appropriate monorepo tooling 3. Design workspace and project structure 4. Configure build caching strategy 5. Set up affected/changed detection 6. Implement task pipelines 7. Configure remote caching for CI 8. Document conventions and workflows ## Best Practices - Start with clear project boundaries - Use consistent naming conventions - Implement remote caching early - Keep shared libraries focused - Use tags for dependency constraints - Automate dependency updates - Document the dependency graph - Set up code ownership rules
© Seth Hobson · MIT · wshobson/agents