🦆 러버덕 디버깅 실습 프로젝트

📺 YouTube 영상

🎯 프로젝트 개요

⚡ 빠른 시작

1단계: Clone

git clone https://github.com/dingcodingco/rubber-duck-demo
cd rubber-duck-demo

2단계: CLAUDE.md 확인

cat CLAUDE.md

3단계: 데모 실행

🌱 Spring Boot 순환 참조

cd 01-spring-circular
./mvnw spring-boot:run
# BeanCurrentlyInCreationException 발생 확인
# Claude Code 실행
claude
# 러버덕과 대화하며 해결

🧮 알고리즘 최적화

cd 02-algorithm
javac TwoSumBruteForce.java && java TwoSumBruteForce
javac TwoSumOptimal.java && java TwoSumOptimal
javac TwoSumTest.java && java TwoSumTest

📁 프로젝트 구조

rubber-duck-demo/
│
├── CLAUDE.md # ⭐ 러버덕 에이전트 설정
│
├── 01-spring-circular/ # Spring Boot 순환 참조 데모
│ ├── service/
│ │ ├── UserService.java # ❌ 문제 버전
│ │ └── OrderService.java # ❌ 문제 버전
│ ├── service_fixed/
│ │ ├── *Lazy.java # ✅ @Lazy 해결
│ │ └── *Setter.java # ✅ Setter 주입 해결
│ └── README.md
│
├── 02-algorithm/ # Two Sum 알고리즘 데모
│ ├── TwoSumBruteForce.java # ❌ O(n2) 버전
│ ├── TwoSumOptimal.java # ✅ O(n) HashMap 버전
│ ├── TwoSumTest.java # 성능 비교
│ └── README.md
│
└── README.md # 이 파일

🎓 러버덕 방식의 효과

📊 연구 결과

🦆 러버덕이 하는 일

❌ 하지 않는 것 (꽥! 안 돼요!)

✅ 하는 것 (오리오리~ 이건 좋아요!)

💬 대화 예시

일반 AI (답 주기)

나: BeanCurrentlyInCreationException이 나요
AI: 순환 참조 문제입니다. @Lazy를 추가하세요:
 @Service
 public class UserService {
 public UserService(@Lazy OrderService orderService) {
 ...
 }
 }

러버덕 AI (질문하기)

나: BeanCurrentlyInCreationException이 나요
🦆: 오리오리~ 각 서비스가 무슨 일을 하는지, 그리고 왜 서로가
 필요한지 설명해줄 수 있어요?
나: UserService는 최근 주문을 가져와야 해서 OrderService가
 필요하고, OrderService는 주문할 때 유저 검증이 필요해서
 UserService가 필요해요
🦆: 오호~ 그 의존성 화살표를 그림으로 그린다면, 어떤 모양이 될까요?
 마치 연못에서 오리들이 서로를 따라가는 것처럼요!
나: 음... 서로를 가리키니까... 원형? 아, 순환이네
🦆: 꽥! 맞아요! 그럼 OrderService가 유저를 검증하는 게,
 '객체가 생성되는 시점'에 꼭 필요한 건가요?
 아니면 '주문이 실제로 들어올 때'만 필요한 건가요?
나: 주문이 들어올 때만... 아! 그러면 생성자 주입이 아니라
 메서드 호출 시점에 가져오면 되겠네요!
🦆: 🎉 오리오리! 완벽해요! 스스로 핵심을 찾아냈어요!
 '생성 시점'과 '사용 시점'의 차이를 발견한 게 대단해요! ✨

🚀 적용 분야

✅ 효과적인 분야

⚠️ 제한적인 분야

🛠️ 커스터마이징

CLAUDE.md 수정

# 🦆 러버덕 디버깅 파트너
## 특화 모드 추가
- 시스템 설계 면접 모드: 대규모 시스템 설계 시 트레이드오프 질문
- 코드 리뷰 모드: 개선점 발견을 위한 질문
- 알고리즘 모드: 시간/공간 복잡도 분석 질문

Skills 추가 (고급)

# ~/.claude/skills/rubber-duck.js 생성
# 더 세밀한 대화 흐름 제어

📚 참고 자료

논문 & 연구

관련 자료

🤝 기여하기

📝 라이센스

💬 피드백

⭐ Star 주세요!