
목차마크다운이 어떻게 워크플로가 되나요?
액션스 YAML 들여쓰기 하나 틀려서 파이프라인을 깨뜨려 본 적 있을 거예요.
깃허브의 실험 조직 Next가 다른 방법을 들고 나왔습니다. 마크다운으로 자동화 지시를 쓰면, gh-aw라는 CLI가 그걸 액션스 워크플로로 컴파일해 줍니다. 이슈 분류, PR 리뷰, CI 실패 조사 같은 반복 잡무를 에이전트가 레포 안에서 맡는 구조입니다.
사람들은 발표 트윗을 3만 8천 번 봤고, 204번 북마크했습니다.
마크다운이 어떻게 워크플로가 되나요?
gh-aw는 세 단계로 움직입니다.
하나, 마크다운 파일에 YAML 머리말을 얹어 무슨 일을 언제 할지 적습니다. 새 이슈가 열리면 분류하라, PR이 오면 리뷰하라, CI가 깨지면 원인을 조사하라. 지시 본문은 자연어로 씁니다.
둘, gh-aw 명령이 이 마크다운을 잠금 파일(.lock.yml)로 컴파일합니다. gh-aw가 사람 말을 액션스가 알아듣는 형식으로 번역하는 단계입니다.
셋, 깃허브 액션스가 그 파일대로 에이전트를 돌립니다.
코파일럿, 클로드, 코덱스, 제미나이. 특정 에이전트에 잠그지 않고 열어놨어요.
gh extension install github/gh-aw 한 줄로 설치하고, GitHub Next는 샘플 모음 레포(githubnext/agentics)와 퀵스타트 문서까지 갖춰 뒀습니다.
안전장치는 어떻게 설계됐나요?
GitHub Next가 제일 공들인 부분입니다.
GitHub Next는 기본 권한을 읽기 전용으로 뒀습니다. 에이전트는 샌드박스 안에서 돌고, 밖으로 나가는 행동을 하려면 safe-outputs라는 규격을 거쳐야 해요. 이슈에 댓글을 달거나 PR을 만드는 것 같은 쓰기 행동만 명시적으로 허용 목록에 올리는 방식입니다.
낯익은 방식이에요. 되돌릴 수 있는 작업은 자유롭게 두고, 되돌릴 수 없는 행동만 허용 목록으로 통제하는 승인선입니다. 개인 파이프라인에서 쓰던 원칙을 깃허브가 인프라 규모로 가져왔어요. 레포에 에이전트를 많이 둘수록 이 통제선을 더 신경 써야 해요.
반대편에서는 뭐라고 하나요?
답글 두 개를 보면 무엇이 논쟁거리인지 알 수 있어요.
하나는 뼈아픈 농담입니다. Next의 다음 실험 말고, 매주 장애 안 나는 깃허브부터 주면 안 되나. 사람들은 신기능보다 기본기를 챙기라는 견제구를 어느 발표에나 던지지만, 인프라 회사는 이 말을 특히 아프게 들을 거예요.
다른 하나는 방향 자체에 대한 반박이에요. 불필요하다. 내 컴퓨터에 이미 에이전트가 있다. 최고의 API와 MCP만 내놓으면 된다.
이건 노선 싸움입니다. 에이전트를 레포에 상주시킬 것인가, 내 손의 에이전트가 레포에 드나들게 할 것인가.
깃허브는 전자에 걸었고, 로컬 하네스 진영은 후자를 밀어요. WebMCP가 웹사이트에 에이전트 정문을 내는 것과 같은 구도를 코드 저장소에서도 볼 수 있어요.
남는 생각
저는 이 실험을 자동화 문법의 세대교체로 읽습니다.
지금까지 사람은 액션스 YAML을 기계에 맞춰 썼어요. 들여쓰기 하나 틀려 파이프라인을 깨뜨리고, 문법을 익히는 데 하루를 썼습니다. 마크다운 워크플로에서는 반대로 갑니다. 사람이 사람 말로 쓰면 기계가 자기 언어로 컴파일해요.
사람들은 이미 여러 곳에서 인프라 설정을 프롬프트로 바꾸고 있습니다. 의도 파일로 개발을 시작하는 SDLC 플레이북과 스킬 마크다운으로 조직 지식을 싣는 하네스들이 그런 사례예요. 깃허브가 이제 CI/CD 층까지 같은 문법을 가져왔습니다.
다만 답글의 반박도 유효합니다. 레포 안 에이전트와 내 손의 에이전트 가운데 어느 쪽을 표준으로 삼을지는 아직 몰라요. 어느 쪽이든 사람들은 YAML을 점점 덜 손으로 쓸 거예요.
원문·소스
FAQ
자주 묻는 질문
- 마크다운이 어떻게 워크플로가 되나요?
- 마크다운에 YAML 머리말로 언제 무엇을 할지 적고, gh-aw가 잠금 파일로 컴파일하면 깃허브 액션스가 에이전트를 돌립니다. 깃허브는 특정 에이전트에 잠그지 않고 코파일럿·클로드·코덱스·제미나이를 모두 받아요.
- 안전장치는 어떻게 설계됐나요?
- 기본 권한은 읽기 전용입니다. 에이전트는 샌드박스 안에서 돌고, 이슈 댓글이나 PR 생성 같은 쓰기만 safe-outputs 허용 목록을 거쳐요.
- 반대편 논점은 무엇인가요?
- 에이전트를 레포에 상주시킬 것인가, 내 손의 에이전트가 레포에 드나들게 할 것인가입니다. 깃허브는 전자에 걸었고, 로컬 하네스 진영은 후자를 밀어요.
