На маленьких задачах ИИ-кодинг — магия. На реальном проекте — хаос: контекст теряется, код плывёт, каждая сессия начинается с нуля. BMAD (Breakthrough Method for Agile AI-Driven Development) — open-source фреймворк, который превращает ИИ-разработку в работу виртуальной agile-команды из 12+ специализированных агентов. Работает с Claude Code, Cursor, Codex CLI и любыми IDE.
Что это
Обычный подход к ИИ-кодингу: промпт → код → правки → повтор. Проблемы накапливаются: контекст теряется, результаты непредсказуемы, непонятно, почему принято то или иное решение. BMAD решает это через фронтлоадинг планирования (frontloading) — сначала 80% усилий на создание точных спецификаций (PRD, архитектура, стори), затем AI-разработчик получает полный контекст и реализует задачи предсказуемо.
Если вайб-кодинг — это «дай ИИ делать что хочет», то BMAD — это «дай ИИ работать как профессиональная команда с чёткими ролями и артефактами».
Зачем нужно
- Превратить хаотичный вайб-кодинг в предсказуемый процесс с воспроизводимым результатом.
- Получить спецификации (PRD, архитектура, стори) до того, как написан хоть один кусок кода.
- Декомпозировать сложные фичи на эпики и стори, которые реально реализуются за одну сессию.
- Версионировать все артефакты в Git — полная трассируемость каждого решения.
- Использовать Party Mode — обсуждение задачи несколькими агентами с разных ролей ещё до кода.
Как устроено
Метод разделён на две фазы, каждая со своими агентами и артефактами.
Фаза 1: Планирование
Цель — создать полный набор документов: что строить и как.
- Analyst (Mary) — исследует рынок, анализирует конкурентов, формирует Project Brief.
- PM (James) — превращает Brief в PRD с требованиями, персонами и метриками.
- Architect (Winston) — проектирует архитектуру, выбирает стек, описывает модели данных.
- UX Designer (Reily) — создаёт фронтенд-спецификацию и UI-гайдлайны.
- Scrum Master (Flo) + PO (Quinn) — декомпозируют всё на эпики и стори с acceptance criteria.
Фаза 2: Реализация
Цель — превратить спецификации в рабочий код.
- Developer (Dev) — пишет код строго по спецификации, создаёт тесты.
- QA — валидирует реализацию по чеклистам.
- Tech Writer (Jamie) — пишет документацию.
BMAD автоматически подстраивает глубину планирования под масштаб задачи. Баг-фикс пойдёт сразу к Dev, фича пройдёт через PRD и архитектуру, новый продукт — полный цикл.
Команда агентов
Каждый агент — это Markdown-файл с системным промптом, описанием персоны, набором команд и правилами создания артефактов. Агенты хранятся в _bmad/agents/ вашего проекта и полностью кастомизируются.
| Агент | Роль | Ключевые команды |
|---|---|---|
| BMad Master | Универсальный координатор, точка входа | /bmad-help, /create-doc |
| Analyst (Mary) | Исследование, конкуренты, брейнсторм | /brainstorm, /research |
| PM (James) | Требования, PRD, эпики | /create-prd, /create-epic |
| Architect (Winston) | Техническая архитектура и стек | /create-architecture |
| UX Designer (Reily) | Фронтенд-спецификация, UI | /create-frontend-spec |
| Scrum Master (Flo) | Декомпозиция на stories | /create-stories |
| Developer (Dev) | Написание и отладка кода | /implement, /fix |
| QA | Тестирование и валидация | /test, /validate |
| Tech Writer (Jamie) | Документация | /create-docs |
Когда использовать
Установка
# Установить глобально
npm install -g bmad-method
# Инициализировать в проекте
npx bmad-method@alpha installУстановщик спросит, какую IDE вы используете (Cursor, Claude Code, VS Code, Codex), какие агенты нужны, и создаст структуру.
_bmad/
├── agents/ # Файлы агентов (.md)
├── checklists/ # Чеклисты валидации
├── templates/ # Шаблоны документов
├── docs/ # Артефакты проекта
└── tasks/ # Трекинг задачПолный цикл для нового проекта
- Активируйте Analyst и опишите идею. Он проведёт анализ рынка, SWOT и сформирует Project Brief.
- Переключитесь на PM. Он превратит Brief в PRD с требованиями, персонами, метриками успеха.
- Architect спроектирует архитектуру, выберет стек, опишет модели данных и API.
- Scrum Master декомпозирует всё на стори с acceptance criteria.
- Developer получает полный контекст и реализует задачи строго по спецификации.
Все артефакты сохраняются как файлы в репозитории и версионируются через Git — полная трассируемость каждого решения.
Party Mode
Уникальная фича BMAD: можно вызвать нескольких агентов в одну сессию, и они будут обсуждать вопрос с разных позиций. Например, Architect и QA находят 80% проблем до написания кода. PM хочет фичу — Architect говорит «это сломает масштабируемость».
Party Mode требует мощных моделей (Claude Opus, GPT-4o). На слабых моделях персоны «сливаются» и теряют специализацию.
Сравнение с альтернативами
| Критерий | BMAD | Вайб-кодинг | Taskmaster AI |
|---|---|---|---|
| Подход | Spec-driven, agile-команда | Промпт → код | Декомпозиция + трекинг |
| Агенты | 12+ специализированных | 1 общий | 1 менеджер |
| Покрытие цикла | Полный: анализ → деплой | Только код | Планирование + код |
| Трассируемость | Полная (Git) | Нет | Частичная |
| IDE | Cursor, Claude Code, VS Code, Codex | Любая | Cursor, Claude Code |
| Цена | Бесплатно, open-source | — | Бесплатно, open-source |
Ограничения
| Ограничение | Пояснение |
|---|---|
| Требует мощных reasoning-моделей (Claude Opus, GPT-4o) | На слабых моделях агенты теряют специализацию, персоны «сливаются». |
| Party Mode жрёт много токенов | каждая сессия с несколькими агентами обходится в разы дороже обычного ИИ-кодинга. |
| Все артефакты (PRD, архитектура, стори) должны жить в Git | Без версионирования теряется контекст при переключении сессий. |
| Стори должны быть маленькими | если стори не реализуется за одну сессию, она слишком большая, надо декомпозировать дальше. |
| Без вызванной команды /validate пропускается 80% проблем | чеклисты валидации обязательны. |
| Накладные расходы на планирование (PRD + архитектура) оправданы не для всех задач | для баг-фикса это overhead, для нового продукта — необходимость. |
Антипаттерны
| Антипаттерн | Почему опасно |
|---|---|
| Не делать — пропускать планирование и сразу вызывать Dev без PRD и архитектуры. | Без спецификаций вы вернулись к вайб-кодингу. |
| Не делать — использовать слабые модели для планирования. | Analyst, PM и Architect требуют мощных reasoning-моделей. |
| Не делать — забывать версионировать артефакты. | Документы должны жить в Git, иначе теряется контекст. |
| Не делать — делать слишком крупные стори. | Если стори не реализуется за одну сессию — декомпозируйте дальше. |
| Не делать — пропускать валидацию. | Команда /validate проверяет артефакты по чеклистам, пропуск — причина 80% проблем. |
Чеклист
| Проверка | Что сделать |
|---|---|
| BMAD установлен глобально (npm install -g bmad-method) и инициализирован в проекте (npx bmad-method@alpha install) | |
| Выбрана IDE (Cursor, Claude Code, VS Code или Codex) и нужные агенты | |
| Project Brief создан Analyst-агентом, прошёл валидацию и закоммичен в Git | |
| PRD с требованиями, персонами и метриками готов и валидирован | |
| Архитектура, стек и модели данных описаны Architect-агентом | |
| Все стори декомпозированы Scrum Master до размера одной сессии | |
| Party Mode протестирован на ключевых архитектурных решениях | |
| QA-валидация по чеклистам запускается перед каждым релизом |