swe-programming-golanglisted

# Go Coding Standards ## Purpose Progressive disclosure of Go coding standards for agents writing Go code. **Authoritative Source**: [docs/explanation/software-engineering/programming-languages/golang/README.md](../../../docs/explanation/software-engineering/programming-languages/golang/README.md) **Usage**: Auto-loaded for agents when writing Go code. Provides quick reference to idioms, best practices, and antipatterns. ## Prerequisite Knowledge **IMPORTANT**: This skill provides **demo-specific style guides**, not educational tutorials. **You MUST understand Go fundamentals before using these standards.** Complete the demo Go learning path first: **What this skill covers**: demo naming conventions, framework choices, repository-specific patterns, how to apply Go knowledge in THIS codebase. **What this skill does NOT cover**: Go syntax, language fundamentals, generic patterns (those are in crud-fs-ts-nextjs). ## Quick Standards Reference ### Naming Conventions **Packages**: lowercase, single word - `http`, `json`, `user`, `payment` - Avoid underscores **Types and Functions**: MixedCaps - Exported: `UserAccount`, `CalculateTotal()` - Unexported: `userAccount`, `calculateTotal()` **Variables**: Short names in limited scope - `i`, `j` for loop counters - `r` for reader, `w` for writer - Descriptive names for package-level: `defaultTimeout` **Constants**: MixedCaps (not UPPER_CASE) - `MaxRetries`, `DefaultTimeout` ### Modern Go Features (Go 1.18+) **Generics