에이전트 활용 사례

오늘 등록된 사례

2전체 191건

191개 중 1–20개

개발·코딩

AI가 코드 리뷰를 맡고 사람은 위험한 변경만 확인하는 팀 운영

Anthropic Claude Code 팀은 코드 리뷰를 AI에 맡기고 사람은 고위험 변경만 직접 검토하도록 운영하고 있어요.

사용법

  1. 코드를 작성한 뒤, 실행 가능한 테스트나 빌드, 디자인 비교 스크린샷 등으로 변경 사항을 검증해요.
  2. Claude에게 코드 변경의 결과물을 보여주고, 내부 서브에이전트가 새 맥락에서 diff를 검토하게 해요.
  3. CLAUDE.md와 REVIEW.md 등 프로젝트와 리뷰 기준을 명확히 문서화해, AI 리뷰어가 이를 참고하도록 해요.
  4. 모든 풀리퀘스트(PR)에 대해 Claude가 자동으로 코드 리뷰를 진행해요. 변경 목적과 전체 코드베이스를 참고해 문제점을 찾고, 여러 에이전트가 버그 여부를 투표로 검증해요.
  5. 보안 리뷰도 자동화해서, 버그나 보안 이슈가 남아 있으면 병합을 막아요. 오픈소스 GitHub Action이나 /security-review 명령도 활용할 수 있어요.
  6. 자동화된 린트, 타입 체크, 테스트, 빌드 등 다양한 검증을 통과해야 해요. PR 템플릿에는 테스트 방법과 롤백 방법을 명시해요.
  7. 변경 위험도에 따라 사람의 승인 단계를 다르게 적용해요. 위험이 낮은 변경은 자동화만으로 병합하고, 중간 이상은 한 명 또는 두 명의 승인을 받아요. 신뢰받는 작성자만 자동화 경로를 이용할 수 있어요.
  8. 머지 큐에서 모든 체크를 다시 실행해, 병합 후 문제가 없도록 해요. 새 기능은 플래그로 내부 직원에게 먼저 배포하고, 점진적으로 공개해요.
  9. 문제가 발생하면 빠르게 감지하고 롤백할 수 있도록 플래그와 대시보드, 온콜 체계를 운영해요.
  10. 리뷰 프로세스와 AI 리뷰어는 실제 사고 사례를 모아 매일 평가하고, 반복되는 문제는 룰이나 문서, 스킬로 개선해요.

결과

작성자는 코드 변경의 대부분을 AI가 자동으로 리뷰하고, 위험이 높은 변경만 사람이 직접 승인하는 체계를 운영하고 있다고 소개했어요. 자동화된 리뷰와 보안 체크, 린트, 테스트, 빌드 등 여러 단계의 검증을 거친 뒤, 위험도에 따라 사람의 승인 단계를 조절해요. 실제로 병합된 PR 수가 두 배로 늘었지만, 롤백 비율은 40% 이상 줄었다고 해요. 반복되는 리뷰 피드백은 문서와 룰로 개선하고, 사고 사례를 매일 평가에 반영해 AI 리뷰어의 품질을 높이고 있다고 해요.

참고사항

작성자는 Claude Code 팀의 실제 운영 경험을 바탕으로 자동화 코드 리뷰와 사람의 역할 분담 방식을 설명했어요. 구체적인 설정값이나 외부에 공개된 코드, 프롬프트 예시는 포함되어 있지 않아요. 팀 내부의 신뢰 기준, 위험도 분류, 승인 정책 등은 각 조직 상황에 맞게 조정해야 해요.

출처

Anthropic Claude.dev 블로그 원문 ↗

예시 프롬프트 · Claude Code

목표: 코드 변경의 대부분을 AI가 자동으로 리뷰하고, 위험이 높은 변경만 사람이 직접 승인하는 팀 운영 방식을 구현하고 싶습니다.

필요한 입력 및 환경:
- GitHub 저장소와 풀리퀘스트(PR) 기반 개발 환경
- Claude Code(또는 유사한 AI 코드 리뷰 도구) 사용 권한
- 프로젝트별 CLAUDE.md(프로젝트 설명, 스택, 규칙 등)와 REVIEW.md(리뷰 기준, 실패 예시, 스킵 경로 등) 문서 작성
- 린트, 타입 체크, 자동 테스트, 빌드 등 자동화된 CI 파이프라인
- 보안 리뷰용 GitHub Action 또는 /security-review 명령
- 위험도 분류 기준(예: 저위험: 문서/내부 기능, 중위험: 주요 기능, 고위험: 결제/빌드/CI 등)
- 신뢰받는 작성자 목록 및 승인 정책

구현 및 설정 순서:
1. CLAUDE.md와 REVIEW.md를 각 저장소에 작성해 AI 리뷰어가 참고할 수 있게 합니다.
2. PR 생성 시 자동으로 /code-review와 /security-review를 실행하도록 워크플로를 설정합니다.
3. 린트, 타입 체크, 테스트, 빌드 등 자동화된 검증을 PR에 통합합니다.
4. PR 템플릿에 테스트 방법, 위험도, 롤백 방법을 명시하는 항목을 추가합니다.
5. 위험도 분류 로직(예: 경로, 변경 내용, 작성자 신뢰도 기반)을 구현해, 저위험 PR은 자동화만으로, 중위험 이상은 한 명 또는 두 명의 승인을 요구하도록 합니다.
6. 신뢰받는 작성자만 자동화 경로를 이용할 수 있게 하고, 나머지는 항상 사람 승인을 요구합니다.
7. 머지 큐에서 모든 체크를 다시 실행해, 병합 후 문제가 없도록 합니다.
8. 새 기능은 플래그로 내부 직원에게 먼저 배포하고, 점진적으로 공개합니다.
9. 사고나 롤백 사례를 모아 AI 리뷰어의 평가 세트로 활용하고, 반복되는 피드백은 룰이나 문서로 개선합니다.

결과물:
- 대부분의 PR이 AI 리뷰와 자동화된 검증만으로 병합되고, 위험이 높은 변경만 사람이 직접 승인하는 워크플로
- 사고 발생 시 빠른 롤백과 원인 분석, 리뷰 프로세스 개선 체계

검증 조건:
- PR별로 자동화 리뷰, 보안 체크, 린트/테스트/빌드가 정상 동작하는지 확인합니다.
- 위험도 분류와 승인 정책이 실제로 적용되는지 샘플 PR로 테스트합니다.
- 사고 발생 시 롤백 및 평가 체계가 작동하는지 점검합니다.