Help us improve
Share bugs, ideas, or general feedback.
From bkit-starter
Analyzes Claude Code setup including CLAUDE.md, commands, agents, skills, MCP, and CI/CD; evaluates mastery levels; researches latest trends; suggests prioritized upgrades.
npx claudepluginhub gaegulgaegul/gaegulzip --plugin bkit-starterHow this skill is triggered — by the user, by Claude, or both
Slash command
/bkit-starter:upgrade-claude-codeThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
현재 설정을 분석하고 **최신 트렌드를 반영**하여 업그레이드를 제안합니다.
Guides users through configuring and optimizing Claude Code settings, workflows, and team rules across five learning levels.
Analyzes Claude Code setup files in any project, assesses mastery level (0-4) via dashboard, and provides level-specific learning guide with upgrade suggestions.
Analyzes Claude Code usage patterns from history, detects project tech stacks, discovers GitHub community resources, suggests CLAUDE.md improvements, and generates agent/skill/command configs.
Share bugs, ideas, or general feedback.
현재 설정을 분석하고 최신 트렌드를 반영하여 업그레이드를 제안합니다. 어떤 프로젝트, 어떤 언어에서든 동일하게 작동합니다.
/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 참조하여 직접 수정