Урок 2.13. GSD 2

Зачем это нужно

GSD 2 полезен как пример того, как SDD tooling может сдвинуться от "набор prompts and commands" к более полноценной runtime-системе для agentic development.

Если GSD Core удобно объяснять через phase loop, то GSD 2 интересен другим:

Agent workflow начинает иметь собственное состояние,
memory architecture, database, runtime files и session commands.

Это важный шаг в развитии AI-agent tooling. Чем длиннее и сложнее задача, тем меньше хватает одного Markdown plan. Нужны state, memory, resume, autonomous mode and verification discipline.

Основная идея

GSD 2 можно воспринимать как AI coding agent/runtime, который управляет:

• planning;
• execution;
• verification;
• shipping;
• state;
• memory;
• provider routing;
• skills;
• session lifecycle.

Его mental model:

Не просто "agent читает файлы".
Agent работает внутри runtime, где есть authoritative state и workflow commands.

Ключевые термины

Как это устроено

В такой модели artifacts and database становятся частью "операционной памяти" agent workflow. Это снижает зависимость от одного context window, но увеличивает complexity.

Требования и запуск

По docs GSD 2 требует:

• Node.js 22+;
• Git;
• LLM provider or subscription flow;
• project repository.

Он поддерживает множество providers через Pi SDK style layer: Anthropic, OpenAI, Gemini, OpenRouter, GitHub Copilot, Bedrock, Azure OpenAI, Vertex, Groq, Mistral and others.

Практический вывод:

Перед использованием GSD 2 проверьте requirements и installation docs.
Это не просто Markdown toolkit, а runtime с зависимостями.

Session commands

В docs GSD 2 выделяются commands вроде:

Для курса здесь важны два режима:

• step mode для контролируемого обучения;
• auto mode для long-running agent execution, когда specs and verification достаточно сильные.

Artifacts

GSD 2 manages context through artifacts:

gsd.db
PROJECT.md
REQUIREMENTS.md
DECISIONS.md
KNOWLEDGE.md
RUNTIME.md
STATE.md
M001-ROADMAP.md
M001-CONTEXT.md
research/*.md

Роль artifacts:

• gsd.db хранит authoritative runtime state;
• PROJECT.md описывает текущую систему;
• REQUIREMENTS.md фиксирует capabilities and exclusions;
• DECISIONS.md защищает architecture от silent drift;
• KNOWLEDGE.md переносит lessons между sessions;
• RUNTIME.md помогает agent понимать environment;
• STATE.md дает dashboard;
• roadmap/context files удерживают milestone structure.

Как пользоваться

На обзорном уровне:

1. Проверить prerequisites.
2. Установить GSD 2 по official README.
3. Запустить в repository.
4. Начать с step mode, а не сразу с auto mode.
5. Дать agent сформировать project artifacts.
6. Проверить requirements and decisions.
7. Запускать /gsd next для controlled progress.
8. Использовать /gsd auto только когда test baseline and verification reliable.

Пример cautious workflow:

/gsd

Потом review generated state.

/gsd discuss

Потом steering:

/gsd steer

И только после этого:

/gsd auto

Пример: migration на новую notification subsystem

Задача:

Перенести notifications с синхронных calls на event-driven subsystem.

Почему GSD 2 может быть уместен:

• задача длинная;
• нужны decisions;
• нужны runtime details;
• нужна память между sessions;
• есть risk of partial migration;
• нужно много verification.

Prompt:

Use GSD 2 in controlled step mode.

Goal:
Migrate notifications to an event-driven subsystem.

First update project understanding:
- current notification flow
- event infrastructure
- database tables
- runtime services
- test commands

Do not enter auto mode until PROJECT, REQUIREMENTS, DECISIONS, and STATE are reviewed.

Когда GSD 2 полезен

GSD 2 хорошо подходит, когда:

• задача long-running;
• требуется runtime state;
• нужны resume and pause semantics;
• project memory должна жить между sessions;
• есть несколько model providers;
• нужно autonomous execution, но с tracked state;
• project has reliable tests and CI.

Когда не стоит брать

GSD 2 может быть лишним, если:

• нужна одна маленькая feature;
• команда не хочет runtime dependencies;
• project state проще держать в Markdown;
• нет стабильных verification commands;
• разработчики не готовы review runtime-generated artifacts;
• требуются very strict enterprise controls, которые tool не покрывает.

Риски

GSD 2 vs GSD Core

Prompt patterns

Controlled start

Use GSD 2 in step mode.
Do not use auto mode yet.
First build project understanding and show the generated artifacts for review.

Auto mode guard

Before entering auto mode, confirm:
- tests are passing
- requirements are explicit
- decisions are logged
- runtime assumptions are documented
- stop conditions are clear

Decision update

This changes architecture.
Update DECISIONS.md with:
- decision
- alternatives considered
- rationale
- consequences
- verification required

Практика

Выберите long-running task и определите, нужен ли runtime-style tool:

Task:
Estimated phases:
Requires persistent state: yes/no
Requires decision log: yes/no
Requires runtime context: yes/no
Can be done with simple specs: yes/no
Recommended tool:
Why:

Критерии готовности

После урока студент должен уметь:

• объяснить GSD 2 как runtime-oriented SDD tool;
• назвать основные state artifacts;
• понять разницу между step mode and auto mode;
• объяснить риск autonomous execution без verification;
• выбрать между GSD Core and GSD 2.

Краткое резюме

GSD 2 показывает, что SDD tooling может стать полноценной runtime-системой. Это дает memory, state and autonomous execution, но требует большей дисциплины. Чем мощнее agent runtime, тем важнее approval gates, evidence and state validation.

Вопросы для самопроверки

1. Зачем GSD 2 нужен gsd.db?
2. Чем DECISIONS.md отличается от REQUIREMENTS.md?
3. Когда auto mode опасен?
4. Почему step mode лучше для первого внедрения?
5. Когда GSD Core будет лучше GSD 2?

Источники для актуализации

• GSD 2 repository: https://github.com/gsd-build/gsd-2
• GSD 2 user docs: https://github.com/gsd-build/gsd-2/tree/main/docs/user-docs

Что дальше

Следующий урок разберет Agent-OS / Ouroboros - подход, где agent workflow описывается почти как operating system: seed specs, ledger, runtime adapters and evaluation gates.