React
React Native
Node.js
Python
Rust
PostgreSQL
Solana
Claude
AI Agents
Go

Sections

Go Core & Fundamentals

Why Go Exists: Simplicity, Readability, and Practical Concurrency Go Philosophy Basics Go's Target Domains: Systems, Cloud-Native, CLIs, and Distributed Services Go vs Rust: Safety, Performance, and Team Velocity Trade-offs Go vs C++, Java, Python, and Node.js Simplicity as a Deliberate Constraint in API Design When Go Is the Wrong Tool Go Philosophy Best Practices

Go's Evolution: From 2007 Origins to Go 1.0 and Beyond Go Releases Basics Major Milestones: Modules, Generics, Workspaces, Fuzzing, and PGO Go 1.26 Highlights: Green Tea GC, go fix Modernizers, and Language Tweaks The Go 1 Compatibility Promise in Practice Go 2 Discussion History and What Actually Shipped Reading Release Notes Like a Tech Lead Planning Go Version Upgrades Across a Monorepo Go History & Releases Best Practices

How Go Programs Are Structured: Packages, main, and the Toolchain Go Fundamentals Basics Variables, Constants & Scope Zero Values and Initialization Numeric Types, Strings, Runes & Byte Slices Arrays, Slices & Maps at a Glance Structs, Embedding & Field Promotion Pointers & the Address-of Operator Go Fundamentals Best Practices

Go's Memory Model: Stack, Heap, and Value Semantics Data Types Basics Slice Internals: Pointer, Len, Cap & Append Map Internals & Hash Table Behavior Struct Alignment, Padding & unsafe.Sizeof Interface Internals: Static Type, Dynamic Type & itables Channel Internals: Buffered vs Unbuffered unsafe Pointers & the unsafe Package Data Types & Memory Model Best Practices

Go Control Flow: Expression-Oriented Design Control Flow Basics for Loop Variants & range Semantics if with Initialization & switch Patterns defer, panic & recover break, continue & Labeled Control Flow range Variable Reuse Pitfalls Control Flow in HTTP Middleware Control Flow Best Practices

Functions and Interfaces: Go's Composition Model Functions & Methods Basics Multiple Returns, Named Returns & Naked Returns Variadic Functions & Function Types Methods: Value vs Pointer Receivers Function Literals & Closures Defining and Implementing Interfaces Nil Interface vs Nil Pointer Functions, Methods & Interfaces Best Practices

Errors as Values: Go's Error Philosophy Error Handling Basics Sentinel Errors & errors.Is Error Wrapping with %w & errors.As Custom Error Types & Error Interfaces Stack Traces with runtime/debug Error Handling in Concurrent Code API Error Design for HTTP and gRPC Services Error Handling Best Practices

Packages and Modules: Go's Unit of Distribution Packages & Modules Basics Package Naming & internal/ Directories go.mod, go.sum & Minimal Version Selection Pseudo-Versions, replace & retract Directives Import Cycles, Blank Imports & Dot Imports go work: Workspace Mode for Multi-Module Repos Standard Project Layout for Services and Libraries Packages, Modules & Project Layout Best Practices

Tooling, Quality & Craft

The go Command: Build, Test, and Module Lifecycle Go Toolchain Basics go build, run, install & clean go test, list & generate go mod tidy, vendor, download & graph go fix Modernizers & go vet Analyzers Build Tags & Conditional Compilation Cross-Compilation & Private Module Proxies Go Toolchain Best Practices

Go Developer Tooling: LSP, Debugger, and Analyzers Go Tooling Setup Basics gopls: Navigation, Refactoring & Diagnostics Debugging with Delve govulncheck for Dependency Vulnerabilities staticcheck & golangci-lint in CI gosec & nilaway for Security and Nil Safety Writing Custom go/analysis Analyzers gopls & Analysis Tooling Best Practices

Go Testing Culture: Simple, Fast, Table-Driven Go Testing Basics Table-Driven Tests & Subtests testify, httptest & Test Doubles Examples as Executable Documentation Benchmarks with testing.B & B.Loop Fuzz Testing with testing.F Coverage, Race Detector & Golden Files Testing Best Practices

Go Code Quality: Opinionated by Design Code Quality Basics gofmt & goimports Enforcement go vet & Common Analyzer Diagnostics golangci-lint Configuration Pre-commit Hooks & Review Checklists CI Quality Gates: Lint, Test, Race, Vuln Code Review Standards for Go Teams Linting & Code Quality Best Practices

