brew-update

name	brew-update
description	로컬에 설치된 Homebrew 패키지와 이 레포의 Brewfile을 비교하고 동기화한다. 사용자가 "brew 동기화", "Brewfile 정리", "Brewfile 업데이트"를 언급하거나, 패키지를 설치·삭제한 뒤 Brewfile에 반영하려 할 때 사용한다.
allowed-tools	Read, Edit, Bash(brew:*), Bash(bash .claude/skills/brew-update/scripts/brewfile-diff.sh:*)

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에서 사라졌는지 확인한다. 남아 있는 항목은 사용자가 반영하지 않기로 한 것과 일치해야 한다.