Install
npx impeccable install누구에게 맞나
AI 코딩 에이전트에 설계 안내를 보탤 때 Impeccable을 본다. 공식 요약은: Design guidance for AI coding agents. 1 skill, 23 commands, live browser iteration, and 61 deterministic detector rules for AI-generated frontend design.
이미 프론트엔드 프로젝트가 있고 먼저 안정된 제품 사실을 적은 뒤 이후 명령이 그 사실로 일하게 하려는 사람에게 맞다. 색만 바꾸는 테마 패키지가 아니다. 본문은 Cursor, Claude Code, Gemini CLI, Codex CLI, Grok Build, Hermes Agent, Veto 및 every other supported tool와 함께 쓸 수 있다고 나열한다. 그 명단을 유일한 지원 범위로 읽지 말 것.
페이지:
https://github.com/pbakaus/impeccable
3분 안에 첫 시도 끝내기
공식 경로는 이 한 구간만이다. 먼저 프로젝트 루트에서 실행한다:
npx impeccable install
그다음 AI coding tool에서 /impeccable init를 실행한다. 전제: 현재 디렉터리가 프로젝트 루트다. init이 제품 사실을 PRODUCT.md에 쓰는 것을 받아들인다. 다른 설치기나 쓰지 않은 스킬 디렉터리를 발명하지 말 것.
첫 번째는 읽기 전용 대조를 하고 파일을 급히 쓰지 말 것. 에이전트에게 확인한다: init이 어떤 사실을 PRODUCT.md에 적는지, 그 사실이 시각 방향과 어떻게 다른지. 성공은 에이전트가 audience, purpose, operating context, constraints, voice, evidence를 말하고 later commands가 이를 surface-level visual direction과 섞으면 안 된다고 설명하는 것이다.
확인된 뒤에 /impeccable init를 실행한다. 성공은 프로젝트에 PRODUCT.md가 나타나고 위 필드를 덮는 것이다.
사용 사례
사례 1: 먼저 제품 사실을 고정한다. /impeccable init records durable product truth in PRODUCT.md. 「누구를 위해 만드는지, 제품이 무엇을 하는지, 어떤 단단한 제약인지, 목소리가 무엇인지」를 에이전트에게 넘겨 그 파일에 쓰게 한다. 이것은 파일 변경이다. 실행 전 PRODUCT.md를 만들거나 덮어써도 되는지 확인한다. 페이지는 파일 템플릿 전문을 주지 않는다. 장 이름 밖의 구조를 만들지 말 것.
사례 2: 결정적 규칙으로 프론트엔드 설계를 검사한다. 본문은 61 deterministic detector rules를 쓰고 따로 LLM-only critique checks이 있다. The CLI and browser extension run the deterministic rules with no LLM and no API key. 화면을 한 판 고친 뒤 모델 없는 규칙 검사를 먼저 하는 용도이며 처음부터 생성형 평을 하지 않는다. 대조 가능한 것은 이번 검사가 LLM을 쓰지 않고 API key도 요구하지 않는다고 선언하는 것이다. 23개 명령의 구체 이름은 페이지에 없다. 발명하지 말 것.
사용 경계
설치는 프로젝트 루트에서 시작한 뒤 /impeccable init다. 두 단계를 서로 경쟁하는 두 주 설치기로 쪼개지 말 것.
PRODUCT.md가 적는 것은 내구성 있는 제품 사실이며 시각 스타일 설명서가 아니다.
CLI와 브라우저 확장이 결정적 규칙을 돌릴 때 LLM과 API key가 필요 없다. LLM-only critique는 다른 종류의 검사이며 한 단계로 섞지 말 것.
클라이언트는 원문대로 나열되며 every other supported tool를 포함한다. 그중 하나만 지원한다고 쓰지 말 것. 쓰지 않은 명령 이름, 규칙 세부, 라이브 브라우저 조작 단계를 채우지 말 것.