Effective Go as a Living Standard Go Rules Quickstart Effective Go Rules Checklist API Design Rules for Go Libraries Concurrency Rules Checklist Module & Dependency Rules Security Rules for Go Services Performance Rules: When to Optimize Go Rules & Best Practices Summary

Architecture, Patterns & Debugging

Architecture in Go: Small Interfaces, Explicit Dependencies Go Architecture Basics Monolith vs Microservices in Go Clean & Hexagonal Architecture in Go Handler-Service-Repository Layering Dependency Injection: wire, dig & Manual Wiring Architecture Decision Records for Go Teams Refactoring & Architecture Audit Checklist Architecture & Design Best Practices

Go Idioms: Composition Over Inheritance Go Patterns Basics Functional Options Pattern Constructor Functions & Package APIs Repository & Service Layer Patterns Middleware & Decorator Patterns sync.Once & Singleton Patterns Common Anti-Patterns in Go Codebases Go Patterns & Idioms Best Practices

Debugging Go: Observable Failures and Sharp Edges Go Debugging Basics Nil Interface vs Nil Pointer Defect Walkthrough Slice Header Copy & Append Surprise Range Variable & Goroutine Closure Bugs Time Zone & time.Parse Gotchas Goroutine Leaks & Missing Context Cancellation Data Race Scenarios & race Detector Fixes Debugging & Defect Scenarios Best Practices

Concurrency, Generics & Runtime

Concurrency in Go: Goroutines and Channels First Concurrency Basics Goroutines: Creation Cost & Scheduling Overview Channels: Buffered, Unbuffered & Closing Rules select Statement & Default Cases sync.Mutex, RWMutex & WaitGroup sync.Once, Cond, Pool & sync.Map Race Detector: Running and Interpreting Output Concurrency Fundamentals Best Practices

Production Concurrency: Patterns Beyond Hello Goroutine Advanced Concurrency Basics Worker Pools & Task Queues Fan-In, Fan-Out & Pipeline Stages Rate Limiting & Backpressure errgroup & golang.org/x/sync Extensions sync/atomic Operations Avoiding Goroutine Leaks & Channel Deadlocks Advanced Concurrency Best Practices

context.Context: Cancellation as a First-Class API context Basics Cancellation Propagation in HTTP Handlers Deadlines & Timeouts Across Service Boundaries context Values: When and When Not context in database/sql & gRPC Testing Code That Accepts context.Context Context Misuse Anti-Patterns context Package Best Practices

Generics in Go: Constraints Without Templates Generics Basics Type Parameters & Constraint Interfaces Type Sets & the comparable Constraint Generic Data Structures: Sets, Queues, Maps Generic Algorithms: slices, maps & cmp Packages Performance Implications of Generics When to Avoid Generics in Go APIs Generics Best Practices

Reflection vs Code Generation in Go Reflection Basics Struct Tags & Custom Tag Parsing Deep Equality & Kind Switches ORM & Serializer Reflection Costs go generate & stringer Building Custom Code Generators go:fix inline & API Migration Directives Reflection & Code Generation Best Practices

Beyond the Spec: Embed, Build Modes, and Assembly Advanced Language Features Basics //go:embed for Files and Templates Build Constraints & Platform-Specific Files Assembly in Go (*.s files)Linker Flags & buildmode Options Plugin Packages & Dynamic Loading Compiler Directives: //go:noinline, linkname & go:fix inline Advanced Language Features Best Practices

CGO: Crossing the Go-C Boundary CGO Basics Calling C from Go & Exporting Go to C CGO Performance & Scheduler Interactions syscall & Pure-Go Alternatives to CGO FFI Safety: Pointers, C.CString & Free WebAssembly Overview (see WebAssembly & TinyGo section)Interop Decision Guide: CGO vs RPC vs Rewrite CGO & Interoperability Best Practices

The Go Runtime: Scheduler, GC, and Memory Runtime Basics Garbage Collector: Tri-Color Mark-Sweep & Pacing Green Tea GC & GOEXPERIMENT Flags (Go 1.26)Escape Analysis & Stack vs Heap Allocation GOGC, GOMEMLIMIT & Finalizers Goroutine Stacks & Stack Growth Memory Leaks in Go: Common Causes Runtime & GC Best Practices

Web, Data & Production Services

net/http: Go's Batteries-Included HTTP Stack net/http Basics HTTP Servers, Handlers & ServeMux Patterns HTTP Clients, Transport & Connection Pooling Middleware Chains & Request Context HTTP/2, Timeouts & ReverseProxy httptest for Handler Integration Tests Production net/http Configuration Checklist net/http Best Practices

