AI 코딩 에이전트가 최신 Go 문법을 자연스럽게 쓰게 만드는 기준표
AI가 작성한 Go 코드가 구식 문법으로 가득 차서 매번 손으로 고쳐야 하는 상황을 끝냅니다. 이 저장소는 AI 에이전트가 Go 1.0부터 1.27까지의 최신 기능을 알아서 활용하도록 돕는 가이드라인 모음입니다. 에이전트가 프로젝트의 Go 버전을 확인하고, 해당 버전에서 쓸 수 있는 현대적인 문법과 표준 라이브러리 기능을 우선적으로 선택하게 만듭니다.
왜 AI는 구식 Go를 쓰는가
AI 코딩 에이전트가 구식 Go 코드를 생성하는 이유는 두 가지입니다. 첫째, 학습 데이터의 시차입니다. 모델이 학습된 시점 이후에 추가된 기능은 알지 못합니다. 예를 들어 Go 1.26에서 도입된 errors.AsType[T]는 학습 데이터에 없으면 사용할 수 없습니다. 둘째, 빈도 편향입니다. 학습 데이터에 for i := 0; i < n; i++ 같은 구식 패턴이 더 많기 때문에, 모델이 최신 문법을 알더라도 구식 패턴을 선택할 가능성이 높습니다. 이 가이드라인은 에이전트에게 명시적인 참고 자료를 제공하여 이 두 문제를 해결합니다. Go 팀의 modernize 분석기가 기존 코드를 최신 문법으로 업데이트하는 것과 같은 목표를 공유하며, 새 코드부터 현대적인 Go를 쓰게 하여 나중에 고칠 일이 줄도록 합니다.
에이전트가 적용하는 현대적 문법
가이드라인은 Go 1.0부터 1.27까지의 유용한 기능을 포함하며, modernize 분석기가 다루는 모든 항목을 커버합니다. 에이전트는 go.mod 파일에서 프로젝트의 Go 버전을 감지하고, 그 버전까지 사용 가능한 언어 기능과 표준 라이브러리 추가 항목을 활용합니다. 예를 들어 if-else 블록 대신 max(a, b)를, 수동 루프 대신 slices.Contains를, nil 체크 연쇄 대신 cmp.Or(a, b, c)를 사용합니다. 또한 new(42)로 값의 포인터를 얻거나, 타입 안전한 에러 매칭을 위해 errors.AsType[T](err)를 사용하는 등 최신 기능을 자연스럽게 적용합니다. 자세한 기능 목록과 예제는 FEATURES.md 파일에서 확인할 수 있습니다.
지원 에이전트별 설치 방법
이 가이드라인은 Junie, Claude Code, Codex, Cursor를 지원하며, skills.sh를 통해 다른 에이전트에도 적용할 수 있습니다. 각 에이전트에서 마켓플레이스에 저장소를 추가하고 플러그인을 설치하는 명령어가 다릅니다. Junie CLI에서는 /extensions marketplace add와 /extensions install 명령을 사용합니다. Cursor는 터미널에서 마켓플레이스를 추가한 뒤 세션 내에서 /plugins 명령으로 설치합니다.
실행 환경과 개발자용 설정
마켓플레이스 통합은 첫 사용 시 go install로 작은 CLI를 설치합니다. 따라서 Go 툴체인이 설치되어 있고 PATH에 포함되어 있어야 합니다. CLI는 로컬 캐시(예: ~/.cache/go-modern-guidelines)에 설치되며 프로젝트 파일을 수정하지 않습니다. Go 1.25 이상을 대상으로 하지만, 자동 툴체인 전환(GOTOOLCHAIN=auto)이 활성화되어 있으면 더 오래된 Go 버전에서도 실행됩니다. 이 변수가 설정되면 에이전트는 릴리스 버전 대신 로컬 빌드를 사용합니다. 빌드 스크립트는 에이전트가 빌드를 트리거하지 못하도록 의도적으로 분리되어 있습니다.
적용 전 확인 사항
이 저장소는 Go 프로젝트를 다루는 AI 코딩 에이전트를 사용하는 개발자에게 적합합니다. 특히 최신 Go 문법을 선호하지만 AI가 구식 코드를 생성하는 문제를 겪는 팀에 유용합니다. Go 버전이 1.25보다 낮다면 자동 툴체인 전환이 활성화되어 있는지 점검해야 합니다. 이 가이드라인은 코드를 자동으로 수정하는 도구가 아니라, 에이전트가 코드를 생성할 때 참고하는 기준표이므로, 기존 코드베이스를 일괄 업데이트하는 용도로는 사용할 수 없습니다.
