COMING SOON · DISK-BACKED AGENT PIPELINE

GSD PathA disk-backed, gated project pipeline for AI coding agents.

Turns raw ideas into shipped code through strictly gated phases — inspect, define, research, decide, roadmap, plan, build, and ship — with every handoff written to .project/ so any session can resume from disk alone.

Join the Waitlist & DiscordOpen GSD GitHub
gsd-path · upcoming release
DURABLE DISK MANIFESTS
.project/
.project/INTENT.mdPhase 1 Define
.project/SYNTHESIS.mdPhase 3 Decide
.project/PLAN.mdPhase 4 Plan
.project/next/Lookahead M02
14 Canonical Skills InstalledAll Hosts
Architecture

Engineered for Zero Context Loss

Current AI coding assistants forget project decisions between sessions. GSD Path anchors every state transition directly on disk.

Disk-Backed State Store

Every phase handoff writes directly to .project/ (INTENT.md, SYNTHESIS.md, PLAN.md). Any agent can pick up work with zero context drift.

Core Guarantee

Strictly Gated Router

The router halts if required architectural decisions or verification criteria are open. Irreversible steps require explicit sign-off.

Core Guarantee

Parallel Worktree Waves

Build phases dispatch coders into isolated git worktrees, streaming dependent tasks as soon as upstream contracts pass verification.

Core Guarantee

Parallel Lookahead Planning

Plan Milestone N+1 under .project/next/ while Milestone N builds. A building milestone can be abandoned on an explicit ruling, archiving partial work for a re-slice.

Core Guarantee
Interactive Spec

Explore the Gated Pipeline

Click through the 7 gated phases to see how GSD Path turns intent into code, task contracts, and verified release archives.

GSD PATH · DISK-BACKED AGENT ENGINE

Interactive 7-Phase Gated Pipeline

Disk Store: .project/
PHASE SKILL & INVOCATIONPhase 4

Plan Phase

Generate waves, task contracts, and verification test requirements.

Skill Commandgsd-path-plan

# In Codex:

$gsd-path-plan

# In Claude Code / Antigravity / Cursor / Zed:

/gsd-path-plan

Gated Router Condition

Task contracts and verifier briefs validated by base SHA.

Disk-backed handoffs in .project/
.project/PLAN.md
DURABLE ON DISK
## Wave 1: Core Harness
- Task 1.1: Worktree isolator (contract-grade)
- Task 1.2: Checkpoint manager
- Verifier: tests/worktree.spec.ts
Session Resumability: Any coding agent can drop into the repo and instantly pick up the exact state by reading .project/PLAN.md.
/gsd-path-discuss sidecar activeZero context drift
System Architecture

How GSD Path Works

Explore the complete gated pipeline, parallel wave worktrees, lookahead planning track, and durable disk state hierarchy.

GSD PATH ARCHITECTURE SYSTEM

Deep Architecture & Flow Diagrams

End-to-End Gated Pipeline & Multi-Milestone Loop

Human Gated & Checkpoint Commits

Every phase operates with strict input/output contracts. Non-interactive phases auto-advance once criteria pass; milestone boundaries loop through the roadmap until the program completes.

PHASE 0Auto-Gate
Inspect Codebase

Brownfield map + doc drift audit.

→ .project/codebase-map.json
PHASE 1HUMAN GATE
Define Scope

Intent interview & milestone boundary.

→ .project/INTENT.md (or CHARTER.md)
PHASE 2Parallel Batch
Research Dimensions

Independent child agents probe APIs & data.

