GSD Core — фреймворк для управления AI-агентами через контекстную инженерию

GSD Core (Git. Ship. Done.) — это фреймворк контекстной инженерии и spec-driven разработки, который управляет AI-кодинг-агентами через дисциплинированный фазовый цикл. Проект поддерживает Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf и другие среды. Написан на JavaScript/TypeScript, распространяется через npm как @opengsd/gsd-core, лицензия MIT. На момент написания — 2.7k звёзд на GitHub.

Проблема: контекстная деградация

При длительной работе с AI-агентами качество генерации незаметно падает — это называется context rot. Контекстное окно заполняется, модель начинает терять детали, повторяться или отклоняться от задачи. GSD Core решает эту проблему, выполняя всю тяжёлую работу (исследование, планирование, выполнение) в свежих сабагентах с чистым контекстом, оставляя основную сессию минимальной.

Фазовый цикл

Каждый milestone проходит через один и тот же пятиступенчатый цикл, по одной фазе за раз:

1. Discuss — сбор решений по реализации до начала планирования
2. Plan — исследование, декомпозиция и проверка, что план помещается в свежее контекстное окно
3. Execute — запуск планов параллельными волнами; каждый исполнитель начинает с чистым контекстом на 200k токенов
4. Verify — проверка того, что было построено; диагностика и исправление до объявления фазы завершённой
5. Ship — создание PR, архивирование фазы, переход к следующей

Установка

npx @opengsd/gsd-core@latest

Установщик спрашивает вашу среду выполнения (Claude Code, OpenCode, Gemini CLI и т.д.) и тип установки — глобальная или локальная. Установщик обязателен для кросс-рантайм совместимости — не копируйте файлы из agents/ или commands/ вручную.

После установки запустите первый проект:

/gsd-new-project

Ключевые механизмы

Свежие сабагенты. Вся ресурсоёмкая работа запускается в новых сабагентах. Это предотвращает накопление контекстного мусора и сохраняет высокое качество генерации на протяжении всего проекта.

Структурированные артефакты. Файлы STATE.md и CONTEXT.md переживают сессии и передают контекст между запусками. Каждый этап оставляет после себя документацию, которая служит входом для следующего.

Верификация перед завершением. Перед тем как фаза объявляется завершённой, система проходит через построенный код, находит проблемы и генерирует планы исправлений. Это не просто «запустить тесты» — это структурированная проверка качества.

Почему это работает

Большинство AI-кодинг сетапов проваливаются на масштабе по трём причинам:

• Context bloat — контекстное окно переполняется, качество незаметно падает
• Нет общей памяти — между сессиями нет преемственности, агент забывает предыдущие решения
• Нет верификации — никто не проверяет, что код реально работает

GSD Core решает все три проблемы: тяжёлая работа идёт в свежих сабагентах, структурированные артефакты хранят контекст между сессиями, а шаг верификации проверяет результат до объявления готовности.

Документация

Проект содержит подробную документацию нескольких типов:

• Tutorials — пошаговые руководства: Your first project, Onboarding an existing codebase
• How-to guides — рецепты для конкретных задач: установка, планирование фазы, верификация и шиппинг
• Reference — команды, конфигурация, CLI-инструменты
• Explanation — концепции и архитектурные решения: Context engineering, The phase loop

Документация доступна на нескольких языках: английский, японский, корейский, португальский, китайский.

Сообщество и экосистема

У проекта есть Discord для обсуждений и поддержки. Существует порт для OpenCode — gsd-opencode. Последняя версия на момент написания — v1.3.1.