Repolode
pbakaus

pbakaus/impeccable

AI 코딩 에이전트를 위한 디자인 가이드: 디자인 스킬, 24개 명령어, 브라우저 실시간 반복 작업, AI 생성 프런트엔드 UI를 검사하는 61개의 결정론적 탐지 규칙을 제공합니다.

스타
83,060
포크
5,022
열린 이슈
48
마지막 커밋
3시간 전

어떤 프로젝트인가요?

Impeccable은 Claude Code, Cursor, Codex CLI, Gemini CLI 같은 AI 코딩 에이전트를 위한 디자인 스킬이자 툴킷입니다. polish, audit, critique, distill, animate 등의 명령어로 에이전트가 공통 디자인 용어를 사용하도록 돕고, init 단계에서 제품 맥락을 PRODUCT.md에 기록해 이후 명령어가 대상 사용자와 제약 조건을 파악할 수 있게 합니다.

또한 HTML, 소스 디렉터리, 실시간 URL에 61개의 결정론적 탐지 규칙을 적용하는 독립 실행형 CLI와 브라우저 확장 프로그램을 제공합니다. LLM이나 API 키는 필요하지 않습니다. 규칙은 지나치게 자주 쓰이는 글꼴, 보라색 그라데이션, 중첩 카드, bounce easing 같은 AI 생성 프런트엔드의 흔한 패턴과 작은 터치 영역, 건너뛴 제목 단계 같은 일반적인 문제를 대상으로 합니다.

지원되는 하네스에서는 설치 가능한 hook이 UI 파일을 직접 수정한 뒤 탐지기를 실행하고, 발견 사항을 에이전트 작업 흐름에 전달합니다. 실시간 모드에서는 로컬 개발 서버나 정적 HTML을 대상으로 브라우저에서 페이지 요소를 수정하며 반복 작업을 진행할 수 있습니다.

핵심 기능

  • 01impeccable init 한 번으로 제품 맥락을 PRODUCT.md에 기록합니다.
  • 02비평, 감사, 다듬기, 레이아웃, 타이포그래피, 모션 등을 위한 명령어 24개를 제공합니다.
  • 03CLI, 브라우저 확장 프로그램, 에이전트 hook을 통해 실행할 수 있는 결정론적 탐지 규칙 61개를 제공합니다.
  • 04로컬 개발 서버나 정적 HTML을 대상으로 요소를 수정하며 반복 작업을 진행하는 브라우저 실시간 모드를 제공합니다.
  • 05Cursor, Claude Code, Codex CLI, Gemini CLI를 비롯한 다양한 AI 코딩 도구용 설치 프로그램을 지원합니다.

활용 사례

  • AI 코딩 에이전트가 생성한 프런트엔드 코드의 시각적 품질을 개선합니다.
  • 출시 전에 기존 웹 페이지의 접근성, 반응형 동작, 레이아웃 문제를 점검합니다.
  • CI에서 HTML이나 JSX를 대상으로 탐지기를 실행해 흔히 나타나는 획일적인 AI 디자인 패턴을 찾아냅니다.
  • 소스 코드를 건드리지 않고 프로덕션 URL에서 디자인 안티패턴을 검사합니다.

빠른 시작

  1. 1

    프로젝트 루트에서 스킬을 프로젝트에 설치합니다

    npx impeccable install
  2. 2

    AI 코딩 도구 내에서 최초 1회 설정 명령을 실행합니다

    /impeccable init

사용 전 알아둘 점

  • npx 설치 프로그램을 사용하려면 Node.js가 필요하지만, 수동 설치나 Git 설치 옵션은 Node.js 없이 사용할 수 있습니다.
  • 일부 하네스에서는 디자인 훅을 실행하기 전에 훅 승인이나 신뢰 설정 등의 추가 단계가 필요합니다.

토픽

자주 묻는 질문

impeccable은(는) 무엇인가요?
AI 코딩 에이전트를 위한 디자인 가이드: 디자인 스킬, 24개 명령어, 브라우저 실시간 반복 작업, AI 생성 프런트엔드 UI를 검사하는 61개의 결정론적 탐지 규칙을 제공합니다. Impeccable은 Claude Code, Cursor, Codex CLI, Gemini CLI 같은 AI 코딩 에이전트를 위한 디자인 스킬이자 툴킷입니다. polish, audit, critique, distill, animate 등의 명령어로 에이전트가 공통 디자인 용어를 사용하도록 돕고, init 단계에서 제품 맥락을 PRODUCT.md에 기록해 이후 명령어가 대상 사용자와 제약 조건을 파악할 수 있게 합니다.
impeccable은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
impeccable은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
impeccable은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. impeccable의 마지막 커밋은 2026년 10월 19일입니다.
impeccable은(는) 어디에 사용할 수 있나요?
AI 코딩 에이전트가 생성한 프런트엔드 코드의 시각적 품질을 개선합니다. 출시 전에 기존 웹 페이지의 접근성, 반응형 동작, 레이아웃 문제를 점검합니다. CI에서 HTML이나 JSX를 대상으로 탐지기를 실행해 흔히 나타나는 획일적인 AI 디자인 패턴을 찾아냅니다. 소스 코드를 건드리지 않고 프로덕션 URL에서 디자인 안티패턴을 검사합니다.
impeccable는 어떻게 설치하나요?
프로젝트 루트에서 스킬을 프로젝트에 설치합니다: npx impeccable install AI 코딩 도구 내에서 최초 1회 설정 명령을 실행합니다: /impeccable init
impeccable은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pbakaus/impeccable

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트