cemezgin/go-service-guide

architecture

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

concurrency

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

go-style

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

observability

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

patterns

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

testing

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