Skill

upgrade-claude-code

Analyzes Claude Code setup including CLAUDE.md, commands, agents, skills, MCP, and CI/CD; evaluates mastery levels; researches latest trends; suggests prioritized upgrades.

GitHub Actions

CI/CD

Git

developer-tools

automation

Install

npx claudepluginhub gaegulgaegul/gaegulzip --plugin bkit-starter

Tool Access

This skill uses the workspace's default tool permissions.

Preview

현재 설정을 분석하고 **최신 트렌드를 반영**하여 업그레이드를 제안합니다.

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars42

Forks12

Last CommitJan 14, 2026

Actions

View Source View Plugin View on GitHub View README

Claude Code 설정 업그레이드

현재 설정을 분석하고 최신 트렌드를 반영하여 업그레이드를 제안합니다. 어떤 프로젝트, 어떤 언어에서든 동일하게 작동합니다.

사용법

/upgrade-claude-code

왜 이 커맨드가 필요한가?

문제: AI 도구는 빠르게 변화하므로 설정이 금방 구식이 됨
해결: WebSearch로 최신 트렌드 조사 + 현재 설정 분석 + 개선 제안
결과: 항상 최신 베스트 프랙티스 유지 (정기적으로 실행 권장)

수행 작업

1단계: 마스터 가이드 참조

반드시 다음 문서를 먼저 읽습니다:

.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 추천 포함)

2단계: 현재 설정 분석

# 분석 대상
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 자동화

3단계: 레벨 및 체크리스트 평가

중요: 레벨 정의, 항목별 체크리스트, 대시보드 형식은 모두 .claude/docs/mastery/04-curriculum.md의 "4.0 Claude Code 설정 현황 시스템"을 참조합니다.

해당 문서에서 다음 내용을 확인:

레벨 정의 (0-5)
항목별 체크리스트 (8개 항목)
대시보드 출력 형식
빠른 레벨업 가이드

4단계: 시간대별 트렌드 조사 (WebSearch)

AI 도구는 빠르게 변화하므로, 시간대별로 검색을 세분화합니다.

4.1 년도 트렌드 (연간 베스트 프랙티스)

검색어:

- "Claude Code best practices {current_year}"
- "Claude Code setup guide {current_year}"
- "Boris Cherny Claude Code tips"

4.2 월간 트렌드 (최근 업데이트)

검색어:

- "Claude Code updates {current_month} {current_year}"
- "Claude Code new features {current_month}"
- "Anthropic Claude Code changelog {current_month}"

4.3 주간 트렌드 (핫 토픽)

검색어:

- "Claude Code this week"
- "Claude Code latest news"
- "MCP servers new releases"

4.4 카테고리별 검색 (선택적)

카테고리	검색어	중요도
Features	"Claude Code new feature"	높음
Breaking	"Claude Code breaking change deprecated"	높음
Integration	"Claude MCP server new {current_year}"	중간

4.5 플랫폼별 검색 (선택적)

플랫폼	검색어	특징
Reddit	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}	인기 프로젝트

5단계: 개선점 식별

## 개선점 우선순위

### 높음 (레벨업 가능)
- [x] CLAUDE.md 규칙 상세화 → 레벨 1 달성
- [x] Skills 폴더 추가 → 레벨 4 달성
- [x] 누락된 Agents 추가 → 레벨 3 달성

### 중간 (체크리스트 완성)
- [ ] 새로운 MCP 서버 연결
- [ ] 커맨드 추가
- [ ] 훅 고도화

### 낮음 (세부 요소 보완)
- [ ] 기존 설정 최적화
- [ ] 문서 개선

6단계: 사용자에게 제안

## 업그레이드 제안

### 현재 레벨: {N} ({레벨명}) - {X}/8 항목

### 권장 업그레이드

1. **[높음]** Skills 폴더 추가
   - 효과: 레벨 4 달성
   - 설명: 도메인별 전문 컨텍스트 제공

2. **[중간]** 새 MCP 서버 연결
   - 효과: MCP 체크리스트 완성
   - 설명: 프로젝트 의존성 기반 연동

3. **[낮음]** 커맨드 추가
   - 효과: Commands 세부 요소 완성
   - 설명: 추가 자동화

### 트렌드 분석 결과

🔥 **년도 트렌드 ({current_year})**:
| 트렌드 | 설명 | 적용 권장 |
|--------|------|:--------:|
| {트렌드 1} | {설명} | 높음/중간/낮음 |
| {트렌드 2} | {설명} | 높음/중간/낮음 |

⚡ **월간 트렌드 ({current_month})**:
| 업데이트 | 날짜 | 영향도 |
|----------|------|:------:|
| {업데이트 1} | {날짜} | 높음/중간/낮음 |

📢 **주간 핫토픽**:
- 🔥 [높음] {핫토픽 1}
- ⚡ [중간] {핫토픽 2}
- 📢 [정보] {핫토픽 3}

7단계: 사용자 승인 대기

업그레이드를 적용하시겠습니까?

1. 전체 적용
2. 선택적 적용 (번호 선택)
3. 취소

8단계: 업그레이드 적용

사용자 승인 시:

백업 생성 (기존 파일)
새 설정 적용
변경 사항 요약

9단계: 지속적 업데이트 알림 (선택)

프로젝트에 트렌드 체크 리마인더를 제안합니다:

## 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 실패 시

⚠️ 트렌드 검색에 실패했습니다.

가능한 원인:
- 네트워크 연결 문제
- WebSearch 도구 사용 불가

대안:
→ 공식 채널에서 직접 확인 (아래 참고 문서 참조)
→ 트렌드 분석 없이 현재 설정만 평가: /learn-claude-code

업그레이드 적용 실패 시

⚠️ 업그레이드 적용에 실패했습니다.

복구 방법:
→ git checkout HEAD~1 -- .claude/ (위 롤백 방법 참조)

수동 적용하려면:
→ 01-settings-guide.md 참조하여 직접 수정

참고 문서

내부 문서

.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 추천 전략 포함)

공식 채널

커뮤니티 채널

Anthropic Discord - API 지원, MCP 논의
r/ClaudeAI - Claude 관련 토론
Hacker News - 기술적 토론