🏗 Архитектура Roo Code

Roo Code построен как мультиагентная платформа поверх расширения VS Code. В отличие от простых автодополнений, Roo Code реализует многослойную архитектуру: ядро агента управляет контекстом и координирует инструменты, слой примитивов предоставляет базовые операции (файлы, терминал, браузер), реализации включают специализированных агентов (Roo Commander, Roo Flow), а внешний слой подключает LLM-провайдеров и MCP-серверы.

🤖 Что такое Roo Code?

Roo Code — это мультиагентный AI-ассистент для написания кода с открытым исходным кодом (Apache 2.0). Он работает как расширение VS Code и позиционируется как «целая dev-команда AI-агентов прямо в вашем редакторе». Проект был основан в октябре 2024 года как форк Cline (тогда ещё Claude Dev), но быстро обогнал родительский проект по набору функций: мультиагентная оркестрация через Roo Commander, специализированные режимы (Code, Architect, Ask, Debug), кастомные режимы под команду и полноценная поддержка MCP-серверов.

За полтора года активной разработки Roo Code набрал более 24 000 звёзд на GitHub и 3 400 форков, став одним из самых популярных AI-инструментов для разработки. Ключевое отличие от конкурентов — мультиагентная архитектура: вместо одного агента, который пытается сделать всё сам, Roo Code позволяет запускать специализированных агентов для разных задач, координируя их через Roo Commander. Это особенно ценно для больших проектов, где одна задача требует изменений в разных частях кодовой базы.

История и эволюция

Roo Code был создан как форк Cline (изначально Claude Dev от Saoud Rizwan) и быстро приобрёл самостоятельность. Команда Roo Code Inc. (ранее Roo Veterinary Inc.) добавила уникальные возможности: систему режимов (Modes), мультиагентную оркестрацию, улучшенную работу с контекстом и правилами проекта. Сообщество активно участвовало в разработке через GitHub Issues и Discord.

К весне 2026 года Roo Code достиг пика популярности — 24 360 звёзд, активное сообщество, регулярные релизы. Однако 15 мая 2026 года репозиторий был заархивирован, а компания объявила о переходе на облачный продукт Roomote — self-hosted AI-агента для команд, который работает в собственной инфраструктуре, принимает задачи из мессенджеров и создаёт reviewable PR. Сообщество оперативно создало форк ZooCode, который продолжает развитие открытой версии Roo Code.

Модель ценообразования

До закрытия проекта Roo Code предлагал трёхуровневую модель: Free — базовые функции с собственным API-ключом (вы платите только провайдеру LLM); Pro ($10–20/мес) — расширенные лимиты, приоритетная поддержка, дополнительные режимы; Enterprise — кастомные развёртывания, on-premise, SSO и аудит. Сам инструмент под Apache 2.0 бесплатен — вы платите только за использование LLM-моделей. С локальными моделями через Ollama или LM Studio работа полностью бесплатна.

📋 Режимы и компоненты Roo Code

⚡ Установка и настройка

VS Code Extension (основной способ)

Расширение устанавливается из маркетплейса VS Code за 30 секунд:

# 1. Откройте VS Code, нажмите Ctrl+Shift+X (Extensions)
# 2. Найдите "Roo Code" (издатель: RooVeterinaryInc)
# 3. Нажмите Install
# Или установите через командную строку:
code --install-extension RooVeterinaryInc.roo-cline

Cursor IDE

Roo Code отлично работает в Cursor — форке VS Code с нативными AI-возможностями:

# 1. Откройте Cursor, перейдите в Extensions (Ctrl+Shift+X)
# 2. Найдите "Roo Code" → Install
# Cursor автоматически подхватывает VS Code-расширения
# Все режимы Roo Code работают параллельно с нативным AI Cursor

Конфигурация провайдера LLM

После установки настройте API-ключ вашего провайдера:

# Anthropic (рекомендуется — Claude Sonnet/Opus)
ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI (GPT-4o, o3, o4-mini)
OPENAI_API_KEY="sk-..."

# Google Gemini
GEMINI_API_KEY="..."

# OpenRouter — единый доступ к 200+ моделям
OPENROUTER_API_KEY="..."

