🎯 О чём этот конспект: Разбор революционной методологии BMAD (Breakthrough Method for Agile AI-driven Development), которая превращает ваш IDE в полноценную софтверную компанию. Вместо хаотичного «вайбкодинга» предлагается строгий Agile-процесс с разделением ролей (PO, Scrum Master, Dev, QA), использованием PRD и архитектурных планов.

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

✨ Что получите: Пошаговый алгоритм настройки автономной команды AI-агентов внутри Cursor, Windsurf или Claude Code, который умеет декомпозировать задачи на эпики и стори, писать код и проводить автоматическое тестирование.

1. От «Вайбкодинга» к Контекстной Инженерии

Контекст: Большинство пользователей используют Cursor просто как продвинутый чат, прося «сделай мне клон Uber». Это работает для демо, но проваливается на сложных проектах из-за ограничений контекстного окна и отсутствия структуры. Метод BMAD внедряет классический Agile-процесс прямо в IDE. Система заставляет AI следовать документации (PRD и Architecture), разбивая проект на мелкие, тестируемые задачи (User Stories). Это гарантирует, что каждая строчка кода соответствует бизнес-требованиям и архитектурному плану.

Выгода: Создание сложных приложений без потери контроля над кодовой базой и значительное снижение галлюцинаций AI за счет узкого фокуса на конкретных задачах.

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

• Шаг 1: Подготовка базы — Используйте специальный системный промпт (Team Fullstack) для генерации PRD (Product Requirements Document) и Architecture.md в ChatGPT или Claude.
• Шаг 2: Инициализация структуры — Установите BMAD в проект, чтобы создать папки ролей (.cursorrules, .claudecode и т.д.).
• Шаг 3: Разделение ответственности — Работайте через специализированных агентов: PO (Product Owner) для управления требованиями, Scrum Master для планирования и Dev для кодинга.

2. Генерация документации через Brainstorm-сессию

Контекст: Качественный софт начинается не с кода, а с понимания фич. Автор предлагает использовать файл team_fullstack.txt из репозитория BMAD как «мозг» для внешней LLM (Gemini или GPT-4o). С помощью команды *brainstorm AI не просто слушает вас, а задает уточняющие вопросы, формирует матрицу фич и дорожную карту MVP. Это позволяет выявить скрытые требования (например, виджеты для iOS или специфику UI) до начала написания первой строки кода.

Выгода: Четкий план разработки (Roadmap) и минимизация переделок в будущем.

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

• Шаг 1: Загрузка роли — Загрузите файл team_fullstack.txt в Claude/GPT и дайте инструкцию:

Attached are the operating system instructions. You must not break character. Use the *brainstorm command to help me define my app idea.

• Шаг 2: Проработка PRD — Используйте команду *PM и затем create doc. Пройдите через 5 стадий выбора функционала, предлагаемых агентом.
• Шаг 3: Архитектура — Переключитесь на роль *Architect для создания architecture.md, где будет описан стек технологий и связи компонентов.

3. Процесс Sharding: Управление контекстом через декомпозицию

Контекст: Одной из главных проблем AI-разработки является переполнение контекстного окна. BMAD решает это через «шардинг» (sharding) — разбиение тяжелых файлов PRD и архитектуры на мелкие индексированные фрагменты. Агент PO (Product Owner) берет ваши документы и превращает их в набор управляемых задач. Это позволяет AI-разработчику фокусироваться только на текущей задаче, не отвлекаясь на 50 страниц общего описания проекта.

Выгода: Экономия токенов и высокая точность выполнения задач.

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

• Шаг 1: Подготовка папок — Создайте в корне проекта папку docs/ и положите туда prd.md и architecture.md.
• Шаг 2: Запуск PO — В Cursor вызовите агента PO (через @ или выбрав соответствующий .cursorrules).
• Шаг 3: Шардинг — Выполните команду:

/shard_doc path: docs/prd.md
/shard_doc path: docs/architecture.md

Результат: В проекте появятся структурированные задачи, готовые к передаче Scrum-мастеру.

4. Цикл разработки: Эпики, Стори и Статусы

