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
11 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/ in parallel while Milestone N is actively building and running verification tests.

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

11 Explicit-Only Skills

Invoke the router by default; use phase skills for single steps, or use the discussion sidecar at any non-shipped phase.

Router

gsd-path

Detects current project state from disk and runs the next gated phase.

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 and wave review.

Phase 6

gsd-path-ship

Final review, verification, human approval, archive to .project/archive/, and tag.

Sidecar

gsd-path-discuss

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

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