Сравнение трёх инструментов спецификации для AI-разработки: BMAD, Spec-Kit, OpenSpec
Spec-driven разработка — это подход, при котором вы сначала определяете и уточняете спецификацию того, что строите, а уже потом AI генерирует код. Ицхак Эрец Кдоша (Palo Alto Networks) протестировал три таких инструмента на одной реальной задаче: добавление backend-фичи к serverless Python-сервису с аутентификацией и IaC.
Что такое spec-driven AI-разработка
Идея проста: вы приносите задачу или набросок идеи, работаете с AI для создания структурированной спецификации, которая описывает поведение, границы, краевые случаи и интеграцию с системой. AI находит пробелы, которые вы не учли. Вы уточняете, добавляете ограничения и утверждаете. Затем AI реализует спецификацию вместо сырого промпта.
Три инструмента
BMAD (v6.0.3) — полноцикловый фреймворк с отдельными рабочими процессами для выявления требований и корректировки курса. Имеет два режима: полный поток для сложных фич и Quick Flow с переходом сразу к реализации. Артефакты планирования сохраняются в docs/ проекта.
Spec-Kit (v0.1.6) — инструмент от GitHub. Вы один раз определяете конституцию проекта, и каждая спецификация наследует эти правила. Шаблоны отмечают неизвестные как NEEDS CLARIFICATION вместо угадывания.
OpenSpec (v1.2.0) — минимальный след. Пишутся delta-спецификации: только то, что меняется. Завершённые спецификации архивируются и сливаются в единый документ, который растёт вместе с проектом.
Результаты оценки
Автор определил 13 категорий и оценил каждый инструмент от 1 до 5.
| Критерий | BMAD | BMAD Quick | Spec-Kit | OpenSpec |
|---|---|---|---|---|
| Качество спецификации | 4 | 3 | 2 | 4 |
| Адаптивность | 4 | 4 | 2 | 3 |
| Время до PR | 2 | 5 | 5 | 5 |
| Опыт разработчика | 2 | 3 | 3 | 4 |
| Итеративная доработка | 5 | 3 | 2 | 3 |
| Контрольные точки ревью | 2 | 5 | 3 | 5 |
| Совместимость с AI-инструментами | 4 | 4 | 4 | 5 |
| Поддержка параллельной разработки | 2 | 2 | 5 | 5 |
| Видимость workflow | 5 | 5 | 2 | 4 |
| Установка и обновление | 4 | 4 | 2 | 4 |
| Здоровье проекта | 4 | 4 | 2 | 3 |
| Стоимость | 4 | 5 | 5 | 5 |
| Корректировка mid-feature | 5 | 3 | 2 | 4 |
| Итого | 3.65 | 3.74 | 2.77 | 4.00 |
Время и стоимость
| Метрика | BMAD | BMAD Quick | Spec-Kit | OpenSpec |
|---|---|---|---|---|
| Время планирования | 2 дня | 5 часов | 4 часа | 3 часа |
| Время реализации | 4 дня | 1.5 дня | 1 день | 1 день |
| Стоимость планирования | $50 | $30 | $30 | $25 |
| Стоимость реализации | $150 | $55 | $45 | $70 |
BMAD Full — аутсайдер по скорости (6 дней), но глубина планирования окупается, когда цена ошибки высока. Остальные три инструмента сопоставимы по времени и стоимости.
Сильные стороны каждого
BMAD Full — лучший для итеративной доработки и корректировки курса. Adversarial code review (/bmad-bmm-code-review) находит проблемы, которые обычное ревью пропускает. Party Mode прогоняет дизайн через несколько агентных персон. Минус — сложность: 12 агентов, тяжёлый набор артефактов, крутая кривая обучения.
BMAD Quick — минимальный порог входа: два шага, один документ, то же качество выявления требований. Для небольших задач достаточно.
Spec-Kit и OpenSpec обеспечивают параллельную разработку: каждая фича получает изолированную директорию. Два инженера не трогают одни и те же файлы по дизайну. BMAD помещает весь вывод в общую директорию.
Здоровье open-source проектов
| Метрика | BMAD | Spec-Kit | OpenSpec |
|---|---|---|---|
| Коммиты за 90 дней | 458 | 37 | 158 |
| Открытые issues / close rate | 44 / 94.3% | 533 / 36.8% | 201 / 24.2% |
| PR backlog (открытые / медианный возраст) | 6 / 1 день | 94 / 62 дня | 37 / 30 дней |
| Bus factor | 2 | 2 | 1 |
BMAD — самый здоровый проект. Spec-Kit имеет устаревшую очередь PR. OpenSpec разрабатывается одним человеком.
Рекомендации
OpenSpec — лучший старт. Наилучший опыт из коробки, параллельная работа по умолчанию, delta-спецификации подходят для существующих кодобаз. Минус: lock-in и один мейнтейнер.
BMAD Full — когда критична корректность дизайна. Adversarial review, Party Mode и корректировка курса ловят ошибки до того, как они накапливаются.
BMAD Quick — для небольших задач. Два шага, один документ, но для такого масштаба может хватить и Plan Mode.
BMAD (полный) — для глубокой кастомизации. .customize.yaml переживает обновления, Builder генерирует кастомные агенты и workflow.
Советы для enterprise-адопции
- Оберните установку и настройку инструмента. Владейте слоем governance: что устанавливается, как настраивается, какие параметры обязательны.
- Проектируйте желаемый опыт, а не тот, который поставляет инструмент. Определите шаги workflow, артефакты, форматы и review gates.
- Абстрагируйте взаимодействие через кастомные навыки. Команда
/my-company-sdd start feature TICKET-123указывает на нужный workflow. Разработчики учат команды компании, а не инструмента.