// gsd-pi · evolution GSD-2

01Зачем GSD-2

Оригинальный GSD стал вирусным как промпт-фреймворк для Claude Code. Он работал, но боролся с инструментом — инжектил промпты через slash-команды и надеялся, что LLM их выполнит. Без реального контроля над контекстными окнами, сессиями или выполнением.

GSD-2 — другой. Это standalone CLI на Pi SDK, что даёт прямой TypeScript-доступ к самому agent harness. То есть GSD теперь может реально делать то, что v1 мог только попросить LLM сделать.

02В чём разница с v1

Оригинальный GSD был коллекцией markdown-промптов. Полагался на то, что LLM прочитает их и сделает правильно. GSD-2 — TypeScript-приложение, которое контролирует agent-сессию.

03Структура работы

GSD-2 структурирует работу в иерархию из трёх уровней. Железное правило: таск должен помещаться в одно контекстное окно. Если не помещается — это два таска.

Цикл слайса

Каждый слайс автоматически проходит через фазы:

Plan (с research) → Execute (per-task) → Complete → Reassess Roadmap → Next Slice
                                                                          ↓ (все готовы)
                                                                  Validate Milestone → Done

Plan — изучает кодовую базу, ресерчит документацию, разбивает слайс на таски с must-haves. Execute — каждый таск в свежем контекстном окне с предзагруженными файлами. Запускает verification commands (lint, test) с auto-fix retries. Complete — пишет summary, UAT-скрипт, отмечает roadmap, коммитит. Reassess — проверяет, актуален ли roadmap. Validate Milestone — финальный гейт перед закрытием.

04Установка

Шаг 1 — Установить пакет

$ npm install -g gsd-pi

Нужен Node.js 22+ (рекомендуется 24 LTS). Если Node ставился через Homebrew на Mac — может быть development release вместо LTS, лучше пинить 24 LTS.

Шаг 2 — Логин в LLM-провайдер

$ gsd > /login

Выбираешь из 20+ провайдеров: Anthropic, OpenAI, Google, OpenRouter, GitHub Copilot и других. Если есть подписка Claude Max или GitHub Copilot — OAuth-флоу делает всё сам. Иначе вставляешь API-ключ.

Шаг 3 — Использование

$ cd my-project
$ gsd

Открывает интерактивную agent-сессию. Дальше два пути:

Два терминала, один проект

Реальный воркфлоу: auto mode в одном терминале, рулёжка из другого.

# Терминал 1 — пусть строит $ gsd > /gsd auto # Терминал 2 — рулим параллельно $ gsd > /gsd discuss # обсудить архитектурные решения > /gsd status # проверить прогресс > /gsd queue # поставить в очередь следующий маилстоун

Оба терминала читают и пишут одни .gsd/ файлы на диске. Решения из второго терминала подхватываются автоматически на следующей фазе — без остановки auto-режима.

05Auto Mode — главное

То, что отличает GSD-2 от всего остального. Запустил, ушёл, вернулся к построенному софту.

> /gsd auto

Auto mode — это state machine на основе файлов на диске. Читает .gsd/STATE.md, определяет следующий unit работы, создаёт свежую agent-сессию, инжектит фокусированный промпт со всем нужным контекстом, и даёт LLM выполнить. Когда LLM закончил, auto mode снова читает диск и диспатчит следующий unit.

Что под капотом

06Все команды

// ОСНОВНЫЕ

// ОТЛАДКА И УТИЛИТЫ

// CLI-ТЕРМИНАЛЬНЫЕ

// ГОРЯЧИЕ КЛАВИШИ

07Конфигурация

Preferences GSD живут в ~/.gsd/preferences.md (глобально) или .gsd/preferences.md (проект). Управляются через /gsd prefs.

---
version: 1
models:
  research: claude-sonnet-4-6
  planning:
    model: claude-opus-4-6
    fallbacks:
      - openrouter/z-ai/glm-5
      - openrouter/minimax/minimax-m2.5
  execution: claude-sonnet-4-6
  completion: claude-sonnet-4-6
