핵심 요약

Impeccable은 웹 UI의 코드와 실제 렌더링 화면을 구분하여 검사하는 도구이다. 소스 코드는 정적 규칙과 패턴을 확인하고, 렌더링 화면은 실제 브라우저에서 배치와 표현 상태를 점검한다. 두 검사 방식은 상호 보완적이며 각각의 결과를 별개로 해석해야 한다.


구분 코드 검사 실제 화면 검사
검사 대상 JSX·TSX·HTML 등 UI 및 스타일 코드 브라우저에서 렌더된 화면 주소
검사 내용 코드 구조, 스타일 정의, 패턴 적합성 글자 가독성, 렌더링 배치, 동적 요소
한계 동적 상태·상속 스타일 반영 불가 코드상의 문제 파악은 제한적
필요 이유 정적 분석 통한 일관성 및 규칙 준수 확인 실제 사용자 환경과 UI 표현 현황 점검

실무 유의점

  • 탐지기는 규칙 위배 사항의 위치와 이름을 명확히 제시하므로, 발견된 문제를 집중적으로 재검토하는데 유용하다.
  • 검사 종료 코드는 0(문제 없음), 2(주요 문제 발견), 1(일부 검사 실패)로 구분되며, 실패 코드는 재검사를 권고한다.
  • 의도된 디자인 선택(예: 브랜드 지정 글꼴)일 경우, 예외 사유를 문서화하여 검사 규칙 내에서 허용할 수 있다.
  • 에이전트 후크 사용 시, 반드시 프로젝트 내 설정과 코딩 도구의 권한 부여 상태를 별도로 확인해야 한다.
  • 저장소 및 후크 실행 범위를 사전에 점검하며, 자동 적용은 위험할 수 있으니 수동 검토를 권장한다.
  • 자동 검사의 통과 여부는 완성도와 동일하지 않으며, 실제 제품 사용자 환경과 작업 흐름에 기반한 최종 검토가 반드시 필요하다.

1차 출처