Введение
oh-my-agent — это фреймворк мультиагентной оркестрации для ИИ-совместимых IDE и CLI-инструментов. Вместо того чтобы полагаться на одного универсального ИИ-помощника, oh-my-agent распределяет работу между 21 специализированными агентами — каждый из которых моделирует реальную инженерную роль с собственным набором знаний о технологическом стеке, протоколами выполнения, справочниками по ошибкам и чек-листами качества.
Вся система располагается в переносимой директории .agents/ внутри вашего проекта. Переключайтесь между Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, Cursor или любым другим поддерживаемым инструментом — конфигурация агентов перемещается вместе с вашим кодом.
Парадигма мультиагентности
Традиционные ИИ-помощники для программирования работают как универсалы. Они обрабатывают фронтенд, бэкенд, базы данных, безопасность и инфраструктуру с одним и тем же контекстом промпта и одинаковым уровнем экспертизы. Это приводит к:
- Размыванию контекста — загрузка знаний по всем доменам расходует контекстное окно впустую
- Непостоянному качеству — универсал не может сравниться со специалистом ни в одном отдельном домене
- Отсутствию координации — сложные фичи, затрагивающие несколько доменов, обрабатываются последовательно
oh-my-agent решает это с помощью специализации:
-
Каждый агент глубоко знает один домен. Фронтенд-агент знает React/Next.js, shadcn/ui, TailwindCSS v4, FSD-lite архитектуру. Бэкенд-агент знает паттерн Repository-Service-Router, параметризованные запросы, JWT-аутентификацию. Они не пересекаются.
-
Агенты работают параллельно. Пока бэкенд-агент создаёт ваш API, фронтенд-агент уже создаёт UI. Оркестратор координирует через общую память.
-
Качество встроено в процесс. У каждого агента есть доменный чек-лист и справочник по ошибкам. Предполётная проверка устава (Charter Preflight) предотвращает расширение объёма работ до написания кода. QA-ревью — полноценный этап, а не запоздалая мысль.
Все 21 агент
Идеация, архитектура и планирование
| Агент | Роль | Ключевые возможности |
|---|---|---|
| oma-brainstorm | Идеация по принципу «сначала дизайн» | Исследует намерение пользователя, предлагает 2-3 подхода с анализом компромиссов, создаёт документы проектирования до написания кода. 6-фазный рабочий процесс: Контекст, Вопросы, Подходы, Дизайн, Документация, Переход к /plan. |
| oma-architecture | Специалист по системной архитектуре | Границы модуля/сервиса/ответственности, анализ компромиссов, синтез мнений стейкхолдеров. Методологии: диагностическая маршрутизация, сравнение design-twice, анализ рисков в стиле ATAM, приоритизация в стиле CBAM, протоколы решений в стиле ADR. По умолчанию учитывает стоимость. |
| oma-pm | Продуктовый менеджер | Декомпозирует требования в приоритизированные задачи с зависимостями. Определяет API-контракты. Выходные данные: .agents/results/plan-{sessionId}.json и task-board.md. Поддерживает концепции ISO 21500, фреймворк рисков ISO 31000, управление ISO 38500. |
Реализация
| Агент | Роль | Технологический стек и ресурсы |
|---|---|---|
| oma-frontend | UI/UX специалист | React, Next.js, TypeScript, TailwindCSS v4, shadcn/ui, FSD-lite архитектура. Библиотеки: luxon (даты), ahooks (хуки), es-toolkit (утилиты), Jotai (клиентское состояние), TanStack Query (серверное состояние), @tanstack/react-form + Zod (формы), better-auth (аутентификация), nuqs (URL-состояние). Ресурсы: execution-protocol.md, tech-stack.md, tailwind-rules.md, component-template.tsx, snippets.md, error-playbook.md, checklist.md, examples/. |
| oma-backend | Специалист по API и серверной части | Чистая архитектура (Router-Service-Repository-Models). Стеко-агностичный — определяет Python/Node.js/Rust/Go/Java/Elixir/Ruby/.NET из манифестов проекта. JWT + bcrypt для аутентификации. Ресурсы: execution-protocol.md, orm-reference.md, examples.md, checklist.md, error-playbook.md. Поддерживает /stack-set для генерации языко-специфичных stack/ справочников. |
| oma-mobile | Кроссплатформенная мобильная разработка | Flutter, Dart, Riverpod/Bloc для управления состоянием, Dio с интерсепторами для API-вызовов, GoRouter для навигации. Чистая архитектура: domain-data-presentation. Material Design 3 (Android) + iOS HIG. Цель: 60fps. Ресурсы: execution-protocol.md, tech-stack.md, snippets.md, screen-template.dart, checklist.md, error-playbook.md. |
| oma-db | Архитектура баз данных | Моделирование SQL, NoSQL и векторных баз данных. Проектирование схемы (по умолчанию 3НФ), нормализация, индексация, транзакции, планирование ёмкости, стратегия резервного копирования. Поддерживает проектирование с учётом ISO 27001/27002/22301. Ресурсы: execution-protocol.md, document-templates.md, anti-patterns.md, vector-db.md, iso-controls.md, checklist.md, error-playbook.md. |
Дизайн
| Агент | Роль | Ключевые возможности |
|---|---|---|
| oma-design | Специалист по дизайн-системам | Создаёт DESIGN.md с токенами, типографикой, цветовыми системами, анимациями (motion/react, GSAP, Three.js), responsive-first макетами, соответствием WCAG 2.2. 7-фазный рабочий процесс: Настройка, Извлечение, Улучшение, Предложение, Генерация, Аудит, Передача. Применяет анти-паттерны (без «ИИ-мусора»). Опциональная интеграция с Stitch MCP. Ресурсы: design-md-spec.md, design-tokens.md, anti-patterns.md, prompt-enhancement.md, stitch-integration.md, плюс директория reference/ с руководствами по типографике, цвету, пространству, анимации, адаптивности, компонентам, доступности и шейдерам. |
Инфраструктура, DevOps и наблюдаемость
| Агент | Роль | Ключевые возможности |
|---|---|---|
| oma-tf-infra | Инфраструктура как код | Мульти-облачный Terraform (AWS, GCP, Azure, Oracle Cloud). OIDC-first аутентификация, IAM с минимальными привилегиями, политики как код (OPA/Sentinel), оптимизация затрат. Поддерживает контроли ИИ ISO/IEC 42001, непрерывность бизнеса ISO 22301, документирование архитектуры ISO/IEC/IEEE 42010. Ресурсы: multi-cloud-examples.md, cost-optimization.md, policy-testing-examples.md, iso-42001-infra.md, checklist.md. |
| oma-dev-workflow | Автоматизация задач в монорепозитории | Раннер задач mise, CI/CD-пайплайны, миграции баз данных, координация релизов, git-хуки, валидация pre-commit. Ресурсы: validation-pipeline.md, database-patterns.md, api-workflows.md, i18n-patterns.md, release-coordination.md, troubleshooting.md. |
| oma-observability | Маршрутизатор наблюдаемости на основе намерения | Покрытие сигналов MELT+P (metrics/logs/traces/profiles/cost/audit/privacy), настройка транспорта (UDP/MTU, OTLP gRPC vs HTTP, топология Collector, сэмплирование), распространение W3C Trace Context, управление SLO и burn-rate оповещения, криминалистика инцидентов (6-мерная локализация), мета-наблюдаемость (self-health, синхронизация часов, кардинальность, хранение). CNCF-first; Fluentd устарел (используйте Fluent Bit или OTel Collector). |
Качество и отладка
| Агент | Роль | Ключевые возможности |
|---|---|---|
| oma-qa | Обеспечение качества | Аудит безопасности (OWASP Top 10), анализ производительности, доступность (WCAG 2.1 AA), ревью качества кода. Серьёзность: CRITICAL/HIGH/MEDIUM/LOW с указанием файл:строка и кодом исправления. Поддерживает характеристики качества ISO/IEC 25010 и выравнивание по ISO/IEC 29119. Ресурсы: execution-protocol.md, iso-quality.md, checklist.md, self-check.md, error-playbook.md. |
| oma-debug | Диагностика и исправление ошибок | Методология «сначала воспроизведи». Анализ корневой причины, минимальные исправления, обязательные регрессионные тесты, сканирование похожих паттернов. Использует Serena MCP для трассировки символов. Ресурсы: execution-protocol.md, common-patterns.md, debugging-checklist.md, bug-report-template.md, error-playbook.md. |
Локализация, координация и Git
| Агент | Роль | Ключевые возможности |
|---|---|---|
| oma-translator | Контекстно-зависимый перевод | 4-этапный метод перевода: Анализ источника, Извлечение смысла, Реконструкция на целевом языке, Проверка. Сохраняет тон, регистр и доменную терминологию. Обнаружение анти-ИИ паттернов. Поддерживает пакетный перевод (файлы i18n). Опциональный 7-этапный режим для публикационного качества. Ресурсы: translation-rubric.md, anti-ai-patterns.md. |
| oma-orchestrator | Автоматизированный координатор мультиагентной системы | Запускает CLI-субагентов параллельно, координирует через MCP-память, отслеживает прогресс, запускает циклы верификации. Настраиваемый: MAX_PARALLEL (по умолчанию 3), MAX_RETRIES (по умолчанию 2), POLL_INTERVAL (по умолчанию 30 сек). Включает цикл агент-агент ревью и мониторинг Clarification Debt. Ресурсы: subagent-prompt-template.md, memory-schema.md. |
| oma-scm | Конвенциональные коммиты | Анализирует изменения, определяет тип/область, разбивает по фичам при необходимости, генерирует сообщения коммитов в формате Conventional Commits. Co-Author: First Fluke <our.first.fluke@gmail.com>. |
Поиск, ретроспектива и обработка документов
| Агент | Роль | Ключевые возможности |
|---|---|---|
| oma-search | Маршрутизатор поиска на основе намерения | Направляет запросы в Context7 (документы), нативный веб-поиск, gh/glab (код), Serena (локально). Оценка доверия домена на всех нелокальных результатах. Fail-forward маршрутизация (docs→web→fetch). Флаги: --docs, --code, --web, --strict, --wide, --gitlab. |
| oma-recap | Межинструментальная ретроспектива работы | Анализирует истории бесед из Claude, Codex, Gemini, Qwen и Cursor. Разрешает ввод даты/диапазона на естественном языке, группирует по инструменту+сессии, извлекает темы, рендерит дневные/периодические сводки для стендапов, еженедельных ретро и рабочих логов. |
| oma-hwp | HWP/HWPX/HWPML → Markdown | Конвертация документов корейского текстового процессора через bunx kordoc@latest. Сохраняет заголовки, таблицы (в том числе вложенные), сноски, гиперссылки, изображения. Удаляет символы Hancom Private Use Area через постпроцессор flatten-tables.ts. |
| oma-pdf | PDF → Markdown | Конвертация PDF-документов через uvx opendataloader-pdf. Сохраняет заголовки, таблицы, списки, изображения; гибридный режим OCR для сканированных PDF; вывод нормализуется через uvx mdformat. |
Модель прогрессивного раскрытия
oh-my-agent использует двухуровневую архитектуру навыков для предотвращения исчерпания контекстного окна:
Уровень 1 — SKILL.md (~800 байт, всегда загружен): Содержит идентификацию агента, условия маршрутизации, основные правила и руководство «когда использовать / когда НЕ использовать». Это всё, что загружается, когда агент не работает активно.
Уровень 2 — resources/ (загружается по требованию):
Содержит протоколы выполнения, справочники по технологическому стеку, шаблоны кода, справочники по ошибкам, чек-листы и примеры. Загружаются только при вызове агента для задачи, и даже тогда — только ресурсы, релевантные конкретному типу задачи (на основе оценки сложности и маппинга задач-ресурсов в context-loading.md).
Такой дизайн экономит примерно 75% токенов по сравнению с предварительной загрузкой всего. Для моделей flash-уровня (контекст 128K) общий бюджет ресурсов составляет примерно 3100 токенов — всего 2,4% контекстного окна.
.agents/ — Единый источник истины (SSOT)
Всё, что нужно oh-my-agent, находится в директории .agents/:
.agents/
├── config/ # oma-config.yaml
├── skills/ # 22 директории навыков (21 агент + _shared)
│ ├── _shared/ # Основные ресурсы для всех агентов
│ └── oma-{agent}/ # Для каждого агента: SKILL.md + resources/
├── workflows/ # 16 определений рабочих процессов
├── agents/ # 9 определений субагентов
├── results/plan-{sessionId}.json # Сгенерированный план
├── state/ # Файлы состояния активных рабочих процессов
├── results/ # Файлы результатов агентов
└── mcp.json # Конфигурация MCP-сервера
Директория .claude/ существует только как слой интеграции с IDE — она содержит символические ссылки на .agents/, а также хуки для обнаружения ключевых слов и строку состояния HUD. Директория .serena/memories/ хранит состояние выполнения во время сессий оркестрации.
Эта архитектура означает, что конфигурация ваших агентов:
- Переносима — переключайте IDE без перенастройки
- Под контролем версий — коммитьте
.agents/вместе с кодом - Общая — участники команды получают одинаковую настройку агентов
Поддерживаемые IDE и CLI-инструменты
oh-my-agent работает с любой ИИ-совместимой IDE или CLI, поддерживающей загрузку навыков/промптов:
| Инструмент | Метод интеграции | Параллельные агенты |
|---|---|---|
| Claude Code | Нативные навыки + Agent tool | Task tool для истинного параллелизма |
| Gemini CLI | Навыки автозагружаются из .agents/skills/ | oma agent:spawn |
| Codex CLI | Навыки автозагружаются | Параллельные запросы через модель |
| Antigravity IDE | Навыки автозагружаются | oma agent:spawn |
| Cursor | Навыки через интеграцию .cursor/ | Ручной запуск |
| OpenCode | Загрузка навыков | Ручной запуск |
Запуск агентов автоматически адаптируется к каждому вендору через протокол определения вендора, который проверяет специфичные для вендора маркеры (например, инструмент Agent для Claude Code, apply_patch для Codex CLI).
Система маршрутизации навыков
Когда вы отправляете промпт, oh-my-agent определяет, какой агент его обработает, используя карту маршрутизации навыков (.agents/skills/_shared/core/skill-routing.md):
| Ключевые слова домена | Маршрут |
|---|---|
| API, endpoint, REST, GraphQL, database, migration | oma-backend |
| auth, JWT, login, register, password | oma-backend |
| UI, component, page, form, screen (web) | oma-frontend |
| style, Tailwind, responsive, CSS | oma-frontend |
| mobile, iOS, Android, Flutter, React Native, app | oma-mobile |
| bug, error, crash, broken, slow | oma-debug |
| review, security, performance, accessibility | oma-qa |
| UI design, design system, landing page, DESIGN.md | oma-design |
| brainstorm, ideate, explore, idea | oma-brainstorm |
| plan, breakdown, task, sprint | oma-pm |
| automatic, parallel, orchestrate | oma-orchestrator |
Для сложных запросов, охватывающих несколько доменов, маршрутизация следует установленным порядкам выполнения. Например, «Создать fullstack-приложение» маршрутизируется в: oma-pm (план), затем oma-backend + oma-frontend (параллельная реализация), затем oma-qa (ревью).
Что дальше
- Установка — Три способа установки, пресеты, настройка CLI и верификация
- Агенты — Подробный обзор всех 21 агентов и предполётной проверки устава
- Навыки — Двухуровневая архитектура в деталях
- Рабочие процессы — Все 16 рабочих процессов с триггерами и фазами
- Руководство по использованию — Реальные примеры от одиночных задач до полной оркестрации