TL;DR

이 레포지토리는 AI coding agent가 오래된 Go 작성 습관 대신 프로젝트의 Go 버전에 맞는 최신 문법과 표준 라이브러리를 선택하도록 하는 JetBrains 공식 plugin-extension-skill입니다. 에이전트가 go.mod를 읽어 사용 가능한 기능 범위를 정하고, max와 slices.Contains 같은 현대적 관용구를 코드 생성 과정에 적용합니다. Junie, Claude Code, Codex, Cursor와 skills.sh를 통한 다른 에이전트에서 설치할 수 있으며 첫 사용 시 Go CLI를 로컬 cache에 설치하지만 프로젝트 파일은 바꾸지 않습니다. Go 1.25 이상이 기본 대상이므로 Go 프로젝트에서 AI 생성 코드의 구식 패턴을 줄이고 싶은 팀에 적합하지만 일반 Go 프로그램에서 직접 호출하는 library는 아닙니다.

핵심 포인트

• 이 레포지토리는 독립 실행형 도구가 아니라 AI 코딩 에이전트용 plugin-extension-skill입니다. Junie, Claude Code, Codex, Cursor에 설치하는 Go 전용 guidelines 패키지이며 skills.sh를 통해 다른 에이전트에도 연결됩니다. Go 프로젝트의 새 코드를 더 현대적인 관용구로 작성하게 만드는 목적이므로 일반 애플리케이션 개발자가 직접 import하는 library는 아닙니다.
• 에이전트는 프로젝트의 go.mod에서 Go 버전을 감지한 뒤 해당 버전까지 사용할 수 있는 언어 기능과 표준 라이브러리 추가 사항을 선택합니다. 예를 들어 조건문 대신 max(a, b), 수동 순회 대신 slices.Contains, nil 검사 연결 대신 cmp.Or(a, b, c)를 사용하도록 유도합니다. Go 1.0부터 Go 1.27까지의 주요 기능과 modernize analyzer가 겨냥하는 패턴을 새 코드 작성 단계에서 반영하는 방식입니다.
• 설치는 각 에이전트의 marketplace 또는 plugin 명령으로 진행하며 Junie, Claude Code, Codex, Cursor에서는 Go 작업과 관련될 때 skill이 자동으로 호출됩니다. Claude Code에서는 /modern-go-guidelines:use-modern-go로 명시 호출할 수 있고, 다른 에이전트는 npx skills add JetBrains/go-modern-guidelines로 설치합니다. 설치된 CLI는 첫 사용 때 go install로 로컬 cache에 들어가며 프로젝트 파일은 수정하지 않습니다.
• 사용하려면 Go toolchain이 PATH에 있어야 하고 CLI는 Go 1.25 이상을 대상으로 합니다. 더 오래된 Go에서도 GOTOOLCHAIN=auto가 활성화되어 있으면 호환 toolchain을 내려받아 실행할 수 있습니다. CLI를 수정하려는 개발자는 make dev-install과 GO_MODERN_GUIDELINES_DEV=1을 사용해 로컬 build를 cache에 연결할 수 있으며 Windows에서는 제공된 sh 또는 PowerShell 스크립트를 직접 실행할 수 있습니다.