| name | upgrade-claude-code |
| description | Claude Code 설정 업그레이드 |
| user-invocable | true |
현재 설정을 분석하고 최신 트렌드를 반영하여 업그레이드를 제안합니다. 어떤 프로젝트, 어떤 언어에서든 동일하게 작동합니다.
/upgrade-claude-code
문제: AI 도구는 빠르게 변화하므로 설정이 금방 구식이 됨
해결: WebSearch로 최신 트렌드 조사 + 현재 설정 분석 + 개선 제안
결과: 항상 최신 베스트 프랙티스 유지 (정기적으로 실행 권장)
반드시 다음 문서를 먼저 읽습니다:
.claude/docs/CLAUDE-CODE-MASTERY.md # 목차 및 핵심 개념
.claude/docs/mastery/04-curriculum.md # 레벨 시스템 정의 (단일 소스)
.claude/docs/mastery/05-advanced.md # 최신 트렌드 분석 방법
.claude/docs/mastery/01-settings-guide.md # 설정 요소별 상세 (MCP 추천 포함)
# 분석 대상
1. CLAUDE.md - 규칙 수, 상세도
2. .claude/settings.local.json - 훅, 권한 설정
3. .claude/commands/ - 커맨드 수, 품질
4. .claude/agents/ - 에이전트 수, 전문성
5. .claude/skills/ - 스킬 수, 도메인 커버리지
6. .mcp.json - 연결된 외부 도구
7. .github/workflows/ - CI/CD 자동화
중요: 레벨 정의, 항목별 체크리스트, 대시보드 형식은 모두 .claude/docs/mastery/04-curriculum.md의 "4.0 Claude Code 설정 현황 시스템"을 참조합니다.
해당 문서에서 다음 내용을 확인:
AI 도구는 빠르게 변화하므로, 시간대별로 검색을 세분화합니다.
검색어:
- "Claude Code best practices {current_year}"
- "Claude Code setup guide {current_year}"
- "Boris Cherny Claude Code tips"
검색어:
- "Claude Code updates {current_month} {current_year}"
- "Claude Code new features {current_month}"
- "Anthropic Claude Code changelog {current_month}"
검색어:
- "Claude Code this week"
- "Claude Code latest news"
- "MCP servers new releases"
| 카테고리 | 검색어 | 중요도 |
|---|---|---|
| Features | "Claude Code new feature" | 높음 |
| Breaking | "Claude Code breaking change deprecated" | 높음 |
| Integration | "Claude MCP server new {current_year}" | 중간 |
| 플랫폼 | 검색어 | 특징 |
|---|---|---|
| site:reddit.com Claude Code {current_month} | 실사용 리뷰, 팁 | |
| HN | site:news.ycombinator.com Claude Code | 기술적 토론, 비판적 시각 |
| Discord | Anthropic Discord 채널 직접 확인 | 실시간 기술 지원 |
| GitHub | "Claude Code" in:readme stars:>50 pushed:>{last_week} | 인기 프로젝트 |
## 개선점 우선순위
### 높음 (레벨업 가능)
- [x] CLAUDE.md 규칙 상세화 → 레벨 1 달성
- [x] Skills 폴더 추가 → 레벨 4 달성
- [x] 누락된 Agents 추가 → 레벨 3 달성
### 중간 (체크리스트 완성)
- [ ] 새로운 MCP 서버 연결
- [ ] 커맨드 추가
- [ ] 훅 고도화
### 낮음 (세부 요소 보완)
- [ ] 기존 설정 최적화
- [ ] 문서 개선
## 업그레이드 제안
### 현재 레벨: {N} ({레벨명}) - {X}/8 항목
### 권장 업그레이드
1. **[높음]** Skills 폴더 추가
- 효과: 레벨 4 달성
- 설명: 도메인별 전문 컨텍스트 제공
2. **[중간]** 새 MCP 서버 연결
- 효과: MCP 체크리스트 완성
- 설명: 프로젝트 의존성 기반 연동
3. **[낮음]** 커맨드 추가
- 효과: Commands 세부 요소 완성
- 설명: 추가 자동화
### 트렌드 분석 결과
🔥 **년도 트렌드 ({current_year})**:
| 트렌드 | 설명 | 적용 권장 |
|--------|------|:--------:|
| {트렌드 1} | {설명} | 높음/중간/낮음 |
| {트렌드 2} | {설명} | 높음/중간/낮음 |
⚡ **월간 트렌드 ({current_month})**:
| 업데이트 | 날짜 | 영향도 |
|----------|------|:------:|
| {업데이트 1} | {날짜} | 높음/중간/낮음 |
📢 **주간 핫토픽**:
- 🔥 [높음] {핫토픽 1}
- ⚡ [중간] {핫토픽 2}
- 📢 [정보] {핫토픽 3}
업그레이드를 적용하시겠습니까?
1. 전체 적용
2. 선택적 적용 (번호 선택)
3. 취소
사용자 승인 시:
프로젝트에 트렌드 체크 리마인더를 제안합니다:
## CLAUDE.md에 추가할 내용 (선택)
## 트렌드 체크 일정
- 마지막 체크: {today}
- 다음 체크 권장: {next_check_date}
- 실행: /upgrade-claude-code
권장 체크 주기:
| 프로젝트 유형 | 권장 주기 | 이유 |
|---|---|---|
| 활발한 개발 | 주 1회 | AI 도구 변화가 빠름 |
| 유지보수 | 월 1회 | 주요 업데이트만 확인 |
| 안정화 단계 | 분기 1회 | Breaking Changes만 확인 |
🚀 Claude Code 업그레이드 완료!
📊 레벨 변화: {N} ({레벨명}) → {N+1} ({새레벨명})
📈 진행 현황: {X}/8 → {Y}/8 항목
📝 적용된 변경:
- Skills 폴더 생성 (4개) ✅
- 새 MCP 서버 연결 (MongoDB) ✅
- CLAUDE.md 규칙 추가 ✅
🔥 반영된 최신 트렌드:
- {트렌드 1}
- {트렌드 2}
🎯 다음 단계:
- 새로운 설정 테스트
- 팀원과 공유
- /learn-claude-code 로 새 기능 학습
# 백업에서 복원
git checkout HEAD~1 -- .claude/
git checkout HEAD~1 -- CLAUDE.md
git checkout HEAD~1 -- .mcp.json
⚠️ 마스터 가이드 문서를 찾을 수 없습니다.
해결 방법:
1. bkit-starter 저장소에서 .claude/docs/ 폴더를 복사하세요
2. /learn-claude-code 로 현재 상태 확인
⚠️ 트렌드 검색에 실패했습니다.
가능한 원인:
- 네트워크 연결 문제
- WebSearch 도구 사용 불가
대안:
→ 공식 채널에서 직접 확인 (아래 참고 문서 참조)
→ 트렌드 분석 없이 현재 설정만 평가: /learn-claude-code
⚠️ 업그레이드 적용에 실패했습니다.
복구 방법:
→ git checkout HEAD~1 -- .claude/ (위 롤백 방법 참조)
수동 적용하려면:
→ 01-settings-guide.md 참조하여 직접 수정