# wiki index — 세션 시작 주입 (50줄 캡, 한 줄 = 언제 읽을지의 트리거)

- 라이브러리를 올리거나 새로 고를 때: `.claude/rules/dependencies.md` 결정표 먼저 — radix-ui는 1.6.2 고정(1.6.3 타입 리그레션, incidents 참조)
- 게이트/훅/린트 설정을 고치기 전: `pnpm gate:selftest` — grep 게이트는 조용히 죽는다 (실사례 incidents 참조)
- npm 발행·스캐폴더 파일을 다룰 때: npm pack은 `.gitignore`·`.npmrc`를 제외한다 — 템플릿엔 `gitignore`/`npmrc`로 싣고 CLI가 복원
- 패키지 매니저 라이프사이클: pnpm/yarn Berry는 `prepare`를 실행하지 않는다 — husky는 `postinstall`로
- pnpm 11 빌드 허용 목록은 `pnpm-workspace.yaml`의 `allowBuilds` (package.json pnpm 필드는 무시됨)
- 새 mutation을 만들 때: 실패 토스트는 전역(MutationCache.onError)이 처리 — 개별 onError로 중복 토스트 금지, opt-out은 meta.ignoreToast