# Ollama — локальные модели, полностью бесплатно
OLLAMA_HOST="http://localhost:11434"

# AWS Bedrock
AWS_ACCESS_KEY_ID="..."
AWS_SECRET_ACCESS_KEY="..."
AWS_REGION="us-east-1"

Настройка правил проекта (.roo/rules)

Roo Code использует директорию .roo/rules/ для правил проекта — аналог .clinerules в Cline, но с расширенными возможностями:

# Стандарты кодирования для проекта

## TypeScript
- Используй строгий режим (strict: true в tsconfig.json)
- Предпочитай async/await вместо цепочек .then()
- Все публичные функции должны иметь JSDoc-комментарии
- Максимальная длина строки: 100 символов
- Именование: camelCase для переменных, PascalCase для классов

## Тестирование
- Покрытие тестами не ниже 80%
- Каждый PR должен включать unit-тесты для новой логики
- Используй Vitest (не Jest) для новых проектов

## Git
- Conventional Commits: feat:, fix:, docs:, refactor:, test:
- Один коммит — одна логическая единица изменений
- Перед пушем: npm run lint && npm run test

# Архитектурные соглашения

## Структура проекта
src/
├── domain/        # Бизнес-логика, не зависит от фреймворков
├── application/   # Use cases, координирует domain и infra
├── infrastructure/# Базы данных, внешние API, файловая система
└── presentation/  # HTTP-контроллеры, GraphQL-резольверы, UI

## Принципы
- Следуй Clean Architecture (Роберт Мартин)
- Инверсия зависимостей: domain не импортирует infrastructure
- Все внешние зависимости — через интерфейсы (порты и адаптеры)

🧩 Ключевые возможности

🎯 Roo Commander: мультиагентная оркестрация в деталях

Roo Commander — ключевая инновация Roo Code, не имевшая аналогов среди open-source AI-ассистентов в 2025–2026. Это встроенный оркестратор, который принимает сложную задачу, декомпозирует её на атомарные подзадачи, назначает каждой подзадаче специализированного агента (с нужным режимом — Code, Architect, Debug), запускает их параллельно и собирает результаты в единый артефакт.

Как работает Roo Commander

1. Декомпозиция — Commander анализирует запрос пользователя и разбивает его на подзадачи, используя Architect Mode для планирования.
2. Назначение агентов — каждой подзадаче назначается агент с определённым режимом. Например: «Создать схему БД» → Architect Mode, «Написать API-роуты» → Code Mode.
3. Параллельное исполнение — агенты работают одновременно в изолированных контекстах, что кратно ускоряет выполнение.
4. Сборка и мерж — Commander собирает результаты, разрешает конфликты и создаёт итоговый набор изменений.
5. Валидация — запускаются тесты, линтер и проверки из .roo/rules/. Если есть ошибки — Commander запускает Debug-агента для исправления.

Пример масштабной задачи через Commander

Задача: «Добавь в интернет-магазин систему рекомендаций товаров с A/B-тестированием». Commander разбивает её так:

• Агент 1 (Architect Mode): проектирует ML-пайплайн, схему данных для логов, API для A/B-тестов.
• Агент 2 (Code Mode): реализует сервис рекомендаций на Python/FastAPI.
• Агент 3 (Code Mode): создаёт компоненты UI для отображения рекомендаций на React.
• Агент 4 (Code Mode): пишет интеграционные тесты и сценарии A/B-тестов.
• Агент 5 (Debug Mode): валидирует результаты, запускает нагрузочное тестирование.

Все агенты работают параллельно. Итоговый результат — готовый PR с backend, frontend, тестами и конфигурацией A/B-тестов за один проход.

Roo Flow: автоматизация рабочих процессов

Roo Flow — движок автоматизации, позволяющий создавать цепочки последовательных и условных действий без ручного вмешательства. В отличие от ручного переключения между режимами, Flow выполняет полный цикл: получает задачу → запускает агента в нужном режиме → валидирует результат → при успехе идёт дальше, при ошибке возвращает на доработку.

Типичный сценарий Roo Flow для ежедневного рабочего процесса:

