CLAUDE.md

Project Context

Go API service using chi router, sqlc for queries, and Docker for deployment.

Architecture

• Clean architecture: handlers → services → repositories
• All errors wrap with fmt.Errorf and %w
• Context propagation required on all service methods

Code Style

• Follow Effective Go and Go Proverbs
• Table-driven tests
• No init() functions
• Exported types need godoc comments

Testing

• go test ./... before committing
• Integration tests use testcontainers
• Mock external services with interfaces

Deployment

• Multi-stage Docker builds
• Health check at /healthz
• Graceful shutdown with signal handling