깃허브 에이전틱 워크플로우 정식 출시: 바뀐 점과 지금 할 일

깃허브 에이전틱 워크플로우, 무엇이 정식 출시됐나

깃허브 에이전틱 워크플로우(GitHub Agentic Workflows)는 GitHub Actions 안에서 코딩 에이전트를 돌려 이슈 분류, CI 실패 분석 같은 작업을 자동화하는 기능으로, 2026년 10월 28일 정식 출시됐다.

이 발표로 저장소를 관리하는 개발자는 반복 업무를 AI에게 맡길지, 맡긴다면 어떤 권한까지 줄지 다시 정해야 한다. 사람에게 일을 시킬 때 업무 매뉴얼을 글로 적어 주고 결재선을 두는 것과 비슷하다. 에이전틱 워크플로우도 해야 할 일을 일반 글로 적어 두면 AI가 읽고 처리하고, 결과는 정해진 절차를 거쳐서만 저장소에 반영된다. 다만 결재선이 있어도 매뉴얼을 어떻게 쓰느냐에 따라 결과가 달라지므로, 어떤 일을 맡길지는 팀이 정해야 한다.

깃허브 공식 변경 기록에 따르면 이 기능은 GitHub Next의 오픈소스 프로젝트이고, 이슈 분류, CI 실패 분석, 문서 업데이트, 테스트 작성처럼 추론이 필요한 작업을 자동화한다. 자동화 내용은 자연어 Markdown 파일로 쓰고, 이를 표준 Actions YAML로 컴파일해 기존 러너 그룹과 정책 제약을 그대로 쓴다.

프리뷰 이후 달라진 점

깃허브 발표에 따르면 프리뷰 이후 바뀐 내용은 다섯 가지다.

구분	달라진 내용
러너	셀프 호스티드 ARC(Actions Runner Controller, 쿠버네티스에서 러너를 관리하는 도구) 러너와 Docker-in-Docker 지원
비용 예측	gh aw forecast가 실험 기능에서 빠지고, 위협 탐지 크레딧과 월간 범위까지 포함해 AI 크레딧 지출을 보여 줌
모델·엔진	모델 목록 갱신, 워크플로별 모델 제공자 선택, gh aw add-wizard로 추가하는 새 템플릿
모델 라우팅	작업 유형과 난이도에 맞춰 모델을 고르는 라우터 사용 가능
격리	Cloud Hypervisor 또는 NVX 마이크로 VM에서 에이전트 실행, 저장소 사이 데이터 유출을 막는 엔클레이브

공식 발표에 따르면 기본 엔진은 GitHub Copilot CLI라서 쓰려면 Copilot 라이선스가 필요하다. 다른 코딩 에이전트를 가져와 쓸 수도 있다. 제공 플랜은 github.com의 GitHub Free, Team, Enterprise이고, 발표문에는 별도 가격표가 없다. 비용은 gh aw forecast로 예측하라고만 안내한다. Copilot 쪽 과금이 궁금하면 깃허브 코파일럿 코드 리뷰 요금·조직 과금 설정을 함께 보면 된다.

에이전틱 워크플로우는 어떻게 안전하게 돌아가나

공식 아키텍처 문서에 따르면 Markdown 파일은 컴파일 단계에서 .lock.yml로 바뀌고, 이때 스키마 검증과 액션 SHA 고정, actionlint·zizmor·poutine 같은 보안 스캐너 검사를 거친다. 검사를 통과하지 못하면 컴파일이 실패한다.

AI 에이전트 잡은 최소한의 읽기 전용 권한으로 돈다. 이슈 생성이나 PR 생성 같은 쓰기 작업은 바로 실행되지 않고 결과 파일로 쌓인다. 별도 잡이 이 결과를 받아 먼저 비밀 정보 유출이나 악성 패치가 있는지 탐지하고, 통과한 것만 범위가 제한된 쓰기 권한으로 반영한다. 기본인 경고 모드에서는 위협이 탐지돼도 결과물에 주석을 달거나 검토용 PR로 돌리고, 엄격 모드에서는 반영을 막고 워크플로를 실패시킨다. 문서는 탐지가 방어 계층 하나일 뿐 안전을 증명하지는 않는다고 밝힌다.

