Tom Boucher 330e5200bc docs: add v2.18/v2.19 feature documentation (#631 )

New docs:
- dynamic-model-routing.md — complexity classification, tier models,
  escalation, budget pressure, cost table, adaptive learning
- captures-triage.md — fire-and-forget capture, triage pipeline,
  classification types, dashboard integration, worktree awareness
- visualizer.md — four-tab TUI overlay (progress, deps, metrics,
  timeline), controls, auto-refresh, auto_visualize preference

Updated docs:
- README.md — added links to three new docs
- commands.md — added capture, triage, visualize, knowledge, queue reorder
- configuration.md — added dynamic_routing and auto_visualize settings,
  updated full example with new config options
- auto-mode.md — added capture, visualize sections, dashboard badge,
  dynamic model routing reference
- architecture.md — updated dispatch pipeline (routing + captures steps),
  added key modules table for v2.19
- cost-management.md — added dynamic routing and visualizer tips

2026-03-16 09:00:58 -06:00

3.1 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
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.1 KiB Raw Blame History