GitHub Agentic Workflows란 무엇인가?
2026년 2월 17일, GitHub은 Agentic Workflows(에이전틱 워크플로우)의 기술 프리뷰를 공식 발표했다. 이는 단순한 새 기능 추가가 아니다. GitHub의 수석 연구원 Eddie Aftandilian이 밝혔듯, "Continuous AI(지속적 AI)"라는 새로운 엔지니어링 패러다임의 시작이다.
기존 CI/CD가 코드를 자동으로 빌드·테스트·배포하는 것이라면, Agentic Workflows는 AI 에이전트가 자율적으로 이슈를 분류하고, 코드를 개선하고, 리포트를 작성하는 완전히 새로운 자동화 레이어다. GitHub Next와 Microsoft Research가 공동 개발했으며, Claude Code, GitHub Copilot, OpenAI Codex를 에이전트 엔진으로 사용한다.
Agentic Workflows vs 기존 GitHub Actions
| 구분 | 기존 GitHub Actions | Agentic Workflows |
|---|---|---|
| 실행 방식 | 결정론적(Deterministic) | 비결정론적(AI 기반) |
| 워크플로우 정의 | YAML 파일 직접 작성 | 마크다운 파일 작성 → GitHub CLI가 YAML로 컴파일 |
| 트리거 | push, PR, 스케줄 등 | 이슈 생성, 이슈 댓글, PR, 토론 등 |
| 적합한 작업 | 빌드, 테스트, 배포 (재현 가능해야 하는 작업) | 이슈 분류, 문서 업데이트, 코드 개선, CI 실패 분석 |
| AI 에이전트 | 없음 | GitHub Copilot, Claude Code, OpenAI Codex |
핵심 원칙: Agentic Workflows는 기존 CI/CD를 대체하는 것이 아니라, 그 옆에서 보완하는 레이어다. 빌드·배포처럼 엄격한 재현성이 필요한 작업은 기존 Actions가, AI의 유연성이 필요한 작업은 Agentic Workflows가 담당한다.
Agentic Workflows 핵심 특징
1. 마크다운 기반 워크플로우 정의
기존 GitHub Actions는 YAML로 워크플로우를 정의했다. Agentic Workflows는 마크다운 파일로 작성하고, GitHub CLI(gh)가 이를 Actions YAML로 컴파일한다. 덕분에 일반 텍스트로 AI 에이전트에게 할 일을 지시하는 방식으로 워크플로우를 작성할 수 있다.
# issue-triage.md (Agentic Workflow 예시)
## Trigger
- New issues created
- Issue comments containing "/analyze"
## Instructions
새로운 이슈가 생성되면:
1. 이슈 내용을 분석하여 버그/기능요청/질문으로 분류
2. 적절한 레이블 추가 (bug, enhancement, question, needs-triage)
3. 중복 이슈 여부 확인 후 링크 첨부
4. 우선순위 추정 및 코멘트 작성
5. 담당자 자동 어사인 (컴포넌트 기반)
## Agent
GitHub Copilot
## Security
sandboxed: true
secure-output: true2. 샌드박스 실행 + Secure Output
보안이 가장 중요한 고려사항이다. Agentic Workflows는 두 가지 보안 메커니즘을 제공한다:
- 샌드박스 실행(Sandboxed Execution): AI 에이전트가 격리된 환경에서 실행되어 의도하지 않은 시스템 접근을 방지
- Secure Output: 에이전트의 출력물이 악의적으로 악용되지 않도록 검증. 예를 들어 이슈 본문에 숨겨진 프롬프트 인젝션 시도를 차단
3. 지원하는 AI 에이전트
- 🤖 GitHub Copilot: 코드 중심 작업에 최적화, GitHub 생태계와 깊이 통합
- 🎭 Claude Code (Anthropic): 복잡한 코드 분석, 문서 작성, 리팩토링에 강점
- 💻 OpenAI Codex: 코드 생성 및 수정에 특화
실전 활용 사례 5가지
✅ 1. 자동 이슈 트리아지(Triage)
새 이슈가 생성되면 AI가 자동으로 분류, 레이블 추가, 우선순위 평가, 중복 여부 확인까지 처리한다. 이슈가 많은 오픈소스 프로젝트에서 메인테이너의 부담을 대폭 줄인다.
✅ 2. CI 실패 자동 분석
빌드가 실패하면 AI가 로그를 분석해 원인을 파악하고, 해결 방법을 제안하는 PR 코멘트를 작성한다. 개발자가 로그를 직접 파헤치는 시간을 절약한다.
✅ 3. 문서 자동 업데이트
코드 변경 시 AI가 관련 README, API 문서, 변경 로그를 자동으로 업데이트하는 PR을 생성한다.
✅ 4. 테스트 커버리지 모니터링
주기적으로 테스트 커버리지를 분석하고, 커버리지가 낮은 영역에 대한 테스트 코드를 자동으로 추가 제안한다.
✅ 5. 리포지토리 헬스 리포트
매주 자동으로 리포지토리 상태(미해결 이슈, PR 대기, 기술 부채, 성능 트렌드)를 분석해 팀에게 요약 리포트를 전송한다.
GitHub CLI로 Agentic Workflow 설정하기
# GitHub CLI 설치 (최신 버전 필요)
brew install gh # macOS
gh --version
# Agentic Workflow 확장 설치
gh extension install github/gh-aw
# 워크플로우 파일 컴파일 및 배포
gh aw compile .github/agentic/issue-triage.md
gh aw deploy .github/agentic/issue-triage.md
# 실행 중인 워크플로우 목록 확인
gh aw list
# 워크플로우 로그 확인
gh aw logs issue-triage현재 기술 프리뷰 제한사항
아직 기술 프리뷰 단계이므로 몇 가지 제한이 있다:
- ✋ 일반 CI/CD 빌드·배포 파이프라인 대체 용도로는 사용 불가 (비결정론적이므로)
- ✋ 에이전트 실행 비용이 추가로 발생 (API 토큰 소모)
- ✋ 일부 복잡한 멀티스텝 작업에서 아직 신뢰성 이슈
- ✋ 퍼블릭 리포지토리 위주 지원 (엔터프라이즈는 단계적 확대)
Continuous AI: 소프트웨어 개발의 다음 단계
GitHub은 Agentic Workflows를 "Continuous AI" 개념의 핵심으로 포지셔닝하고 있다. CI(지속적 통합)가 빌드·테스트를 자동화했고, CD(지속적 배포)가 릴리즈를 자동화했다면, CA(지속적 AI)는 코드 리뷰·문서화·이슈 관리 같은 인지적 작업을 자동화한다.
아직 초기 단계지만, 이 기술이 성숙해지면 개발팀의 업무 방식이 근본적으로 바뀔 것이다. 반복적이고 시간이 걸리는 관리 작업은 AI가 처리하고, 개발자는 진짜 창의적인 문제 해결에 집중할 수 있게 된다. 지금 기술 프리뷰에 참여해보는 것을 강력히 추천한다.
시작하는 방법
- GitHub 계정에서 Agentic Workflows 기술 프리뷰 신청
- GitHub CLI 최신 버전 업데이트
gh extension install github/gh-aw설치- 간단한 이슈 레이블링 워크플로우로 시작
- 팀 피드백을 바탕으로 점진적으로 확대
