go-coding-standards

Use the standard layout with cmd/ for entry points, internal/ for private domain packages like auth and user, and pkg/ for reusable components. Initialize with go mod init and keep dependencies tidy with go mod tidy.

Return errors explicitly and wrap them with context using fmt.Errorf and the %w verb. Define sentinel errors with errors.New, then check them with errors.Is and extract custom error types with errors.As.

Enable gofmt, goimports, govet, errcheck, staticcheck, unused, gosec, ineffassign, misspell, and revive. The provided .golangci.yml configures these with shadow checking, medium gosec severity, and a five-minute run timeout.

Define a slice of anonymous structs holding test name, inputs, and expected output, then loop over them calling t.Run for each case. This pattern scales well and integrates with go test -cover and -bench flags.

Use goroutines with channels for worker pools and pipelines where data flows between stages. Use sync.WaitGroup to coordinate completion and sync.Pool to reuse buffers, and always propagate cancellation via context.Context.