Gsd 2 Agent Framework

This is a full CLI framework for running coding agents that actually finish projects without you babysitting them. It breaks work into milestones, slices, and tasks, then executes each one in a fresh context window with git worktree isolation, crash recovery, and cost tracking. The key insight is enforcing that every task must fit in one context window and requiring mechanically verifiable must-haves like passing tests or curl commands that return 200. You write a ROADMAP.md, run `/gsd auto`, and walk away. It handles the research, planning, execution, and git commits for each unit, then squash-merges completed milestones back to main. Built by ara.so with real opinions about how to keep agents from spinning in circles or burning through your API budget.

skills.sh installs: 1.4K
GitHub stars: 61
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill gsd-2-agent-framework --agent claude-code

Installs into .claude/skills of the current project.

Files

GSD 2 — Autonomous Spec-Driven Agent Framework

Skill by ara.so — Daily 2026 Skills collection

GSD 2 is a standalone CLI that turns a structured spec into running software autonomously. It controls the agent harness directly — managing fresh context windows per task, git worktree isolation, crash recovery, cost tracking, and stuck detection — rather than relying on LLM self-loops. One command, walk away, come back to a built project with clean git history.

Installation

npm install -g gsd-pi

Requires Node.js 18+. Works with Claude (Anthropic) as the underlying model via the Pi SDK.

Core Concepts

Work Hierarchy

Milestone  →  a shippable version (4–10 slices)
  Slice    →  one demoable vertical capability (1–7 tasks)
    Task   →  one context-window-sized unit of work

Iron rule: A task must fit in one context window. If it can't, split it into two tasks.