✍️ 필사 모드: Issue에서 배포까지 — AI가 리뷰하고 CI/CD가 검증·배포하는 자동화 파이프라인 만들기 (2025)

 ┌────────────────────────────────────────────────────────────────┐
 │                                                                │
 │  [S1] Issue ──ai-ready 라벨──▶ AI 에이전트 ──▶ Draft PR        │
 │         ▲                                         │            │
 │         │                                         ▼            │
 │         │                              [S2] AI 코드 리뷰       │
 │         │                                  (생성≠리뷰)         │
 │         │                                         │            │
 │         │                                         ▼            │
 │         │                              [S3] CI 검증 게이트     │
 │         │                          lint·type·test·build·E2E    │
 │         │                                         │            │
 │         │                          ┌── 실패 ──────┤            │
 │         │                          ▼              ▼ 통과       │
 │         │                   AI 자가 수정    [S4] Human Gate    │
 │         │                   (로그 읽고 재푸시)   머지 결정      │
 │         │                                         │            │
 │         │                                         ▼            │
 │         │                              [S5] CD: Preview        │
 │         │                              → Canary → Production    │
 │         │                                         │            │
 │         │                                         ▼            │
 │         │                              [S6] 자동 검증          │
 │         │                          smoke·E2E·SLO 게이트        │
 │         │                                         │            │
 │         │                          ┌── 실패 ──────┤            │
 │         │                          ▼              ▼ 통과       │
 │         └──── 자동 Issue 생성 ◀─ [S7] 모니터링 & 피드백        │
 │              (자동 롤백 + 사건화)     배포 후 관측, 롤백 트리거 │
 │                                                                │
 └────────────────────────────────────────────────────────────────┘

# 같은 이슈에 PR이 이미 있으면 새로 안 만든다
- name: Check existing PR
  id: check
  run: |
    EXISTING=$(gh pr list --search "in:title #${{ github.event.issue.number }}" --json number --jq 'length')
    echo "exists=$EXISTING" >> "$GITHUB_OUTPUT"

- name: Run agent
  if: steps.check.outputs.exists == '0'
  uses: anthropics/claude-code-action@v1
  # ...

생성 에이전트 (Claude/Copilot) ──▶ PR
                                   │
리뷰 에이전트 (다른 모델/도구) ──▶ 리뷰 코멘트
                                   │
사람 ──────────────────────────▶ 최종 결정

name: AI Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review]

jobs:
  ai-review:
    # draft가 아닐 때만 — 작업 중인 PR은 리뷰 안 함
    if: github.event.pull_request.draft == false
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            이 PR을 리뷰하라. 다음에 집중:
            - 정확성: 로직 버그, 엣지 케이스, 누락된 에러 처리
            - 보안: 입력 검증, 시크릿, 권한
            - 테스트: 변경에 대한 커버리지가 충분한가
            - 컨벤션: CLAUDE.md를 따르는가

            문제는 해당 라인에 인라인 코멘트로 남겨라.
            마지막에 요약과 함께 APPROVE 또는 REQUEST_CHANGES 를 명시하라.
            사소한 스타일은 nit: 으로 표시해 사람이 무시할 수 있게 하라.

빠름 ──────────────────────────────────▶ 느림
lint → typecheck → unit test → build → integration → E2E
  │        │           │          │         │          │
 초 단위  초 단위    초~분       분        분         분~십분

PR 푸시 ──▶ CI 실행 ──▶ 실패
                          │
                          ▼
            에이전트가 CI 로그를 읽음
                          │
                          ▼
            원인 파악 → 수정 커밋 푸시
                          │
                          ▼
                     CI 재실행 ──▶ 통과

# CI 실패 시 에이전트에 로그를 주고 수정 시도 — 단, 라벨로 횟수 제한
- name: Self-heal on CI failure
  if: failure() && !contains(github.event.pull_request.labels.*.name, 'ai-heal-exhausted')
  uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: |
      CI가 실패했다. 아래 로그를 읽고 원인을 고쳐 커밋하라.
      추측하지 말고 로그가 가리키는 것만 고쳐라.

Settings → Branches → main 보호 규칙:
  ✅ Require status checks: ci/lint, ci/test, ci/build, ai-review
  ✅ Require branches to be up to date before merging
  ✅ Require a pull request before merging
  ✅ Require approvals: 1+ (S4 사람 게이트)
  ✅ Dismiss stale approvals when new commits pushed
  ✅ Do not allow bypassing the above

# 의존성 PR이고 CI 통과 + AI 리뷰 APPROVE면 자동 머지 활성화
- name: Enable auto-merge for safe deps
  if: |
    contains(github.event.pull_request.labels.*.name, 'dependencies') &&
    github.event.pull_request.user.login == 'dependabot[bot]'
  run: gh pr merge --auto --squash "${{ github.event.pull_request.number }}"

main 머지
   │
   ▼
Canary 배포 (트래픽 5%)
   │
   ▼  [S6 자동 검증]
smoke test + SLO 관측 (5~15분)
   │
   ├── 실패 ──▶ 자동 롤백 (Canary 제거)
   │
   ▼ 통과
Production 승격 (트래픽 100%)

name: Deploy
on:
  pull_request:
    types: [closed]
    branches: [main]

