GSD (Get Shit Done) — это система контекст-инжиниринга и spec-driven разработки для Claude Code. Она решает главную проблему AI-кодинга: context rot — деградацию качества кода по мере заполнения контекстного окна Claude.
Проще говоря: Claude Code мощный, но без правильной структуры он теряет контекст, забывает архитектуру проекта и начинает генерировать несогласованный код. GSD даёт Claude всё, что нужно, чтобы работать качественно и последовательно.
Что GSD делает
- Структурирует проект — собирает вашу идею в чёткую спецификацию через AI-диалог
- Планирует фазы — разбивает проект на атомарные задачи, которые Claude может выполнить качественно
- Выполняет автономно — субагенты реализуют задачи, делают коммиты, отслеживают прогресс
- Верифицирует результат — проверяет качество после каждого этапа
- Сохраняет контекст — между сессиями, между фазами, между milestone-ами
Что GSD устанавливает в ваш проект
GSD — это набор markdown-файлов, которые размещаются в папке .claude/ вашего проекта. Никаких бинарников, серверов или сложных зависимостей:
| Компонент | Описание |
|---|---|
commands/gsd/ | Слэш-команды (/gsd:new-project, /gsd:plan-phase и т.д.) |
agents/ | Субагенты: планировщик, исполнитель, верификатор, исследователь |
get-shit-done/ | Ядро системы: шаблоны, конфиги, state management |
hooks | Мониторинг контекстного окна, авто-коммиты |
Что нужно перед установкой
- VS Code (или Cursor) — последняя версия
- Claude Code расширение — установите из VS Code Marketplace (поиск: «Claude Code» от Anthropic)
- Подписка Claude — Pro, Max, Team или Enterprise (Claude Code не работает на бесплатном плане)
- Node.js 18+ — нужен для команды npx
Проверить Node.js: откройте терминал (не чат Claude Code!) и введите:
node --version
Если видите v18.x.x или выше — всё готово.
Терминал — это командная строка внизу VS Code (PowerShell, cmd, bash). Открывается через Ctrl+` или меню Terminal → New Terminal. Все команды установки вводятся ТОЛЬКО в терминале.
Чат Claude Code — это панель сбоку, где вы общаетесь с AI. Команды установки сюда НЕ вводятся — Claude воспримет их как промпт и начнёт что-то делать с вашим проектом.
Установка GSD
Вариант А: Глобальная установка (рекомендуется)
GSD будет доступен во всех ваших проектах. Файлы устанавливаются в пользовательскую папку Claude Code:
npx get-shit-done-cc --claude --global
Вариант Б: Локальная установка (для одного проекта)
npx get-shit-done-cc --claude --local
Пошаговая инструкция
- Откройте VS Code с вашим проектом (или пустую папку для нового)
- Откройте терминал:
Ctrl+backtick - Убедитесь, что видите путь к проекту, например:
PS C:\Users\user\Desktopmy-project> - Введите команду установки и нажмите Enter:
npx get-shit-done-cc --claude --global - Дождитесь логотипа GSD и списка галочек ✓ — установка завершена
- Перейдите в чат Claude Code и напишите:
/gsd:help
Новый проект с нуля
Если вы начинаете проект с нуля — GSD проведёт вас через весь цикл: от идеи до готового кода.
Шаг 1: Создайте проект
Откройте пустую папку в VS Code. В чате Claude Code напишите:
/gsd:new-project
GSD начнёт задавать вопросы о вашем проекте: цели, стек, ограничения, edge cases. Процесс завершится созданием файла PROJECT.md — полной спецификации вашего проекта.
Шаг 2: Спланируйте фазу
/gsd:plan-phase 1
Система создаст атомарные планы задач. Каждый план содержит конкретные файлы, действия и критерии готовности.
Шаг 3: Выполните план
/gsd:execute-plan
Субагент-исполнитель начнёт реализовывать задачи автономно: писать код, создавать файлы, делать коммиты.
Шаг 4: Повторяйте для каждой фазы
Когда фаза завершена — планируйте следующую (/gsd:plan-phase 2) и выполняйте. Цикл: plan → execute → plan → execute.
Существующий проект
Шаг 1: Картографируйте кодовую базу
/gsd:map-codebase
GSD запустит параллельных агентов, которые проанализируют ваш стек, архитектуру, конвенции кода и текущее состояние проекта.
Шаг 2: Начните новый milestone
/gsd:new-milestone
Опишите, что вы хотите построить дальше. Система исследует домен, вы уточните требования, и GSD создаст свежий роадмап.
Быстрые задачи (без полного планирования)
Для мелких задач — багфиксы, небольшие фичи, конфиг — не нужен полный цикл планирования:
/gsd:quick
GSD спросит, что нужно сделать. Описываете задачу (например: «Добавь тёмную тему в настройки»), и он выполнит с гарантиями качества — атомарные коммиты, отслеживание состояния.
| Флаг | Что делает |
|---|---|
--research | Исследует подходы перед планированием |
--discuss | GSD задаст уточняющие вопросы перед выполнением |
--full | Проверка плана + пост-верификация результата |
Все команды GSD
Все команды вводятся в чат Claude Code (не в терминал). Это слэш-команды, которые Claude Code распознаёт автоматически.
Основные
| Команда | Описание |
|---|---|
/gsd:new-project | Создать новый проект с нуля |
/gsd:new-milestone | Начать новый этап в существующем проекте |
/gsd:plan-phase N | Спланировать фазу номер N |
/gsd:execute-plan | Выполнить текущий план |
/gsd:quick | Быстрая задача без планирования |
Анализ и исследование
| Команда | Описание |
|---|---|
/gsd:map-codebase | Проанализировать существующий код |
/gsd:discuss-phase N | Обсудить фазу перед планированием |
Управление
| Команда | Описание |
|---|---|
/gsd:help | Показать все доступные команды |
/gsd:settings | Настройки GSD |
/gsd:health | Проверить состояние системы |
/gsd:health --repair | Автоисправление проблем |
Структура проекта с GSD
ваш-проект/ ├── .claude/ │ ├── agents/ ← субагенты GSD + ваши │ ├── commands/gsd/ ← слэш-команды │ ├── get-shit-done/ ← ядро системы │ └── settings.json ← hooks и разрешения ├── .planning/ ← планы, roadmap │ ├── ROADMAP.md │ ├── REQUIREMENTS.md │ └── STATE.md ├── PROJECT.md ← спецификация ├── CLAUDE.md ← ваш конфиг └── src/ ← ваш код
Два уровня конфигурации
Claude Code читает конфигурацию с двух уровней и объединяет их:
| Уровень | Путь | Описание |
|---|---|---|
| Глобальный | ~/.claude/ | Доступен во ВСЕХ проектах. Сюда ставится GSD при --global |
| Локальный | ./.claude/ | Только текущий проект. Ваши кастомные субагенты, rules, skills |
Если одинаковый файл есть и глобально, и локально — локальный имеет приоритет. Проекты друг с другом НЕ конфликтуют — у каждого своя изолированная папка .claude/.
Настройка автоматизации
GSD спроектирован для автономной работы. GSD при установке добавляет базовые разрешения в .claude/settings.json. Они позволяют Claude автоматически выполнять безопасные операции (чтение, git-коммиты, создание папок) без подтверждения.
- Ask before edits (по умолчанию) — Claude покажет diff перед изменением, вы решаете — принять или нет.
- Auto-accept edits — для полной автоматизации, но будьте готовы проверять результат.
Удаление GSD
Если устанавливали глобально (--global):
npx get-shit-done-cc --claude --global --uninstall
Если устанавливали локально (--local):
npx get-shit-done-cc --claude --local --uninstall
Это удалит все GSD-файлы (команды, агенты, hooks), но сохранит ваши собственные файлы.
Частые вопросы
gsd- (gsd-planner.md, gsd-executor.md). Ваши файлы не затрагиваются..claude/. Изменения в одном не влияют на другие.Ctrl+`), а не в чат. Чат — только для /gsd: команд.