Каждый внешний модуль ставится на один из трёх каналов: стабильный, предварительный или закреплённый на конкретном теге. Управляется это флагами --channel, --next=<код> и --pin <код>=<тег>, приоритет у них в обратном порядке - закрепление сильнее всего.
Важная деталь про обновления: заплаточные и минорные версии применяются автоматически, а мажорные заморожены по умолчанию, потому что ломающие изменения обычно всплывают как неожиданная нестабильность. Чтобы принять мажорное обновление в неинтерактивном режиме, тег придётся указать явно.
Существующий код
Для чужой кодовой базы предусмотрен отдельный вход, и подход там нетипичный.
bmad-project-context не генерирует гору документации. Он читает то, что у вас уже есть, говорит, насколько это годится, спрашивает, какие правила соблюдать, а остальное выясняет сам - выполняя каждую команду прежде, чем записать её как факт. Результат - один небольшой проверенный блок в вашем AGENTS.md.
Правило отбора в этот блок сформулировано одной проверкой: всё, что выводится из исходников, читается на месте и не сохраняется. Поэтому строчка pnpm test туда не попадёт, а фраза "прогон занимает одиннадцать минут" попадёт.
Скил показывает каждую запись перед тем, как её сделать, работает без установленного BMAD и запускается только по имени - сам он ни на что не срабатывает.
Что стоит знать заранее
uv теперь обязателен. С версии 6.11.0 это жёсткое требование для генерируемых скилов, отката на другой интерпретатор нет: bmad-build и bmad-build-auto просто останавливаются, если uv недоступен. Питон при этом нужен версии 3.11 или новее, хотя README называет 3.10 как общее требование.
Установщик не удаляет старые скилы. Это записано прямым текстом: файлы снятого модуля остаются лежать. Лечится удалением устаревших каталогов или всего каталога скилов с последующим повтором установки.
После добавления или удаления модуля установщик надо запустить снова, иначе набор скилов разъедется с набором модулей.
Конфигурация переехала на многослойный TOML, и генератор больше не прощает ошибок. Отсутствующий ключ раньше подставлялся пустой строкой, нечитаемый файл переопределения молча игнорировался. Теперь оба случая - чистая остановка с кодом ошибки.
Числа из старых материалов не проверяются. README раньше обещал двенадцать с лишним специалистов и тридцать четыре с лишним процесса; сейчас этих цифр там нет вообще. По факту в основном модуле пять агентов, в ядре восемь инструментов, в карте процессов пятнадцать именованных позиций плюс четырнадцать переходников.
Лицензия MIT, но имя защищено. BMad, BMad Method и BMad Core - торговые марки BMad Code, LLC во всех написаниях. На код это не влияет, на название вашего форка - влияет.
Ошибки первого знакомства
Идти по старым руководствам. bmad-quick-dev, bmad-dev-story, bmad-create-story, три исследовательских скила и шесть скилов ревью сменили имена в 6.11.0. Они работают, но это переходники, и до седьмой версии.
Ставить в CI без --tools. Для свежей установки с --yes флаг обязателен, и --tools none больше не принимается.
Считать --modules дельтой. Это полный набор: перечислять надо всё, что должно остаться.
Забыть про uv. Без него сборка не запустится вообще.
Ждать, что удалённый модуль уберёт за собой скилы. Не уберёт, чистить надо руками.
Проходить все четыре фазы ради мелкой правки. Весь смысл метода в том, что понятная задача входит прямо в bmad-build.
Латать код, когда ошибка в намерении. Документация настаивает: возвращаться надо на тот слой, где ошибка вошла.
Брать цифры про агентов и процессы из чужих обзоров. Проект сам их со своей витрины убрал.
Если свести к одной фразе: BMAD ставит не на то, чтобы агент писал код без человека, а на то, чтобы человек тратился только там, где его суждение действительно чего-то стоит.
Источники
Статья сверена с репозиторием bmad-code-org/BMAD-METHOD (ветка main) 25 августа 2026 года: README, package.json, LICENSE, CHANGELOG.md, bmad-modules.yaml, дерево src/core-skills и src/bmm-skills, а также страницы документации по установке, скилам, агентам, карте процессов и сборке. Количества агентов, инструментов ядра и переходников посчитаны по дереву репозитория. Версия пакета, звёзды и форки сняты в тот же день. Обратите внимание: релиз 6.11.0 переименовал значительную часть скилов, поэтому материалы старше августа 2026 года описывают другие имена команд.
