Sub-agents

Основной агент (Tech Lead) координирует работу специализированных суб-агентов. Каждый суб-агент имеет свою зону ответственности и набор обязательных документов.

Архитектура

┌─────────────────────────────────────────────────────────────┐
│                     Main Agent (Tech Lead)                   │
│  • Получает ТЗ                                               │
│  • Декомпозирует на задачи                                   │
│  • Делегирует суб-агентам                                    │
│  • Принимает кросс-доменные решения                          │
└─────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│    Backend    │    │   Frontend    │    │      QA       │
│    Domain     │    │    Domain     │    │    Domain     │
└───────────────┘    └───────────────┘    └───────────────┘

Backend Agents

backend-analyst

Цель: Максимально переиспользовать существующее, не плодить дубликаты.

Задачи:

• Анализ ТЗ и выделение необходимых сущностей
• Проверка существующих API и моделей
• Составление спецификации для разработчика
• Решение: новое vs расширение существующего

Обязательные документы:

MCP: oro-playbook, prisma

backend-developer

Цель: Реализация по спецификации аналитика + документация.

Задачи:

• Создание/изменение Prisma моделей
• Реализация API endpoints
• Написание event handlers (Socket.io)
• Документирование API

Обязательные документы:

MCP: prisma, nuxt-remote

backend-testing

Цель: Покрытие тестами по спеке аналитика, проверка соответствия бизнес-требованиям.

Задачи:

• Написание unit-тестов для API
• Интеграционные тесты с БД
• Проверка edge cases из ТЗ
• Валидация бизнес-логики

Обязательные документы:

MCP: prisma

backend-reviewer

Цель: Консистентность кодовой базы, соблюдение стандартов.

Задачи:

• Code review изменений
• Проверка соответствия стандартам
• Проверка naming conventions
• Проверка структуры файлов
• Запуск тестов и проверка их прохождения

Обязательные документы:

MCP: oro-playbook

backend-integrator

Цель: Установка и настройка новых инструментов с проверкой актуальной документации.

Задачи:

• Проверка актуальной документации инструмента
• Поиск примеров интеграции в других модулях
• Базовая настройка и проверка работоспособности
• Обновление существующих зависимостей

Обязательные документы:

MCP: nuxt-remote, prisma + WebSearch для актуальной документации

Frontend Agents

frontend-analyst

Цель: Переиспользование компонентов, выбор подхода к реализации UI.

Задачи:

• Анализ ТЗ с точки зрения UI/UX
• Проверка существующих компонентов
• Определение: новый компонент vs расширение
• Составление спецификации для разработчика

Обязательные документы:

MCP: oro-playbook, nuxt-ui-remote

frontend-developer

Цель: Реализация UI по спецификации аналитика.

Задачи:

• Создание Vue компонентов
• Реализация страниц и layouts
• Интеграция с API и stores
• Работа с формами и валидацией

Обязательные документы:

MCP: nuxt-remote, nuxt-ui-remote

frontend-testing

Цель: Тестирование компонентов и интеграций.

Задачи:

• Unit-тесты компонентов
• Тесты composables
• Тесты stores
• E2E тесты критичных flow

Обязательные документы:

MCP: nuxt-remote

frontend-reviewer

Цель: Консистентность frontend кода, соблюдение стандартов.

Задачи:

• Code review компонентов
• Проверка декомпозиции
• Проверка naming conventions
• Проверка использования Tailwind
• Запуск тестов и проверка их прохождения

Обязательные документы:

MCP: oro-playbook

frontend-integrator

Цель: Установка и настройка frontend инструментов.

Задачи:

• Проверка актуальной документации
• Интеграция новых библиотек
• Настройка Nuxt modules
• Обновление зависимостей

Обязательные документы:

MCP: nuxt-remote, nuxt-ui-remote + WebSearch для актуальной документации

frontend-qa

Цель: Проверка качества UI/UX и отсутствия runtime ошибок.

Задачи:

• Визуальная проверка UI (скриншоты)
• Проверка консоли браузера на ошибки
• Проверка Network на failed requests
• Проверка в светлой и тёмной теме
• Проверка responsive design

Обязательные документы:

MCP: chrome-devtools (для проверки консоли и скриншотов)

Чек-лист проверки:

• Нет ошибок в Console
• Нет failed requests в Network
• Input'ы растянуты на всю ширину контейнера
• Корректно в светлой теме
• Корректно в тёмной теме
• Корректно на мобильных (< 768px)
• Loading states работают
• Error states отображаются

Процесс работы Tech Lead

1. Получить бизнес-задачу (ТЗ)
       │
       ▼
2. Декомпозировать на backend/frontend части
       │
       ▼
3. Backend Flow (если нужен)
       │
       ├── backend-analyst ──► спека + решение о переиспользовании
       │         │
       │         ├── нужен новый инструмент? ──► backend-integrator
       │         │
       │         ▼
       │   ┌─────┴─────┐
       │   │           │
       │   ▼           ▼
       ├── backend-developer    backend-testing
       │   (реализация)         (тесты по спеке)
       │   │           │
       │   └─────┬─────┘
       │         ▼
       └── backend-reviewer ──► code review
                 │
                 ▼
           Артефакты backend готовы (API, типы, события)
                 │
                 ▼
4. Frontend Flow (если нужен, с артефактами backend)
       │
       ├── frontend-analyst ──► спека UI + декомпозиция компонентов
       │         │
       │         ├── нужен новый инструмент? ──► frontend-integrator
       │         │
       │         ▼
       │   ┌─────┴─────┐
       │   │           │
       │   ▼           ▼
       ├── frontend-developer   frontend-testing
       │   (реализация)         (тесты по спеке)
       │   │           │
       │   └─────┬─────┘
       │         ▼
       ├── frontend-reviewer ──► code review
       │         │
       │         ▼
       └── frontend-qa ──► UI/UX + консоль + network
                 │
                 ▼
5. Интеграция и финальная проверка

Ключевые моменты

1. Backend первый — если задача требует backend, он идёт первым. Frontend получает готовые артефакты (API endpoints, типы, Socket.io события).
2. Developer и Testing параллельно — после спеки аналитика, разработка и написание тестов могут идти одновременно (TDD-подход).
3. Integrator по требованию — вызывается после analyst, если тот определил необходимость нового инструмента.
4. Артефакты передаются — результаты backend (спека API, типы, endpoints) передаются в frontend flow.
5. QA последний — frontend-qa проверяет финальный результат в браузере.

Матрица документов