ilhae.ai

EBOOK · 2026년 10월 31일

Claude Code 개발자를 위한 impeccable 도입 가이드

김재우 지음 · 9장 · 읽는 시간 약 1시간

impeccable은 AI에게 만들게 한 화면이 매번 같은 모습으로 나오는 '버릇'을 62개의 결정론적 규칙으로 기계 검출하는 스킬입니다. 이 가이드는 그 도입 방법을 다룹니다. 검출 CLI는 버릇투성이 HTML에서 지적 7건, 수정 후 0건이 나오는 것을 실측으로 확인했습니다(검증일 2026년 10월 30일, CLI 4.8.0). 설치 절차 전체와 도구별로 필요한 추가 한 수, init부터 첫 명령까지 쓰는 법을 담았습니다. 필자 환경에서 번들 다운로드가 TLS 오류로 실패했을 때 원인을 어떻게 구분했는지, 미검증 범위(init 이후·훅·라이브 모드)와 그 재확인 포인트까지 솔직하게 적은 실측 가이드입니다.

처음부터 읽기

웹 뷰어에서만 읽을 수 있는 책입니다. 본문 복사·인쇄·저장은 막혀 있어요.

목차

  1. 1. 들어가며 — impeccable이란 무엇인가

    이 책은 impeccable(pbakaus/impeccable)의 도입 가이드입니다. impeccable은 AI 코딩 에이전트가 생성하는 화면의 'AI 티'를 기계로 검출해 고치는 스킬입니다.

    읽기
    절 4개 보기
    • 이 책에 대해
    • impeccable은 무엇을 하는가
    • 이 책의 검증 방침(먼저 솔직하게 적어 둡니다)
    • 이 책의 구성

  2. 2. 먼저 검출만 해 보기 — 실측 7건의 실패 카탈로그와, 0건이 되기까지

    스킬을 넣기 전이라도 검출기만큼은 프로젝트 루트에서 다음 명령 하나로 쓸 수 있습니다.

    읽기
    절 5개 보기
    • 필요한 것
    • 검출만이라면 설치가 필요 없다
    • 실측: 버릇을 잔뜩 넣은 HTML의 검출 결과(실패 카탈로그)
    • 규칙은 모두 62개
    • 스캔 방식에 따라 작동하는 규칙이 달라진다

  3. 3. 스킬 본체 설치 — 절차 전체와, 번들 다운로드 실패 원인 구분표

    프로젝트 루트에서 실행합니다.

    읽기
    절 4개 보기
    • 설치 절차
    • 필자가 실제로 막힌 곳: 번들 다운로드 실패
    • 원인 구분표
    • 여러분 환경에서 재확인할 포인트(이 장 분)

  4. 4. 도구별로 필요한 추가 한 수

    이 장은 공식 정보를 따라 썼습니다. 필자 환경에서는 스킬 본체 설치가 끝나지 않아(3장 참조) 각 도구에서 실제로 승인하는 조작은 검증하지 못했습니다. 조작이 필요한지와 그 절차는 공식 안내대로 적었습니다.

    읽기
    절 1개 보기
    • 도구별 요점 정리

  5. 5. 첫 사용법 — init부터, 좁은 대상에 명령 하나

    이 장 역시 공식 정보에서 가져온 내용입니다. 필자 환경에서는 /impeccable init 이후의 명령 실행을 검증하지 못했습니다(3장 참조). 절차와 주의점은 공식 진행 방식대로 적었습니다. 특히 생성물을 반드시 눈으로 확인한다는 운용상의 요점은 검증 여부와 상관없이 그대로 유효합니다.

    읽기
    절 3개 보기
    • init: 프로젝트마다 한 번만
    • 명령의 기본형: '명령 + 좁은 대상'
    • 새 페이지를 만드는 경우

  6. 6. 라이브 모드 — 브라우저에서 요소를 골라 바꿔 끼우기

    이 장도 필자가 직접 실행해 보지 못한 채 공식 안내를 따라 적었습니다(3장 참조). 편리한 대신 건드리는 범위를 잘못 잡으면 사고가 나는 기능이니 주의점부터 읽어 주세요.

    읽기
    절 2개 보기
    • 라이브 모드란
    • 주의점(두 가지)

  7. 7. ignores(지적 제외)와, 팀에서 버전 고정하기

    브랜드 폰트로 Inter를 정식 채택한 경우처럼 의도해서 쓰는 것까지 매번 지적받으면, 결국 검출 결과 자체를 안 읽게 됩니다. 이럴 때 쓰는 제외 장치가 있습니다.

    읽기
    절 2개 보기
    • 지적을 '고치지 않기' 위한 장치: ignores
    • 팀에서 버전 고정하기

  8. 8. 검증 완료/미검증 전체 기록과, 재확인 체크리스트

    검증 환경: Linux VM, Node v24.22.1 / npm 10.9.4, impeccable CLI 4.8.0.

    읽기
    절 6개 보기
    • 검증 완료(필자가 2026년 10월 30일 이 환경에서 실행한 것)
    • 미검증(공식 정보에 근거하지만 필자가 실행해 확인하지 않은 것)
    • 여러분 환경에서의 재확인 체크리스트
    • 도입 후 곁에 두고 볼 체크리스트(운용 편)
    • 라이선스
    • 출처

  9. 9. 부록: 한국어 화면 규칙 포크(ilhae-ai/impeccable)

    이 부록은 전체가 원문에 없는 보완 내용입니다. 2026년 10월 31일 기준 ilhae-ai/impeccable 포크(커밋 27402c4, upstream CLI 4.8.0 기반)의 README.ko.md와 skill/reference/korean.md를 바탕으로 정리했습니다.

    읽기
    절 5개 보기
    • 포크에서 달라진 점
    • 포크 설치
    • init에서 한국어라고 답해 두기
    • korean.md 규칙 요약
    • 포크 유지보수
impeccableAI 티AI 디자인 버릇UI 검출디자인 린트Claude Code 스킬프론트엔드 디자인전자책ebook

독자 평가

이 책 어땠나요?

별점과 함께 좋았던 점, 보완하면 좋을 점을 남겨 주세요. 저자가 모두 읽고, 골라서 답변과 함께 이 페이지에 싣습니다. 이름·연락처 같은 개인정보는 적지 마세요.

별점 (필수)

함께 읽으면 좋은 전자책

EBOOK 전체 보기 →