← ClaudeAtlas

ui-audit-methodlisted

UI 코드베이스를 인상이 아니라 숫자로 감사하는 방법. 지표를 세는 grep의 함정, 실제 렌더로 검증하는 절차, 배율 때문에 없는 버그가 보이는 스크린샷 함정, 그리고 판정을 기록해 같은 논의가 반복되지 않게 하는 베이스라인 구조를 다룬다. "UI 감사", "디자인 점검", "이 UI 측정해줘", UI audit, design audit, 레이아웃이 깨져 보인다는 요청에 사용. 무엇을 좋은 디자인으로 볼지는 정하지 않는다 — 그건 프로젝트 베이스라인이 정한다.
rhino-ty/ui-audit-method · ★ 0 · Web & Frontend · score 67
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