Контекст: После шардинга в игру вступает Scrum Master. Он группирует задачи в Эпики (крупные блоки) и User Stories (конкретные фичи). Каждая стори имеет жизненный цикл: draft -> approved -> in_progress -> ready_for_review -> done. Разработчик (Dev Agent) не имеет права брать задачу, пока она не переведена в статус approved. Это имитирует работу реальной команды, где код пишется только после того, как требования утверждены.

Выгода: Полная прозрачность процесса и исключение ситуации, когда AI начинает писать код «от себя».

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

• Шаг 1: Создание эпиков — Агент Scrum Master выполняет команду create_epic.
• Шаг 2: Утверждение — Откройте файл сгенерированной стори (например, story_1.1.md) и вручную измените статус:

status: approved

• Шаг 3: Кодинг — Запустите Dev-агента в НОВОМ чате (для чистоты контекста) и укажите номер стори:

Implement story 1.1

5. Автоматическое тестирование и ревью (QA Agent)

Контекст: Код считается готовым только после прохождения ревью. В BMAD за это отвечает отдельный агент-тестировщик. Он сканирует кодовую базу на соответствие требованиям стори, проверяет наличие багов и может проводить активный рефакторинг (удаление дублей, оптимизация). Только после его одобрения статус задачи меняется на done, и команда переходит к следующему этапу.

Выгода: Высокое качество кода и работающее приложение на каждом этапе (incremental shipping).

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

• Шаг 1: Запуск ревью — После того как Dev-агент закончил работу, вызовите агента-тестировщика.
• Шаг 2: Метод review — Используйте встроенный метод:

/review story: 1.1

• Результат: Агент либо найдет ошибки и попросит их исправить, либо автоматически обновит статус стори на done.

6. Установка и настройка BMAD в IDE

Контекст: BMAD — это набор конфигурационных файлов (правил) для разных IDE. Установка производится через одну команду в терминале и позволяет быстро развернуть всю инфраструктуру агентов в новом проекте.

Выгода: Быстрый старт нового проекта со всеми настроенными ролями.

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

• Шаг 1: Команда установки — Откройте терминал в папке проекта и введите:

npx bmad-code@latest

• Шаг 2: Конфигурация — Укажите путь к проекту, выберите "Install BMAD Agile Core System", включите шардинг PRD и Архитектуры.
• Шаг 3: Выбор IDE — Выберите ваши инструменты (Cursor, Claude Code, Windsurf).
• Шаг 4: Перезапуск — Перезагрузите IDE, чтобы подтянулись новые .cursorrules или файлы конфигурации.

FAQ

В: Можно ли использовать BMAD в обычном VS Code без платных AI-расширений?

О: Метод лучше всего работает с Cursor, Windsurf или Claude Code (CLI), так как они поддерживают систему правил (rules) и агентов. В обычном VS Code вам придется вручную копировать промпты из файлов ролей, что сильно замедлит процесс.

В: Зачем начинать каждый этап (Dev, QA) в новом чате?

О: Это критически важно для управления контекстом. Если вести весь проект в одном чате, AI быстро начнет путаться, забывать старый код или предлагать неверные решения из-за огромного объема истории. Новый чат с конкретной задачей (Story) дает AI «чистый лист» и максимум внимания на текущий код.

В: Какую модель лучше использовать для генерации PRD и Архитектуры?

О: Автор рекомендует Gemini 1.5 Pro из-за огромного контекстного окна и дешевизны, но GPT-4o и Claude 3.5 Sonnet также отлично справляются с ролью PM и Архитектора.

В: Что делать, если AI-агент застрял или совершает ошибку в логике?

О: В BMAD предусмотрен агент Orchestrator. Вы можете вызвать его, чтобы он проанализировал текущее состояние проекта и подсказал, какой шаг или какой агент должен быть задействован следующим. Также всегда можно вручную поправить файлы стори или PRD.

В: Нужно ли мне самому писать код при использовании этого метода?

О: В идеале — нет. Ваша роль смещается от «написания строк кода» к «управлению продуктом» (Product Management). Вы проверяете логику, утверждаете стори и следите за тем, чтобы AI следовал архитектуре. Однако понимание кода необходимо для контроля качества на этапе Review.

Конспект создан на основе видео «The Best Way To Build Apps With Cursor AI (BMAD Method)» канала AICodeKing. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=fD8NLPU0WYU