Huny's Dev Blog
huny.dev

gh-aw v1.2.3 프리릴리스: 모델 라우팅·커넥터·PR 병합 기본값 점검

GitHub Agentic Workflows v1.2.3의 호환성 변경을 모델 선택, 선언형 커넥터, 보호 파일 병합, 포크 이벤트 관점에서 점검하고 단계별 검증 방법을 정리한다.

Hun Jang
Hun Jang Nov 17, 2026

모델 선택 경로와 변경 승인 경계를 표현한 생성형 개념 이미지다. 실제 GitHub 화면이 아니다.

자동화 코드는 그대로인데 업그레이드 뒤 사용하는 모델이 바뀌거나, 전에는 되던 PR 병합이 막힌다면 무엇부터 확인해야 할까. GitHub Agentic Workflows의 gh-aw v1.2.3에서는 모델 선택과 외부 서비스 연결, 보호 파일 처리의 기본 동작부터 점검해야 한다. 버전 숫자만 보고 작은 수정으로 넘기기 어려운 변경이다.

GitHub는 2026년 11월 13일 v1.2.3을 Pre-release로 공개했고, 11월 16일 공식 주간 업데이트에서 호환성에 영향을 주는 변경들을 정리했다. 아래 내용은 해당 릴리스와 현재 공식 레퍼런스를 읽고 작성한 업그레이드 검토 가이드다. 실제 저장소에 설치하거나 유료 실행을 시험한 결과는 아니다. 문서의 최신 기능 전체가 v1.2.3에 포함됐다고 가정하지 않는다. 릴리스, 공식 주간 업데이트

1. 모델을 생략했다면 선택 정책부터 확인한다

v1.2.3의 변경 중 먼저 볼 것은 기본 모델 라우팅이다. 모델이나 라우팅을 따로 지정하지 않은 적격 워크플로는 Copilot 추론 경로에서 비용을 목표로 하는 자동 라우팅의 영향을 받는다. 모든 워크플로가 무조건 바뀌는 것은 아니다. 기존 모델 지정, 가져온 설정, 런타임과 사용자 정의 추론 설정 등에 따라 적용 여부가 달라진다.

공식 모델 라우팅 문서는 이 기능을 실험적이라고 명시한다. 비용을 목표로 한다는 말은 매 실행의 비용 절감이나 결과 품질을 보장한다는 뜻이 아니다. 같은 작업에서도 선택 모델이나 추론 강도가 달라질 수 있다. 라우팅 자체를 예산 상한으로 취급해서도 안 된다.

자동 선택을 원하지 않지만 특정 모델을 고정하고 싶지도 않다면 다음처럼 옵트아웃할 수 있다. 아래는 Copilot 엔진을 사용하는 기존 frontmatter에 합칠 설정 조각이다. 다른 engine 설정을 통째로 덮어쓰지 않는다.

이 설정은 모델 버전을 영구 고정하는 기능이 아니다. gh-aw 라우팅을 끄는 것과 공급자의 기본 모델 변경까지 막는 것은 다르다. 모델 일관성이 중요한 작업이라면 모델을 명시하는 방안과 함께 검토한다. 모델 라우팅 레퍼런스

2. Jira·Linear·Azure DevOps는 연결 정의를 다시 본다

릴리스는 기존 네이티브 Jira·Linear·Azure DevOps 통합을 선언형 커넥터로 이전하도록 안내한다. 핵심은 단순히 설정 이름을 바꾸는 일이 아니다. 읽을 수 있는 자원과 실행할 수 있는 쓰기 작업, 사용할 자격 증명의 경계를 다시 명시해야 한다.

공식 커넥터 문서에서 커넥터는 일반 AW Markdown 파일로 설명되며, 저장소의 .github/workflows/connectors/ 아래에 둘 수 있다. 읽기 프로필과 쓰기 효과를 구분하고, 승인한 프로젝트·팀·이슈 등의 자원 범위를 입력한다. 누락된 자원 허용 범위를 알아서 넓혀 주는 방식으로 이해하면 안 된다.

특히 파일을 import했다고 외부 이벤트 수신기가 설치되거나 인증이 끝나는 것은 아니다. 문서는 커넥터 선언을 실험적으로 표시하며, 수신기 연동을 따로 승인·구성하지 않은 경우 수동 실행 경로부터 사용하도록 안내한다. 기존에 이벤트 기반으로 움직이던 자동화라면 “컴파일 성공”과 “실제 이벤트 수신”을 별도 항목으로 검증해야 한다. 커넥터 레퍼런스