1. Code: генерация или рефакторинг кода по спецификации.
2. Test: автоматический запуск тестов (npm test / pytest).
3. Lint: проверка код-стиля (ESLint / ruff).
4. Review: self-review через Custom Mode «Code Review».
5. Commit & PR: создание коммита и Pull Request с описанием.

Flow настраивается через JSON-конфигурацию и поддерживает условные переходы (if test fails → Debug Mode → fix → retest), параллельные шаги и ручные gate'ы (требуется подтверждение перед коммитом).

💻 Примеры работы с кодом

Пример 1: Мультиагентная разработка фичи через Roo Commander

Roo Commander позволяет разбить крупную задачу на подзадачи и распределить их между агентами:

// User → Roo Commander:
"Спроектируй и реализуй систему аутентификации пользователей:
1. Схема базы данных (PostgreSQL)
2. REST API (Express + TypeScript)
3. Фронтенд-компоненты (React)
4. Unit и интеграционные тесты"

→ Roo Commander: декомпозировал задачу на 4 подзадачи
→ Agent 'db-architect' (Architect Mode): спроектировал схему
→ Agent 'api-dev' (Code Mode): реализовал REST API
→ Agent 'ui-dev' (Code Mode): создал React-компоненты
→ Agent 'test-writer' (Code Mode): написал тесты
→ Roo Commander: смержил все изменения, запустил npm test

✓ Все тесты пройдены (23/23)
✓ Линтинг OK
✓ Готово к PR

Пример 2: Настройка Custom Mode для code review

{
  "name": "Code Review",
  "description": "Строгий ревьювер: проверяет безопасность, производительность и стандарты",
  "systemPrompt": "Ты — senior code reviewer. Проверяй код на:
- Уязвимости безопасности (OWASP Top 10)
- Утечки памяти и проблемы производительности
- Соответствие стандартам кодирования из .roo/rules/
- Покрытие тестами
Формат ответа: список проблем с severity (CRITICAL/HIGH/MEDIUM/LOW)",
  "tools": ["read_file", "search_files", "execute_command"],
  "autoApprove": {
    "read_file": true,
    "search_files": true
  }
}

Пример 3: CLI-использование с MCP-сервером

# mcp-config.json в корне проекта
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
      }
    }
  }
}

Пример 4: Debug Mode — трассировка бага

// User → Roo Code (Debug Mode):
"Пользователи жалуются на 500 ошибку при логине.
Найди первопричину и предложи фикс."

→ [Debug Agent] Анализирую логи ошибок...
→ Нашёл: NullPointerException в AuthService.verifyToken()
→ Причина: токен не проверяется на null перед вызовом .substring()
→ Trace: auth.ts:147 → middleware.ts:32 → server.ts:89
→ Предлагаю фикс: добавить guard clause
→ Создал PR с исправлением и регрессионным тестом

📊 Сравнение с аналогами

Roo Code занимал уникальную нишу среди AI-ассистентов: мультиагентная архитектура и кастомные режимы — то, чего нет ни у Cline, ни у Claude Code, ни у Cursor. Ниже — детальное сравнение по ключевым параметрам.

Когда стоило выбирать Roo Code?

• Вам нужна мультиагентность — Roo Commander с параллельными агентами не имел аналогов в 2025–2026. Ни Cline, ни Cursor не предлагали нативного оркестратора.
• Вы хотите кастомные режимы — JSON-конфигурация Custom Modes позволяла создать специализированного агента под любой workflow (code review, security audit, migration assistant).
• Roo Flow для автоматизации — цепочки задач «генерация → тесты → линтинг → PR» без ручного вмешательства.
• Глубокая кастомизация — .roo/rules/, политики auto-approve, конфигурация MCP-серверов давали беспрецедентный уровень контроля.

Альтернативы после закрытия Roo Code

• ZooCode — community-форк Roo Code, сохраняет всю функциональность. Рекомендуется для тех, кто хочет продолжить использование открытой версии.
• Roomote — облачный продукт от Roo Code Inc. Self-hosted агент, интегрируется с GitHub/GitLab, Slack, Discord. Source-available (Fair Core License).
• Cline AI — родительский проект, от которого форкался Roo Code. Активно развивается, 65k+ звёзд, поддержка JetBrains.

📈 Roo Code в цифрах

