spazio-backend

Testing strategy and implementation skill for the Spazio backend (Go + Gin + pgx/v5 + sqlc + Cloudflare R2). Use this skill whenever the user wants to: write tests for any Spazio module, analyze test coverage gaps, plan a testing strategy for a handler/service/repository, create table-driven tests, mock interfaces defined in model.go, or test Gin HTTP handlers with httptest. Triggers on: "write tests for", "add tests", "test coverage", "unit test", "mock this", "test the service", "test the handler", "gap analysis", or any request involving testing a vertical slice module (handler.go / service.go / repository.go / model.go).

Documents Spazio Backend REST API endpoints with Swagger/OpenAPI annotations for Go + Gin. Use this skill whenever the user asks to document a handler, add Swagger annotations, write @Summary/@Param/@Success comments for Gin, generate module documentation, or update the OpenAPI contract for any backend endpoint. Also applies when swaggo, gin-swagger, swag generate, or any task related to keeping documentation in sync with code changes is mentioned.

Best practices for structuring, writing, and refactoring Go backend modules using a vertical slice architecture with Gin and pgx/sqlc. Use this skill whenever the user is creating a new module, refactoring an existing one, reviewing Go backend code, or asking about handler/service/repository patterns in Go. Trigger even for partial tasks like "add a new endpoint", "split this use case", or "clean up this handler".

Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with generics, interfaces, and robust error handling. Use when building Go applications requiring concurrent programming, microservices architecture, or high-performance systems. Invoke for goroutines, channels, Go generics, gRPC integration, CLI tools, benchmarks, or table-driven testing.