GitHub Agentic Workflows, YAML 없이 Markdown으로 CI 자동화하기

GitHub Agentic Workflows — YAML 없이 Markdown으로 CI 자동화하기

GitHub Actions을 쓰다 보면 YAML 작성이 제일 귀찮다. 들여쓰기 한 칸 틀려서 파이프라인 깨진 경험, 다들 있을 거다. 2026년 2월부터 기술 프리뷰로 풀린 GitHub Agentic Workflows, 써보니 방향이 꽤 달랐다.

Agentic Workflows가 뭔데

한 줄로 설명하면: YAML 대신 Markdown으로 워크플로우를 쓰면, AI 에이전트가 그걸 실제 GitHub Actions로 변환해서 돌려준다. `.github/workflows/` 폴더에 `.md` 파일을 넣으면 된다.

예를 들어 이런 식이다:

# Issue Triage Agent

When a new issue is opened:
1. Read the issue title and body
2. Check existing labels and similar issues
3. Assign appropriate labels (bug, enhancement, question)
4. If it's a bug, try to identify the related file from the codebase
5. Leave a comment summarizing what you found

이걸 `gh aw compile`로 컴파일하면 표준 GitHub Actions YAML로 변환되고, GitHub Copilot CLI(또는 다른 코딩 에이전트)가 실행한다.

직접 써보니 이랬다

간단한 이슈 트리아지 워크플로우를 만들어봤다. 신규 이슈 올라오면 레이블 붙이고, 유사 이슈 있으면 코멘트에 링크 달아주는 것. YAML로 했으면 20~30줄 짜야 했을 건데, Markdown 설명 7줄로 끝났다.

실행은 생각보다 빨랐다. 이슈 등록 후 30초 내에 에이전트가 응답했다. 기본 권한이 read-only라 보안 걱정도 덜하다. write 작업은 "safe outputs"라는 방식으로만 허용된다.

아쉬운 점은 아직 기술 프리뷰라 에러 메시지가 불친절하다. 컴파일 실패 시 왜 실패했는지 설명이 부족해서, 직접 로그 파서야 했다. 그리고 복잡한 로직(다단계 조건 분기)은 여전히 Markdown만으로 표현하기 모호한 부분이 있다.

어디에 쓰면 좋을까

이슈/PR 자동 트리아지

레이블 붙이기, 담당자 지정, 유사 이슈 연결 — 반복 작업의 전형이다. 에이전트한테 맡기면 된다.

CI 실패 분석

테스트 실패 시 어떤 파일이 원인인지, 최근 커밋 중 어떤 게 문제인지 분석해서 코멘트로 남겨주는 워크플로우. 개발자가 로그 뒤지는 시간을 아낄 수 있다.

문서 자동 업데이트

코드 변경 시 README나 API 문서를 자동으로 업데이트하는 것도 가능하다. 물론 PR로 제안하는 방식이라 최종 결정은 사람이 한다.

보안은 어떻게 처리되나

기본 설계가 security-first다. 모든 워크플로우는 기본 read-only로 실행되고, 네트워크 격리와 SHA-pinned 의존성이 적용된다. write 작업이 필요하면 명시적으로 `safe outputs`를 선언해야 하고, 이게 사전 승인된 연산만 허용하는 방식이다.

커스텀 MCP 서버도 연결할 수 있어서, 슬랙 알림이나 외부 API 호출도 가능하다. 단, 이 경우엔 네트워크 격리가 완화되는 만큼 설정에 주의가 필요하다.

지금 써볼 수 있나

기술 프리뷰라 `gh` CLI 확장으로 설치해야 한다:

gh extension install github/gh-aw
gh aw --help

`.github/workflows/` 에 Markdown 파일 만들고, `gh aw compile`로 변환, 커밋하면 끝이다. 프로덕션 레포에 바로 쓰기보다는 테스트 레포에서 먼저 돌려보는 걸 권장한다. 아직 프리뷰다.

YAML 알레르기 있는 팀원들한테 보여줬더니 반응이 좋았다. 이게 정식 출시되면 Actions 진입 장벽이 꽤 낮아질 것 같다.

---

📎 참고 자료

• GitHub Agentic Workflows are now in technical preview — GitHub Changelog
• Let's talk about GitHub Actions — GitHub Blog
• GitHub Actions: Late March 2026 updates — GitHub Changelog