Данные актуальны на момент архивации репозитория (15 мая 2026). Репозиторий: github.com/RooCodeInc/Roo-Code

🗺 История развития и дорожная карта

Что было реализовано (октябрь 2024 – май 2026)

• ✓ Выполнено Октябрь 2024 — Форк Cline (Claude Dev), первый релиз Roo Code для VS Code. Поддержка Anthropic API.
• ✓ Выполнено Декабрь 2024 — Добавлены режимы Code и Architect. Система правил .roo/rules/ заменяет одиночный .clinerules.
• ✓ Выполнено Февраль 2025 — Режимы Ask и Debug. Мультипровайдерность: OpenAI, Google, OpenRouter, Ollama.
• ✓ Выполнено Май 2025 — Roo Commander: мультиагентная оркестрация. Custom Modes с JSON-конфигурацией.
• ✓ Выполнено Август 2025 — MCP-поддержка (Model Context Protocol). Roo Flow: движок автоматизации рабочих процессов.
• ✓ Выполнено Ноябрь 2025 — Интеграция с Cursor IDE. Auto-Approve политики. Чекпоинты с визуальным диффом.
• ✓ Выполнено Февраль 2026 — Pro-тариф: расширенные лимиты, приоритетная поддержка. Enterprise: on-premise, SSO.
• ✓ Выполнено Май 2026 — Репозиторий заархивирован. Анонс Roomote как преемника. Запуск ZooCode как community-форка.

Будущее: Roomote и ZooCode (2026+)

• ⟳ В процессе Roomote — Source-available cloud-агент от Roo Code Inc. Self-hosted, интеграции с GitHub/GitLab, Slack, Discord. Fair Core License → Apache 2.0 через 2 года после релиза.
• ⟳ Активен ZooCode — Community-форк Roo Code. Сохраняет всю функциональность оригинального расширения VS Code. Открыт для контрибьюторов.

🏁 Итоги и рекомендация Qantcore

Главные преимущества Roo Code (наследие):

• Мультиагентность как стандарт — Roo Commander показал, что оркестрация агентов возможна прямо в IDE. Идея, которую теперь подхватывают все.
• Custom Modes — JSON-конфигурация специализированных агентов. Ни у кого не было такого уровня кастомизации.
• Roo Flow — первый встроенный workflow-движок для AI-агентов. Автоматизация цепочек «код → тесты → PR» без внешних инструментов.
• Качество кодовой базы — TypeScript, чистая архитектура, отличная документация. Идеальный проект для изучения того, как строить AI-агентов.
• Свобода (Apache 2.0) — код остаётся открытым навсегда. Форкайте, изучайте, используйте в своих проектах.

Недостатки и причины закрытия:

• Проект заархивирован — новые функции не добавляются, баги не исправляются.
• Монетизация не сработала — Pro-тарифы не окупили разработку; компания переключилась на B2B-модель (Roomote).
• CLI-поддержка была ограниченной — в отличие от Cline, Roo Code был сильно завязан на VS Code API.
• Конкуренция — Cline (родительский проект) продолжал активно развиваться с большим комьюнити.

Для кого Roo Code — исторический интерес: Разработчики, изучающие архитектуру AI-агентов; команды, которые хотят форкнуть и поддерживать свою версию; энтузиасты, ценящие мультиагентный подход.

Для кого лучше выбрать альтернативу: Тем, кому нужен активно поддерживаемый инструмент — используйте Cline AI (родительский проект, 65k+ звёзд) или ZooCode (community-форк Roo Code). Для cloud-решений — Roomote от тех же создателей.

Прогноз и наследие

Хотя сам Roo Code заархивирован, его идеи живут. Мультиагентная архитектура, кастомные режимы и Roo Flow — концепции, которые теперь появляются в Cline, Cursor и других инструментах. Roomote продолжает миссию Roo Code Inc. в облаке, а ZooCode — в редакторе. Кодовая база Roo Code остаётся одним из лучших open-source примеров того, как строить AI-агентов для разработки: чистая архитектура, продуманная система расширений, отличная интеграция с LLM-провайдерами. Мы в Qantcore рекомендуем изучить его как архитектурный эталон, даже если вы не планируете использовать его напрямую.