RetroVibe

AI 도구와의 대화 세션을 자동으로 수집하고 분석하여, 개발 패턴과 인사이트를 추출하는 로컬 기반 분석 도구입니다.

✨ 주요 기능

• 🔄 세션 수집: Claude 세션 자동 수집 (Cursor 지원 예정)
• 🧠 AI 분석: Gemini, Claude, GPT 등 다양한 LLM으로 패턴 분석
• 📝 커스텀 템플릿: 개발 블로그, 방법론 분석 등 다양한 관점
• 💾 로컬 우선: 모든 데이터를 로컬 파일로 안전하게 관리
• 🔍 검색 & 조회: 과거 세션 빠른 검색 및 패턴 분석

🚀 빠른 시작

# 오늘 세션 수집
python cli.py collect

# AI로 분석하여 인사이트 추출
python cli.py analyze

# 개발 블로그 포스트 생성
python cli.py analyze --template dev_blog

# AI Native 개발 방법론 분석
python cli.py analyze --template ai_native_methodology

# 날짜 범위 분석
python cli.py analyze --from-date 2025-09-10 --to-date 2025-09-16

# 커스텀 질문
python cli.py ask "이번 주 React 관련 작업 요약해줘"

💡 사용 사례

• 일일 회고: AI와의 협업 과정을 자동으로 정리하여 개발 회고 작성
• 개발 블로그: 기술적 문제 해결 과정을 블로그 포스트로 자동 생성
• 방법론 분석: AI Native 개발 패턴을 분석하여 팀 워크플로우 개선
• 버그 패턴: 반복되는 문제들을 분석하여 예방 전략 수립
• 생산성 추적: 개발 패턴과 시간 분석으로 효율성 개선

🧠 분석 템플릿

기본 템플릿들

• daily_report: 일일 작업 요약 및 성과 분석
• dev_blog: 전문적인 기술 블로그 포스트
• dev_blog_technical: 고도로 기술적인 포스트
• ai_native_methodology: AI Native 개발 방법론 분석 🆕
• bug_analysis: 버그 패턴 분석
• learning_summary: 학습 내용 정리
• productivity_analysis: 생산성 분석

사용법

# 기본 템플릿
python cli.py analyze --template dev_blog --date 2025-09-16

# 범위 분석
python cli.py analyze --from-date 2025-09-10 --to-date 2025-09-16 --template dev_blog_technical

# AI Native 개발 방법론 분석
python cli.py analyze --template ai_native_methodology --date 2025-09-16

⚙️ 설정

config/settings.yaml에서 다음을 설정할 수 있습니다:

• LLM 제공자: 명령어 커스터마이징
• 데이터 소스: Claude/Cursor/Codex 경로 설정
• 수집 옵션: 텍스트 길이, 도구 포함 여부
• 자동화: cron 스케줄 설정

🔧 LLM 설정

지원하는 LLM CLI 도구들:

• Gemini: gemini -y -p (권장)
• Claude: claude
• GPT-4: gpt4
• GPT-3.5: gpt3

각 도구가 시스템에 설치되어 있어야 합니다.

📅 자동화

cron으로 자동 수집

# 매일 자정에 수집
0 0 * * * cd /path/to/retrovibe && python cli.py collect

# 매일 오전 9시에 분석
0 9 * * * cd /path/to/retrovibe && python cli.py analyze

스크립트로 일괄 처리

#!/bin/bash
cd /path/to/retrovibe

# 어제 세션 수집 및 분석
yesterday=$(date -d "yesterday" +%Y-%m-%d)
python cli.py auto --date $yesterday

# 주간 트렌드 분석 (일요일마다)
if [ $(date +%u) -eq 7 ]; then
    python cli.py trends --days 7
fi

💡 사용 사례

1. 일일 회고

python cli.py analyze
# → 오늘 무엇을 했는지, 어떤 문제를 해결했는지 자동 정리

2. 버그 패턴 분석

python cli.py ask "최근 일주일간 발생한 에러들의 공통점을 찾아줘"

3. 학습 내용 정리

python cli.py analyze --template custom/learning_summary
# → 블로그 포스트용 학습 내용 자동 생성

4. 생산성 분석

python cli.py trends --days 30
# → 한 달간 작업 패턴 및 생산성 분석

5. 특정 프로젝트 검색

python cli.py search --keyword "gpai-monorepo" --days 7
# → 특정 프로젝트 관련 작업만 필터링

6. AI Native 개발 방법론 분석 🆕

python cli.py analyze --template ai_native_methodology --date 2025-09-16
# → 실제 AI 협업 패턴을 분석하여 효과적인 개발 방법론 도출

🔍 문제 해결

수집이 안 될 때

1. Claude 프로젝트 경로 확인: ~/.claude/projects
2. 해당 날짜에 실제 세션이 있는지 확인
3. python collect.py --date 2025-09-17 직접 실행으로 디버깅

분석이 안 될 때

1. LLM CLI 도구가 설치되어 있는지 확인
2. gemini -y -p "test" 같은 명령어로 개별 테스트
3. 프롬프트 템플릿 문법 확인

데이터가 없을 때

python cli.py status
# → 현재 수집된 데이터 상태 확인

📈 확장 아이디어

• 팀 공유: 분석 결과를 팀 위키나 Slack에 자동 포스팅
• 지표 대시보드: 웹 인터페이스로 시각화
• 알림 시스템: 생산성 저하나 특이 패턴 감지시 알림
• 지식 베이스: 해결책들을 자동으로 KB에 축적
• 코드 품질 연동: Git 커밋과 연결하여 코드 품질 분석

---

로컬 우선, 단순함, 실용성을 지향하는 AI 세션 분석 도구입니다. 🚀