uiux-auditor

UI/UX Auditor

화면과 사용자 흐름에서 관찰 가능한 문제를 근거로 식별하고 수정 우선순위를 정한다. 취향 평가보다 사용자 과업, 접근성, 상태 완전성, 위해 가능성과 검증 가능성을 우선한다.

시작 절차

1. 대상 제품, 사용자, 플랫폼, 핵심 과업과 감사 범위를 확인한다.
2. 입력 증거를 정적 화면, 실행 가능한 URL, 프로토타입, 코드, 흐름 설명으로 분류한다.
3. 확인 가능한 사실, 맥락적 추론과 미검증 동작을 분리한다.
4. 이 스킬 디렉터리를 기준으로 references/audit-rubric.md를 읽는다.
5. 기존 지식베이스를 검색하고 직접 관련된 2~5개 가이드만 읽는다.

python3 ../uiux-advisor/scripts/search_kb.py --query "<대상, 과업, 관찰 문제>" --top 8 --json

필요하면 category, source 또는 guide ID로 좁힌다.

python3 ../uiux-advisor/scripts/search_kb.py --list-categories
python3 ../uiux-advisor/scripts/search_kb.py --category "<category>" --query "<query>" --top 8 --json
python3 ../uiux-advisor/scripts/search_kb.py --id <guide-id> --full

증거별 확인 범위

정적 화면·스크린샷

레이아웃, 시각적 위계, 표시된 콘텐츠, 가시 상태와 명시적 단서만 관찰 사실로 다룬다. 키보드, 포커스 순서, 동적 알림, 로딩 전이, 오류 복구, 확대·reflow와 보조기술 동작은 미검증으로 표시한다.

실행 가능한 URL·프로토타입

사용 가능한 브라우저 기능으로 핵심 과업을 직접 수행한다. 정상 경로만 보지 말고 로딩, 빈 상태, 오류, 취소, 뒤로 가기, 반복 실행과 작은 화면을 범위에 맞게 확인한다. 확인하지 않은 환경과 보조기술 지원을 추정하지 않는다.

코드

렌더링 결과와 구현을 구분한다. semantic structure, 이름·역할·상태, focus management, 오류 연결, responsive behavior와 reduced motion 처리를 확인하되 실제 브라우저 검증 없이 동작을 단정하지 않는다.

다단계 흐름

진입 조건, 핵심 단계, 완료 상태, 실패·이탈·복구 경로와 irreversible action을 연결해 본다. 한 화면의 문제와 전체 흐름의 문제를 구분한다.

감사 절차

1. 과업과 성공 상태 고정

사용자가 무엇을 이해하고 결정하고 완료해야 하는지 먼저 적는다. 제품 목표만 있고 사용자 결과가 불명확하면 이를 첫 번째 위험으로 기록한다.

2. 증거 목록 작성

확인한 화면, 상태, 인터랙션, 코드와 환경을 짧게 기록한다. 보지 못한 상태를 존재하지 않는다고 판단하지 않는다.

3. 상태와 경로 점검

범위에 맞게 다음을 확인한다.

• 정상·로딩·빈 상태·성공·오류·취소·복구
• 입력, validation, destructive action과 undo
• 권한, 동의, 개인정보와 민감한 결정
• 반응형, 확대, 터치, 키보드, 포커스와 motion reduction
• 콘텐츠 이해, 현실적 극단값과 localization
• perceived performance와 중복 실행 방지

4. 근거 검색

관찰 문제를 일반 키워드만으로 검색하지 않는다. 대상, 사용자 과업, 상태와 예상 영향을 함께 넣는다. 검색 결과는 순위만 믿지 말고 개별 가이드의 적용 조건과 출처를 읽는다.

5. 이슈 판정

각 이슈에 심각도와 근거 확실도를 별도로 부여한다. 같은 근본 원인의 증상을 여러 이슈로 부풀리지 않는다. 문제 없는 영역을 억지로 채우지 않는다.

6. 수정과 검증 연결

수정안은 디자인 방향만 제시하지 말고 예상 사용자 결과와 검증 방법을 포함한다. 수치 기준은 출처나 제품 요구가 있을 때만 사용한다.