GSD Framework: Пошаговое руководство по созданию сложных IT-продуктов с AI-агентами
Узнайте, как использовать фреймворк GSD для итеративной разработки IT-продуктов с помощью AI-агентов. Сравнение с BMAD и Superpowers, настройка и промпты.
🎯 О чём этот конспект: Разбор нового фреймворка GSD (Get Stuff Done) для AI-агентов (Claude Code, Cursor и др.). В отличие от жестко структурированных методов, GSD ориентирован на быструю итеративную разработку MVP, где требования могут меняться в процессе, а контекст защищен от «засорения» (context rot).
👤 Кому будет полезно: Вайбкодерам и разработчикам, создающим кастомные SaaS, сложные веб-приложения или экспериментальные продукты, которые сложно полностью спроектировать на старте.
✨ Что получите: Четкое понимание, какой фреймворк выбрать под конкретный проект (GSD vs BMAD vs Superpowers), и готовую инструкцию по развертыванию GSD для автоматизации цикла «планирование — исследование — кодинг — тестирование».
1. Выбор стратегии: GSD vs BMAD vs Superpowers
Контекст: Главная ошибка вайбкодера — использование тяжеловесных систем планирования для простых задач или, наоборот, отсутствие структуры в сложных проектах. Автор выделяет три ключевых подхода. GSD идеален для неопределенности и экспериментов. BMAD (Business Model Architecture Deployment) нужен для жестко регламентированных корпоративных систем (CRM, ERP), где нельзя отступать от ТЗ. Superpowers базируется на TDD (Test Driven Development) и незаменим там, где цена ошибки критична (например, финансовые транзакции или необратимые действия агентов).
Выгода: Экономия десятков часов на переписывании кода из-за неверно выбранной архитектуры процесса.
Как применить:
Шаг 1: Оцените проект. Если вы делаете MVP и не уверены в финальном UI/UX — выбирайте GSD.
Шаг 2: Оцените риски. Если ошибка в логике приведет к потере денег — используйте Superpowers (тесты пишутся до кода).
Шаг 3: Оцените масштаб. Если это стандартное решение (например, клон соцсети) с понятными требованиями — используйте BMAD для создания глубокой документации (PRD, Architecture Docs).
Результат: Выбран оптимальный темп разработки и уровень контроля для вашего конкретного случая.
2. Установка и инициализация GSD в проекте
Контекст: GSD работает как надстройка над AI-агентом (например, Claude Code). Он устанавливается прямо в папку проекта и создает структуру в формате XML. Это важно, так как модели Claude лучше парсят XML, чем обычный Markdown, что повышает точность следования инструкциям. Фреймворк разделяет обязанности между специализированными агентами (Research, Planner, Verifier), предотвращая «галлюцинации» из-за перегруженного контекста.
Выгода: Изолированная среда разработки и автоматическое управление контекстом (Context Management).
Как применить:
Шаг 1: Установка. Выполните команду в терминале вашего проекта:
# Команда установки (зависит от вашего агента, обычно через npm или curl)npx gsd-cli install
Шаг 2: Настройка. Выберите установку на уровне проекта (Project level), чтобы конфиги не конфликтовали с другими задачами.
Шаг 3: Проверка структуры. Убедитесь, что в корне появилась папка .claude (или .aagent), содержащая папки agents, commands и hooks.
Результат: Ваш AI-агент «прокачан» специфическими ролями и готов к структурированной работе.
3. Фаза итеративного планирования и исследования
Контекст: В отличие от других систем, GSD не заставляет вас отвечать на 100 вопросов сразу. Он проводит сессию интервью, фокусируясь на MVP (Version 1). Важная фишка — Research Synthesizer. Система запускает несколько фоновых агентов для изучения технологий, а затем отдельный агент (на базе Claude 3.5 Sonnet для экономии) объединяет их отчеты.
Выгода: Вы получаете актуальный технологический стек и список потенциальных проблем еще до написания первой строки кода.
Как применить:
Шаг 1: Запуск проекта. Используйте команду инициализации:
/new-project
Шаг 2: Интервью. Ответьте на вопросы о целевой аудитории и ключевых фичах. GSD создаст файл project.md в папке .planning.
Шаг 3: Улучшение поиска. Для более точных результатов подключите MCP (Model Context Protocol), например, Context7, чтобы агент искал по актуальной документации, а не просто в Google по ключу "2025".
Результат: Готовый roadmap проекта и файл research.md с уровнем доверия (confidence level) к каждой технологии.
4. Адверсальное планирование и параллельное исполнение
Контекст: GSD использует уникальный метод «состязательного планирования». Один агент создает план, а другой (Verifier) ищет в нем слабые места и отправляет на доработку. Когда план утвержден, он разбивается на «волны» (waves). Независимые задачи выполняются параллельно суб-агентами, что кратно ускоряет сборку.
Выгода: Высокое качество кода и логики без вашего ручного вмешательства в проверку каждого шага.
Как применить:
Шаг 1: Обсуждение фазы. Выберите опцию Proceed with discussions, чтобы уточнить детали конкретного этапа.
Шаг 2: Верификация плана. Наблюдайте в логах, как агент-верификатор проверяет план на реализуемость.
Шаг 3: Контроль выполнения. GSD автоматически создает и удаляет Playwright-тесты для проверки работоспособности каждого чекпоинта.
Результат: Работающее приложение, где каждая фича прошла автоматизированное тестирование.
5. Борьба с «засорением» контекста (Context Rot)
Контекст: При долгой работе AI-агент начинает «забывать» начало разговора или путаться в деталях. GSD решает это через Sub-agent Spawning. Основной агент остается чистым, делегируя грязную работу (написание кода, тесты) суб-процессам. Вся важная информация сохраняется в сжатых файлах context.md и plan.md.
Выгода: Стабильная работа даже на огромных проектах. Даже если вы очистите историю чата, агент мгновенно восстановит контекст из файлов в папке .planning.
Как применить:
Шаг 1: Мониторинг токенов. Следите за потреблением (в примере итерация заняла ~138k токенов).
Шаг 2: Компактизация. Если контекст переполнен (>200k), GSD предложит сжать данные, опираясь на созданную документацию фаз.
Шаг 3: Использование XML. Не меняйте формат промптов в папке agents — XML-структура критически важна для удержания фокуса модели.
Результат: Агент не «глючит» на поздних стадиях разработки, сохраняя точность выполнения задач.
FAQ
В: Можно ли использовать GSD с Cursor или только с Claude Code? О: GSD — это набор промптов и инструкций в формате XML. Его можно адаптировать под любого агента, поддерживающего кастомные инструкции и работу с файловой системой, но лучше всего он оптимизирован под модели Claude через Claude Code или терминальные интерфейсы.
В: Чем GSD лучше обычного промпта "напиши мне приложение"? О: Обычный промпт ведет к хаосу в больших проектах. GSD внедряет многоэтапную проверку: исследование рынка/технологий, состязательное планирование (один агент проверяет другого) и автоматическое тестирование через Playwright.
В: Нужно ли мне самому писать тесты в GSD? О: Нет, фреймворк сам генерирует тестовые скрипты на базе Playwright для проверки выполненных этапов («волн»), запускает их и удаляет после проверки, чтобы не мусорить в проекте.
В: Что делать, если требования изменились в середине разработки? О: В этом сила GSD. Поскольку планирование идет по фазам (Just-in-time planning), вы можете скорректировать следующую фазу в файле context.md или в процессе обсуждения, и система адаптирует план без поломки всей архитектуры.
В: Сколько это стоит в токенах? О: Одна полная итерация сложной фазы занимает около 130-150 тысяч токенов. При лимитах современных моделей (1M+ у Claude) это позволяет работать очень долго без потери качества.
Конспект создан на основе видео «AI Coding Frameworks: Which One is Best?» канала World of AI. Все права на оригинальный материал принадлежат авторам.Источник: https://youtu.be/uEit1oOJK0w