blevels

Home / AI / AI 바이브코딩 / AI로 GitHub Actions 만들기 — 자동화 워크플로우 30분 완성

VIBE

AI로 GitHub Actions 만들기 — 자동화 워크플로우 30분 완성

게시일 2026-04-30수정일 2026-04-30
공식 링크
On this page

코드를 push할 때마다 테스트가 자동으로 돌고, main 브랜치 병합 시 자동 배포가 실행된다. 이 모든 자동화를 AI와 함께 30분 만에 구축할 수 있다.

:::callout type=info 이 튜토리얼은 GitHub Actions + Claude Code (claude-sonnet-4-6) 기준입니다 (2026-04). 도구 업데이트 시 검토 필요. :::

목표

YAML 문법을 깊이 몰라도 AI의 도움으로 GitHub Actions 워크플로우를 완성하는 바이브코딩 실습이다. PR 생성 시 자동 린트·테스트 실행, main 병합 시 자동 배포까지 전체 CI/CD 파이프라인을 구축한다.

준비물

  • GitHub 계정 및 리포지토리
  • Node.js 20 이상 (로컬 환경)
  • Claude Code 또는 Cursor 1.0
  • 기본 npm 프로젝트 (package.json에 lint·test 스크립트 존재)
  • 예상 소요 시간: 30분

1. 현재 프로젝트 파악시키기

AI에게 워크플로우를 만들어 달라기 전에, 현재 프로젝트 구조와 실행 가능한 명령어를 파악시킨다.

# Claude Code에 다음과 같이 입력
@package.json 을 읽고 어떤 npm 스크립트가 있는지 확인해줘.
GitHub Actions 워크플로우를 만들 건데, 먼저 이 프로젝트 구조부터 파악해줘.

AI가 package.json의 scripts 항목을 확인하고 사용 가능한 명령어 목록을 파악한다.

AD

2. CI 워크플로우 생성 요청

프로젝트 파악이 끝나면 CI 워크플로우 생성을 요청한다.

다음 조건의 GitHub Actions CI 워크플로우를 만들어줘:

- PR 생성·업데이트 시 트리거
- Node.js 20 환경
- npm install → lint → test 순서로 실행
- 실패 시 PR merge 차단

파일 경로: .github/workflows/ci.yml

AI가 생성하는 워크플로우 예시:

name: CI

on:
  pull_request:
    branches: [main]

jobs:
  lint-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run lint
      - run: npm run test

3. 캐시 최적화 추가 요청

기본 워크플로우가 완성되면 속도 개선을 요청한다.

ci.yml에 npm 캐시를 적용해서 반복 실행 속도를 높여줘.
node_modules를 캐싱하는 방식으로.

actions/setup-node의 cache: 'npm' 옵션이 이미 포함됐다면 AI가 이를 확인하고 추가 최적화 방안(예: 의존성 변경 감지를 위한 캐시 키 설정)을 제안한다.

AD

4. 배포 워크플로우 추가

CI 통과 후 자동 배포 워크플로우를 별도 파일로 생성한다.

main 브랜치에 push될 때 Vercel에 자동 배포하는 워크플로우를 만들어줘.
VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID는 GitHub Secrets에 저장돼 있어.
파일 경로: .github/workflows/deploy.yml
name: Deploy to Vercel

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run build
      - uses: amondnet/vercel-action@v25
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
          vercel-args: '--prod'

5. 검증: 로컬에서 YAML 구문 확인

push 전에 YAML 구문 오류를 로컬에서 검증한다.

# actionlint 도구로 GHA YAML 검증
npm install -g @action-validator/cli
action-validator .github/workflows/ci.yml
action-validator .github/workflows/deploy.yml

오류가 발견되면 AI에게 오류 메시지를 그대로 붙여넣어 수정을 요청한다.

결과

  • PR 생성 시 lint·test 자동 실행, 실패 시 merge 버튼 비활성화
  • main 병합 시 Vercel 자동 배포
  • 전체 파이프라인 설정 시간: 30분 이내

다음 단계

관련 가이드: vibe-coding-context-management — AI에게 프로젝트 이해시키는 컨텍스트 관리법 도구 상세: github-actions / vercel

AD