59134fa426
New v2.23 features documented: - getting-started.md: Add VS Code extension install section (chat participant, sidebar dashboard, command palette, RPC requirement) - README.md: Add VS Code extension to documentation index, update troubleshooting link to include forensics - docs/README.md: Add VS Code extension to user documentation table - architecture.md: Add headless mode, MCP server mode, and VS Code extension to system structure diagram; expand Browser Tools description to cover 10 new tools (PDF export, device emulation, visual regression, structured extraction, route mocking, etc.); add missing extensions (Async Jobs, Remote Questions, TTSR, Universal Config) - auto-mode.md: Add validate-milestone phase to the pipeline diagram and phase descriptions — reconciliation gate before milestone completion - configuration.md: Add models.json resolution section — custom model definitions with ~/.gsd/agent/models.json and ~/.pi/agent/models.json fallback Co-authored-by: TÂCHES <afromanguy@me.com>
50 lines
3.4 KiB
Markdown
50 lines
3.4 KiB
Markdown
# 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](./getting-started.md) | Installation, first run, and basic usage |
|
|
| [Auto Mode](./auto-mode.md) | How autonomous execution works — the state machine, crash recovery, and steering |
|
|
| [Commands Reference](./commands.md) | All commands, keyboard shortcuts, and CLI flags |
|
|
| [Remote Questions](./remote-questions.md) | Discord and Slack integration for headless auto-mode |
|
|
| [Configuration](./configuration.md) | Preferences, model selection, git settings, and token profiles |
|
|
| [Token Optimization](./token-optimization.md) | Token profiles, context compression, complexity routing, and adaptive learning (v2.17) |
|
|
| [Dynamic Model Routing](./dynamic-model-routing.md) | Complexity-based model selection, cost tables, escalation, and budget pressure (v2.19) |
|
|
| [Captures & Triage](./captures-triage.md) | Fire-and-forget thought capture during auto-mode with automated triage (v2.19) |
|
|
| [Workflow Visualizer](./visualizer.md) | Interactive TUI overlay for progress, dependencies, metrics, and timeline (v2.19) |
|
|
| [Cost Management](./cost-management.md) | Budget ceilings, cost tracking, projections, and enforcement modes |
|
|
| [Git Strategy](./git-strategy.md) | Worktree isolation, branching model, and merge behavior |
|
|
| [Parallel Orchestration](./parallel-orchestration.md) | Run multiple milestones simultaneously with worker isolation and coordination |
|
|
| [Working in Teams](./working-in-teams.md) | Unique milestone IDs, `.gitignore` setup, and shared planning artifacts |
|
|
| [Skills](./skills.md) | Bundled skills, skill discovery, and custom skill authoring |
|
|
| [Migration from v1](./migration.md) | Migrating `.planning` directories from the original GSD |
|
|
| [Troubleshooting](./troubleshooting.md) | Common issues, `/gsd doctor`, and recovery procedures |
|
|
| [VS Code Extension](../vscode-extension/README.md) | Chat participant, sidebar dashboard, and RPC integration for VS Code |
|
|
|
|
## Architecture & Internals
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Architecture Overview](./architecture.md) | System design, extension model, state-on-disk, and dispatch pipeline |
|
|
| [Native Engine](../native/README.md) | Rust N-API modules for performance-critical operations |
|
|
| [ADR-001: Branchless Worktree Architecture](./ADR-001-branchless-worktree-architecture.md) | 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](./what-is-pi/README.md) | Core concepts — modes, agent loop, sessions, tools, providers |
|
|
| [Extending Pi](./extending-pi/README.md) | Building extensions — tools, commands, UI, events, state |
|
|
| [Context & Hooks](./context-and-hooks/README.md) | Context pipeline, hook reference, inter-extension communication |
|
|
| [Pi UI / TUI](./pi-ui-tui/README.md) | Terminal UI components, theming, keyboard input, rendering |
|
|
|
|
## Research
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [Building Coding Agents](./building-coding-agents/README.md) | Research notes on agent design — decomposition, context engineering, cost/quality tradeoffs |
|