pbakaus/impeccable

해결하는 문제

Impeccable은 AI 코딩 에이전트가 범용적이고 반복적이며 품질이 낮은 프론트엔드 설계(흔히 "SaaS 템플릿" 스타일이라 불리는 것)를 생성하지 않도록 설계 가이드와 품질 관리를 제공합니다. 공통 설계 어휘와 결정론적 규칙을 확립하여 AI가 생성한 UI가 전문적이고 독창적이며 특정 제품 목표에 부합하도록 보장합니다.

작동 방식

이 프로젝트는 다양한 AI 코딩 도구(Claude Code, Cursor, GitHub Copilot, Grok Build 등)에 "스킬"로 통합됩니다. 다음과 같은 기능을 조합하여 사용합니다:

• 제품 컨텍스트 (Product Context): /impeccable init 명령어를 통해 PRODUCT.md 파일을 생성하여 프로젝트의 타겟층과 목적에 대한 변하지 않는 사실을 저장합니다.
• 명령어 세트 (Command Set): 24개의 전문 명령어(예: /impeccable polish, /impeccable audit, /impeccable critique)가 UX 리뷰, 접근성 검사, 시각적 개선과 같은 특정 설계 단계에서 AI를 안내합니다.
• 결정론적 탐지기 (Deterministic Detectors): LLM을 사용하지 않고 로컬에서 실행되는 61개의 규칙을 통해 과도하게 사용된 폰트나 부적절한 색상 대비와 같은 설계 안티패턴을 즉시 탐지합니다.
• 디자인 훅 (Design Hooks): UI 파일 편집을 실시간으로 스캔하여 발견된 내용을 에이전트에게 다시 전달하는 네이티브 통합 기능입니다.

대상 사용자

AI 코딩 에이전트를 사용하는 프론트엔드 개발자 및 디자이너 중, 범용적인 AI 생성 레이아웃을 넘어 고충실도의 맞춤형 전문 설계를 구현하고자 하는 분들.

주요 특징

• 광범위한 도구 지원: Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI 등 다양한 에이전트와 호환됩니다.
• 결정론적 규칙: 61개의 비-LLM 규칙이 포함되어 있어 일반적인 설계 실수를 즉시 잡아냅니다.
• 구조화된 워크플로우: 제품 사실 수집(init)부터 계획(shape), 최종 출시 준비(polish)까지의 과정을 체계화합니다.
• 실시간 반복: live 모드를 통해 브라우저에서 직접 시각적 변형을 반복적으로 수정할 수 있습니다.