---
name: "Run long-horizon spec-driven coding agent workflows with GSD 2"
slug: "run-long-horizon-spec-driven-coding-agent-workflows-with-gsd-2"
description: "Use GSD 2 to break a project into milestones, manage agent context and branches, recover from drift, and let coding agents advance through supervised long-running implementation work."
github_stars: 7340
verification: "security_reviewed"
source: "https://github.com/gsd-build/gsd-2"
author: "gsd-build"
publisher_type: "open_source"
category: "Templates & Workflows"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "gsd-build/gsd-2"
  github_stars: 7340
  npm_package: "gsd-pi"
  npm_weekly_downloads: 11369
---

# Run long-horizon spec-driven coding agent workflows with GSD 2

Use GSD 2 to break a project into milestones, manage agent context and branches, recover from drift, and let coding agents advance through supervised long-running implementation work.

## Prerequisites

GSD 2 CLI, Node.js/npm, git, a supported coding-agent environment

## Installation

Requirements and caveats from upstream:
- **📋 NOTICE: New to Node on Mac?** If you installed Node.js via Homebrew, you may be running a development release instead of LTS. **[Read this guide](./docs/user-docs/node-lts-macos.md)** to pin Node 24 LTS and avoid...
- **[Docker Sandbox](./docker/README.md)** — run GSD auto mode in an isolated Docker container
- **Verification enforcement** — Configure simple executable commands (npm run lint, npm run test, etc.) that run automatically after task execution. Verification commands must not use shell composition or control synta...

Basic usage or getting-started notes:
- **[Getting Started](./docs/user-docs/getting-started.md)** — install, first run, basic usage
- **[Parallel Orchestration](./docs/user-docs/parallel-orchestration.md)** — run multiple milestones simultaneously
- This is what makes GSD different. Run it, walk away, come back to built software.

- Source: https://github.com/gsd-build/gsd-2
- Extracted from upstream docs: https://raw.githubusercontent.com/gsd-build/gsd-2/HEAD/README.md

## Documentation

- https://github.com/gsd-build/gsd-2

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/run-long-horizon-spec-driven-coding-agent-workflows-with-gsd-2/)