Go Development Patterns
Required Workflow
For reviews, invoke related skills: security-audit (OWASP), enterprise-readiness (OpenSSF/SLSA), github-project (branch protection).
Core Principles
Type Safety
- Avoid:
interface{} (use any), sync.Map, scattered type assertions, reflection
- Prefer: Generics
[T any], errors.AsType[T] (Go 1.26), concrete types
- Run
go fix ./... after upgrades
Consistency
- One pattern per problem domain
- Match existing codebase patterns
- Refactor holistically or not at all
- Config precedence: defaults < config file < env vars < flags
Testing
- Build tags isolate test tiers: unit (default),
integration, e2e
- Always use
t.Parallel(), t.Helper(), table-driven subtests
- Use
log/slog directly -- never wrap it in custom Logger interfaces
Conventions
- Naming: ID, URL, HTTP (not Id, Url, Http) — not tool-enforced (ST1003 is off by default)
- Error wrapping:
fmt.Errorf("failed to process: %w", err)
References
Git hooks: ls lefthook.yml 2>/dev/null && lefthook install || echo "Add lefthook — see references/lefthook-template.md"
Load as needed:
| Reference |
Purpose |
references/architecture.md |
Package structure, state mutation completeness |
references/logging.md |
Structured logging with log/slog, migration from logrus |
references/cron-scheduling.md |
go-cron patterns: named jobs, runtime updates, resilience |
references/resilience.md |
Pointer to go-cron's built-in retry/circuit-breaker/timeout wrappers |
references/docker.md |
Docker client patterns, buffer pooling |
references/ldap.md |
LDAP/Active Directory integration |
references/testing.md |
Build tags, resource isolation, race gotchas |
references/linting.md |
golangci-lint v2, staticcheck |
references/api-design.md |
Enum/status defensive handling |
references/fuzz-testing.md |
Go fuzzing patterns, security seeds |
references/contracts-and-invariants.md |
Contracts, invariants, property tests |
references/mutation-testing.md |
Gremlins configuration, test quality measurement |
references/makefile.md |
Standard Makefile interface for CI/CD |
references/modernization.md |
Go 1.26 modernizers, go fix, errors.AsType[T] |
references/dependencies.md |
Upgrades: go get -u all, majors, build-set scoping |
references/lefthook-template.md |
Ready-to-use lefthook.yml for Go project git hooks |
references/branch-protection.md |
Ruleset watermark: three-ruleset gate, bypass modes |
references/reusable-workflows.md |
Reusable Actions workflow callers, permission propagation, release-gate outputs |
references/single-build-release.md |
Single-build release: cross-compile once, reuse for release+container |
references/awesome-go-submission.md |
awesome-go submission: CI-parsed PR body, name collisions |
Quality Gates
Run before completing any review:
golangci-lint run --timeout 5m # Linting
go vet ./... # Static analysis
staticcheck ./... # Additional checks
govulncheck ./... # Vulnerability scan
go test -race ./... # Race detection
Stdlib Vulnerability Fixes
When govulncheck reports stdlib vulnerabilities: check fix version via vuln.go.dev, update go X.Y.Z in go.mod, run go mod tidy.
Contributing: Submit improvements to https://github.com/netresearch/go-development-skill
1---2name: go-development3description: "Use when developing Go applications, implementing job schedulers or cron (netresearch/go-cron, ofelia), Docker API integrations, LDAP/AD clients, building resilient services with retry logic, setting up Go test suites (unit/integration/fuzz/mutation), or running golangci-lint."4license: "(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0"5compatibility: "Requires go 1.21+, golangci-lint, docker."6metadata:7 source: https://skillmd.com/skills/netresearch/go-development8 author: Netresearch DTT GmbH9 version: "1.15.3"10 repository: https://github.com/netresearch/go-development-skill11allowed-tools: Bash(go:*) Bash(make:*) Bash(docker:*) Bash(golangci-lint:*) Read Write Glob Grep12---1314# Go Development Patterns1516## Required Workflow1718**For reviews, invoke related skills:** security-audit (OWASP), enterprise-readiness (OpenSSF/SLSA), github-project (branch protection).1920## Core Principles2122### Type Safety2324- **Avoid:** `interface{}` (use `any`), `sync.Map`, scattered type assertions, reflection25- **Prefer:** Generics `[T any]`, `errors.AsType[T]` (Go 1.26), concrete types26- Run `go fix ./...` after upgrades2728### Consistency2930- One pattern per problem domain31- Match existing codebase patterns32- Refactor holistically or not at all33- Config precedence: defaults < config file < env vars < flags3435### Testing3637- Build tags isolate test tiers: unit (default), `integration`, `e2e`38- Always use `t.Parallel()`, `t.Helper()`, table-driven subtests39- Use `log/slog` directly -- never wrap it in custom Logger interfaces4041### Conventions4243- Naming: ID, URL, HTTP (not Id, Url, Http) — not tool-enforced (ST1003 is off by default)44- Error wrapping: `fmt.Errorf("failed to process: %w", err)`4546## References4748Git hooks: `ls lefthook.yml 2>/dev/null && lefthook install || echo "Add lefthook — see references/lefthook-template.md"`4950Load as needed:5152| Reference | Purpose |53|-----------|---------|54| `references/architecture.md` | Package structure, state mutation completeness |55| `references/logging.md` | Structured logging with log/slog, migration from logrus |56| `references/cron-scheduling.md` | go-cron patterns: named jobs, runtime updates, resilience |57| `references/resilience.md` | Pointer to go-cron's built-in retry/circuit-breaker/timeout wrappers |58| `references/docker.md` | Docker client patterns, buffer pooling |59| `references/ldap.md` | LDAP/Active Directory integration |60| `references/testing.md` | Build tags, resource isolation, race gotchas |61| `references/linting.md` | golangci-lint v2, staticcheck |62| `references/api-design.md` | Enum/status defensive handling |63| `references/fuzz-testing.md` | Go fuzzing patterns, security seeds |64| `references/contracts-and-invariants.md` | Contracts, invariants, property tests |65| `references/mutation-testing.md` | Gremlins configuration, test quality measurement |66| `references/makefile.md` | Standard Makefile interface for CI/CD |67| `references/modernization.md` | Go 1.26 modernizers, `go fix`, `errors.AsType[T]` |68| `references/dependencies.md` | Upgrades: `go get -u all`, majors, build-set scoping |69| `references/lefthook-template.md` | Ready-to-use lefthook.yml for Go project git hooks |70| `references/branch-protection.md` | Ruleset watermark: three-ruleset gate, bypass modes |71| `references/reusable-workflows.md` | Reusable Actions workflow callers, permission propagation, release-gate outputs |72| `references/single-build-release.md` | Single-build release: cross-compile once, reuse for release+container |73| `references/awesome-go-submission.md` | awesome-go submission: CI-parsed PR body, name collisions |7475## Quality Gates7677Run before completing any review:7879```bash80golangci-lint run --timeout 5m # Linting81go vet ./... # Static analysis82staticcheck ./... # Additional checks83govulncheck ./... # Vulnerability scan84go test -race ./... # Race detection85```8687## Stdlib Vulnerability Fixes8889When `govulncheck` reports stdlib vulnerabilities: check fix version via `vuln.go.dev`, update `go X.Y.Z` in `go.mod`, run `go mod tidy`.9091---9293> **Contributing:** Submit improvements to https://github.com/netresearch/go-development-skill