Brewfile 동기화
설치 상태 수집과 diff 계산은 스크립트가 결정적으로 처리한다. 이 문서는 그 결과를 어떻게 판단하고 Brewfile에 반영할지만 다룬다.
1. diff 실행
bash .claude/skills/brew-update/scripts/brewfile-diff.sh
- 출력은
type name라인이== ADD ==/== REMOVE ==두 섹션으로 나뉜다. - 두 섹션 모두 비어 있으면 "동기화 상태"라고 보고하고 종료한다.
- npm 항목은 비교 대상이 아니다 — 이 머신은 글로벌 패키지를 pnpm으로 설치해서
brew bundle dump가 감지하지 못한다. npm 라인은 수동 관리한다.
2. 판단 후 사용자 확인
결과를 유형별 표로 정리해 보여주고, 어떤 항목을 반영할지 확인받는다. diff는 사실이지만 전부 반영 대상은 아니다:
homebrew/*기본 탭(core, cask, bundle, services)은 자동 관리되므로 추가를 제안하지 않는다.- 다른 패키지의 의존성으로 깔린 것으로 보이는 formula(예: expat, pkgconf)는
brew uses --installed <name>으로 확인하고, 의존성이면 추가를 제안하지 않는다. - REMOVE 후보에 부트스트랩 필수 패키지(git, gh, stow, just)가 있으면 삭제 시 재설치가 깨진다는 경고를 붙인다.
- mas 항목은 App Store 로그인에 의존하므로 별도로 표시한다.
3. Brewfile 반영
승인된 항목만 수정한다:
- 기존 섹션 구조(CLI tools, Dev tools, Productivity 등)와 정렬 순서를 유지한다.
- 새 패키지는 알맞은 섹션에 넣고, 기존 스타일대로 정렬 맞춘
# 한 줄 설명주석을 붙인다. - 승인되지 않은 라인은 건드리지 않는다.
4. 검증
스크립트를 재실행해서 승인된 항목이 diff에서 사라졌는지 확인한다. 남아 있는 항목은 사용자가 반영하지 않기로 한 것과 일치해야 한다.