🎯 О чём этот конспект: Подробный разбор методологии BMAD (Business, Management, Architecture, Development) для создания IT-продуктов с помощью AI-агентов. Автор демонстрирует полный цикл: от брейншторминга идеи до генерации кода и тестирования, используя Claude Code прямо в терминале VS Code.

👤 Кому будет полезно: Вайбкодерам, разработчикам и фаундерам, которые хотят делегировать планирование и написание кода AI-агентам, сохраняя при этом архитектурный контроль и качество продукта.

✨ Что получите: Готовую систему из специализированных AI-персон (Аналитик, ПМ, Архитектор, Разработчик, QA), установку фреймворка одной командой и пошаговый алгоритм превращения сырой идеи в структурированный проект.

1. Установка и инициализация BMAD Method

Контекст: BMAD — это не просто набор промптов, а оркестрация агентов. Вместо того чтобы клонировать весь репозиторий, автор предлагает использовать npx-установщик, который интегрирует нужные команды и шаблоны прямо в ваш рабочий каталог. Это создает структуру папок (Docs, BMAD core) и настраивает slash-команды для Claude Code.

Выгода: Экономия часов на настройке окружения и создании структуры проекта. Вы получаете стандартизированный процесс за 10 секунд.

Как применить:

• Шаг 1: Установка — В терминале вашей IDE (VS Code, Cursor и др.) выполните команду:

npx bmad-method install

• Шаг 2: Настройка — Следуйте интерактивному меню: укажите путь (например, ./my-app), выберите BMAD core, согласитесь на шардирование (разбиение) PRD и архитектуры, и выберите вашу IDE (например, Claude Code).
• Шаг 3: Запуск Claude Code — Введите команду для старта AI-агента:

claude

Результат: Готовая структура проекта с предустановленными агентами и системными инструкциями.

2. Брейншторминг с агентом-аналитиком (Mary)

Контекст: Большинство AI-инструментов просто выдают средний результат по запросу. Агент Mary (Business Analyst) работает как коуч: она использует 20+ техник (6 шляп мышления, 5 Why, ролевые игры), чтобы вытащить из вас уникальные фичи и проверить идею на прочность.

Выгода: Превращение банальной идеи (например, To-Do списка) в уникальный продукт с «поведенческим интеллектом».

Как применить:

• Шаг 1: Вызов агента — В Claude Code введите:

/analyst

• Шаг 2: Запуск брейншторма — Выберите опцию brainstorm (или введите 5). Ответьте на вопросы агента о целях и ограничениях.
• Шаг 3: Выбор техник — Автор рекомендует сочетать «6 Thinking Hats» (для оценки рисков и выгод) и «Role Playing» (для понимания болей пользователей).
• Шаг 4: Анализ артефакта — После завершения в папке Docs появится файл brainstorming_session.md. Изучите раздел «Moonshots» для будущих фич.

Результат: Глубоко проработанная концепция продукта, зафиксированная в Markdown-документе.

3. Создание PRD и управление MVP-скоупом

Контекст: Product Manager (PM) в BMAD превращает результаты брейншторма в техническое задание (PRD). Ключевая фишка — использование «Advanced Elicitations» (продвинутых уточнений), таких как «Hindsight is 2020», чтобы заставить AI критиковать собственные предложения и отсекать лишнее для MVP.

Выгода: Четкий список эпиков и стори, которые реально реализовать, не раздувая бюджет и сроки.

Как применить:

• Шаг 1: Передача контекста — Вызовите /pm и скормите ему файл брейншторма:

Вот результаты нашего брейншторма: [перетащите файл]. Создай на их основе PRD.

• Шаг 2: Применение техник критического мышления — Используйте промпт для проверки логики:

Используй технику "Hindsight is 2020". Представь, что мы запустили MVP через 6 месяцев и провалились. Какие ошибки в текущем PRD к этому привели?

• Шаг 3: Шардирование — Разбейте огромный PRD на мелкие части (эпики), чтобы не перегружать контекстное окно AI при кодинге:

/shard

Результат: Набор атомарных User Stories с четкими критериями приемки (Acceptance Criteria).

4. Архитектура и технологический стек

Контекст: Архитектор определяет, на каких технологиях будет строиться проект. Важно зафиксировать версии библиотек и структуру папок в отдельном файле (Tech Stack), чтобы разработчик (James) не начал самовольно устанавливать новые фреймворки в середине процесса.

Выгода: Консистентность кода и отсутствие «галлюцинаций» AI по поводу структуры проекта.

Как применить:

• Шаг 1: Генерация архитектуры — Вызовите /architect и выберите тип (Backend/Fullstack).
• Шаг 2: Уточнение стандартов — Добавьте требования к документации:

Добавь в стандарты кодирования обязательное использование JSDoc для всех публичных функций и интерфейсов.

• Шаг 3: Визуализация — Используйте расширение "Markdown Preview Mermaid" в VS Code, чтобы увидеть диаграммы последовательности и схемы БД, созданные архитектором.

Результат: Файлы tech_stack.md, source_tree.md и datamodel.md, которые станут «рельсами» для разработчика.

5. Цикл разработки: Scrum Master -> Developer -> QA

Контекст: Это финальный этап «конвейера». Scrum Master готовит конкретную задачу для разработчика, вытягивая нужный контекст из архитектуры. Разработчик пишет код, а QA-агент (Quinn) проверяет его в свежем контексте, чтобы избежать замыленного глаза.

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

Как применить:

• Шаг 1: Подготовка задачи — Вызовите /scrum и дайте команду:

/draft 1.1

(где 1.1 — это Эпик 1, Стори 1). Переведите статус задачи в Approved.

• Шаг 2: Написание кода — Вызовите /dev и передайте ему файл стори:

/develop [путь к story_1.1.md]

• Шаг 3: Проверка — Обязательно очистите контекст (/clear) и вызовите /qa для финального аудита кода.

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

FAQ

В: Можно ли использовать BMAD без Claude Code? О: Да, методология универсальна. Вы можете использовать те же шаблоны и промпты в Cursor, Windsurf или даже в веб-интерфейсе ChatGPT/Claude, просто копируя содержимое файлов. Но Claude Code дает максимальную скорость за счет slash-команд.

В: Зачем очищать чат (/clear) между агентами? О: Это критически важно для управления контекстом. Если в чате висит обсуждение брейншторма, разработчик может начать использовать «галлюцинации» из идей, которые не вошли в финальный PRD. Чистый контекст = точное следование документации.

В: Что делать, если AI предлагает слишком сложную архитектуру для простого приложения? О: Используйте агента-аналитика или ПМ с промптом на упрощение: «Challenge the scope. Как мы можем реализовать это в 2 раза проще, используя только базовые возможности Node.js?».

В: Как работает команда /shard? О: Она берет один длинный Markdown-файл (например, PRD) и «разрезает» его на отдельные файлы по заголовкам второго уровня (H2). Это позволяет скармливать AI только нужный эпик, экономя токены и повышая точность.

В: Нужно ли платить за Claude Code? О: Да, требуется подписка (от $20). Автор отмечает, что для большинства задач достаточно модели Claude 3.5 Sonnet, но для сложной архитектуры лучше временно переключаться на Opus через команду /model.

Конспект создан на основе видео «Claude Code + BMAD Method: The Ultimate Vibe Coding Workflow» канала BMAD. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=LorEJPrALcg