ui-audit-methodlisted
Install: claude install-skill rhino-ty/ui-audit-method
# UI 감사 방법론
이 스킬은 **무엇이 좋은 UI인지 말하지 않는다.** 어떻게 재고, 어떻게 검증하고,
어떻게 기록하는지만 다룬다. 무엇을 문제로 볼지는 프로젝트가 정한다.
원칙은 하나다 — **인상으로 말하지 마라.** "좀 AI 같네요"는 보고가 아니다.
`rounded-xl 25회`가 보고다.
## 두 가지 실패 모드
작업 전에 이것부터 읽어라.
1. **없는 문제를 만들어낸다.** 깨끗한 항목까지 지적해서 고칠 것을 지어낸다.
어떤 지표가 0이면 그건 빈칸이 아니라 **지켜야 할 상태**다
2. **이미 내린 판정을 잊는다.** 지난번에 "확인함, 문제 아님"으로 끝낸 항목이
다음 감사에 또 올라온다. 그래서 판정을 파일에 적는다
## 베이스라인이 먼저다
이 스킬 혼자서는 절반만 동작한다. 무엇이 정상인지 모르는 채로 숫자만 뽑게 된다.
```
<프로젝트>/.claude/ui-baseline.md
```
없으면 `../../references/BASELINE-TEMPLATE.md`를 복사해서 채운다. 담기는 것은 넷이다.
- **이 앱의 정체** — 웹인가 데스크탑인가, 뷰포트가 고정인가, 테마가 몇 개인가
- **건드리면 안 되는 것** — 팔레트, 프레임워크 관례, 프로젝트 규칙이 정한 것
- **지표 목록** — 이 프로젝트가 무엇을 세기로 했는지, 그리고 감사 시점 → 현재 값.
**"현재" 열이 회귀 감지선이다**
- **판정 기록** — "확인했고 문제 아님"으로 끝낸 항목, 근거, 재점화 조건
지표를 고르는 건 프로젝트의 몫이다. 이 스킬은 고르는 법이 아니라 **세는 법**을 준다.
## 1. 대상 파일 확인
명령이 무엇을 훑는지부터 정한다. 프레임워크마다 UI가 사는 확장자가 다르다.
```bash
for e in svelte vue jsx tsx astro html css scss; do
n=$(git ls-files "*.$e" | wc -l); [ "$n" -gt 0 ] && echo " .$e $n개"
done
```
아래 예시는 `*.svelte`다. 결과에 맞춰 `--include`를 바꿔 쓴다.
## 2. 세는 법 — 그리고 세 가지 함정
지표가 무엇이든 아래 함정은 똑같이 걸린다. **실제로 오측정이 나온 사례들이다.**
### 함정 1 — 부분집합만 세고 전체라고 믿는다
크기·형태로 필터를 걸면 같은 문제의 다른 형태를 통째로 놓친다.
```bash
grep -rn "text-[45]xl" src --include=*.svelte # 큰 것만 → 9건
# 전수 조사 → 85건. 버튼 레이블과 상태 표시에 박힌 것이 전부 빠져 있었다
```
**정량 지표를 만들 때는 먼저 필터 없이 전수를 세고, 그다음에 분류하라.**
### 함정 2 — 정규식이 템플릿 문법을 먹는다
```bash
grep -rn "#[0-9a-fA-F]\{3,8\}" src --include=*.svelte # 14건 (오탐)
grep -rn "#[0