인프런 커뮤니티 질문&답변

Claude Code Custom Command 을 프로젝트 레벨로 등록 후 Max Plan을 구독중인데 5분만 사용해도 Context 가 소진되고 있습니다.

혹시 해당 Command 을 사용하지 않아도 토큰을 소비하는것일까요?

저의 생각이 맞다면 Command 의 내용을 간략화 하기 위하여 지침을 참조 문서로 변경하면 개선이 될까요?
Skiil 로 변경하는것이 좋을까요?

참고로 제가 추가한 Command 입니다.

# BlockNote Upgrade Command

BlockNote 패키지를 최신 버전으로 업그레이드합니다.

## 실행 방법

이 명령은 다음 작업을 순서대로 수행합니다:

1. 현재 BlockNote 버전 확인
2. npm registry에서 최신 버전 조회
3. GitHub releases에서 변경사항 분석
4. Peer dependencies 호환성 검사
5. 사용자 확인 후 업그레이드 수행
6. 빌드 검증

---

## 지시사항

### Step 1: 현재 버전 확인

pnpm-workspace.yaml 파일에서 현재 BlockNote 버전을 확인하세요:

```yaml
"@blocknote/core": &blocknote "X.X.X"
```

관련 의존성 버전도 함께 확인:
- @mantine/core
- @tiptap/core
- @shikijs/core

### Step 2: 최신 버전 조회

npm registry에서 최신 버전을 확인하세요:

```bash
npm view @blocknote/core version
```

### Step 3: 릴리스 노트 분석

GitHub releases 페이지에서 변경사항을 확인하세요:

```
WebFetch: https://github.com/TypeCellOS/BlockNote/releases
```

다음 항목을 확인:
- Breaking Changes 여부
- 새로운 기능
- 버그 수정
- Peer dependency 변경

### Step 4: Peer Dependencies 확인

BlockNote가 의존하는 패키지들의 버전을 확인하세요.

확인할 파일들:

| 패키지 | URL | 확인할 의존성 |
|--------|-----|--------------|
| @blocknote/mantine | https://raw.githubusercontent.com/TypeCellOS/BlockNote/main/packages/mantine/package.json | @mantine/core, @mantine/hooks |
| @blocknote/core | https://raw.githubusercontent.com/TypeCellOS/BlockNote/main/packages/core/package.json | @tiptap/*, yjs |
| @blocknote/react | https://raw.githubusercontent.com/TypeCellOS/BlockNote/main/packages/react/package.json | react, react-dom |
| @blocknote/code-block | https://raw.githubusercontent.com/TypeCellOS/BlockNote/main/packages/code-block/package.json | @shikijs/* |

우선순위:
1. @blocknote/mantine → Mantine (가장 자주 변경)
2. @blocknote/core → Tiptap, Yjs
3. @blocknote/react → React
4. @blocknote/code-block → Shikijs

WebFetch로 각 package.json을 확인하고 peerDependencies 섹션에서 버전 요구사항을 추출하세요.

### Step 5: 버전 비교 및 변경사항 정리

현재 프로젝트의 버전과 BlockNote가 요구하는 버전을 비교하여 표로 정리:

| 패키지 | 현재 버전 | 필요 버전 | 업데이트 필요 |
|--------|----------|----------|--------------|
| @blocknote/* | X.X.X | Y.Y.Y | O/X |
| @mantine/core | ^X.X.X | ^Y.Y.Y | O/X |
| ... | ... | ... | ... |

### Step 6: 사용자 확인

변경사항을 사용자에게 보여주고 진행 여부를 확인하세요:

- Breaking Changes가 있으면 경고
- 업데이트할 패키지 목록 표시
- 진행 의사 확인

### Step 7: pnpm-workspace.yaml 수정

승인되면 pnpm-workspace.yaml을 수정하세요:

```yaml
# BlockNote 버전 업데이트
"@blocknote/core": &blocknote "NEW_VERSION"

# 필요시 관련 패키지도 업데이트
"@mantine/core": &mantine "^NEW_VERSION"
```

### Step 8: Clean Install

메이저 의존성 업그레이드 시 기존 node_modules를 정리하고 새로 설치합니다:

```bash
# node_modules 및 dist 폴더 삭제
pnpm clean

# 의존성 새로 설치
pnpm install
```

> 이 단계는 캐시된 이전 버전 패키지로 인한 호환성 문제를 방지합니다.

### Step 9: 빌드 검증

```bash
pnpm --filter @collaboration/common build
pnpm --filter @collaboration/editor build
```

### Step 10: 결과 보고

업그레이드 결과를 보고:
- 변경된 패키지 버전
- 빌드 성공 여부
- 다음 단계 안내 (개발 서버 실행, 기능 테스트)

---

## 롤백 안내

문제 발생 시 이전 버전으로 롤백하는 방법도 안내하세요:

```yaml
# pnpm-workspace.yaml에서 이전 버전으로 변경
"@blocknote/core": &blocknote "PREVIOUS_VERSION"
```

```bash
pnpm install
```

---

## 참고 문서

- 업그레이드 가이드: docs/blocknote-upgrade-guide.md
- pnpm catalog 가이드: docs/pnpm-catalog-guide.md
- BlockNote 공식 문서: https://www.blocknotejs.org/docs
- GitHub 저장소: https://github.com/TypeCellOS/BlockNote