Impeccable, 코딩 에이전트 UI를 다듬고 검토하는 디자인 어휘

Impeccable은 코딩 에이전트에 이름이 붙은 명령어를 제공해 이미 만들어진 인터페이스의 특정 부분을 다듬고, 점수 기반 사용성 리뷰나 등급별 감사, 고정 규칙 스캔 결과를 돌려줍니다.
개발자는 에이전트가 그럴듯하지만 뻔한 페이지를 이미 내놓았을 때 이 도구를 찾습니다. 모든 텍스트에 들어간 Inter 폰트, 보라색에서 파란색으로 이어지는 그라데이션, 카드 안에 또 들어간 카드, 색이 깔린 배경 위의 회색 텍스트, 제목마다 위에 붙은 둥근 사각형 아이콘 타일 같은 패턴이 눈에 띌 때입니다.
명령어 하나와 대상 하나를 지정하면, 에이전트가 모호한 요청의 뜻을 짐작하는 대신 그 수정에 맞는 지침서를 따릅니다.
없을 때와 있을 때
이 프로젝트는 같은 모델(Fable 5.1)로 동일한 브리프(리구리아 해안의 객실 14개짜리 가족 게스트하우스)를 스킬을 껐을 때와 켰을 때로 나누어 보여 줍니다. Impeccable이 없을 때 에이전트는 크림색 배경에 이탤릭체 포인트를 준 얇은 세리프 헤드라인, 알약 모양 버튼 두 개, 둥근 카드 안에 담긴 플랫 벡터 일러스트로 페이지를 채웁니다.
Impeccable을 켜면 물 위에서 바라본 게스트하우스의 밤 풍경이라는 사진 한 장을 중심으로 페이지를 다시 짭니다. 문서에 기록된 결과에는 페이지를 가득 채우는 판화풍 야경, 폭이 좁은 크림색과 주홍색 헤드라인, 하단을 따라 놓인 월별 띠가 들어갑니다. 이 비교는 점수를 매긴 벤치마크가 아니라 결과물을 서술한 내용입니다.
무엇을 결정하나
모든 명령어가 다 실행되지는 않으며, 실행하는 명령어들도 정해진 순서를 따르지 않습니다.
init은 프로젝트당 한 번 실행합니다. 코드를 읽은 뒤 추론할 수 없는 사항(누구를 위한 제품인지, 어떤 기능을 해야 하는지, 제약 조건은 무엇인지)만 묻고 PRODUCT.md를 작성합니다. 이후 명령어는 이 파일을 읽기 때문에 같은 내용을 다시 묻지 않습니다. document는 별개 명령어로, 기존 비주얼 시스템을 바탕으로 DESIGN.md를 만듭니다. 이 단계를 건너뛰면 이후 명령어가 참조할 비주얼 시스템 기록이 남지 않습니다.
그런 다음 명령어 하나와 대상 하나를 지정합니다. 해당 명령어는 자기 지침을 불러와 대상에 적용하고, 다른 명령어는 실행하지 않습니다. 섹션 하나처럼 구체적인 대상을 짚어 쓰는 것이 의도한 사용법이며, 자주 쓰는 명령어는 pin으로 /audit 같은 전용 단축 명령어로 꺼내 둘 수 있습니다.
명령어는 순차 절차가 아니라 메뉴입니다. steer, review, finish, live iteration, setup이 있으며, craft는 일반 빌드 요청을 뜻하던 지원 중단된 별칭입니다. critique는 사용성 개선 항목의 우선순위를 매기고, audit은 접근성, 성능, 테마, 반응형 동작을 점검해 발견한 문제를 차단 수준인 P0부터 다듬기 수준인 P3까지 등급으로 나눕니다.
디자인 훅이 켜져 있지 않으면 이런 명령어 안에서 감지기가 돌지 않습니다. 감지기는 언어 모델이나 API 키 없이 고정 규칙 62개를 적용합니다. JSX나 TSX 파일에는 패턴 규칙만 적용하고 멈추며, 낮은 대비와 작은 글씨 검사는 대상이 URL일 때만 실행합니다. 종료 코드 2는 문제가 발견됐다는 신호이고, 종료 코드 1은 대상을 스캔하지 못했다는 뜻입니다. 훅을 켜 두면 에이전트가 작업 완료를 보고하기 전에 수정한 각 UI 파일을 스캔하며, 훅이 없으면 사용자가 직접 실행할 때만 감지기가 돕니다.
live는 별도 세션으로 동작합니다. 로컬 개발 서버를 열어 요소를 선택하게 해 주고, 그 자리에서 변형안을 교체하며, 수락한 변형안을 소스 코드에 다시 씁니다. 배포된 사이트는 수정하지 않습니다. 최근 1분 이내에 live 세션이 폴링했다면 Apply가 대기 중인 문구 수정 사항을 채팅 에이전트로 보내고, 폴링한 세션이 없다면 PATH에서 codex를, codex가 없으면 claude를 승인 절차와 샌드박싱을 끄고 현재 환경 변수를 물려받아 실행합니다. 시작 전에 IMPECCABLE_LIVE_COPY_AGENT를 chat이나 off로 설정하면 Apply를 채팅 세션 안에 머무르게 하거나 비활성화할 수 있습니다.
사용 방법
쓸 때
가격표 카드가 이미 화면에 있는데 요청이 모호해 에이전트가 강조 방식을 혼자 짐작하게 두고 싶지 않을 때입니다.
/impeccable bolder the pricing cards
에이전트가 그 동작 하나에 해당하는 지침을 불러와 가격표 카드에만 적용합니다.
쓸 때
온보딩 흐름이 이미 만들어져 있고, 코드를 고치기 전에 무엇부터 손대야 할지 우선순위부터 정리하고 싶을 때입니다.
/impeccable critique the onboarding flow
무엇부터 고쳐야 할지 순위를 매긴 점수 기반 사용성 리뷰를 돌려받습니다.
쓸 때
에이전트를 띄우지 않고 터미널이나 지속적 통합 환경에서 고정 규칙만으로 UI 코드를 검사하고 싶을 때입니다.
npx impeccable detect src/
해당 디렉터리에 패턴 규칙을 돌려 발견한 문제를 보고하며, 렌더링된 페이지가 필요한 규칙은 적용하지 않습니다.
설치
npx impeccable install
코딩 도구를 다시 불러온 뒤 에이전트에 /impeccable init을 입력하거나, Codex에서는 $impeccable init을 입력합니다.
이 도구가 맞지 않을 때
프로젝트 설명에 따르면 이미 존재하는 인터페이스에 페이지나 컴포넌트를 지정해 반복 수정할 때 가장 잘 작동합니다. 새 페이지를 처음부터 만들 수도 있지만, 프로젝트 스스로 이를 더 까다로운 모드로 부르며 별도 사용법을 문서화해 두었습니다.
다른 도구 대신 pbakaus/impeccable을 고르는 기준은 바이너리 역공학이나 범용 방법론이 아니라 이미 있는 UI 대상 하나를 지정해 조율·검토·스캔해야 하는지 여부입니다.
| 작업 | 다른 저장소 | 스타 수 | Impeccable을 고를 때 |
|---|---|---|---|
| 네이티브 바이너리 수준까지 앱 동작 역공학 | morluto/rea | 462,654 | 대상이 바이너리가 아니라 이미 있는 인터페이스일 때 |
| 개인 .agents 디렉터리에서 엔지니어 스킬 불러오기 | mattpocock/skills | 325,430 | 지정된 디자인 동작 하나, 사용성 점수, 고정 규칙 UI 스캔이 필요할 때 |
| 에이전트 스킬 프레임워크와 개발 방법론 사용 | obra/superpowers | 318,199 | 전체 방법론이 아니라 UI 대상 하나를 조율·검토·스캔할 때 |
pbakaus/impeccable GitHub 저장소에는 스타 110,949개, 포크 6,635개, 열린 이슈 47개가 있으며, 2025-11-16에 만들어졌고 마지막 푸시는 2026-11-16, 라이선스는 Apache-2.0입니다. 이미 있는 인터페이스에 명령어 하나와 대상 하나를 지정하고, 도구가 지원한다면 디자인 훅을 켜고 사용해 보세요.
많이 묻는 질문
어떤 코딩 에이전트에서 실행할 수 있나요?
Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness, Veto에서 작동합니다. Codex에서는 슬래시 명령어 대신 /skills를 열거나 $impeccable을 입력합니다.
에이전트가 수정할 때마다 검사가 실행되나요?
디자인 훅은 에이전트가 수정하는 모든 UI 파일을 스캔해 작업 완료 보고 전에 결과를 돌려주며, 훅이 없으면 사용자가 직접 실행할 때만 감지기가 돕니다. 설치 프로그램에서 동의하면 Claude Code, Cursor, Codex, GitHub Copilot, Grok Build, Hermes Agent에 훅을 설정해 주지만, Codex는 /hooks에서 프로젝트 훅을 승인해야 하고, Grok Build는 /hooks-trust를 실행하거나 --trust 옵션으로 시작해야 하며, Hermes Agent는 hermes plugins enable impeccable-design-hook을 한 번 실행해야 합니다.
소스 스캔은 무엇을 검사하지 않나요?
JSX나 TSX 같은 소스 파일에는 패턴 규칙만 적용합니다. 낮은 대비와 작은 글씨는 http://localhost:5173 같은 로컬 개발 서버를 포함해 대상이 URL일 때 검사합니다.
출처: GitHub 저장소 pbakaus/impeccable, https://github.com/pbakaus/impeccable
'AI 스킬' 카테고리의 다른 글
| Paperclip, AI 에이전트 팀에 목표와 예산 배정하기 (0) | 2026.11.16 |
|---|---|
| Taste Skill, 단일 디자인 시스템과 브라우저 검증으로 회사 사이트 만들기 (0) | 2026.11.15 |
| AI 코딩 에이전트를 명세부터 배포까지 단계대로 이끄는 방법 (0) | 2026.11.15 |