깃허브 발표가 꼽은 보안 기능은 통합 필터(에이전트가 깃허브 콘텐츠에 접근할 때 적용하는 규칙), 기본 읽기 전용 권한, Agent Workflow Firewall 뒤의 샌드박스 컨테이너, Safe outputs 검증, 위협 탐지 작업이다.

우리 저장소에서도 쓸 수 있나

공식 발표 기준으로 대상은 github.com의 Free, Team, Enterprise 플랜이다. 기본 엔진을 쓰려면 Copilot 라이선스가 있어야 하고, 다른 엔진을 가져오면 그 엔진의 계정이 필요하다. 퀵스타트가 안내하는 사전 준비물은 다음과 같다.

• AI 계정: GitHub Copilot, Anthropic Claude, OpenAI Codex, Google Gemini 중 하나
• 쓰기 권한이 있는 저장소와 켜져 있는 GitHub Actions
• GitHub CLI(gh) v2.0.0 이상. Linux, macOS, WSL을 쓰는 Windows에서 실행

엔진별 시크릿 이름도 다르다. Copilot은 COPILOT_GITHUB_TOKEN, Claude는 ANTHROPIC_API_KEY, Codex는 OPENAI_API_KEY, Gemini는 GEMINI_API_KEY를 쓴다. 클로드 쪽은 CLAUDE_CODE_OAUTH_TOKEN이 지원되지 않는다고 문서에 적혀 있다.

지금 할 일: 예제 워크플로 첫 실행

공식 퀵스타트의 첫 실행 순서는 이렇다.

1. gh extension install github/gh-aw로 확장을 설치한다.
2. 저장소 루트에서 gh aw add-wizard githubnext/agentics/repo-status를 실행한다. 마법사가 권한 확인, AI 엔진 선택, 인증 설정, 워크플로 파일 추가(직접 푸시 또는 PR), 첫 실행을 대화형으로 안내한다.
3. Actions 탭에서 최근 실행을 열거나 gh aw status로 상태를 본다.

성공하면 저장소에 「Daily Repo Report」 제목의 이슈가 생긴다. 실패하면 Actions의 단계별 로그를 본다. 내용을 바꾸고 싶으면 .github/workflows/repo-status.md를 고치고, 머리말(frontmatter) 설정을 바꿨다면 gh aw compile을 실행한 뒤 .md와 .lock.yml 두 파일을 함께 커밋한다. 다시 돌릴 때는 gh aw run repo-status를 쓴다. 이슈 분류, 의존성 관리, 코드 리뷰, 리포팅 예제는 agentics 저장소에 있다.

비용이 걱정되면 gh aw forecast가 보여 주는 AI 크레딧 지출 예측을 먼저 확인한다. 위협 탐지 크레딧과 월간 범위가 포함된다고 공식 발표에 적혀 있다.

앞으로 확인할 점

요금 구조는 발표문에 따로 없으므로 공식 변경 기록과 릴리스 노트에서 갱신을 확인한다. 깃허브는 이번 발표에서 Accenture의 한 팀 리더가 개인 개발 작업에서 주당 약 29시간을 절약했다고 밝힌 사례를 소개했지만, 이는 한 사람의 개인 작업 기준 수치다. 자세한 사용법은 공식 문서에서 볼 수 있다.

자주 묻는 질문

기존 GitHub Actions 워크플로를 바꿔야 하나요?

발표문은 에이전틱 워크플로우가 Markdown을 표준 Actions YAML로 컴파일하며 기존 러너 그룹과 정책 제약을 그대로 쓴다고 설명한다. 기존 워크플로를 바꾸라는 안내는 없다.

Copilot 없이도 쓸 수 있나요?

쓸 수 있다. 퀵스타트에 따르면 기본 엔진인 Copilot CLI는 Copilot 라이선스가 필요하지만, Claude, Codex, Gemini 계정과 해당 시크릿으로 다른 엔진을 쓸 수 있다.

AI가 마음대로 코드를 바꾸지는 않나요?

아키텍처 문서는 에이전트 잡이 읽기 전용이고, 쓰기는 탐지 잡을 거친 safe output 잡만 제한된 범위에서 한다고 설명한다.