diff --git a/.github/workflows/go.yml b/.github/workflows/go.yml
index 0c977dc..78c2c92 100644
--- a/.github/workflows/go.yml
+++ b/.github/workflows/go.yml
@@ -26,7 +26,7 @@ jobs:
       run: |
         go mod download
         # Install golangci-lint.
-        curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.64.8
+        curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/v2.12.2/install.sh | sh -s -- -b $(go env GOPATH)/bin v2.12.2
 
     - name: Check gofmt
       run: |
diff --git a/AGENTS.md b/AGENTS.md
index 373b77c..3c39118 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,7 @@ GoBatch is a Go library for batch data processing. It provides infrastructure fo
 - Run tests with race detection and coverage: `go test -race -coverprofile=coverage.txt -covermode=atomic ./...`
 - Basic lint: `go vet ./...`
 - Full lint: `golangci-lint run --timeout=3m`
+- Install golangci-lint (v2.12.2, matching CI): `curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/v2.12.2/install.sh | sh -s -- -b $(go env GOPATH)/bin v2.12.2`
 
 ## Code Standards
 - Follow Go best practices and idiomatic Go patterns
diff --git a/CLAUDE.md b/CLAUDE.md
index 441bfc0..ddc25b4 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,6 +14,7 @@ GoBatch is a Go library for batch data processing. It provides infrastructure fo
 - Run tests with race detection and coverage: `go test -race -coverprofile=coverage.txt -covermode=atomic ./...`
 - Basic lint: `go vet ./...`
 - Full lint: `golangci-lint run --timeout=3m`
+- Install golangci-lint (v2.12.2, matching CI): `curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/v2.12.2/install.sh | sh -s -- -b $(go env GOPATH)/bin v2.12.2`
 
 ## Code Standards
 - Follow Go best practices and idiomatic Go patterns