# GitLab MR 자동 코드 리뷰 봇
## 한 줄 요약
> GitLab MR에 `@claude`를 멘션하면 Claude가 코드를 분석해 리뷰 댓글을 자동으로 달아주는 봇
---
## 문제 인식
- 코드 리뷰는 시간이 많이 걸리고 놓치는 이슈가 생김
- 리뷰어마다 관점이 달라 일관성 부족
- 리뷰 대기 시간 동안 개발 흐름이 끊김
---
## 동작 방식
```
개발자가 MR에 "@claude 리뷰" 댓글
↓
GitLab Webhook → 봇 서버
↓
변경 파일 diff + 주변 코드 컨텍스트 수집
↓
Claude API 호출
↓
버그 / 보안 / 성능 / 코드품질 리뷰 결과
+ 각 이슈를 해당 라인에 인라인 댓글로 게시
```
---
## 주요 기능
| 기능 | 설명 |
|------|------|
| 자동 코드 리뷰 | 버그·보안·성능·코드품질 항목별 분석 |
| 인라인 댓글 | 이슈 발생 라인에 직접 discussion 게시 |
| 프로젝트 맞춤 기준 | `CLAUDE.md`로 팀별 리뷰 기준 주입 |
| 중복 생략 | 기존 댓글 참조해 이미 지적된 내용 제외 |
| 추가 파일 요청 | Claude가 필요한 파일을 직접 요청 후 재리뷰 |
| 자유 질문 | 리뷰 외 MR 코드 기반 Q&A |
| 스레드 답글 | 리뷰 discussion에 후속 질문 대응 |
---
## 기술적 포인트
1. **컨텍스트 전략** — diff만 보내는 게 아니라 변경 주변 코드까지 3단계로 구성해 리뷰 정확도 향상
2. **CLAUDE.md 활용** — 저장소 내 파일로 팀 컨벤션을 프롬프트에 자동 주입, 프로젝트마다 다른 기준 적용 가능
3. **Claude의 능동적 참여** — 리뷰 전 필요한 파일을 Claude가 직접 요청하는 양방향 구조
4. **기존 리뷰 인식** — 이전 리뷰 내용을 읽고 중복 지적을 스스로 걸러냄
---
## 효과
- 리뷰 대기 시간 단축
- 놓치기 쉬운 보안·엣지케이스 자동 포착
- 리뷰어는 Claude 결과를 검토하는 방식으로 부담 감소