jobs:
  deploy-canary:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    environment: canary          # 보호 규칙: 없음 (자동)
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh canary

  promote-production:
    needs: [deploy-canary, verify-canary]
    runs-on: ubuntu-latest
    environment: production      # 보호 규칙: required reviewers = 사람 게이트
    steps:
      - run: ./scripts/deploy.sh production

  verify-canary:
    needs: deploy-canary
    runs-on: ubuntu-latest
    outputs:
      verdict: ${{ steps.gate.outputs.verdict }}
    steps:
      - name: Smoke test
        run: ./scripts/smoke-test.sh https://canary.example.com

      - name: Observe SLO for 10 minutes
        id: gate
        run: |
          sleep 600
          ERROR_RATE=$(curl -s "$METRICS_API/error-rate?env=canary&window=10m")
          P99=$(curl -s "$METRICS_API/latency-p99?env=canary&window=10m")
          # 에러율 1% 초과 또는 p99 500ms 초과면 fail
          if (( $(echo "$ERROR_RATE > 0.01" | bc -l) )); then
            echo "verdict=rollback" >> "$GITHUB_OUTPUT"; exit 1
          fi
          echo "verdict=promote" >> "$GITHUB_OUTPUT"

  rollback-canary:
    needs: verify-canary
    if: failure()
    runs-on: ubuntu-latest
    steps:
      - run: ./scripts/rollback.sh canary

name: Monitor & Auto-Rollback
on:
  schedule:
    - cron: '*/5 * * * *'      # 5분마다 SLO 점검
  workflow_run:
    workflows: ["Deploy"]
    types: [completed]

jobs:
  slo-check:
    runs-on: ubuntu-latest
    steps:
      - name: Check production SLO
        id: slo
        run: |
          BURN=$(curl -s "$METRICS_API/error-budget-burn?env=prod&window=1h")
          echo "burn=$BURN" >> "$GITHUB_OUTPUT"

      - name: Rollback + file issue if breaching
        if: ${{ steps.slo.outputs.burn > 2.0 }}
        run: |
          ./scripts/rollback.sh production
          gh issue create \
            --title "Auto-rollback: error budget burn rate ${{ steps.slo.outputs.burn }}" \
            --label "ai-ready,incident,priority-high" \
            --body "프로덕션 SLO 위반으로 자동 롤백했다.
            마지막 배포: ${{ github.sha }}
            burn rate: ${{ steps.slo.outputs.burn }}
            에이전트는 롤백된 커밋의 diff를 분석하고 원인을 진단해
            수정 PR을 제출하라."

   Issue ──▶ PR ──▶ 리뷰 ──▶ CI ──▶ 머지 ──▶ 배포 ──▶ 검증 ──▶ 모니터
     ▲                                                            │
     └──────────────── 사건이 새 Issue로 ◀──────────────────────────┘

issue.labeled('ai-ready')  ──▶ ai-resolve.yml ──▶ (PR 생성)
                                                       │
pull_request.opened ◀──────────────────────────────────┘
   ├──▶ ai-review.yml   (AI 리뷰 → 체크 보고)
   └──▶ ci.yml          (검증 → 체크 보고)
                                                       │
   [브랜치 보호: 모든 체크 + 사람 승인 대기]            │
                                                       ▼
pull_request.closed(merged) ──▶ deploy.yml ──▶ (Canary → 검증 → Production)
                                                       │
workflow_run('Deploy' completed) ──▶ monitor.yml       │
schedule('*/5')                  ──▶ monitor.yml ◀─────┘
   └──▶ SLO 위반 시: rollback + issue.create('ai-ready')
                                          │
                                          └──▶ (다시 ai-resolve.yml — 고리 완성)

name: AI Resolve
on:
  issues:
    types: [labeled]

jobs:
  resolve:
    if: github.event.label.name == 'ai-ready'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Skip if PR already exists
        id: dedup
        run: |
          N=$(gh pr list --search "#${{ github.event.issue.number }} in:body" --json number --jq 'length')
          echo "exists=$N" >> "$GITHUB_OUTPUT"
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Run agent
        if: steps.dedup.outputs.exists == '0'
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            Issue #${{ github.event.issue.number }}: ${{ github.event.issue.title }}

            ${{ github.event.issue.body }}

            이 이슈를 구현하라. 브랜치를 만들고, 변경하고, 테스트를 통과시키고,
            "Closes #${{ github.event.issue.number }}" 를 포함한 Draft PR을 열어라.
            CLAUDE.md 컨벤션을 따르고, PR 본문에 무엇을·왜 했는지 요약하라.

name: CI
on:
  pull_request:
    types: [opened, synchronize, ready_for_review]

concurrency:
  group: ci-${{ github.event.pull_request.number }}
  cancel-in-progress: true     # 새 푸시 시 이전 실행 취소 — 비용 절감

jobs:
  verify:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: pnpm
      - run: pnpm install --frozen-lockfile
      - run: pnpm lint        # 빠른 것 먼저
      - run: pnpm typecheck
      - run: pnpm test
      - run: pnpm build

name: Deploy
on:
  pull_request:
    types: [closed]
    branches: [main]

jobs:
  canary:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    environment: canary
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh canary

  verify:
    needs: canary
    runs-on: ubuntu-latest
    steps:
      - run: ./scripts/smoke-test.sh https://canary.example.com
      - run: ./scripts/observe-slo.sh canary 600   # 10분 관측

  production:
    needs: verify
    runs-on: ubuntu-latest
    environment: production       # required reviewers = Human Gate
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh production

  rollback:
    needs: [canary, verify]
    if: failure()
    runs-on: ubuntu-latest
    steps:
      - run: ./scripts/rollback.sh canary