skill_discovery: suggest
auto_supervisor:
  soft_timeout_minutes: 20
  idle_timeout_minutes: 10
  hard_timeout_minutes: 30
budget_ceiling: 50.00
unique_milestone_ids: true
verification_commands:
  - npm run lint
  - npm run test
auto_report: true
---

Ключевые настройки

Token-оптимизация

Координированная система снижения расхода на 40-60%. Один параметр координирует выбор моделей, пропуск фаз и сжатие контекста:

08Любая модель

GSD-2 не залочен на одного провайдера. Запускается на Pi SDK, поддерживающем 20+ провайдеров из коробки. Используй разные модели на разных фазах — Opus для планирования, Sonnet для выполнения, быструю модель для ресерча.

Встроенные провайдеры

Anthropic, Anthropic (Vertex AI), OpenAI, Google (Gemini), OpenRouter, GitHub Copilot, Amazon Bedrock, Azure OpenAI, Google Vertex, Groq, Cerebras, Mistral, xAI, HuggingFace, Vercel AI Gateway, и другие.

OAuth / Max планы

Если есть подписка Claude Max, Codex или GitHub Copilot — можешь использовать напрямую. Pi справляется с OAuth-флоу. API-ключ не нужен.

OpenRouter

OpenRouter даёт доступ к сотням моделей через один API-ключ. Используй для запуска GSD на Llama, DeepSeek, Qwen или чём угодно ещё.

Per-phase выбор моделей

models:
  research: openrouter/deepseek/deepseek-r1
  planning:
    model: claude-opus-4-6
    fallbacks:
      - openrouter/z-ai/glm-5
  execution: claude-sonnet-4-6
  completion: claude-sonnet-4-6

Используй дорогие модели где важно качество (планирование), и дешёвые/быстрые где важна скорость (ресерч). Каждая фаза принимает строку модели или объект с model и fallbacks — если основная модель упала, GSD пробует следующую.

09Headless mode — CI и скрипты

gsd headless запускает любую /gsd команду без TUI. Создан для CI-пайплайнов, cron-джобов, скриптовой автоматизации.

# Auto mode в CI $ gsd headless --timeout 600000 # Создать и выполнить маилстоун end-to-end $ gsd headless new-milestone --context spec.md --auto # По одному unit за раз (cron-friendly) $ gsd headless next

# Мгновенный JSON-снэпшот (без LLM, ~50ms) $ gsd headless query

# Заставить выполнить конкретную фазу пайплайна $ gsd headless dispatch plan

Headless авто-отвечает на интерактивные промпты, детектит завершение, выходит со структурированными кодами: 0 — complete, 1 — error/timeout, 2 — blocked. Авто-рестарт на крэшах с exponential backoff.

Web-интерфейс. Запусти gsd --web — получишь полное управление проектом из браузера через server-sent events. Real-time прогресс и multi-project поддержка.

10Миграция с v1

Если есть проекты с .planning директориями от оригинального Get Shit Done — можно мигрировать в формат GSD-2 .gsd:

# Из директории проекта > /gsd migrate # Или указать путь > /gsd migrate ~/projects/my-old-project

Миграционный тул:

• Парсит старые PROJECT.md, ROADMAP.md, REQUIREMENTS.md, директории фаз, планы, summaries и research
• Маппит phases → slices, plans → tasks, milestones → milestones
• Сохраняет состояние (готовые фазы остаются готовыми, summaries переносятся)
• Консолидирует research-файлы в новую структуру
• Показывает превью перед записью
• Опционально запускает agent-driven ревью результата

Поддерживает варианты форматов: milestone-секционированные roadmaps с <details>, bold phase entries, bullet-format requirements, decimal phase numbering.

Обратная миграция (GSD-2 → v1) — через команду /gsd-from-gsd2 в оригинальном GSD.

11Глоссарий GSD-2