go-development-guidelines

name	go-development-guidelines
description	Use this skill when writing or refactoring Go code to ensure adherence to project standards regarding code organization, error handling, concurrency, performance, and style.

Go Development

Clean, efficient, idiomatic Go.

Instructions

Code Organization

• Standard Layout.
• Meaningful, single-responsibility packages.
• Interfaces near usage.

CLI Apps

• cobra + pflag.
• cmd/ directory.
• Verbose binary name (NO server).

Error Handling

• Check errors.
• Short, descriptive messages.
• NO "failed"/"error" prefix.
• Log ONCE at boundary.
• errors.Is/errors.As.
• Wrap: fmt.Errorf("do: %w", err).
• NO panic.

Concurrency

• Judicious goroutines.
• Sync: Mutex/Channel.
• Context cancellation/timeouts.
• Watch race conditions.
• Be mindful of goroutine leaks.

Performance

• Profile first. Benchmark.
• Watch allocations.

Style

• gofmt / goimports.
• golangci-lint.
• Explicit > Implicit.
• Short functions.
• Comments: Why > What.
• CamelCase.