→ .project/research/*.md
PHASE 3Evidence Gate
Decide ADRs

Synthesize trade-offs; resolve questions.

→ .project/SYNTHESIS.md
PHASE 3.5HUMAN GATE
Program Roadmap

Slice charter into milestone roadmap.

→ .project/ROADMAP.md
PHASE 4HUMAN GATE
Plan Waves & Briefs

Task contracts & verification requirements.

→ .project/PLAN.md + task contracts
PHASE 5 Wave Loop
Build & Wave Review

Isolated worktrees & multi-lens review loop.

↻ Review → Fix → Re-verify (max 3)
PHASE 6FINAL SHIP
Ship & Archive

Final review, tag, archive, & next milestone.

↻ Advances to Next Roadmap Entry
OUTER PROGRAM LOOP:On Milestone Ship, GSD Path promotes .project/next/ in one commit and loops back to execute the next milestone in ROADMAP.md.
CONTINUOUS MILESTONES
Canonical Skills

14 Explicit-Only Skills

Invoke the router by default; use phase skills for single steps, or use a sidecar skill — discuss, audit docs, run a bounded loop pass, diagnose, or undo — without advancing the pipeline.

Router

gsd-path

Detects current project state from disk and runs the next gated phase; status mode reports without advancing.

Phase 0

gsd-path-inspect

Brownfield codebase map, entry points, and doc-vs-code drift audit.

Phase 1

gsd-path-define

Intent interview producing INTENT.md and milestone CHARTER.md.

Phase 2

gsd-path-research

Parallel evidence gatherers probing APIs, schemas, and performance.

Phase 3

gsd-path-decide

Synthesizes evidence into formal ADRs and SYNTHESIS.md.

Phase 3.5

gsd-path-roadmap

Slices program charter into ordered milestones with dependency paths.

Phase 4

gsd-path-plan

Generates execution waves, task contracts, and verification test requirements.

Phase 5

gsd-path-build

Parallel coders in isolated worktrees with streaming dispatch, wave review, and a verify ledger that reuses passing runs at the same base.

Phase 6

gsd-path-ship

Final review, human approval, archive to .project/archive/, then a direct merge or user-merged PR and milestone tag.

Sidecar

gsd-path-discuss

Talk through questions at any phase without advancing or corrupting handoffs.

Sidecar

gsd-path-docs-audit

Standalone doc-vs-code drift check that runs outside the phase gates.

Sidecar

gsd-path-loop

One bounded pass from a LOOP.md spec — gate check, independent verify, one fix worker, telemetry.

Sidecar

gsd-path-forensics

Read-only diagnosis of a stuck pipeline. Runs the helpers and names the exact retry command; never mutates state.

Sidecar

gsd-path-undo

Helper-owned undo of unpublished work — a checkpoint, last task landing, uncommitted ship archive, or lookahead track.

Evolution of the Pipeline

gsd-core vs. gsd-path

Understanding when to use the lightweight single-session framework versus the next-generation disk-backed gated pipeline.

Workflow Frameworkv1.9.0 · Stable

gsd-core

The original prompt and workflow framework designed to instill Git-Ship-Done discipline directly inside existing single-session agent runtimes.

  • ›Direct injection into Claude Code, Cursor, Copilot, or Codex
  • ›Ideal for single-sitting feature additions & targeted fixes
  • ›Lightweight memory model in active conversation
Explore gsd-coreRuntime Framework
Gated Pipeline EngineUpcoming Release

gsd-path

A disk-backed, strictly gated pipeline engine for multi-milestone programs with zero context drift, parallel worktree waves, and lookahead planning.

  • ›Durable handoffs written directly to .project/ disk store
  • ›Parallel coders in isolated git worktrees with streaming dispatch
  • ›Lookahead planning track (.project/next/) during active builds
Join Waitlist on DiscordPipeline Engine

Capability Matrix Breakdown

Detailed comparison of architectural guarantees, persistence, and execution models.

Dimensiongsd-coregsd-path
Primary ScopeSingle-sitting tasks, ad-hoc feature work, and rapid bugfixesMulti-milestone programs, large architectures, and complex codebases
State PersistenceVolatile in-session chat context + linear task filesDurable disk-backed manifests in .project/ (Zero context drift)
Concurrency ModelSerial single-agent loop in active chatParallel wave execution in isolated linked git worktrees
Pipeline RoutingLinear conversational stagesStrictly gated router with 7 explicit phases and gate checks
Lookahead PlanningNone (single linear task list)Parallel .project/next/ planning while active milestone builds
Adversarial ReviewIn-band self-review in active conversationMulti-lens reviewer sub-agents + wave review cycles
Discussion HandlingInterleaved into main prompt contextNon-destructive sidecar (/gsd-path-discuss) writing to disk
Session ResumabilityRequires chat history or manual context rebuild100% resumable by any agent from disk files alone
Universal Compatibility

Supported Host Environments

GSD Path installs cleanly across your favorite AI coding tools and terminal runtimes.

Codex
Claude Code
Antigravity CLI
Cursor
Zed
GitHub Copilot CLI
Grok
OpenCode
Qwen Code
Kiro
Kimi Code
Coming Soon

Stay Updated on GSD Path

GSD Path is currently in active development. Join the Open GSD Discord to follow milestone progress and test early developer builds.

Join the Discord CommunityOpen GSD Organization