Mandatory gofmt Formatting

This rule applies to files matching the patterns above.

# Mandatory gofmt Formatting

## Rule
ALL Go code MUST be formatted with `gofmt` (or `goimports` which includes gofmt). CI MUST reject code that is not gofmt-compliant. No project-specific style overrides.

## Format
```bash
# Format a file
gofmt -w main.go

# Format entire project
gofmt -w .

# Check without modifying (CI)
gofmt -l .  # Lists unformatted files
test -z "$(gofmt -l .)"  # Exit 1 if any unformatted

# goimports = gofmt + import organization
goimports -w .
```

## Good: Just Run gofmt
```go
// gofmt handles all formatting decisions:
// - Tabs for indentation
// - Alignment of struct fields
// - Spacing around operators
// - Brace placement
// - Import grouping (with goimports)

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/myorg/myapp/internal/user"
    "github.com/myorg/myapp/internal/order"
)

type Config struct {
    Host    string
    Port    int
    Timeout time.Duration
}
```

## Bad: Fighting gofmt
```go
// BAD: Manually formatted — gofmt will rewrite this
package main
import (
  "fmt"      // 2-space indent — gofmt uses tabs
  "log"
)

type Config struct {
  Host string    // 2-space indent
  Port int
}
```

## Editor Setup
```json
// VS Code settings.json
{
  "[go]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "golang.go"
  },
  "go.formatTool": "goimports"
}
```

## Enforcement
- CI: `test -z "$(gofmt -l .)" || (echo "Run gofmt" && exit 1)`
- Pre-commit hook: run gofmt on staged .go files
- Editor: format on save with goimports
- golangci-lint includes gofmt check by default