docs: record build/lint gotchas and test-harness rule in CLAUDE.md

[pignuante]

What

이번 창 기하 감사 수정 사이클(#97)에서 실제로 시간을 소모했고 재발 가능한 항목을 CLAUDE.md에 기록한다.

추가 내용

Build / test / lint

• make run(서명) 후 make build(ad-hoc)가 같은 DerivedData를 공유해 Sparkle.framework "permission to save" 로 실패 → 앱 종료 후 산출물 번들 삭제하고 재빌드.
• main 브랜치 보호: lint-and-build/gitleaks/secret-scan 통과 전까지 머지가 BLOCKED.

Code conventions

• SwiftFormat(wrapMultilineStatementBraces)과 SwiftLint(opening_brace)가 줄바꿈된 if 조건의 중괄호 위치로 충돌해 pre-commit 훅이 데드락 → 다중 조건 if는 한 줄 유지(필요하면 지역 Bool 추출). 다중 줄 guard … else {는 무관.
• --strict가 SwiftLint 기본 규칙을 에러로 승격 — 파라미터 5개·튜플 2멤버 상한(설계에 영향).
• Xcode 파일시스템 동기화 그룹의 자동 포함이 swiftc 테스트 하네스에는 미치지 않음 → 순수 파일은 scripts/test.sh·scripts/coverage.sh 양쪽에 등록해야 테스트·커버리지에 잡힌다.

그 외

• per-machine 셸 quirk(log/grep 셸 함수 shadowing)는 팀 공유 대상이 아니라 .claude.local.md로 분리하고 .gitignore에 명시 항목 추가.
  (macOS 기본 대소문자 비구분 FS에서는 기존 *.LOCAL.* 규칙에 우연히 걸리지만, 대소문자 구분 FS에서는 안 걸리므로 명시 항목이 필요.)

문서만 변경 — 코드 변경 없음.