Go Guide

The Go SDK is aimed at cloud-native services, backends, and operational tooling.

Primary surfaces

• forge-go/core
• forge-go/agent
• forge-go/identity
• forge-go/auth
• forge-go/mcp

Choose Go when

• you are embedding Forge into long-running services
• you need operationally simple deployment into cloud systems
• you want concurrency-friendly integration patterns

Use Go when you need

• service-oriented runtime integration
• concurrency-friendly backend orchestration
• deployment into cloud or Kubernetes-heavy environments

Baseline developer workflow

1. start in forge-go
2. validate package-level tests before integrating new runtime behavior
3. keep provider, agent, identity, auth, and MCP surfaces aligned

Useful verification commands

• go test ./...
• python3 tools/release_gate.py --root .

Current guidance

Keep parity expectations strict. Do not assume language parity from package shape alone; use the release gate and conformance harness as the production bar.