Get Shit Done

A meta-prompting, context engineering and spec-driven development framework for AI code assistants

Get Shit Done

A light-weight and powerful meta-prompting, context engineering and spec-driven development framework for Claude Code, OpenCode, Gemini CLI, and Codex.

Get Started

View on GitHub

What is GSD?

Get Shit Done (GSD) is a context engineering layer that makes Claude Code reliable. It solves context rot — the quality degradation that happens as AI assistants fill their context window.

Meta-Prompting

XML-structured prompts optimized for AI comprehension and precise execution

Context Engineering

Intelligent context management prevents quality degradation across long sessions

Multi-Agent Orchestration

Parallel specialized agents handle research, planning, execution, and verification

Spec-Driven Development

Requirements-first approach with phase-based execution and atomic commits

Key Features

Wave Execution

Parallel task execution with intelligent dependency management

Atomic Commits

Surgical version control with one commit per task

Manual Verification

User acceptance testing with automated debugging

Brownfield Support

Analyze existing codebases before starting work

Model Profiles

Balance quality vs cost with configurable agent models

Multi-Runtime

Works with Claude Code, OpenCode, Gemini CLI, and Codex

Why GSD?

“If you know clearly what you want, this WILL build it for you. No bs.”

GSD was built by a solo developer who doesn’t write code — Claude Code does. Other spec-driven tools add complexity (sprint ceremonies, story points, Jira workflows). GSD puts complexity in the system, not your workflow.

What you see: A few commands that just work
What happens: Context engineering, XML formatting, subagent orchestration, state management

Trusted by engineers at Amazon, Google, Shopify, and Webflow.

Quick Start

npm

npx get-shit-done-cc@latest

The installer prompts you to choose:

1. Runtime — Claude Code, OpenCode, Gemini, Codex, or all
2. Location — Global (all projects) or local (current project only)

1. Install GSD

   Run the installer and select your preferred runtime and location

2. Verify Installation

   • Claude Code / Gemini: /gsd:help
   • OpenCode: /gsd-help
   • Codex: $gsd-help
3. Initialize Your Project

   Run /gsd:new-project to start with questions, research, requirements, and roadmap

Core Workflow

Initialize Project

Questions → Research → Requirements → Roadmap

Discuss Phase

Capture implementation decisions before planning

Plan Phase

Research + Plan + Verify for each phase

Execute Phase

Parallel wave execution with fresh context per task

Verify Work

Manual UAT with automated debugging

Complete Milestone

Archive milestone and start the next version

How It Works

GSD handles context engineering for you through structured files:

File	Purpose
PROJECT.md	Project vision, always loaded
research/	Ecosystem knowledge (stack, features, architecture, pitfalls)
REQUIREMENTS.md	Scoped v1/v2 requirements with phase traceability
ROADMAP.md	Where you’re going, what’s done
STATE.md	Decisions, blockers, position — memory across sessions
PLAN.md	Atomic task with XML structure, verification steps
SUMMARY.md	What happened, what changed, committed to history

Every stage uses multi-agent orchestration: a thin orchestrator spawns specialized agents, collects results, and routes to the next step.

The result: You can run an entire phase — deep research, multiple plans created and verified, thousands of lines of code written across parallel executors, automated verification — and your main context window stays at 30-40%. The work happens in fresh subagent contexts.

Learn More

Why GSD?

Understand the philosophy and design principles

Installation

Detailed installation guide for all runtimes

Core Concepts

Learn about context engineering, multi-agent orchestration, and XML prompting

Commands

Complete command reference for all workflows