Go HTTP Frameworks: Routers vs Full Frameworks Web Frameworks Basics chi: Lightweight Routing & Middleware gorilla/mux: Regex Routes & Host Matching Gin: Fast JSON APIs & Binding Echo: Middleware Ecosystem & Context Wrapper Framework Selection Decision Guide Migrating Between Routers Without Rewriting Handlers Web Frameworks Best Practices

gRPC in Go: Contracts, Streaming, and Performance gRPC Basics Protocol Buffers Schema Design Unary, Streaming & Bidirectional RPCs gRPC Middleware, Interceptors & Metadata gRPC Error Codes & Status Mapping REST vs gRPC Trade-off Guide gRPC Gateway & JSON Transcoding gRPC Best Practices

Data Access in Go: database/sql as the Foundation Databases Basics database/sql Connection Pooling & Timeouts Transactions, Prepared Statements & sql.Tx GORM vs sqlx vs Raw database/sql Migrations with golang-migrate & goose Redis Caching & NATS/Kafka Messaging embed for SQL Migrations & Seed Data Databases & Data Access Best Practices

Serialization in Go: JSON First, Formats on Demand Serialization Basics encoding/json Custom Marshaling encoding/xml, gob & Binary Formats Struct Tags for JSON, DB & Validation Schema Evolution & Unknown Field Handling High-Performance JSON: jsoniter & sonic Alternatives Validation with go-playground/validator Serialization Best Practices

CLI Design in Go: Single Binary, Fast Startup CLI Tools Basics flag Package & POSIX-Style Flags cobra & urfave/cli Command Trees kingpin & Advanced CLI UX Configuration: Viper, Env & Config Files bubbletea Terminal UI & Progress Bars Color Output & User-Friendly Errors CLI Tools Best Practices

Production Go: Logs, Metrics, Traces, and Signals Observability Basics Structured Logging with slog Prometheus Metrics & RED/USE Dashboards OpenTelemetry Tracing in Go Services Health, Readiness & Liveness Probes Graceful Shutdown & Signal Handling Configuration Management: Env, Flags & Viper Observability Best Practices

Security for Go Services: Defaults and Gaps Go Security Basics crypto/tls Configuration & Certificate Management Input Validation & Safe HTML/JSON Handling Authentication & Authorization Patterns Rate Limiting, CORS & Security Headers Secure Cookies & CSRF for Web Apps Dependency Scanning with govulncheck & SBOM Security Best Practices Summary

Performance, Stdlib & Ecosystem

Performance in Go: Measure, Profile, Then Optimize Performance Basics CPU & Heap Profiling with pprof trace & Execution Tracer Escape Analysis & Compiler Optimizations Slice Preallocation, strings.Builder & map Pre-sizing Profile-Guided Optimization (PGO)GC Tuning for Latency-Sensitive Services Performance Best Practices

