핵심 요약
Impeccable은 웹 UI의 코드와 실제 렌더링 화면을 구분하여 검사하는 도구이다. 소스 코드는 정적 규칙과 패턴을 확인하고, 렌더링 화면은 실제 브라우저에서 배치와 표현 상태를 점검한다. 두 검사 방식은 상호 보완적이며 각각의 결과를 별개로 해석해야 한다.
| 구분 | 코드 검사 | 실제 화면 검사 |
|---|---|---|
| 검사 대상 | JSX·TSX·HTML 등 UI 및 스타일 코드 | 브라우저에서 렌더된 화면 주소 |
| 검사 내용 | 코드 구조, 스타일 정의, 패턴 적합성 | 글자 가독성, 렌더링 배치, 동적 요소 |
| 한계 | 동적 상태·상속 스타일 반영 불가 | 코드상의 문제 파악은 제한적 |
| 필요 이유 | 정적 분석 통한 일관성 및 규칙 준수 확인 | 실제 사용자 환경과 UI 표현 현황 점검 |
실무 유의점
- 탐지기는 규칙 위배 사항의 위치와 이름을 명확히 제시하므로, 발견된 문제를 집중적으로 재검토하는데 유용하다.
- 검사 종료 코드는 0(문제 없음), 2(주요 문제 발견), 1(일부 검사 실패)로 구분되며, 실패 코드는 재검사를 권고한다.
- 의도된 디자인 선택(예: 브랜드 지정 글꼴)일 경우, 예외 사유를 문서화하여 검사 규칙 내에서 허용할 수 있다.
- 에이전트 후크 사용 시, 반드시 프로젝트 내 설정과 코딩 도구의 권한 부여 상태를 별도로 확인해야 한다.
- 저장소 및 후크 실행 범위를 사전에 점검하며, 자동 적용은 위험할 수 있으니 수동 검토를 권장한다.
- 자동 검사의 통과 여부는 완성도와 동일하지 않으며, 실제 제품 사용자 환경과 작업 흐름에 기반한 최종 검토가 반드시 필요하다.