01Зачем это нужно
Вайбкодинг сломан. Описываешь что хочешь → ИИ генерит код → получаешь нестабильный мусор, который рассыпается на масштабе. GSD решает эту проблему — это слой контекстной инженерии, который делает Claude Code надёжным.
Другие системы спецификационной разработки (BMAD, SpecKit…) навязывают церемонии: спринты, сторипойнты, стейкхолдер-синки, ретроспективы. GSD — наоборот: вся сложность спрятана в системе, а не в твоём воркфлоу. Несколько команд, которые просто работают.
Контекстная инженерия
Claude получает всё, что нужно для работы: видение, требования, исследования, историю решений. Качество не деградирует.
Мульти-агентная оркестрация
Параллельные исследователи, планировщики с проверкой, исполнители со свежим контекстом на 200k токенов каждый.
Встроенные гейты качества
Детекция дрифта схемы, security-enforcement, предотвращение тихого сокращения скоупа планировщиком.
Атомарные коммиты
Каждая задача — отдельный коммит. Git bisect находит проблему. Каждый коммит откатывается независимо.
02Установка
Одна команда. Работает на Mac, Windows и Linux. Нужен только Node.js (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, Codex, Copilot, Cursor, Windsurf, Antigravity — или несколько сразу (мульти-выбор).
2. Расположение
Global — для всех проектов (~/.claude/). Local — только текущий проект (./.claude/).
Шаг 2 — Проверка
После установки перезапусти рантайм и проверь:
# Claude Code / Gemini / Copilot / Antigravity > /gsd:help # OpenCode > /gsd-help # Codex > $gsd-help Шаг 3 — Режим без разрешений (рекомендуется)
GSD задуман для работы без пауз. Останавливаться ради подтверждения date и git commit 50 раз убивает весь смысл:
$ claude --dangerously-skip-permissions Если предпочитаешь гранулярные разрешения — добавь в .claude/settings.json:
{
"permissions": {
"allow": [
"Bash(date:*)", "Bash(echo:*)", "Bash(cat:*)", "Bash(ls:*)",
"Bash(mkdir:*)", "Bash(wc:*)", "Bash(head:*)", "Bash(tail:*)",
"Bash(sort:*)", "Bash(grep:*)", "Bash(tr:*)",
"Bash(git add:*)", "Bash(git commit:*)", "Bash(git status:*)",
"Bash(git log:*)", "Bash(git diff:*)", "Bash(git tag:*)"
]
}
} Неинтерактивная установка (Docker, CI, скрипты)
Флаги рантайма и расположения пропускают интерактивные вопросы:
# Claude Code $ npx get-shit-done-cc --claude --global # → ~/.claude/ $ npx get-shit-done-cc --claude --local # → ./.claude/ # OpenCode $ npx get-shit-done-cc --opencode --global # → ~/.config/opencode/ # Gemini CLI $ npx get-shit-done-cc --gemini --global # → ~/.gemini/ # Codex $ npx get-shit-done-cc --codex --global # → ~/.codex/ # Copilot $ npx get-shit-done-cc --copilot --global # → ~/.github/ # Cursor $ npx get-shit-done-cc --cursor --global # → ~/.cursor/ # Windsurf $ npx get-shit-done-cc --windsurf --global # → ~/.windsurf/ # Antigravity $ npx get-shit-done-cc --antigravity --global # → ~/.gemini/antigravity/ # Все рантаймы сразу $ npx get-shit-done-cc --all --global Обновление
GSD развивается быстро. Обновляй периодически той же командой:
$ npx get-shit-done-cc@latest Установка из исходников (для контрибьюторов)
$ git clone https://github.com/gsd-build/get-shit-done.git
$ cd get-shit-done
$ node bin/install.js --claude --local Удаление
# Глобально $ npx get-shit-done-cc --claude --global --uninstall # Локально $ npx get-shit-done-cc --claude --local --uninstall # Другие рантаймы — аналогично, например: $ npx get-shit-done-cc --codex --global --uninstall Удаляются все команды, агенты, хуки и настройки GSD. Остальная конфигурация сохраняется.
Docker / контейнеры
Если чтение файлов падает с тильдой (~/.claude/...), задай абсолютный путь:
$ CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-cc --global 03Полный цикл работы
Шесть этапов. Каждая фаза получает твой ввод, исследование, чистое выполнение и верификацию. Контекст всегда свежий.
Инициализация
Система спрашивает, пока полностью не поймёт идею — цели, ограничения, тех. предпочтения, крайние случаи. Затем параллельные агенты исследуют домен. Извлекаются требования v1/v2, строится дорожная карта.
Обсуждение фазы
Дорожная карта — пара предложений на фазу. Мало для реализации как ты видишь. Этот шаг фиксирует предпочтения: лейаут, взаимодействия, формат API, обработка ошибок. Чем глубже — тем точнее результат.
Планирование
4 параллельных исследователя (стек, фичи, архитектура, подводные камни). Плановщик создаёт 2-3 атомарных XML-плана. Чекер верифицирует против требований, цикл до прохождения.
Выполнение
Планы группируются в волны по зависимостям. Внутри волны — параллельно. Каждый исполнитель — свежие 200k токенов. Каждая задача — атомарный git-коммит. Верификация против целей фазы.
Верификация
Автотесты прошли — но работает ли фича как ожидалось? Система ведёт тебя по тестируемым результатам. Сбои → debug-агенты → готовые планы фиксов.
Отгрузка и повтор
Создание PR из проверенной работы. Цикл discuss → plan → execute → verify → ship для каждой фазы. Маилстоун завершён → архивация, тег, следующая версия.
Или просто: /gsd:next на каждом шаге
04Волновое выполнение
Планы группируются в волны. Независимые — параллельно. Зависимые — ждут. Файловые конфликты — последовательно.
«Вертикальные слайсы» (Plan 01: User фича end-to-end) параллелятся лучше, чем «горизонтальные слои» (Plan 01: все модели, Plan 02: все API).
05Контекстная инженерия
Claude Code невероятно мощный, если дать ему нужный контекст. Большинство не дают. GSD делает это за тебя.
| Файл | Назначение |
|---|---|
| PROJECT.md | Видение проекта — загружается всегда |
| research/ | Знания экосистемы: стек, фичи, архитектура, подводные камни |
| REQUIREMENTS.md | Скоупированные требования v1/v2 с привязкой к фазам |
| ROADMAP.md | Куда идём, что сделано |
| STATE.md | Решения, блокеры — память между сессиями |
| CONTEXT.md | Твои предпочтения по реализации фазы |
| PLAN.md | Атомарная задача в XML со встроенной верификацией |
| SUMMARY.md | Что случилось, что изменилось |
| threads/ | Персистентные контекстные треды для кросс-сессионной работы |
| seeds/ | Идеи на будущее, всплывают в нужный маилстоун |
XML-формат планов
<task type="auto">
<n>Create login endpoint</n>
<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> 06Все команды
// ОСНОВНОЙ ВОРКФЛОУ
| Команда | Что делает |
|---|---|
| /gsd:new-project | Полная инициализация: вопросы → исследование → требования → дорожная карта |
| /gsd:discuss-phase [N] | Фиксация решений перед планированием. --chain автоматически переходит в plan+execute |
| /gsd:plan-phase [N] | Исследование + план + проверка для фазы |
| /gsd:execute-phase <N> | Выполнение планов параллельными волнами |
| /gsd:verify-work [N] | Ручное приёмочное тестирование с автодиагностикой |
| /gsd:ship [N] | Создание PR из проверенной работы |
| /gsd:next | Автоопределение и запуск следующего шага |
| /gsd:fast <текст> | Мгновенные тривиальные задачи без планирования |
| /gsd:quick | Разовая задача с гарантиями GSD. Флаги: --discuss --research --validate --full |
// МАИЛСТОУНЫ
| Команда | Что делает |
|---|---|
| /gsd:audit-milestone | Проверка достижения цели маилстоуна |
| /gsd:complete-milestone | Архивация, тег релиза |
| /gsd:new-milestone | Старт следующей версии |
// УПРАВЛЕНИЕ ФАЗАМИ
| Команда | Что делает |
|---|---|
| /gsd:add-phase | Добавить фазу в дорожную карту |
| /gsd:insert-phase [N] | Вставить срочную работу между фазами |
| /gsd:remove-phase [N] | Удалить будущую фазу |
| /gsd:map-codebase | Анализ существующей кодовой базы (brownfield) |
// СЕССИИ И НАВИГАЦИЯ
| Команда | Что делает |
|---|---|
| /gsd:progress | Где я? Что дальше? |
| /gsd:pause-work | Хендофф при остановке (HANDOFF.json) |
| /gsd:resume-work | Восстановление из последней сессии |
| /gsd:debug [desc] | Систематический дебаг с персистентным состоянием |
| /gsd:forensics | Пост-мортем неудачных запусков |
// БЭКЛОГ, СИДЫ, ТРЕДЫ
| Команда | Что делает |
|---|---|
| /gsd:plant-seed <idea> | Захват идеи с триггером — всплывёт в нужный маилстоун |
| /gsd:add-backlog <desc> | Парковочный лот бэклога (нумерация 999.x) |
| /gsd:review-backlog | Промоутинг, сохранение или удаление элементов |
| /gsd:thread [name] | Кросс-сессионные контекстные треды |
// КАЧЕСТВО И UI
| Команда | Что делает |
|---|---|
| /gsd:review | Кросс-ИИ пир-ревью |
| /gsd:secure-phase [N] | Security-enforcement с привязкой к модели угроз |
| /gsd:ui-phase [N] | UI дизайн-контракт до планирования |
| /gsd:ui-review [N] | Ретроспективный 6-столпный визуальный аудит |
| /gsd:docs-update | Генерация документации с writer + verifier |
07Конфигурация
Настройки хранятся в .planning/config.json. Меняются через /gsd:settings.
Профили моделей
Баланс качества и расхода токенов. Переключение: /gsd:set-profile budget
Основные параметры
08Быстрый режим
/gsd:fast <текст>
Тривиальные задачи — тайпофикс, конфиг-изменение, мелкий рефакторинг. Без планирования, мгновенное выполнение.
/gsd:quick
Разовые задачи с гарантиями GSD (атомарные коммиты, трекинг). Быстрее полного цикла. Живёт в .planning/quick/.
Комбинируемые флаги
--discuss обсуждение · --research исследование · --validate проверка плана · --full всё сразу
$ /gsd:quick > What do you want to do? "Add dark mode toggle to settings" 09Безопасность
GSD генерит markdown-файлы, которые становятся системными промптами для LLM. Любой пользовательский текст — потенциальный вектор prompt injection. Встроенная защита (v1.27):
Path traversal
Все пользовательские пути валидируются — выход за директорию проекта невозможен.
Prompt injection
Модуль security.cjs сканирует текст на паттерны инъекций до попадания в артефакты планирования.
Runtime хуки
gsd-prompt-guard сканирует записи в .planning/ на инъекции в реальном времени.
Защита секретов
Добавь .env, *.pem, *.key в deny-лист .claude/settings.json — Claude не сможет их прочитать.
Deny-лист для секретов
{
"permissions": {
"deny": [
"Read(.env)", "Read(.env.*)",
"Read(**/secrets/*)", "Read(**/*.pem)", "Read(**/*.key)"
]
}
} 10Глоссарий
Все термины, которые встречаются в документации, простым языком.
// ОСНОВНЫЕ ПОНЯТИЯ
// АРХИТЕКТУРА GSD
// ИНСТРУМЕНТЫ И РАНТАЙМЫ
npx get-shit-done-cc@latest — скачивает и запускает установщик GSD./gsd:ship создаёт PR автоматически из проверенной работы.// ФОРМАТЫ И СТРУКТУРЫ
<task>...</task>. GSD использует XML для структурирования планов — Claude лучше понимает чёткую структуру, чем свободный текст.# Заголовок, **жирный**, - список. Все артефакты GSD (PROJECT.md, PLAN.md и т.д.) — файлы в формате Markdown.{"ключ": "значение"}. Конфигурация GSD (.planning/config.json) и хендоффы хранятся в JSON..planning/.// МОДЕЛИ И ПРОФИЛИ
// БЕЗОПАСНОСТЬ
../../etc/passwd. GSD валидирует все пути — выйти за директорию проекта невозможно.gsd-prompt-guard — хук, который проверяет каждую запись в .planning/ на инъекции..env (переменные окружения с паролями), .pem и .key (сертификаты и ключи).// ПРОЦЕССЫ РАЗРАБОТКИ
/gsd:map-codebase анализирует существующий код, чтобы GSD знал стек, архитектуру и конвенции./gsd:verify-work проводит тебя через UAT пошагово./gsd:review запускает кросс-ИИ ревью — другой агент оценивает написанный код./gsd:pause-work, GSD записывает HANDOFF.json — где остановились, что сделано, что дальше. При следующем запуске /gsd:resume-work подхватывает.// ВАЙБКОДИНГ И ОСТАЛЬНОЕ
mode: yolo — система всё одобряет автоматически, без подтверждений. Противоположность interactive, где каждый шаг требует твоего ОК.workflow.text_mode: true.11Частые вопросы
Ответы на популярные вопросы о Claude Code, GSD и работе с ИИ-кодерами.
npm install -g @anthropic-ai/claude-code. Нужен Node.js 18+. После установки запускается командой claude в терминале. Для VS Code есть расширение Claude Code, для JetBrains (PyCharm, IntelliJ IDEA) — плагин. Также доступен как десктоп-приложение.npm install -g @anthropic-ai/claude-code. Или используй WSL (Windows Subsystem for Linux) — там Claude Code работает нативно. Для VS Code — установи расширение из маркетплейса.budget: /gsd:set-profile budget./gsd:set-profile.npx get-shit-done-cc --claude для Claude Code, npx get-shit-done-cc --cursor для Cursor. Claude Code мощнее для автономных задач, Cursor удобнее для визуальной разработки. Многие используют оба.--claude и --codex. Также поддерживаются Copilot (GitHub), Windsurf (Codeium), Gemini CLI (Google), Antigravity и OpenCode (open-source). GSD работает одинаково на всех рантаймах.~/.claude/skills/. GSD — один из самых популярных скиллов (47k+ звёзд на GitHub). Устанавливает набор команд (/gsd:new-project, /gsd:plan-phase и т.д.), которые структурируют работу Claude Code. Свои скиллы можно добавлять через agent_skills в конфигурации..claude/settings.json.workflow.text_mode: true через /gsd:settings — отключает TUI-менюшки, которые могут не работать по SSH. Для Docker используй переменную CLAUDE_CONFIG_DIR.npx get-shit-done-cc --cursor.budget экономит токены, используя Sonnet и Haiku вместо Opus.none (в текущую ветку), phase (ветка на фазу), milestone (ветка на маилстоун). Настройка: /gsd:settings → git.branching_strategy..env, .pem, .key), сканирование prompt injection, валидация путей. Для чувствительных проектов используй /gsd:secure-phase — security-enforcement с моделью угроз.