Jeremy McSpadden 01b0d530c8 docs: parallel milestone orchestration documentation

New: docs/parallel-orchestration.md — comprehensive guide covering:
- Architecture overview with coordinator/worker diagram
- Worker isolation model (process, worktree, state, context)
- Eligibility analysis (dependencies + file overlap)
- Configuration reference (all parallel.* keys)
- Commands reference (/gsd parallel start|status|stop|pause|resume|merge)
- Signal lifecycle (coordinator → worker communication)
- Merge reconciliation with conflict handling
- Budget management across workers
- Doctor integration and health monitoring
- Safety model breakdown
- File layout (.gsd/parallel/ and .gsd/worktrees/)
- Troubleshooting guide

Updated existing docs:
- auto-mode.md: cross-reference to parallel orchestration
- configuration.md: parallel config block with all keys
- commands.md: parallel commands table
- git-strategy.md: parallel worktree branching diagram
- README.md: added to documentation index

2026-03-16 20:32:10 -06:00

3.3 KiB

Raw Blame History

GSD Documentation

Welcome to the GSD documentation. This covers everything from getting started to advanced configuration, auto-mode internals, and extending GSD with the Pi SDK.

User Documentation

Guide	Description
Getting Started	Installation, first run, and basic usage
Auto Mode	How autonomous execution works — the state machine, crash recovery, and steering
Commands Reference	All commands, keyboard shortcuts, and CLI flags
Remote Questions	Discord and Slack integration for headless auto-mode
Configuration	Preferences, model selection, git settings, and token profiles
Token Optimization	Token profiles, context compression, complexity routing, and adaptive learning (v2.17)
Dynamic Model Routing	Complexity-based model selection, cost tables, escalation, and budget pressure (v2.19)
Captures & Triage	Fire-and-forget thought capture during auto-mode with automated triage (v2.19)
Workflow Visualizer	Interactive TUI overlay for progress, dependencies, metrics, and timeline (v2.19)
Cost Management	Budget ceilings, cost tracking, projections, and enforcement modes
Git Strategy	Worktree isolation, branching model, and merge behavior
Parallel Orchestration	Run multiple milestones simultaneously with worker isolation and coordination
Working in Teams	Unique milestone IDs, `.gitignore` setup, and shared planning artifacts
Skills	Bundled skills, skill discovery, and custom skill authoring
Migration from v1	Migrating `.planning` directories from the original GSD
Troubleshooting	Common issues, `/gsd doctor`, and recovery procedures

Architecture & Internals

Guide	Description
Architecture Overview	System design, extension model, state-on-disk, and dispatch pipeline
Native Engine	Rust N-API modules for performance-critical operations
ADR-001: Branchless Worktree Architecture	Decision record for the v2.14 git architecture

Pi SDK Documentation

These guides cover the underlying Pi SDK that GSD is built on. Useful if you want to extend GSD or build your own agent application.

Guide	Description
What is Pi	Core concepts — modes, agent loop, sessions, tools, providers
Extending Pi	Building extensions — tools, commands, UI, events, state
Context & Hooks	Context pipeline, hook reference, inter-extension communication
Pi UI / TUI	Terminal UI components, theming, keyboard input, rendering

Research

Guide	Description
Building Coding Agents	Research notes on agent design — decomposition, context engineering, cost/quality tradeoffs

3.3 KiB Raw Blame History