프로젝트 소개

Impeccable은 AI 코딩 에이전트를 위한 디자인 안내 시스템입니다. 23개의 슬래시 명령어 단축키와 61개의 결정론적 탐지 규칙을 통해 AI가 생성한 프론트엔드 디자인의 품질을 향상시키며, 유사한 SaaS 템플릿으로 훈련된 모델에서 흔히 나타나는 반복 패턴 문제를 타겟팅합니다. 이 도구는 Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Grok Build, Hermes Agent, Pi, OpenCode, DeepSeek Harness, Trae, Rovo Dev, Qoder, Google Antigravity, Mistral Vibe를 포함한 다양한 AI 코딩 하니스에서 스킬 또는 플러그인으로 작동합니다. 단일 `/impeccable init` 명령어를 통해 제품 컨텍스트를 `PRODUCT.md`에 영구 저장한 후, 이후 명령어들은 공유된 디자인 어휘를 기반으로 작동합니다. 주요 명령어는 다음과 같습니다: - `audit`: 접근성, 성능, 반응형 등 기술 품질 점검 - `critique`: UX 디자인 검토 - `polish`: 최종 출시용 다듬기 - `animate`: 목적 있는 모션 추가 - `colorize`: 전략적 색상 도입 - `typeset`: 타이포그래피 수정 - `layout`: 간격 및 시각적 리듬 조정 - `harden`: 에러 처리 및 엣지 케이스 강화 - `distill`: 단순화 - `live`: 브라우저 기반 시각적 반복 작업 이 프로젝트는 AI 모델이나 API 키 없이도 61개의 결정론적 Anti-pattern 검사를 실행하는 독립형 CLI(`npx impeccable detect`)를 포함합니다. 디렉토리, HTML 파일, 라이브 URL 등을 스캔할 수 있습니다. 배포된 사이트를 Inspection할 수 있는 브라우저 확장 프로그램도 제공됩니다. 설치는 `npx impeccable install`로 이루어지며, 설치된 하니스를 자동 감지하고 지원되는 경우 네이티브 훅을 구성합니다. 훅은 UI 파일 편집 시 디자인 검출을 실행하고 결과를 에이전트 흐름에 반영합니다. 엔진은 자체 바이너리로 제공되며, Node는 `npx` 설치자 shim에만 필요합니다.