Go Guide

Applies to: Go 1.21+, Microservices, APIs, CLIs

Core Principles

1. Simplicity: Prefer simple, readable code over clever solutions
2. Concurrency: Use goroutines and channels for concurrent operations
3. Errors Are Values: Explicit error handling, no exceptions
4. Composition Over Inheritance: Interfaces and struct embedding
5. Standard Library First: Rich stdlib, minimize dependencies

Guardrails

Version & Dependencies

• Use Go 1.21+ with Go modules (go.mod)
• Run go mod tidy before committing
• Pin major versions in go.mod