Stack Go

2. Project Structure

cmd/
├── server/              # Main application entry
│   └── main.go
├── cli/                 # CLI tool entry
│   └── main.go
internal/                # Private application code
├── config/
├── handlers/            # HTTP handlers
├── services/            # Business logic
├── repositories/        # Data access
├── models/              # Domain types
└── middleware/
pkg/                     # Public reusable packages
├── logger/
└── httputil/
tests/
├── integration/
└── e2e/
go.mod
go.sum
Makefile

3. Quality Gates

See references/go-quality-gates.md for full configuration.

Quick Reference

go vet ./...              # Static analysis
golangci-lint run         # Comprehensive linting
go test ./...             # Test
go test ./... -race       # Test with race detector
go build ./...            # Build check

4. Key Principles

1. Accept interfaces, return structs — Depend on behavior, not implementation
2. Errors are values — Handle explicitly; wrap with fmt.Errorf("...: %w", err)
3. Small interfaces — Prefer 1-2 method interfaces
4. Package by feature — Group by domain, not by layer
5. context.Context first — Pass as first parameter for cancellation and deadlines
6. No globals — Use dependency injection via constructors
7. Table-driven tests — Standard Go testing pattern

5. Integration with Core Skills