singularity-forge/docs
Nathan Roe 39cd932abb feat: add anthropic-vertex provider for Claude on Vertex AI (#1533)
* feat: add anthropic-vertex provider for Claude models on Google Vertex AI

Add a new anthropic-vertex provider that enables using Claude models
(Opus 4.6, Sonnet 4.6, Haiku 4.5) through Google Vertex AI using the
@anthropic-ai/vertex-sdk package. Follows the same pattern as the
existing google/google-vertex provider split.

Detection uses ANTHROPIC_VERTEX_PROJECT_ID (same env var as Claude Code)
with CLOUD_ML_REGION for region selection, falling back to us-central1.

Extracts shared Anthropic utilities into anthropic-shared.ts (message
conversion, tool conversion, param building, stream processing) to
avoid duplication between anthropic.ts and anthropic-vertex.ts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add full Claude model set for anthropic-vertex provider

Add 200K context window variants for Opus 4.6 and Sonnet 4.6, plus
older models (Sonnet 4.5, Sonnet 4, Opus 4.5, Opus 4.1, Opus 4, Haiku 4.5).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add @anthropic-ai/vertex-sdk to root dependencies

Required for the published package to resolve the vertex SDK at runtime.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: remove unnecessary comments to match codebase style

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: remove duplicate stream functions after rebase

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Nathan Roe <nathan.roe@carvana.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 23:14:13 -06:00
..
building-coding-agents docs: add extension docs 2026-03-11 00:54:01 -06:00
context-and-hooks docs: add extension docs 2026-03-11 00:54:01 -06:00
extending-pi refactor: consolidate extension type guards and inline handler type aliases 2026-03-19 14:55:00 -03:00
pi-ui-tui docs: add extension docs 2026-03-11 00:54:01 -06:00
pr-876 feat: HTML report generator with progression index (#876) 2026-03-17 11:51:54 -06:00
pr-1530 feat(dashboard): two-column layout with redesigned widget (#1530) 2026-03-19 20:07:18 -06:00
proposals fix: prevent ensureGitignore from adding .gsd when tracked in git (#1364) (#1367) 2026-03-19 17:06:01 -06:00
superpowers Add CI/CD pipeline implementation plan 2026-03-17 20:25:19 -04:00
what-is-pi feat: add anthropic-vertex provider for Claude on Vertex AI (#1533) 2026-03-19 23:14:13 -06:00
ADR-001-branchless-worktree-architecture.md refactor(git): branchless worktree architecture (#506) 2026-03-15 13:21:58 -06:00
ADR-003-pipeline-simplification.md feat: simplify auto pipeline — merge research into planning, mechanical completion (ADR-003) (#1235) 2026-03-18 13:53:51 -06:00
agent-knowledge-index.md docs: add extension docs 2026-03-11 00:54:01 -06:00
architecture.md docs: update README and docs for v2.33.0 release (#1320) 2026-03-18 21:15:11 -06:00
auto-mode.md docs: update README and docs for v2.33.0 release (#1320) 2026-03-18 21:15:11 -06:00
captures-triage.md docs: add v2.18/v2.19 feature documentation (#631) 2026-03-16 09:00:58 -06:00
ci-cd-pipeline.md docs: update README and docs for v2.33.0 release (#1320) 2026-03-18 21:15:11 -06:00
commands.md docs: fix stale references across documentation (#1543) 2026-03-19 22:14:03 -06:00
configuration.md fix: wire dead token-profile defaults and add /gsd rate command (#1505) (#1516) 2026-03-19 17:53:00 -06:00
cost-management.md docs: add v2.18/v2.19 feature documentation (#631) 2026-03-16 09:00:58 -06:00
dynamic-model-routing.md docs: add v2.18/v2.19 feature documentation (#631) 2026-03-16 09:00:58 -06:00
getting-started.md docs: fix stale references across documentation (#1543) 2026-03-19 22:14:03 -06:00
git-strategy.md feat: auto-create PR on milestone completion (#687) (#1084) 2026-03-17 21:45:29 -06:00
migration.md docs: add comprehensive documentation set and update README (#605) 2026-03-16 06:21:43 -06:00
node-lts-macos.md fix: improve LSP diagnostics when no servers detected (#1082) (#1086) 2026-03-17 21:45:11 -06:00
parallel-orchestration.md docs: update documentation for v2.27.0 release (#959) 2026-03-17 15:50:55 -06:00
PRD-branchless-worktree-architecture.md refactor(git): branchless worktree architecture (#506) 2026-03-15 13:21:58 -06:00
README.md docs: update documentation for v2.23 release features (#788) 2026-03-16 21:56:00 -06:00
remote-questions.md docs: update documentation for v2.20.0 release 2026-03-16 14:50:36 -04:00
skills.md docs: fix stale references across documentation (#1543) 2026-03-19 22:14:03 -06:00
token-optimization.md fix: wire dead token-profile defaults and add /gsd rate command (#1505) (#1516) 2026-03-19 17:53:00 -06:00
troubleshooting.md docs: fix stale references across documentation (#1543) 2026-03-19 22:14:03 -06:00
visualizer.md docs: update documentation for v2.26 features (#958) 2026-03-17 15:42:18 -06:00
working-in-teams.md feat: workflow mode system (solo/team) with /gsd mode command (#651) 2026-03-16 11:04:51 -06:00

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
VS Code Extension Chat participant, sidebar dashboard, and RPC integration for VS Code

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