3. 보호 파일 병합 차단은 없애야 할 오류가 아니다

merge-pull-request는 보호 파일을 포함하는 PR을 기본적으로 막도록 강화됐다. 여기서의 보호 파일 정책은 GitHub 저장소의 브랜치 보호 설정과 같은 개념이 아니다. 둘 다 검토해야 한다.

현재 safe outputs 문서는 PR 생성·푸시와 병합에서 보호 파일을 다르게 처리한다. 생성·푸시는 검토 요청이 기본이고, 병합은 차단이 기본이다. 또한 병합 기능 자체가 실험적이며 상태 검사, 리뷰, 미해결 토론 등 다른 조건도 적용된다. 파일 목록을 충분히 확인할 수 없는 경우에도 안전하게 병합을 거부하는 방향이다.

따라서 업그레이드 후 병합이 멈췄을 때 첫 조치는 보호 정책 해제가 아니다. 어떤 파일이 포함됐는지 확인하고, 사람이 검토한 뒤 별도 승인 경로로 처리하는 편이 낫다. 이는 문서의 기능 설명에 근거한 운영 제안이지, 모든 팀에 강제되는 절차는 아니다. PR safe outputs 레퍼런스

4. 포크 이벤트와 다운로드 고정도 점검한다

릴리스에는 두 가지 경계 변경이 더 있다.

  • pull_request_target은 같은 저장소의 PR만 받는 것이 기본이다. 허용할 포크는 정확한 소유자/저장소 단위로 명시한다.
  • AWF와 Copilot CLI 다운로드는 명시적 버전과 체크섬을 요구한다. 고정하지 않은 버전이나 latest에 의존한 사용자 설정은 실패할 수 있다.

앞의 포크 변경은 이 글에서 다루는 gh-aw의 동작이다. GitHub 플랫폼 전체의 이벤트 정책 변경과 섞어 같은 시행일을 적용하면 안 된다. 뒤의 다운로드 변경 역시 실패를 없애기 위해 검증을 끄는 대신, 승인한 버전과 무결성 정보를 함께 관리하는 문제로 보는 편이 적절하다. v1.2.3 변경 목록

5. 업그레이드는 실행보다 설정 목록 확인부터 한다

다음은 실제 실행 결과가 아니라 적용 전 검토에 사용할 수 있는 예시다. 먼저 추적 중인 워크플로에서 영향을 받기 쉬운 설정을 찾아본다.

이 검색은 후보를 줄일 뿐이다. import된 공용 파일, 저장소·조직 변수, 별도 관리되는 커넥터까지 자동으로 검사하지 않는다. 검색 결과가 없다는 이유로 영향이 없다고 결론 내리지 않는다.

검토 순서는 다음처럼 잡을 수 있다.

  1. 사용 중인 gh-aw 버전과 생성된 워크플로를 먼저 보존한다.
  1. 모델 생략 워크플로의 선택 정책을 정한다. 라우팅 유지, 명시 모델, 옵트아웃 중 무엇이 필요한지 기록한다.
  1. 커넥터의 읽기 범위·쓰기 작업·인증·이벤트 수신을 각각 확인한다.
  1. 보호 파일이 포함된 PR과 포크 PR이 의도대로 멈추는지 확인할 시험 사례를 만든다.
  1. 별도 브랜치에서 새 버전으로 다시 컴파일하고 생성 파일의 차이를 검토한다.
  1. 승인된 환경의 제한된 실행에서 모델 선택, 결과 정확성, 비용, 외부 쓰기, 병합 차단을 따로 확인한다.

권장 판단 기준은 단순하다. 성공 실행 하나만 확인하지 말고, 허용한 작업은 수행하고 허용하지 않은 작업은 멈추는지 확인한다. 특히 프리릴리스를 도입하는 경우에는 전체 자동화를 한 번에 바꾸기보다 영향이 작은 워크플로부터 비교하는 편이 낫다.

정리

이번 변경의 핵심은 기능 수가 아니라 기본값의 이동이다. 모델을 생략한 의미, 외부 서비스에 연결하는 방식, PR을 자동 병합할 수 있는 경계가 달라진다.

기존 GA 소개가 “무엇을 할 수 있는가”에 관한 글이었다면, 이번에는 “업그레이드 뒤 무엇이 다르게 선택되고 무엇이 거부되는가”가 질문이다. 설정을 명시하고, 컴파일 결과와 실행 결과를 나누어 확인하는 것이 답이다.

추천 글