docs: PRODUCT.md와 2026-11-01 UI 디자인 감사 문서를 추가한다

impeccable이 읽을 제품 정보(사용자, 목적, 제약, 원칙)가 없었다.
화면 품질을 실제 브라우저에서 잰 기록도 없었다.

PRODUCT.md에는 사용자 답으로 확인한 제품 사실만 적었다. 감사 문서는
6개 화면을 라이트·다크, 1280·375·320 폭에서 잰 발견 8건(UI-01~08)을
가이드 36.3 양식으로 적었다. DESIGN.md는 만들지 않았다. 토큰 값을
문서 머리에 복사하는 형식이라 tokens/*.css와 갈라진 복사본이 생긴다.

위험: 문서만 추가한다. 동작 변경은 없다.
검증: verify:documentation PASS_SCOPED.
This commit is contained in:
DongHyeonka
2026-11-01 18:34:28 +09:00
parent 752a61f28b
commit b28715c783
2 changed files with 249 additions and 0 deletions
+56
View File
@@ -0,0 +1,56 @@
# Product
<!-- impeccable:product-schema 1 -->
## Platform
web
## Users
- **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 예제 화면(홈, 플랫폼 구성, UI 구성요소, 화면 상태, 인증 연동, Reference feature)은 이 사람이 실행 구조와 공통 동작을 확인하는 용도입니다.
- **파생 서비스의 최종 사용자**: 디자인 시스템(토큰, 프리미티브, 패턴, 레이아웃, 페이지 템플릿)은 이 템플릿으로 만든 서비스를 실제로 쓰는 사람을 기준으로 합니다.
## Product Purpose
도메인·비즈니스·DB 로직을 뺀 공통 기능을 모두 갖춘 React/Vite 프론트엔드 출발점입니다. 아키텍처 경계, 연동 동작, 릴리스 정합성, 접근성, 성능, 운영을 관례가 아니라 실행되는 계약으로 둡니다. 성공 기준은 이 템플릿에서 도메인만 추가해 서비스를 빠르게 만들고, 운영 중인 desktop 서버에 바로 띄워 출시할 수 있는 것입니다.
## Positioning
화면 품질 규칙(접근성, 상태 표현, 반응형, 토큰 사용)이 문서가 아니라 게이트로 강제됩니다. 시각 회귀 골든, 아키텍처 검사, 접근성 테스트가 그 게이트입니다. 그래서 파생 서비스가 템플릿을 고쳐도 기준이 조용히 낮아지지 않습니다.
## Operating Context
- 실행 형태는 브라우저 SPA + 정적 호스팅 + Service Worker입니다. SSR은 없습니다.
- 파생 서비스는 운영 중인 desktop 서버에 배포됩니다.
- 예제 앱 셸에는 테마 전환(시스템/라이트/다크), 언어 전환(한국어/영어), 로그인 상태 표시가 있습니다.
## Capabilities and Constraints
- 하나의 디자인 시스템으로 세 종류의 서비스를 받칩니다. 업무용·관리 도구(대시보드, 어드민, 설정), 일반 사용자용 웹 서비스, 소개·랜딩 페이지입니다.
- 디자인 시스템 위치는 `src/presentation/design-system/`입니다. 토큰은 primitive → semantic → component 세 단계로 파생됩니다(`tokens/primitive.css`, `semantic.css`, `component.css`).
- 시각 회귀 골든이 `tests/visual/__snapshots__/`에 있습니다. 화면을 바꾸면 골든도 의도적으로 갱신해야 합니다.
- 예제 기능과 라우트는 지울 수 있게 만들어져 있습니다(`test:sample-removal`). 예제 화면에만 있는 디자인은 파생 서비스에 남지 않습니다.
- 어떤 서비스가 먼저 만들어질지, 서비스별 우선순위는 아직 정하지 않았습니다.
## Brand Commitments
브랜드는 중립으로 유지합니다. 템플릿에는 브랜드 이름·로고·고유 톤을 넣지 않고, 서비스마다 토큰을 바꿔 브랜드를 입힙니다. 현재 표시 이름 "Frontend Skeleton"은 자리표시자입니다.
## Evidence on Hand
- 실제 고객, 사용 후기, 로고, 지표, 가격 정보는 없습니다. 지어내지 않습니다.
- 예제 문구는 템플릿 기능 설명뿐입니다(`src/presentation/i18n/catalog.ts`).
- 현재 화면 기록: `tests/visual/__snapshots__/platform.visual.spec.ts-snapshots/`, Storybook(`src/presentation/design-system/design-system.stories.tsx`).
## Product Principles
1. 디자인 시스템은 최종 사용자를 위한 것이고, 예제 화면은 개발자를 위한 것입니다. 둘을 섞지 않습니다.
2. 브랜드는 토큰으로만 바꿉니다. 컴포넌트에 브랜드 값을 직접 넣지 않습니다.
3. 업무 도구, 일반 서비스, 랜딩을 모두 받쳐야 하므로 밀도와 표현 폭은 토큰과 페이지 템플릿에서 조절합니다. 컴포넌트를 서비스 종류별로 복제하지 않습니다.
4. 접근성과 상태 표현(로딩, 빈 상태, 오류, 권한 없음)은 기능이 아니라 기본값입니다.
5. 한국어가 기본이고 영어를 함께 지원합니다. 두 언어의 문구 길이 차이를 견디는 레이아웃이어야 합니다.
## Accessibility & Inclusion
WCAG 2.2 AA를 기준으로 합니다. 키보드 탐색, 포커스 이동과 복원, 색에만 의존하지 않는 상태 표현, 라이트·다크 테마 모두에서 대비를 지킵니다. 릴리스 후보 하나로 10개 라우트를 사람이 직접 접근성 검토하는 절차가 따로 있습니다(`SPEC.md` U-2).
+193
View File
@@ -0,0 +1,193 @@
# UI 디자인 감사 (impeccable audit) — 2026-11-01
이 문서는 화면 구현의 기술 품질만 본다. 대상은 접근성, 테마, 반응형, 구현 일관성, 성능(정적 확인만)이다. 분류는 `TEMPLATE-MATURITY-REVIEW-GUIDE.md` 35·36절을 따른다. 리뷰 중에는 코드를 고치지 않았다.
## 범위 (36.1)
| 항목 | 기록 |
| --- | --- |
| 대상 | `clean-architecture-frontend-template` 화면 계층 (`src/presentation/`, 예제 라우트 6개) |
| 커밋·작업 상태 | `752a61f`, 작업 트리 깨끗함. 이 감사로 `PRODUCT.md`, `.claude/launch.json`, 이 문서가 추가됨 |
| 실행 구성 | `corepack pnpm dev` (Vite, Node 24.14.0), Chromium(앱 내장 브라우저), Linux. 이 PC에는 Inter 글꼴이 없음(`fc-list` 0건, `fc-match Inter` → Noto Sans) |
| 읽은 범위 | `design-system/tokens/*.css`, `styles/theme/*.css`, `components/page-header.tsx`, `design-system/patterns/common-patterns.tsx`, `routes/route-runtime.tsx`, 시각 회귀 골든 5장 |
| 수행한 실험 | impeccable 탐지기(소스 + 6개 URL × 1280·390 폭), 6개 화면 × 라이트·다크 글자 대비 전수 측정, 375·320 폭 가로 넘침과 터치 영역 측정, 키보드 Tab 포커스 확인, 토큰 계산값 확인, 한국어·영어 전환 확인 |
| 확인하지 못한 범위 | 성능 실측(번들 크기, Web Vitals) — `scripts/test-performance.ts`를 돌리지 않음. 스크린 리더 실사용. Firefox·WebKit. 텍스트 200% 확대. 다크 테마의 포커스 링 대비는 토큰값 계산으로만 판단 |
| 이전 리뷰와 비교 | 없음. 화면 디자인만 본 첫 감사 |
## 요약 (impeccable 5개 축)
| # | 축 | 점수 | 핵심 |
|---|---|---|---|
| 1 | 접근성 | 3/4 | 라이트 테마 포커스 링 대비 2.33:1 (UI-01). 본문 대비 미달 0건 |
| 2 | 성능 | 3/4 | 라우트 단위 지연 로딩, 웹폰트 0, 레이아웃 속성 애니메이션 0. 실측 안 함 |
| 3 | 테마 | 3/4 | 토큰 밖 하드코딩 색 0건. 선택 상태 색이 분홍으로 계산됨 (UI-02) |
| 4 | 반응형 | 3/4 | 320폭에서 6개 화면 가로 넘침 0건. 머리글 선택 상자 글자 잘림 (UI-04) |
| 5 | 구현 일관성 | 3/4 | 글꼴 토큰이 실제로 적용되지 않음 (UI-05), 같은 색 계산식 중복 (UI-03) |
| | **합계** | **15/20** | **Good** — 약한 축을 손보면 되는 수준 |
**구현 일관성 판정: 통과.** 토큰 3단계(primitive → semantic → component)를 화면 전체가 실제로 따른다. 발견은 모두 국소적이다. 다만 템플릿이라 모든 결함이 파생 서비스로 그대로 복제된다.
발견 8건: P1 1 · P2 4 · P3 3. 출시 차단은 UI-01 하나다.
## 발견 사항 (36.3)
공통: 단순 구현 결함은 설계 선택 필드(결정 근거, 대안 비교, 단순화 보존 조건, 재검토 조건)를 `적용 제외 — 선택 비교가 필요한 문제가 아님`으로 둔다. 담당·기한·상태는 전 항목 `미배정 · 미정 · 열림`이다.
### UI-01 라이트 테마 포커스 링 대비가 3:1 미만
| 필드 | 내용 |
| --- | --- |
| 성격 | 확인된 결함 |
| 관련 관점 | 1, 10, 21 |
| 근거 | `src/presentation/design-system/tokens/semantic.css:17` `--color-focus: oklch(0.72 0.16 225)`. 브라우저 실측: 흰 패널 대비 2.33:1, 표면 대비 2.23:1. 포커스 링은 3px 실선에 `outline-offset: 3px`이라 인접색이 버튼이 아니라 배경이다 |
| 발생 조건 | 라이트 테마에서 키보드로 이동할 때 항상 |
| 영향 | 저시력 키보드 사용자가 포커스 위치를 찾기 어렵다. WCAG 2.2 AA 1.4.11(비텍스트 대비 3:1) 위반. PRODUCT.md·README가 약속한 AA 기준과 어긋난다. 모든 파생 서비스에 복제된다 |
| 심각도·우선순위 | Medium · P1 — 피해는 접근성 한 축이지만, 템플릿 도입 전에 고치지 않으면 모든 서비스가 같은 위반을 갖고 출발한다 |
| 확실성 | 라이트 대비는 실측(E3, Chromium). 다크(`semantic.css:68`, `oklch(0.82 0.15 220)`)는 토큰값으로 계산만 했다. 패널 대비 10.53:1, 표면 대비 11.83:1로 통과 |
| 통제 수준 | M0 — 포커스 링 대비를 검사하는 테스트·스크립트가 없음(`tests/`, `scripts/` 검색 결과 0건). axe는 이 항목을 검사하지 않는다 |
| 최소 개선 방향 | 라이트 `--color-focus`를 흰 패널·표면 대비 3:1 이상인 진한 색으로 바꾼다 |
| 완료 기준 | 두 테마에서 포커스 색이 panel·surface·surface-muted 대비 모두 3:1 이상. offset을 없애는 변경이 생기면 action 대비도 포함 |
| 검증 방법 | 토큰 대비 단위 테스트 추가(두 테마 × 인접색 목록). 시각 골든 갱신 |
### UI-02 선택 상태 배경이 파란색이 아니라 분홍색으로 계산됨
| 필드 | 내용 |
| --- | --- |
| 성격 | 확인된 결함 |
| 관련 관점 | 1, 23 |
| 근거 | `styles/theme/shell.css:181-188`이 `color-mix(in oklch, var(--color-action) 14%, var(--color-panel))`를 쓴다. 라이트의 panel은 `primitive.css:2` `--palette-white: oklch(1 0 0)`로 색상각 0을 명시한다. 그래서 색상각이 255에서 0 쪽으로 보간되어, 실측값이 `oklch(0.937 0.0252 345.3)`(분홍)이다. 다크는 panel 색상각이 255라 정상 |
| 발생 조건 | 라이트 테마의 현재 메뉴 항목. 같은 방식의 `color-mix(in oklch, …)`가 15곳 있다. 다른 곳은 섞는 비율과 채도가 낮아 눈에 띄는 색 변화는 확인하지 못함 |
| 영향 | 선택 상태가 브랜드 action 색(파랑)과 다른 계열로 보인다. 대비는 통과한다. 파생 서비스가 브랜드 색을 바꾸면 엉뚱한 색상각이 나올 수 있다 |
| 심각도·우선순위 | Low · P2 |
| 확실성 | 계산값 실측(E3). 다른 14곳의 시각 영향은 미확인 |
| 결정의 근거 | 고치는 방법이 둘이다. (a) 섞는 공간을 `in oklab`으로 바꾼다. oklab에는 색상각이 없어 이 종류의 문제가 다시 생기지 않는다. (b) 흰색을 `oklch(1 0 none)`으로 바꾼다. 원인 지점 하나만 고치는 방법이지만, 앞으로 추가될 무채색 토큰마다 같은 규칙을 기억해야 한다 |
| 최소 개선 방향 | (a)를 권장. 15곳을 `in oklab`으로 바꾼다 |
| 비용·부작용 | 섞인 색이 미세하게 달라져 시각 골든 갱신이 필요하다 |
| 재검토 조건 | 색상각 보간을 일부러 쓰는 곳(그라데이션 등)이 생기면 그곳만 oklch를 유지 |
| 완료 기준 | 라이트 현재 메뉴 배경 색상각이 action 색상각 ±15° 안 |
| 검증 방법 | 계산값 단위 테스트 또는 시각 골든 |
### UI-03 현재 메뉴 배경 색 계산식이 두 곳에 따로 있음
| 필드 | 내용 |
| --- | --- |
| 성격 | 구조적 위험 |
| 관련 관점 | 9, 21, 23 |
| 근거 | `design-system/tokens/component.css:8-12`에 `--navigation-active-background`가 정의되어 있다. `token-contract.ts:53`은 이 토큰이 있는지만 검사한다. 그런데 실제로 쓰는 곳은 없고, `styles/theme/shell.css:181-188`이 같은 식을 직접 다시 적는다 |
| 발생 조건 | 누군가 토큰만 바꾸거나(UI-02 수정 포함) 서비스가 브랜드를 토큰으로 입힐 때 |
| 영향 | 토큰을 바꿔도 화면이 안 바뀐다. "브랜드는 토큰으로만 바꾼다"(PRODUCT.md 원칙 2)가 이 지점에서 깨진다 |
| 심각도·우선순위 | Low · P2 — UI-02를 고칠 때 같이 고쳐야 한다 |
| 통제 수준 | M3(존재 검사)이지만 사용 여부는 M0 |
| 최소 개선 방향 | `shell.css`가 `var(--navigation-active-background)`를 쓰게 한다 |
| 완료 기준 | 저장소에 이 색 계산식이 한 곳에만 있음 |
| 검증 방법 | component 토큰이 최소 한 곳에서 쓰이는지 확인하는 검사를 `token-contract` 테스트에 추가 |
### UI-04 머리글 테마·언어 선택 상자의 값 글자가 잘림
| 필드 | 내용 |
| --- | --- |
| 성격 | 확인된 결함 |
| 관련 관점 | 1, 10, 13 |
| 근거 | `styles/theme/shell.css:109` `max-width: 8.5rem`, `:115` `max-width: 7rem`, 오른쪽 여백 2rem. 실측 화면: 한국어 "라이트 테ㅁ", 영어 "Light then", "Englisl". 커밋된 골든 `tests/visual/__snapshots__/…/app-shell-wide-light-chromium-visual-linux.png`도 "시스템 테ㅁ"으로 잘린 상태다 |
| 발생 조건 | 데스크톱 폭의 모든 화면, 두 언어 모두. 글꼴이 넓을수록 심해진다 |
| 영향 | 현재 설정값을 읽을 수 없다(펼치면 보임). 새 언어를 추가하면 더 잘린다. 골든에 결함이 들어가 있어 시각 회귀 테스트가 이 결함을 지킨다 |
| 심각도·우선순위 | Low · P2 — 모든 화면 머리글에 있고 모든 서비스로 복제된다 |
| 확실성 | 실측(E3). 의사 로캘 `en-XA`에서는 확인하지 않음 |
| 최소 개선 방향 | 고정 `max-width`를 없애고 내용 폭에 맞춘다. 좁은 화면 폭 제한은 미디어 쿼리로만 둔다 |
| 완료 기준 | ko·en·en-XA에서 선택값이 잘리지 않음 |
| 검증 방법 | 골든 갱신 + 선택 상자 `scrollWidth <= clientWidth` 컴포넌트 테스트 |
### UI-05 글꼴 토큰이 Inter라고 적혀 있지만 실제로는 기기 글꼴로 그려짐
| 필드 | 내용 |
| --- | --- |
| 성격 | 확인된 결함 |
| 관련 관점 | 5, 10, 23 |
| 근거 | `design-system/tokens/semantic.css:33` `--font-sans: Inter, ui-sans-serif, system-ui, sans-serif`. `@font-face`나 웹폰트 로딩이 저장소에 없다. 이 PC에는 Inter가 없어서 Noto Sans / Noto Sans CJK로 그려진다. Inter에는 한글 글리프가 없어서, 설치된 기기에서도 한글은 다른 글꼴로 그려진다 |
| 발생 조건 | Inter가 없는 모든 기기, 그리고 모든 한글 문구 |
| 영향 | 토큰이 실제와 다른 것을 주장한다(위험이 코드에 드러나지 않음). 기기마다 글자 폭이 달라 UI-04 같은 잘림이 환경에 따라 나타난다. 시각 회귀 골든이 실행 호스트의 글꼴에 따라 달라진다(`playwright.visual.config.ts`에 글꼴·컨테이너 고정 없음) |
| 심각도·우선순위 | Low · P2 |
| 결정의 근거 | 중립 템플릿이므로 글꼴은 서비스가 바꾸는 값이다. 지금 필요한 것은 "토큰이 사실을 말하게 하는 것"이다 |
| 대안 비교 | (a) 한글을 포함한 웹폰트를 함께 배포(예: Pretendard 가변 글꼴의 한글 서브셋). 모든 기기에서 같은 모양이지만, 전송량과 라이선스 관리가 생긴다. (b) 토큰을 실제 시스템 글꼴 스택으로 바꾼다(`system-ui, "Apple SD Gothic Neo", "Noto Sans KR", "Malgun Gothic", sans-serif`). 비용은 0이고 정직하지만, OS마다 모양이 다르다. (c) 현상 유지. 비용은 0이지만 토큰이 사실과 다르다 |
| 최소 개선 방향 | (b) + 시각 테스트를 글꼴이 고정된 컨테이너에서 실행. 기기 간 같은 모양이 요구되면 (a) |
| 재검토 조건 | 서비스에서 브랜드 글꼴 요구가 생기면 그 서비스 토큰에서 (a)를 적용 |
| 완료 기준 | 토큰에 적힌 첫 글꼴이 실제 렌더링 글꼴과 같음. 골든이 호스트 글꼴과 무관함 |
| 검증 방법 | `document.fonts`로 로드된 글꼴 확인 E2E 1건, 시각 테스트 실행 환경 고정 |
| 비고 | 탐지기의 `overused-font`(Inter 과다 사용) 경고는 계산된 font-family 문자열만 보고 판단한 것이다. 실제 원인은 이 항목이다 |
### UI-06 예제 화면마다 작은 "예제" 라벨이 큰 제목 위에 반복됨
| 필드 | 내용 |
| --- | --- |
| 성격 | 개선 제안 |
| 관련 관점 | 4, 23 |
| 근거 | 탐지기 `hero-eyebrow-chip`·`kicker-above-heading` 5개 화면. `components/page-header.tsx:46`의 `eyebrow`는 선택 속성이고, 예제 8곳이 쓴다 |
| 영향 | 정보가 없는 반복 라벨이다. 개발자가 예제를 복사하면 서비스 화면에도 남는다 |
| 심각도·우선순위 | Low · P3 |
| 최소 개선 방향 | 예제 화면은 eyebrow를 빼거나, 화면별 의미 있는 상위 분류로 바꾼다. 컴포넌트는 그대로 둔다 |
### UI-07 카드 안에 카드가 들어간 예제 화면
| 필드 | 내용 |
| --- | --- |
| 성격 | 개선 제안 |
| 관련 관점 | 4, 23 |
| 근거 | 탐지기 `nested-cards`: `/examples/ui`, `/examples/states`. 테두리 있는 구획 안에 테두리 있는 카드가 다시 들어간다 |
| 영향 | 깊이가 한 단계 늘어 화면이 시끄럽다. 업무용 화면(Operate)에서 이 구성을 복사하면 밀도가 떨어진다 |
| 심각도·우선순위 | Low · P3 |
| 최소 개선 방향 | 바깥 구획은 테두리 없이 제목과 간격으로만 나눈다 |
### UI-08 표 가로 스크롤 영역이 포커스는 받지만 이름이 없음
| 필드 | 내용 |
| --- | --- |
| 성격 | 확인된 결함 |
| 관련 관점 | 1 |
| 근거 | `design-system/patterns/common-patterns.tsx:32` `<div className="ui-data-table__scroll" tabIndex={0}>`에 `role`·`aria-label`이 없다. 표에는 `caption`이 있다 |
| 영향 | 스크린 리더가 이름 없는 영역으로 읽는다. 키보드 스크롤 자체는 된다 |
| 심각도·우선순위 | Low · P3 |
| 최소 개선 방향 | `role="region"`과 `aria-labelledby`(caption id)를 붙인다 |
## 탐지기 결과 처리
| 규칙 | 건수 | 처리 |
| --- | --- | --- |
| overused-font | 데스크톱 6, 모바일 3 | UI-05로 원인 재분류 |
| hero-eyebrow-chip / kicker-above-heading | 5 / 5 | UI-06 |
| nested-cards | 5 | UI-07 |
| bounce-easing (참고) | 1 (`primitive.css:49`, `cubic-bezier(0.2, 0, 0, 1.2)`) | 채택 안 함. 짧게 넘치는 감속 곡선이 의도된 토큰으로 보이고, 모션 줄이기 설정에서 대체된다 |
## 잘 되어 있는 것
- `src/presentation/`에서 토큰 파일 밖의 하드코딩 색이 0건이다.
- 6개 화면 × 2개 테마의 글자 대비 미달이 0건이다(비활성 제외).
- 320px 폭에서 6개 화면 모두 가로 넘침이 없다. 넓은 표는 자체 스크롤 영역 안에 있다.
- 24px 미만 터치 영역은 체크박스·라디오 3개뿐이고, 모두 44px 높이 라벨로 감싸져 있어 WCAG 2.5.8 예외를 충족한다.
- 스킵 링크, `:focus-visible` 3px 포커스 링, `prefers-reduced-motion` 대체가 있다.
- 라우트별 지연 로딩, 웹폰트 비용 0, 레이아웃 속성 애니메이션 0건이다.
- 의사 로캘(`en-XA`)과 RTL 스모크 로캘이 있어 문구 길이와 방향 테스트 수단이 준비돼 있다.
## 관점별 판정 (36.2, 이번 범위만)
| 번호 | 관점 | 적용 여부·사유 | 목표·확인 통제 | 증거 | 판정·잔여 위험 |
| --- | --- | --- | --- | --- | --- |
| 1 | 코드 성숙도 | 적용 — 화면 구현 | 목표 M3 / 확인 M2 | E3 | 부분 충족 — UI-01, 02, 04, 08 |
| 4 | 인지 부하 | 적용 — 예제 화면 구성 | 목표 M1 / 확인 M1 | E3 | 부분 충족 — UI-06, 07 |
| 5 | 위험 가시성 | 적용 — 토큰이 실제를 말하는가 | 목표 M2 / 확인 M1 | E3 | 미충족 — UI-05 |
| 9 | 유지보수 성숙도 | 적용 — 토큰 중복 | 목표 M3 / 확인 M3(존재만) | E1 | 부분 충족 — UI-03 |
| 10 | 테스트 성숙도 | 적용 — 시각·접근성 테스트가 잡는가 | 목표 M3 / 확인 M0~M3 | E1 | 부분 충족 — 골든에 결함 포함(UI-04), 포커스 대비 검사 없음(UI-01) |
| 13 | 확장성 | 적용 — 언어 추가 | 목표 M2 / 확인 M1 | E3 | 부분 충족 — UI-04 |
| 14 | 성능 성숙도 | 정적 확인만 | 미평가 | E1 | 미검증 — 실측 안 함 |
| 21 | Guardrail 성숙도 | 적용 — 토큰 사용·대비 자동 검사 | 목표 M3 / 확인 M0 | E1 | 미충족 — UI-01, 03 |
| 23 | 일관성 | 적용 — 토큰·색 일관성 | 목표 M3 / 확인 M2 | E3 | 부분 충족 — UI-02, 03, 05 |
| 그 외 19개 | — | 미평가 — 이번 감사 범위(화면 디자인) 밖 | 미평가 | 미확인 | 미검증 |
## 권장 순서
1. **P1 UI-01**: 포커스 색 수정 + 토큰 대비 테스트 추가
2. **P2 UI-02 + UI-03**: 함께 처리(`in oklab` 전환과 토큰 사용 일원화)
3. **P2 UI-04**: 선택 상자 폭 수정, 골든 갱신
4. **P2 UI-05**: 글꼴 방향 결정(대안 a/b) 후 토큰 수정, 시각 테스트 글꼴 고정
5. **P3 UI-06, 07, 08**: 예제 화면 정리
impeccable 명령으로는 1·3이 `harden`/`adapt`, 2가 `polish`, 4가 `typeset`, 5가 `distill`/`layout`에 해당한다. 마지막에 `polish`로 마무리한다.