# 바선생 (Vibe Sunsang) 바이브코더를 위한 AI 멘토 에이전트. Claude Code와 나눈 **모든 대화를 자동으로 수집, 변환, 분석**하여 더 나은 AI 협업자로 성장할 수 있게 도와줍니다. --- ## 이런 분을 위한 도구입니다 - 개발 지식 없이 AI로 코딩하는 **바이브코더** - "나는 뭘 잘못하고 있는 거지?" 궁금한 사람 - 매주 내가 한 작업을 돌아보며 **AI 활용 실력을 키우고 싶은** 사람 - AI한테 "고쳐줘"만 반복하다가 지친 사람 --- ## 어떻게 작동하나요? ``` Claude Code 대화 기록 (JSONL) ↓ 자동 변환 읽기 좋은 Markdown 파일 ↓ 분석 멘토링 / 성장 리포트 / 패턴 발견 ``` Claude Code는 여러분이 나눈 모든 대화를 `~/.claude/projects/`에 JSONL 파일로 저장합니다. 바선생은 이 파일들을 **읽기 좋은 Markdown으로 변환**하고, 프로젝트별로 정리한 뒤, 여러분의 요청 패턴, 실수 습관, 성장 지표를 분석합니다. --- ## 설치 방법 ### 1. 마켓플레이스 등록 (처음 한 번만) ``` /plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git ``` ### 2. 플러그인 설치 ``` /plugin install vibe-sunsang ``` ### 3. 업데이트 플러그인이 업데이트되면 아래 명령어로 최신 버전을 받을 수 있습니다: ``` /plugin update ``` > 설치/업데이트 후에는 Claude Code를 **재시작**하세요. ### 처음 시작하기 아무 프로젝트에서: ``` /vibe-sunsang 시작 ``` 온보딩이 하는 일: 1. Claude Code 대화 기록(`~/.claude/projects/`) 탐색 2. 발견된 프로젝트에 읽기 좋은 이름 지정 3. 워크스페이스 유형 분류 (Builder/Explorer/Designer/Operator) 4. 모든 JSONL 대화를 Markdown으로 첫 변환 5. 바로 시작할지 선택 (멘토링 / 성장 리포트 / 나중에) --- ## 핵심 기능 ### 1. `/vibe-sunsang 변환` - 대화 변환 + 분석 가이드 JSONL 로그를 Markdown으로 변환하고, 분석 방법을 안내합니다. ``` /vibe-sunsang 변환 ← 새 대화만 변환 (증분) /vibe-sunsang 변환 force ← 전체 재변환 /vibe-sunsang 변환 프로젝트명 ← 특정 프로젝트만 변환 ``` **변환 결과:** - 프로젝트별 폴더로 정리된 Markdown 파일 - 각 파일에 메타데이터 포함 (날짜, 토큰 수, 사용 모델, 도구 목록) - 전체 인덱스(`INDEX.md`)로 한눈에 파악 --- ### 2. `멘토링해줘` - AI 활용 능력 코칭 4가지 모드로 맞춤형 멘토링을 제공합니다. | 모드 | 트리거 | 하는 일 | |------|--------|---------| | **A: 요청 품질 코칭** | "요청 코칭해줘" | 내 요청이 얼마나 명확했는지 A~D 등급으로 채점 | | **B: 안티패턴 진단** | "뭘 잘못하고 있는지" | 8가지 나쁜 습관 체크. 구체적 사례와 해결 전략 | | **C: 개념 학습** | "이게 뭐야" | 최근 대화에 나온 개념을 비유와 예시로 쉽게 설명 | | **D: 종합 코칭** (기본) | "멘토링해줘" | 전체 점검 + 레벨 판정 + 행동 계획 | --- ### 3. `성장 리포트 만들어줘` - 성장 리포트 자동 생성 대량의 세션 데이터를 전용 AI 에이전트가 분석하여 성장 리포트를 자동 생성합니다. **리포트에 포함되는 분석:** 1. **기본 통계** - 총 세션 수, 메시지 수, 토큰 사용량 2. **요청 품질 분석** - 구체적/모호한 요청 비율 3. **안티패턴 탐지** - 유형별 나쁜 습관 체크 4. **성장 지표** - 유형별 성장 지표 추적 5. **레벨 판정** - 5단계 중 현재 위치 6. **이전 리포트 비교** - 트렌드 분석 --- ## 워크스페이스 유형 시스템 바선생은 각 프로젝트의 **워크스페이스 목적**에 따라 다른 기준으로 분석합니다. | 유형 | 워크스페이스 목적 | 레벨 시스템 | |------|-------------------|-------------| | **Builder** | 코딩/개발 | Observer → Conductor | | **Explorer** | 리서치/Q&A/학습 | Asker → Scholar | | **Designer** | 기획/아이디에이션 | Dreamer → Visionary | | **Operator** | 업무 자동화 | User → Automator | --- ## 레벨 시스템 바선생은 당신의 AI 활용 수준을 5단계로 진단합니다: | Level | 이름 | 특징 | |-------|------|------| | 1 | **Observer** | "만들어줘"만 요청, 결과를 그대로 수용 | | 2 | **Questioner** | "왜?"라고 물어보기 시작 | | 3 | **Collaborator** | 구체적으로 요청, 대안을 질문 | | 4 | **Orchestrator** | 작업을 나눠서 지시, 검증 주도 | | 5 | **Conductor** | 여러 AI를 조율, 기술적 의사결정 | *(레벨명은 워크스페이스 유형에 따라 달라집니다)* --- ## 추천 루틴 ### 매주 금요일 (15분) ``` 1. /vibe-sunsang 변환 ← 이번 주 대화 변환 2. 멘토링해줘 ← 이번 주 리뷰 3. 행동 계획 실천 ← 다음 주에 시도할 것 1가지 ``` ### 매월 1회 (30분) ``` 1. /vibe-sunsang 변환 force ← 전체 변환 2. 성장 리포트 만들어줘 ← 월간 성장 리포트 3. 이전 리포트와 비교 ← 자동으로 트렌드 분석 ``` --- ## 사용자 데이터 바선생의 모든 사용자 데이터는 `~/vibe-sunsang/`에 저장됩니다: ``` ~/vibe-sunsang/ ├── config/ ← 설정 (프로젝트 매핑, 유형 분류) ├── conversations/ ← 변환된 대화 Markdown └── exports/ ← 성장 리포트, 멘토링 결과 ``` 플러그인 코드와 사용자 데이터가 완전히 분리되어, 플러그인 업데이트 시 데이터가 영향받지 않습니다. --- ## 요구사항 - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) - Python 3.8+ --- ## 라이선스 MIT