The Go Standard Library: Batteries Included Standard Library Basics os, io, bufio & path/filepath time, timezones & context Integration crypto/*, compress & math/rand/v2 log, regexp & text/template runtime, debug & pprof Packages database/sql & net Package Family Overview Standard Library Best Practices

The Go Ecosystem: Small, Focused Libraries Essential Libraries Basics Logging: zap vs zerolog vs slog Configuration with viper & envconfig Testing with testify & mockery Dependency Injection with google/wire Validation, migrate & sqlc Prometheus & OpenTelemetry Client Libraries Essential Go Libraries Best Practices

Deploying Go: Single Binary as a Superpower Deployment Basics Multi-Stage Docker Builds for Go Kubernetes Deployments, Services & Ingress Probes, HPA & Pod Disruption Budgets CI/CD Pipelines for Go Services Chaos Engineering Hooks for Go Microservices Single-Binary Edge & Air-Gapped Deployments Deployment Best Practices

Why Go Dominates the Kubernetes Operator Ecosystem Kubernetes Operators Basics controller-runtime Manager, Client & Scheme Writing a Reconciler: ctrl.Request & Reconcile Loop CRD Design & kubebuilder Scaffolding Watches, Predicates, Owner References & Finalizers Admission Webhooks: Validating & Mutating in Go Operator Testing with envtest & fake client Leader Election, Metrics & Operator Observability OLM Bundles, Upgrades & Multi-Tenant RBAC Kubernetes Operators Best Practices

Go on WebAssembly: Browser, WASI, and Embedded Paths WebAssembly & TinyGo Basics Compiling with GOOS=wasip1 GOARCH=wasm syscall/js: Go in the Browser WASI Host Runtimes: wasmtime, wazero & Spin TinyGo for Microcontrollers & Constrained WASM WASM Size Optimization: TinyGo vs gc WASM Go 1.26 WASM Runtime & Memory Improvements Native Go vs TinyGo vs Rust WASM Decision Guide WebAssembly & TinyGo Best Practices

Go in the Cloud: Lambda, Cloud Run, and Beyond Cloud Deploy Basics AWS Lambda Custom Runtime & provided.al2023 GCP Cloud Run & AWS Fargate Patterns Azure Functions & Container Apps for Go Secrets, IAM & Workload Identity S3/GCS SDK Patterns with aws-sdk-go-v2 Serverless Go Architecture Decision Guide Cloud & Serverless Best Practices

Agent Skills for Go Teams Agent Skills Basics Go Concurrency Review Skill Go Module & Security Audit Skill Go Performance Profiling Skill Go API Design Review Skill Go Testing & Benchmark Skill Go Kubernetes Operator Review Skill WASM & TinyGo Build Review Skill Agent Skills Best Practices

Git for Go Teams Git Basics for Go Projects Branching Strategies & Trunk-Based Flow Rebasing, Cherry-Pick & Worktrees GitHub Actions for Go Repos Code Review with GitHub PRs Signed Tags & Go Module Releases Monorepo Git Patterns with go work Git & GitHub Best Practices

Linux CLI Skills for Go Engineers Linux CLI Basics Go Toolchain on Linux: Install & Version Switching Build, Test & Profile from the Shell Search, ripgrep & jq for Debugging systemd & Service Unit Files for Go Binaries Containers from the CLI: docker & kubectl Shell Productivity: tmux, fzf & direnv Linux CLI Best Practices

Onboarding Go Specialists Team Onboarding Basics Go SME Onboarding Checklist (30/60/90)Effective Go Reading Path Pairing & Mob Sessions for Go Teams Code Review Culture for Go Leveling Guide: Junior to Staff in Go Documentation & godoc Conventions Team & Onboarding Best Practices

Tech-Lead Craft: Delivery, Leadership & Longevity

Incident Response for Go Services Production Troubleshooting Basics Live CPU & Heap Profiling Under Incident Load Goroutine Dump & Leak Profile Analysis OOM, GC Storm & Latency Spike Playbooks Database Connection Pool Exhaustion Post-Mortem Template for Go Incidents On-Call Handoff Checklist for Go Platforms Production Troubleshooting Best Practices

Shipping Go Services Safely at Enterprise Scale Enterprise Delivery Basics Release Strategy: Blue-Green & Canary for Go Feature Flags in Go Services Rollback Runbooks for Go Deployments DORA Metrics for Go Teams Progressive Delivery & Automated Verification Change Management & Compliance Gates Enterprise Delivery Best Practices

Technical Leadership in Go Teams Tech Leadership Basics Writing ADRs for Go Architecture Decisions Design Reviews for Go Services Mentoring Go Developers Across Experience Levels Handling Technical Disagreements on Go Teams Tech Debt Backlogs for Go Codebases Staff Engineer Path in Go Organizations Technical Leadership Best Practices

Tech Leads Bridge Engineering and the Business Stakeholder Collaboration Basics From Requirements to Go Service Specs Estimating Go Work: Modules, Risk & Unknowns Prioritizing Features vs Platform Work in Go Communicating Go Trade-offs to Non-Go Stakeholders Risk Registers for Go Migration Projects Release Notes for Internal Go Platform Changes Stakeholder Collaboration Best Practices

Learning from Production Go Systems Case Studies Basics Reference Build: Cloud-Native REST Microservice Reference Build: High-Throughput gRPC Data Plane Reference Build: Production CLI with cobra Reference Build: Kubernetes Operator End-to-End Reference Build: WASI Edge Module with wazero Host Before/After: Refactoring a God Package Benchmark Case Study: JSON API Latency Case Studies Best Practices

Go Community & Long-Term Craft Community & Governance Basics Official Resources: go.dev, pkg.go.dev & Go Blog GopherCon, Meetups & Proposal Tracking Contributing to Go Toolchain & Stdlib Coding Standards & Doc Conventions for Teams Dependency Governance & License Compliance Future-Proofing: Proposals, Experiments & Roadmap Standards, Governance & Community Best Practices

/

/

© 2026 @csjcode|SystemsArchitect.io: Cloud Systems Tools|Terms

An independent, unofficial educational resource. Not affiliated with, endorsed, or sponsored by the brand/trademark maintainers/owners.

Search Documentation

Search across all documentation pages

Go SME/Tags/Adr

#Adr2 pages

Pages tagged Adr across 2 sections.

Architecture Decision Records for Go Teams

Tech Leadership

Writing ADRs for Go Architecture Decisions

Related tags

Go List Ranked Decision