HarnessCommunity★ 59k

GSD Core

Updated Jul 7, 2026

GSD Core (formerly "get-shit-done", now at open-gsd/gsd-core) is a context-engineering and spec-driven development framework that drives AI coding agents through a disciplined five-phase loop. Heavy research, planning, and execution run in fresh-context subagents while the main session stays lean. Supports Claude Code, OpenCode, Antigravity CLI, Kimi CLI, Kilo, Codex, Copilot, Cursor, Windsurf, and more.

View on GitHub

What it does

/gsd-new-project
Initializes GSD Core for a greenfield project, creating STATE.md and CONTEXT.md scaffolding.
/gsd-onboard
Onboards an existing codebase into the GSD phase loop, analyzing the repo before the first Discuss phase.
Discuss phase
Captures implementation decisions in a structured session before any planning begins.
Execute phase
Runs plan tasks in parallel waves, each executor starting with a clean 200K-token context to prevent drift.
Verify phase
Walks through what was built, diagnoses failures, and generates fix plans before declaring the phase done.

Files (1)

OVERVIEW.mdprimary · markdown · 1.7 KB

## What it does

GSD Core (formerly the "get-shit-done" repo, now maintained at github.com/open-gsd/gsd-core) is a context-engineering and spec-driven development framework. It solves context rot — the quality degradation that accumulates as an AI fills its context window — by running all heavy research, planning, and execution work in fresh-context subagents while keeping the main session lean. Structured artifacts (STATE.md, CONTEXT.md) survive session boundaries so work can resume without re-explaining scope.

Each milestone repeats the same five-step phase loop:

1. Discuss — capture implementation decisions before anything is planned
2. Plan — research, decompose, and verify the plan fits a fresh context window
3. Execute — run plans in parallel waves; each executor starts with a clean 200K-token context
4. Verify — walk through what was built; diagnose and fix before declaring done
5. Ship — create the PR, archive the phase, repeat for the next milestone

## Install

npx @opengsd/gsd-core@latest

The installer prompts for your runtime (Claude Code, OpenCode, Codex, Cursor, Windsurf, and more) and whether to install globally or locally.

Start a new project:

/gsd-new-project # greenfield
/gsd-onboard # existing codebase

## When to use

Use GSD Core when you have a multi-milestone project where context drift across long sessions is a real problem. The five-phase loop works best when milestones are scoped to a few hundred lines of change — large enough to benefit from planning, small enough for a single execute wave. The STATE.md/CONTEXT.md artifacts make it practical to pause and resume across multiple sessions without losing implementation decisions.