Урок 2.12. GSD Core · Agent Dev 101

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

GSD Core полезен как пример SDD tool, который делает акцент не на красивых документах, а на process primitives. Его идея:

AI coding agent должен идти через дисциплинированный phase loop:
Discuss -> Plan -> Execute -> Verify -> Ship.

Это важно для курса, потому что многие команды не хотят брать тяжелую methodology. Им нужен минимальный, повторяемый процесс, который можно встроить в свой repository и agent harness.

GSD Core показывает именно такой слой: не "полная agile-команда", а core workflow для context engineering and spec-driven delivery.

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

GSD Core - это context-engineering and spec-driven development framework для AI coding agents.

Он решает три recurring проблемы:

Context bloat.
Потеря project memory между sessions.
Отсутствие строгой проверки перед "done".

Вместо одного большого run используется phase loop:

Discuss
-> Plan
-> Execute
-> Verify
-> Ship

Каждая phase должна быть достаточно маленькой, чтобы ее можно было понять, спланировать, выполнить и проверить.

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

Термин	Значение
GSD Core	Core package экосистемы Git. Ship. Done.
Phase loop	Повторяемый цикл Discuss, Plan, Execute, Verify, Ship.
Discuss	Capture implementation decisions before planning.
Plan	Research and decompose work into executable plan.
Execute	Выполнение plan, часто через fresh-context execution.
Verify	Проверка результата и исправление gaps до completion.
Ship	Закрытие phase: PR, archive, release или transition к следующей phase.
Context engineering	Управление тем, какой context agent получает для конкретной задачи.

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

flowchart LR A[Milestone] --> B[Discuss] B --> C[Plan] C --> D[Execute] D --> E[Verify] E --> F[Ship] F --> G[Next milestone or phase]

Важная идея GSD Core: heavy work не должен загрязнять main session. Research, planning and execution можно выносить в fresh contexts, а main session должен оставаться управляемым.

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

На обзорном уровне установка выглядит так:

npx @opengsd/gsd-core@latest

Installer предлагает выбрать runtime и scope установки. Runtime может быть Claude Code, Codex, Cursor, Copilot, OpenCode, Gemini CLI, Windsurf и другие supported agents.

После установки типовые entry points:

/gsd-new-project
/gsd-onboard

Смысл:

/gsd-new-project - начать greenfield workflow;
/gsd-onboard - подключить existing codebase.

Дальше работа идет через phase loop:

Discuss -> Plan -> Execute -> Verify -> Ship

Artifacts

GSD Core делает ставку на structured artifacts, которые переживают session boundaries. В docs упоминаются artifacts вроде:

STATE.md
CONTEXT.md

Идея этих файлов:

STATE.md помогает понять текущий статус;
CONTEXT.md сохраняет important project context;
phase artifacts фиксируют decisions, plan, verification and shipping state.

Точный layout зависит от версии и runtime. Для курса важен принцип:

Project state не должен жить только в голове агента.

GSD Core vs Get Shit Done

В предыдущем уроке мы рассматривали gsd-build/get-shit-done как user-facing lightweight system. GSD Core полезно воспринимать как более нейтральный core layer:

Вопрос	Get Shit Done	GSD Core
Основной образ	Готовый practical workflow	Core framework
Фокус	Быстро и дисциплинированно ship phases	Process primitives and runtime compatibility
Пользователь	Разработчик, которому нужен готовый tool	Команда, которая хочет понять/адаптировать core process
Ценность для курса	Phase-based delivery	Architecture of repeatable agent workflow

Пример: onboarding существующего проекта

Задача:

Добавить audit log в existing SaaS backend.

Плохой prompt:

Add audit log.

GSD Core-style:

Use GSD Core workflow.

First onboard the existing codebase.
Capture current architecture, conventions, test commands, and risk areas.

Then discuss phase 1:
- audit event model
- storage strategy
- API boundaries
- verification commands

Do not implement until the phase plan is reviewed.

Возможные phases:

Phase 1: audit event domain and persistence
Phase 2: write events for project changes
Phase 3: query audit log API
Phase 4: admin UI integration
Phase 5: verification and documentation

Каждая phase проходит Discuss, Plan, Execute, Verify, Ship.

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

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

нужен lightweight but structured workflow;
команда хочет phase loop без full methodology;
несколько agent harnesses должны использовать похожий process;
важно сохранить state across sessions;
есть risk context rot;
команда хочет адаптировать workflow под себя.

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

GSD Core может не подойти, если:

нужна полноценная product methodology с PRD, roles, epics;
команда хочет готовый product UI;
задача слишком мала;
repository не имеет tests and verification commands;
команда не готова поддерживать process artifacts.

Риски

Риск	Как проявляется	Что делать
Абстрактность core layer	Команда не понимает, какой конкретно workflow использовать.	Начать с documented default flow.
Слабая verification	Phase завершена без evidence.	Сделать verification обязательной частью Ship.
Stale state	`STATE.md` или context artifacts устаревают.	Обновлять state after each phase.
Runtime mismatch	Commands работают по-разному в разных agents.	Проверять install output and runtime docs.

Prompt patterns

Onboard brownfield

Use GSD Core.
Onboard this repository first.
Identify architecture, conventions, test commands, and risk areas.
Stop with a concise context artifact before planning new work.

Discuss phase

Discuss the first phase.
Capture decisions, alternatives, constraints, dependencies, and verification.
Do not plan tasks until decisions are explicit.

Verify phase

Verify the phase against the plan.
Run fresh tests after the last code change.
List evidence and gaps.
Do not ship if verification is incomplete.

Практика

Возьмите medium-size feature и опишите ее как GSD Core phases:

Milestone:
Phase 1:
Discuss questions:
Plan outputs:
Execute boundaries:
Verify commands:
Ship criteria:

Проверьте, можно ли phase выполнить независимо и проверить свежими commands.

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

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

объяснить GSD Core как process primitives layer;
описать loop Discuss, Plan, Execute, Verify, Ship;
понять, зачем нужны persistent state artifacts;
отличить GSD Core от full methodology;
сформулировать prompt для onboarding and phase discussion.

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

GSD Core показывает минималистичный, но дисциплинированный способ управлять agent development. Его сила в phase loop and context engineering. Он не решает product discovery как BMAD, но хорошо удерживает engineering execution от drift.

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

Что дает phase loop?
Почему Discuss должен идти до Plan?
Зачем нужны STATE.md и context artifacts?
Чем GSD Core отличается от BMAD?
Что означает Ship в agent workflow?

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

GSD Core repository: https://github.com/open-gsd/gsd-core
GSD Core docs: https://github.com/open-gsd/gsd-core/tree/main/docs

Что дальше

Следующий урок разберет GSD 2 - более runtime-oriented подход, где появляются database-backed state, memory architecture, providers, session commands and autonomous mode.