claude-pr-logger

Claude PR Logger

Claude Code에서 개발 과정을 자동으로 기록하여 PR 작성 시 활용할 수 있는 플러그인입니다.

왜 만들었나요?

AI 시대의 코드 리뷰 패러다임 변화

AI를 활용한 개발이 보편화되면서 개발 속도와 생성되는 코드의 양이 급격히 증가했습니다. 하지만 기존의 코드 리뷰 방식은 이러한 변화를 따라가지 못하고 있습니다.

기존 방식의 한계:

• 한 PR에 수백, 수천 줄의 변경사항
• 모든 코드를 라인 바이 라인으로 검토하기 어려움
• AI가 생성한 코드의 의도를 파악하기 힘듦

새로운 코드 리뷰: 컨텍스트 리뷰

이제는 "어떤 코드가 생성되었는가"보다 "어떤 맥락에서, 어떤 명령으로 코드가 생성되었는가"를 리뷰해야 합니다.

컨텍스트 리뷰의 장점:

• 개발자가 AI에게 내린 명령과 의도를 확인
• 문제 해결 과정과 의사결정 흐름을 추적
• 코드 변경의 "왜"를 이해하고 리뷰

PR Logger의 역할

이 플러그인은 개발자와 AI 간의 대화를 자동으로 기록하여:

1. 개발 컨텍스트 보존 - 어떤 요청으로 코드가 생성되었는지 기록
2. 의사결정 추적 - 왜 이런 방식으로 구현했는지 확인 가능
3. 효율적인 리뷰 - 코드보다 맥락을 중심으로 빠른 리뷰
4. 지식 공유 - 팀원들이 개발 과정을 이해하고 학습

기능

• 브랜치별 로그 분리: Git 브랜치마다 별도의 로그 파일 자동 생성
• 자동 질문 기록: 사용자의 모든 질문을 타임스탬프와 함께 기록
• 답변 요약 트리거: 이전 답변을 요약하도록 Claude에게 자동 알림
• 에러 메시지 요약: 긴 에러 메시지를 자동으로 요약 (30줄 이상)
• PR용 로그: 개발 과정을 PR에 그대로 활용 가능

브랜치별 로그 파일

.claude/pr-logger/
├── session-log-feature-10-geofence-management.md
├── session-log-feature-11-worker-api.md
├── session-log-develop.md
└── session-log-main.md

브랜치를 전환하면 자동으로 해당 브랜치의 로그 파일을 사용합니다.

설치 방법

방법 1: GitHub에서 설치 (권장)

# Claude Code에서 실행
/plugin install pr-logger@MMMIIIN/claude-pr-logger

설치 후 Claude Code를 재시작하세요.

방법 2: 마켓플레이스 등록 후 설치

# 1. 마켓플레이스 추가
/plugin marketplace add MMMIIIN/claude-pr-logger

# 2. 플러그인 설치
/plugin install pr-logger

삭제 방법

방법 1: 명령어로 삭제 (권장)

# Claude Code에서 실행
/pr-logger:uninstall

Claude가 캐시, 마켓플레이스, 설정 파일을 모두 정리합니다.

방법 2: 기본 삭제

/plugin uninstall pr-logger

주의: 기본 삭제 후 Hook 에러가 발생하면 /pr-logger:uninstall 명령어를 사용하세요.

삭제 후 Claude Code를 재시작하세요.

동작 원리

플러그인은 다음과 같은 흐름으로 동작합니다:

┌─────────────────────────────────────────────────────────────────┐
│                        첫 번째 질문                              │
├─────────────────────────────────────────────────────────────────┤
│  1. 사용자가 질문 입력                                           │
│  2. Hook이 질문을 session-log.md에 기록                          │
│  3. Claude가 답변                                                │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                        두 번째 질문                              │
├─────────────────────────────────────────────────────────────────┤
│  1. 사용자가 다음 질문 입력                                       │
│  2. Hook이 질문을 session-log.md에 기록                          │
│  3. Hook이 <pr-log-reminder> 메시지를 Claude에게 전달            │
│  4. Claude가 이전 답변을 요약하여 session-log.md에 추가           │
│  5. Claude가 현재 질문에 답변                                    │
└─────────────────────────────────────────────────────────────────┘
                              ↓
                        (반복...)

핵심 포인트:

• 질문은 입력 즉시 자동 기록됩니다
• 답변 요약은 다음 질문 시 Claude가 작성합니다
• 이를 통해 질문-답변 쌍이 순차적으로 기록됩니다

사용법

자동 기록

플러그인 설치 후 자동으로 동작합니다:

1. 질문을 입력하면 .claude/pr-logger/session-log.md에 기록됨
2. 다음 질문 시 이전 답변 요약을 자동으로 추가

슬래시 명령어

명령어	설명
/pr-logger:pr-log	현재 PR용 개발 로그 확인
/pr-logger:pr-log-clear	PR 작성 완료 마커 추가
/pr-logger:pr-log-all	전체 개발 로그 확인
/pr-logger:uninstall	플러그인 완전 삭제 (캐시, 설정 파일 모두 정리)

로그 형식

# PR 개발 로그

브랜치: `feature-10-geofence-management`
세션 ID: `abc123`
시작 시간: 2025-12-22 10:00:00

---

## [2025-12-22 10:00:00] 질문

사용자 질문 내용

### 답변 요약
- 수행한 작업 1
- 수행한 작업 2
- 커밋: `abc1234`

CLAUDE.md 설정 (권장)

프로젝트의 CLAUDE.md에 다음 내용을 추가하면 더 정확하게 동작합니다:

## PR 개발 로그 자동화

`<pr-log-reminder>` 메시지가 표시되면:

1. `.claude/pr-logger/session-log.md`를 읽어서 마지막 질문 확인
2. 해당 질문에 대한 이전 답변을 간결하게 요약 (2-5줄)
3. 요약 내용을 `### 답변 요약` 형식으로 추가
4. 그 후 현재 질문에 대한 답변 진행

파일 구조

claude-pr-logger/
├── .claude-plugin/
│   ├── plugin.json          # 플러그인 매니페스트
│   └── marketplace.json     # 마켓플레이스 등록 정보
├── hooks/
│   └── hooks.json           # Hook 설정
├── scripts/
│   └── log-prompt.py        # 로깅 스크립트
├── commands/
│   ├── pr-log.md            # 로그 확인 명령어
│   ├── pr-log-clear.md      # 완료 마커 명령어
│   └── pr-log-all.md        # 전체 로그 명령어
└── README.md

라이선스

MIT License