go-service-guide

Clean/hexagonal architecture rules, folder structure, interface ownership, and dependency direction. Use when creating new packages, services, or understanding codebase structure.

Goroutine ownership, errgroup patterns, worker pools, and graceful shutdown. Use when writing concurrent code or parallel request handling.

Uber Go style guide rules for guidelines, performance, and code style. Use when writing or reviewing Go code for style compliance.

Tracing with OpenTelemetry and structured logging with slog. Use when adding observability to services, handlers, or debugging production issues.

Project patterns including functional options, must pattern, caching decorator, error handling, configuration, and HTTP clients. Use when implementing common patterns in the codebase.

Testing patterns including table-driven tests, mock setup, and coverage requirements. Use when writing tests or setting up test infrastructure.