.claude/rules/linting.md
raw| 1 | --- |
| 2 | paths: |
| 3 | - "**/*.go" |
| 4 | --- |
| 5 | |
| 6 | # Linting conventions (go-openapi) |
| 7 | |
| 8 | ```sh |
| 9 | golangci-lint run |
| 10 | ``` |
| 11 | |
| 12 | Config: `.golangci.yml` — posture is `default: all` with explicit disables. |
| 13 | See `docs/STYLE.md` for the rationale behind each disabled linter. |
| 14 | |
| 15 | Key rules: |
| 16 | - Every `//nolint` directive **must** have an inline comment explaining why. |
| 17 | - Prefer disabling a linter over scattering `//nolint` across the codebase. |