01Зачем это нужно
Вайбкодинг сломан. Описываешь что хочешь → ИИ генерит код → получаешь нестабильный мусор, который рассыпается на масштабе. GSD решает эту проблему — это слой контекстной инженерии, который делает Claude Code надёжным.
Другие системы спецификационной разработки (BMAD, SpecKit, OpenSpec, Taskmaster…) навязывают церемонии: спринты, сторипойнты, стейкхолдер-синки, ретроспективы. GSD — наоборот: вся сложность спрятана в системе, а не в твоём воркфлоу. Несколько команд, которые просто работают.
Базовые принципы
Контекстная инженерия
Claude получает всё, что нужно для работы: видение, требования, исследования, историю решений. Качество не деградирует.
Мульти-агентная оркестрация
Параллельные исследователи, планировщики с проверкой, исполнители со свежим контекстом на 200k токенов каждый.
Встроенные гейты качества
Детекция дрифта схемы, security-enforcement, предотвращение тихого сокращения скоупа планировщиком.
Атомарные коммиты
Каждая задача — отдельный коммит. Git bisect находит проблему. Каждый коммит откатывается независимо.
Возвращаешься после ToS-изменений Anthropic?
Запусти /gsd-map-codebase для сканирования текущего состояния кода, затем /gsd-new-project для инициализации свежей структуры планирования. Код в порядке — GSD просто пересобирает контекст планирования.
02Что нового в v1.37–v1.38
Главные обновления последних версий — два новых режима для эксперимента, минимальная установка для локальных моделей и ужесточение лимитов на размер агентов.
Spike — экспериментирование
Команда /gsd-spike запускает 2-5 фокусных экспериментов с вердиктами Given/When/Then. Артефакты в .planning/, упаковка результатов в project-локальные скиллы через /gsd-spike-wrap-up.
Sketch — мокапы UI
Команда /gsd-sketch создаёт 2-3 интерактивных HTML-варианта на каждый дизайн-вопрос. Без инициализации проекта. Упаковка в скиллы через /gsd-sketch-wrap-up.
Минимальная установка
Флаг --minimal ставит только 6 ключевых скиллов вместо 86 и 0 субагентов вместо 33. Снижение токенов на 94% — критично для локальных моделей и платных API.
Лимиты размера агентов
Tiered line-count limits (XL: 1600, Large: 1000, Default: 500). Промпты агентов держатся под контролем. Нарушения всплывают в CI.
Ingest docs
/gsd-ingest-docs сканирует репозиторий с разбросанными ADR, PRD, SPEC и DOC файлами и бутстрапит/мерджит полную .planning/ структуру за один проход.
Shared boilerplate
Логика обязательного начального чтения и discovery скиллов вынесена в reference-файлы. Дюжина агентов стала легче.
03Установка
Одна команда. Работает на Mac, Windows и Linux. Нужен Node.js 22+ (npx).
Самый простой способ
Можно просто скинуть Claude Code ссылку на GitHub-репозиторий:
> Установи GSD из https://github.com/gsd-build/get-shit-done Claude Code сам прочитает репозиторий, разберётся в структуре и выполнит установку. Работает и для обновления — просто попроси «обнови GSD» со ссылкой.
Шаг 1 — Запуск установщика
$ npx get-shit-done-cc@latest Установщик интерактивно спросит два вопроса:
1. Рантайм
Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Qwen Code, CodeBuddy, Cline — или несколько сразу (мульти-выбор).
2. Расположение
Global — для всех проектов (~/.claude/). Local — только текущий проект (./.claude/).
Шаг 2 — Проверка
# Claude Code / Gemini / Copilot / Antigravity / Qwen Code > /gsd-help # OpenCode / Kilo / Augment / Trae / CodeBuddy > /gsd-help # Codex > $gsd-help # Cline — проверь наличие файла .clinerules Claude Code 2.1.88+, Qwen Code и Codex устанавливаются как skills (skills/gsd-*/SKILL.md). Более старые версии Claude Code используют commands/gsd/. Cline — через .clinerules. Установщик разбирается автоматически.
Шаг 3 — Режим без разрешений (рекомендуется)
GSD задуман для работы без пауз. Останавливаться ради подтверждения date и git commit 50 раз убивает весь смысл:
$ claude --dangerously-skip-permissions Неинтерактивная установка (Docker, CI, скрипты)
# Claude Code $ npx get-shit-done-cc --claude --global # → ~/.claude/ $ npx get-shit-done-cc --claude --local # → ./.claude/ # Codex $ npx get-shit-done-cc --codex --global # → ~/.codex/ # Cursor / Windsurf $ npx get-shit-done-cc --cursor --global # → ~/.cursor/ $ npx get-shit-done-cc --windsurf --global # → ~/.codeium/windsurf/ # Cline (rules-based) $ npx get-shit-done-cc --cline --global # → ~/.cline/ # Все 14 рантаймов сразу $ npx get-shit-done-cc --all --global # Минимальная установка (94% экономия токенов) $ npx get-shit-done-cc --claude --global --minimal Полный список флагов: --claude, --opencode, --gemini, --kilo, --codex, --copilot, --cursor, --windsurf, --antigravity, --augment, --trae, --qwen, --codebuddy, --cline, --all.
Обновление
$ npx get-shit-done-cc@latest Удаление
$ npx get-shit-done-cc --claude --global --uninstall Docker / контейнеры
$ CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-cc --global 04Полный цикл работы
Шесть этапов. Каждая фаза получает твой ввод, исследование, чистое выполнение и верификацию. Контекст всегда свежий.
Инициализация
Система спрашивает, пока полностью не поймёт идею. Затем параллельные агенты исследуют домен. Извлекаются требования v1/v2, строится дорожная карта.
Обсуждение фазы
Дорожная карта — пара предложений на фазу. Этот шаг фиксирует предпочтения: лейаут, взаимодействия, формат API, обработка ошибок. Флаг --batch группирует вопросы, --chain автоматически переходит в plan+execute.
Планирование
4 параллельных исследователя (стек, фичи, архитектура, подводные камни). Плановщик создаёт 2-3 атомарных XML-плана. Чекер верифицирует против требований, цикл до прохождения.
Выполнение
Планы группируются в волны по зависимостям. Внутри волны — параллельно. Каждый исполнитель — свежие 200k токенов. Каждая задача — атомарный git-коммит.
Верификация
Автотесты прошли — но работает ли фича как ожидалось? Система ведёт тебя по тестируемым результатам. Сбои → debug-агенты → готовые планы фиксов.
Отгрузка и повтор
Создание PR из проверенной работы. Цикл discuss → plan → execute → verify → ship для каждой фазы. Маилстоун завершён → архивация, тег, следующая версия.
Или просто: /gsd-next на каждом шаге
05Волновое выполнение
Планы группируются в волны. Независимые — параллельно. Зависимые — ждут. Файловые конфликты — последовательно.
«Вертикальные слайсы» (Plan 01: User фича end-to-end) параллелятся лучше, чем «горизонтальные слои» (Plan 01: все модели, Plan 02: все API).
XML-формат планов
<task type="auto">
<name>Create login endpoint</name>
<files>src/app/api/auth/login/route.ts</files>
<action>
Use jose for JWT (not jsonwebtoken - CommonJS issues).
Validate credentials against users table.
Return httpOnly cookie on success.
</action>
<verify>curl -X POST localhost:3000/api/auth/login → 200 + Set-Cookie</verify>
<done>Valid credentials return cookie, invalid return 401</done>
</task> 06Spike & Sketch — режимы эксперимента
Новые в v1.37 команды для проверки гипотез до того, как уйдёшь в полное планирование. Не требуют инициализации проекта — можно запустить в любой директории.
/gsd-spike [идея]
Запускает 2-5 фокусных экспериментов с Given/When/Then вердиктами. Например, проверить: «работает ли библиотека X с нашим стеком?», «выдержит ли API нагрузку?», «можно ли подключить две системы через webhook?»
Артефакты сохраняются в .planning/spikes/. После — /gsd-spike-wrap-up упаковывает находки в project-локальный скилл, который попадёт в будущие билды.
/gsd-sketch [идея]
Генерит 2-3 интерактивных HTML-варианта на каждый дизайн-вопрос. Не дизайн-документация — настоящие кликабельные мокапы, которые можно показать заказчику или прокликать самому.
Артефакты в .planning/sketches/. /gsd-sketch-wrap-up упаковывает выбранный дизайн в скилл для использования при реальной реализации.
Флаг --quick работает с обеими командами — быстрый режим без избыточной структуры.
# Spike: проверить три способа авторизации $ /gsd-spike "OAuth vs JWT vs session-based — что лучше для нашего случая?"
# Sketch: три варианта дашборда $ /gsd-sketch "Дашборд аналитики с графиками выручки и таблицей сделок"
# Упаковать находки в скилл проекта $ /gsd-spike-wrap-up 07Все команды
// ОСНОВНОЙ ВОРКФЛОУ
| Команда | Что делает |
|---|---|
| /gsd-new-project | Полная инициализация: вопросы → исследование → требования → дорожная карта |
| /gsd-discuss-phase [N] | Фиксация решений перед планированием. --analyze, --chain, --batch |
| /gsd-plan-phase [N] | Исследование + план + проверка для фазы. --reviews подгружает ревью кодовой базы |
| /gsd-execute-phase <N> | Выполнение планов параллельными волнами |
| /gsd-verify-work [N] | Ручное приёмочное тестирование с автодиагностикой |
| /gsd-ship [N] | Создание PR из проверенной работы (--draft — черновик) |
| /gsd-next | Автоопределение и запуск следующего шага |
| /gsd-fast <текст> | Мгновенные тривиальные задачи без планирования |
| /gsd-quick | Разовая задача с гарантиями GSD. Флаги: --discuss --research --validate --full |
// SPIKE & SKETCH (новое в v1.37)
| /gsd-spike [идея] | Одноразовые эксперименты для валидации до планирования. --quick для быстрого режима |
| /gsd-sketch [идея] | Одноразовые HTML-мокапы с мульти-вариантным исследованием |
| /gsd-spike-wrap-up | Упаковка результатов spike в project-локальный скилл |
| /gsd-sketch-wrap-up | Упаковка выбранного дизайна sketch в скилл |
// МАИЛСТОУНЫ
| /gsd-audit-milestone | Проверка достижения цели маилстоуна |
| /gsd-complete-milestone | Архивация, тег релиза |
| /gsd-new-milestone [name] | Старт следующей версии |
| /gsd-milestone-summary [version] | Сводка маилстоуна для онбординга команды |
| /gsd-forensics [desc] | Пост-мортем неудачных запусков |
// УПРАВЛЕНИЕ ФАЗАМИ И BROWNFIELD
| /gsd-add-phase | Добавить фазу в дорожную карту |
| /gsd-insert-phase [N] | Вставить срочную работу между фазами |
| /gsd-remove-phase [N] | Удалить будущую фазу |
| /gsd-list-phase-assumptions [N] | Предполагаемый подход Claude до планирования |
| /gsd-plan-milestone-gaps | Создать фазы для закрытия пробелов из аудита |
| /gsd-map-codebase [area] | Анализ существующей кодовой базы (brownfield) |
| /gsd-ingest-docs [dir] ★ v1.37 | Сканирует репо со смешанными ADRs/PRDs/SPECs/DOCs и бутстрапит .planning/ за один проход |
// ВОРКСТРИМЫ И ВОРКСПЕЙСЫ
| /gsd-workstreams list/create/switch/complete | Namespaced воркстримы для параллельной работы в маилстоуне |
| /gsd-new-workspace | Изолированный воркспейс с копиями репо (worktrees или клоны) |
| /gsd-list-workspaces | Все GSD-воркспейсы и их статус |
| /gsd-remove-workspace | Удалить воркспейс и зачистить worktrees |
// СЕССИИ И НАВИГАЦИЯ
| /gsd-progress | Где я? Что дальше? |
| /gsd-manager | Интерактивный командный центр для управления фазами |
| /gsd-pause-work | Хендофф при остановке (HANDOFF.json) |
| /gsd-resume-work | Восстановление из последней сессии |
| /gsd-session-report | Сводка сессии с выполненной работой |
| /gsd-debug [desc] | Систематический дебаг с персистентным состоянием |
| /gsd-help | Все команды и гайд по использованию |
| /gsd-update | Обновление GSD с превью чейнджлога |
// БЭКЛОГ, СИДЫ, ТРЕДЫ
| /gsd-plant-seed <idea> | Захват идеи с триггером — всплывёт в нужный маилстоун |
| /gsd-add-backlog <desc> | Парковочный лот бэклога (нумерация 999.x) |
| /gsd-review-backlog | Промоутинг или удаление элементов |
| /gsd-thread [name] | Кросс-сессионные контекстные треды |
| /gsd-add-todo / /gsd-check-todos / /gsd-note | Захват идей и заметок |
// КАЧЕСТВО, БЕЗОПАСНОСТЬ И UI
| /gsd-review | Кросс-ИИ пир-ревью (Cursor, Qwen Code + настройка моделей) |
| /gsd-secure-phase [N] | Security-enforcement с привязкой к модели угроз |
| /gsd-ui-phase [N] | UI дизайн-контракт (UI-SPEC.md) до планирования |
| /gsd-ui-review [N] | Ретроспективный 6-столпный визуальный аудит |
| /gsd-docs-update | Генерация документации с writer + verifier |
| /gsd-pr-branch | Чистая PR-ветка с фильтрацией .planning/ коммитов |
| /gsd-audit-uat | Аудит UAT-долга — фазы без верификации |
// УТИЛИТЫ
| /gsd-settings | Конфигурация профиля моделей и воркфлоу-агентов |
| /gsd-set-profile <profile> | Переключить профиль (quality/balanced/budget/inherit) |
| /gsd-do <text> | Автомаршрутизация freeform текста в нужную команду |
| /gsd-health [--repair] | Валидация целостности .planning/ |
| /gsd-stats | Статистика проекта — фазы, планы, требования, git |
| /gsd-profile-user | Профиль разработчика для персонализированных ответов |
08Конфигурация
Настройки в .planning/config.json. Меняются через /gsd-settings.
Профили моделей
Баланс качества и расхода токенов. Переключение: /gsd-set-profile budget
Профиль inherit — для не-Anthropic провайдеров (OpenRouter, локальные модели) или следования текущей модели рантайма.
Основные параметры
09Минимальная установка
Главная новинка v1.38: флаг --minimal (синоним --core-only) для локальных LLM с маленьким контекстом или платных API, где каждый токен на счету.
Проблема
GSD ставит 86 скиллов и 33 субагента. Каждый рантайм (Claude Code, OpenCode и т.д.) перечисляет описания скиллов и субагентов в системный промпт на каждом ходу — это около ~12k токенов накладных расходов до того, как ты что-то ввёл. Frontier-модели с большим контекстом (Sonnet 4.6, Opus 4.7 — от 200K до 1M контекста) этого не замечают. Локальные LLM с 32K-128K и любые модели с оплатой за токен — почувствуют сильно.
Решение
$ npx get-shit-done-cc --claude --global --minimal | Поверхность | Полная установка | --minimal |
|---|---|---|
| Скиллы | 86 (new-project, discuss-phase, plan-phase, execute-phase…+82) | 6 (new-project, discuss-phase, plan-phase, execute-phase, help, update) |
| Субагенты | 33 gsd-* агента | 0 |
| Cold-start overhead | ~12k токенов | ~700 токенов (≥94% сокращение) |
| Manifest mode | "full" | "minimal" |
Когда использовать --minimal
- Локальная модель с 32K-128K контекстом (Qwen3, Llama, Mistral)
- Token-metered API, где важен каждый ход
- Throwaway директория или не-GSD проект, где нужен только
/gsd-new-project - CI-раннеры или эфемерные контейнеры, где футпринт установки имеет значение
Когда НЕ использовать
- Активный GSD-проект, где регулярно нужен широкий набор команд (autonomous, ship, code-review, debug)
- Frontier-модели с 200K-1M контекстом — экономия в пределах шума
⚠️ Важно
Экономия исчезает в момент, когда ты обновляешься без флага --minimal. Чтобы остаться в минимальном режиме — всегда передавай флаг при обновлении: npx get-shit-done-cc@latest --claude --global --minimal
10Безопасность
GSD генерит markdown-файлы, которые становятся системными промптами для LLM. Любой пользовательский текст — потенциальный вектор prompt injection. Встроенная защита с v1.27:
Path traversal
Все пользовательские пути валидируются — выход за директорию проекта невозможен.
Prompt injection
Модуль security.cjs сканирует текст на паттерны инъекций до попадания в артефакты планирования.
Runtime хуки
gsd-prompt-guard сканирует записи в .planning/ на инъекции в реальном времени.
CI injection scanner
prompt-injection-scan.test.cjs сканирует все файлы агентов, воркфлоу и команд.
Safe JSON parsing
Малформед --fields аргументы ловятся до того, как повредят state.
Защита секретов
Добавь .env, *.pem, *.key в deny-лист .claude/settings.json.
Deny-лист для секретов
{
"permissions": {
"deny": [
"Read(.env)", "Read(.env.*)",
"Read(**/secrets/*)", "Read(**/*credential*)",
"Read(**/*.pem)", "Read(**/*.key)"
]
}
} 11Глоссарий
Все термины простым языком.
// ОСНОВНЫЕ ПОНЯТИЯ
// АРХИТЕКТУРА GSD
/gsd-spike./gsd-sketch.agent_skills в конфиге. GSD-агенты автоматически их находят.// ИНСТРУМЕНТЫ И РАНТАЙМЫ
npx get-shit-done-cc@latest — скачивает и запускает установщик.// БЕЗОПАСНОСТЬ И КАЧЕСТВО
../../etc/passwd).gsd-prompt-guard проверяет каждую запись в .planning/./gsd-map-codebase анализирует существующий код.12Частые вопросы
npm install -g @anthropic-ai/claude-code. Нужен Node.js 22+. После запускается командой claude. Также есть расширения для VS Code и JetBrains.budget или флаг --minimal.npx get-shit-done-cc@latest.