BMAD — фреймворк агентной разработки через ИИ-навыки и спецификации

BMAD Method — система навыков для AI-инструментов разработки. Она помогает зафиксировать замысел и ограничения в проверяемых артефактах, а затем передать реализацию специализированным навыкам, сохраняя контекст работы в репозитории.

Материал актуализирован 2 сентября 2026 года по состоянию на BMAD v6.11.0.

Содержание

1. Целевая архитектура работы — как связать замысел, спецификацию и код.
2. Как выбрать маршрут — процесс для исправления, функции или продукта.
3. Основные навыки и артефакты — актуальные команды и результаты.
4. Эталонный рабочий шаблон — последовательность для крупного изменения.
5. Установка и требования — безопасный способ начать работу.
6. Многоагентные обсуждения — когда полезен Party Mode.
7. Чеклист быстрой проверки — десять пунктов перед реализацией.
8. Типичные ошибки — что чаще всего ломает процесс.

Целевая архитектура работы

В официальной документации именованные команды BMAD называются навыками (skills). Одни навыки помогают исследовать идею, проверить варианты и записать решения. Другие передают подготовленное изменение в bmad-build, который реализует его и участвует в проверке результата.

Целевой поток выглядит так:

flowchart LR
    A[Замысел или проблема] --> B[Исследование и выбор маршрута]
    B --> C[Спецификация]
    C --> D[UX и архитектурные решения]
    D --> E[Планирование спринта]
    E --> F[Реализация]
    F --> G[Проверка кода]
    G --> H[Проверяемый результат]

Полный маршрут нужен крупной функции или новому продукту. Небольшое точно сформулированное исправление можно сразу передать bmad-build. Для большого изменения сначала подготовьте спецификацию и те архитектурные или UX-артефакты, которые влияют на решение.

Практическая ценность подхода заключается в явных границах задачи. Решения сохраняются в репозитории, их можно проверить и использовать в следующей сессии без пересказа всей истории проекта.

Как выбрать маршрут

Текущая документация предлагает выбирать глубину планирования по масштабу и определённости задачи.

Планирующие и реализующие навыки можно использовать отдельно. Полный процесс не требуется для каждой задачи.

Основные навыки и артефакты

В релизе v6.11.0 каталог основного ядра сокращён с четырнадцати до восьми навыков: несколько исследовательских, редакционных и проверочных операций объединены. Поэтому старый список из «12+ агентов» нельзя использовать как стабильный справочник.

В v6.11.0 bmad-build стал официальным способом реализации кода. bmad-quick-dev переименован в bmad-build, а bmad-dev-auto — в bmad-build-auto. bmad-create-story и bmad-dev-story переведены в устаревающий режим. Старые идентификаторы продолжают работать через переходные оболочки до выхода v7.

bmad-spec перемещён из core в BMM, поэтому core-only установка не включает этот навык. bmad-review объединяет документальные и редакционные проверки через настраиваемые линзы, а bmad-code-review сохраняется в цепочке реализации:

bmad-sprint-planning → bmad-build → bmad-code-review

Эталонный рабочий шаблон

Ниже опорный маршрут для крупного изменения. Конкретные промежуточные навыки выбираются по задаче.

1. Зафиксируйте результат

Опишите наблюдаемое поведение, которое должно измениться, пользователей и ограничения. Если замысел уже полный, передайте его в bmad-spec.

2. Закройте неизвестное

Для сырой идеи сначала соберите варианты или проверьте решение на прочность. Затем используйте bmad-deep-recon для рыночного, предметного или технического исследования и сохранения свидетельств.

3. Создайте проектные артефакты

Добавляйте только документы, влияющие на решение:

• PRD — если нужны продуктовые требования и критерии успеха;
• DESIGN.md и EXPERIENCE.md — если меняются визуальная система, пользовательские потоки или информационная архитектура;
• ARCHITECTURE-SPINE.md — если изменение затрагивает архитектурные границы, данные или интеграции;
• проверенный блок в AGENTS.md — если в существующем репозитории есть правила, которые нельзя надёжно вывести из исходного кода.

4. Проверьте готовность

Запустите bmad-sprint-planning. В v6.11.0 он включает проверку готовности со статусами PASS, CONCERNS и FAIL. Перед реализацией закройте блокирующие замечания и зафиксируйте оставшиеся риски.

5. Реализуйте и проверьте

Передайте подготовленный контекст в bmad-build, затем выполните bmad-code-review. Проверьте соответствие спецификации и наличие тестов, которые действительно обнаружат поломку изменённого поведения.

6. Зафиксируйте результат

Сохраните спецификации, архитектурные решения и код в одном репозитории. Другой разработчик должен восстановить причины решения по артефактам, а не по истории чата.

Установка и требования

Команды и варианты установщика меняются между выпусками, поэтому используйте актуальную официальную инструкцию, а не сохранённую команду из старой статьи.

После установки выполните минимальную проверку:

1. Откройте проект в поддерживаемом AI-инструменте.
2. Запустите bmad-help.
3. Убедитесь, что помощник видит установленные навыки и предлагает маршрут.
4. Для небольшого безопасного изменения вызовите bmad-build и задайте проверяемый результат.
5. Просмотрите diff и результат bmad-code-review перед принятием изменения.

Этот материал основан на документации и снимке релизов; команды в реальном проекте здесь не запускались.

Многоагентные обсуждения

bmad-party-mode запускает обсуждение с несколькими персонами или проверочными ролями. В релизе v6.9.0 описаны собственные составы, именованные комнаты и опциональная память предыдущих сессий.

Режим полезен, когда решение затрагивает продуктовые требования, архитектуру и проверяемость. Он расходует дополнительный контекст, поэтому подходит для спорных решений, архитектурных развилок и ретроспектив. Итоговое решение остаётся за человеком.

Чеклист быстрой проверки

Перед передачей задачи в реализацию проверьте десять пунктов:

Типичные ошибки

• Использовать старые имена навыков. В v6.11.0 Quick Dev переименован в Build, а часть прежних команд работает через переходные оболочки.
• Применять полный процесс к мелкому исправлению. Точно описанное небольшое изменение можно сразу передать bmad-build.
• Начинать крупную функцию без контракта. Для неё нужен хотя бы SPEC.md с результатом, границами и критериями проверки.
• Хранить правила проекта только в чате. Устойчивые ограничения фиксируйте в проверенном блоке AGENTS.md.
• Копировать в контекст сведения, выводимые из репозитория. bmad-project-context предназначен для правил и наблюдений, которые нельзя надёжно получить из исходного кода.
• Считать сгенерированный документ доказательством. Требования, архитектура и результаты проверки должны ссылаться на реальные артефакты проекта.
• Пропускать проверку тестов. Наличие тестового файла само по себе не показывает, что тест обнаружит поломку изменённого поведения.
• Игнорировать зависимости среды. Для текущих отрисованных навыков нужны uv и Python 3.11 или новее.

Где проверить версию и команды

• Документация BMAD Method
• Установка BMAD
• Репозиторий BMAD Method
• Релизы BMAD Method

Следующий шаг

Если вы планируете применять BMAD в Cursor, сначала проверьте возможности самого редактора и его агентного режима: Cursor — AI-редактор кода для агентной разработки.

Связанные материалы

• Статья: Почему идеальный план не спасает от багов — и почему это нормально
• Блог: Навык ведущего разработчика — главный скилл для работы с ИИ
• База знаний: PRD — что это и как его правильно писать

BMAD особенно полезен командам, которым нужно согласовать требования, архитектурные ограничения и проверку реализации в одном процессе.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov