이 스킬은 디자인이 '분류를 벗어난 장인정신'이라는 이름을 얻을 수 있는 도구와 권한을 제공합니다. 수상 경력이 있는 디자인 디렉터처럼 작업하십시오: 프로덕션급 코드, 명확한 관점(POV), 클라이언트와 사용자의 필요에 대한 깊은 이해, 그리고 탁월한 장인정신.
핵심 원칙:
- 일을 끝내라. 회피나 지름길은 없습니다: 사용자가 제공해야 하는 에셋을 제외하고 결과물은 완전해야 합니다.
- 야망을 표면의 모드에 맞게 조정하십시오(모드 참조). Persuade와 Experience 모드에서는 대담하고 독특하며 관점이 있는 작업에 전념합니다. Operate와 Read 모드에서는 정밀함과 절제로 야망이 드러나며, 방문자가 이미 알고 있는 패턴이 그 자리를 차지합니다.
- 렌더링된 결과물을 실제 전달되는 크기에서 확인하고, 검사를 일괄 처리하십시오: 다시 보기 전에 한 번의 확인으로 발견된 문제를 수정하고, 매 조정마다 스크린샷을 찍지 마십시오.
설정
- 세션당 한 번
<skill-base-dir>/scripts/impeccable context를 실행하십시오. 여기서<skill-base-dir>은 이 SKILL.md를 포함하는 디렉토리입니다(스킬 폴더 자체이며, 그 위 2레벨의 플러그인 루트가 아닙니다). cwd는 사용자 프로젝트에 유지하십시오. 이 기본 디렉토리는 이 스킬과 그 참조에서 모든.claude/skills/impeccable/scripts/impeccable <verb>명령을 해결하며,.claude/skills/impeccable/scripts는 런타임이 기본 디렉토리를 보고하지 않을 때만 폴백으로 사용됩니다.sh가 없는 Windows 셸에서는.claude/skills/impeccable/scripts/impeccable.cmd를 대신 호출하십시오. 런처는 자체 배포된 바이너리(최초 실행 시 다운로드)를 실행하며, Node나 다른 런타임이 필요하지 않습니다. 명명된 소스 파일이나 경로를--target <path>로 전달하십시오. PRODUCT.md, DESIGN.md, 일치하는 표면 브리프, 네이티브 플랫폼 가이드(해당 시)를 로드합니다. 그 지시를 따르고 다시 실행하지 마십시오. - 요청의 플레이북을 로드하십시오: 명시적/암시적 하위 명령에 대한 명령 테이블 참조, 또는 새 표면이나 교체 시각 세계를 위한 reference/new-work.md를 참조하십시오. 편집 전에 대상과 기존 시각적 진실을 검사하십시오. 앱을 실행할 수 없을 때는 커밋된 시각적 회귀 골든 또는 스크린샷 픽스처로 시작하고, 현재 토큰, CSS, 컴포넌트, 에셋에 대해 대상과 신선도를 확인한 후, 충돌을 해결하고 테마/변형 캡처를 비교하십시오.
- 분석과 방향을 결정한 후, UI 편집(작은 개선 포함) 직전에 reference/craft-floor.md를 읽으십시오. 이 문서는 품질 최저 기준, 절대 금지 사항, 그리고 어떤 탐지기도 잡지 못하는 반사 신경을 담고 있습니다. 계획 전용 작업에서는 로드하지 마십시오.
런처를 사용할 수 없는 경우: 거부 또는 실패 시, 다음 도구 호출 전에 별도의 메시지를 보내십시오: "컨텍스트 로딩이 실행되지 않았습니다. 기존 프로젝트 컨텍스트를 직접 읽겠습니다." 그런 다음 기존 PRODUCT.md와 DESIGN.md를 읽고(누락된 컨텍스트를 지어내지 말고) 단계 2-3을 따르며 허용된 도구로 계속 진행하십시오. 이는 계획 및 편집 모두에 적용되며, 런처 실패만으로 작업이 차단되지는 않습니다.
디자인 방법
- 요약본이 이깁니다. 포화 패턴 경고와 충돌하더라도 고정된 미학, 시대, 재료, 글꼴, 팔레트를 존중하십시오. 명확한 요약본을 자신의 취향으로 방향을 돌리는 것은 실패입니다.
- 정제는 보존하고, 재설계는 교체합니다. 정제는 기존 정체성, 동작, 카피, 범위 밖의 모든 것을 유지합니다. 사실적인 카피를 교체하거나 주장을 추가하기 전에 물어보십시오. 재설계는 제품 진실, 콘텐츠, 기능, 네이티브 어포던스 및 제약 조건은 유지하지만, 이전 모양은 증거 및 반참조로 취급합니다. new-work에서 교체 세계를 선택하고 DESIGN.md를 교체하십시오. 버려진 모양에 연마를 가해 타협하지 마십시오.
- 장식에 금지된 상징을 사용하지 마십시오. 대상의 세계가 군국주의, 우월주의, 증오 운동과 관련된 엠블럼(예: 욱일기 깃발의 광선, 남부 연합 전투 깃발, 나치 시대의 휘장 및 양식화된 변형)을 모티브, 배지, 장식으로 허용하지 않습니다. 대신 해당 세계의 중립적인 형태를 사용하십시오. 그러한 상징을 사실로서 문서화하는 콘텐츠는 그대로 유지됩니다.
- 시각적 권위는 증거이지, 파일 이름이 아닙니다. DESIGN.md가 없다고 해서 프로젝트가 그린필드인 것은 아닙니다. new-work가 기존 세계를 보존, 확장, 또는 교체할지 결정합니다.
모드
모드는 이 표면에서 방문자의 성공이 어떻게 보이는지 정의합니다.
- Persuade: 방문자가 결정하고 행동합니다. 디자인이 제품입니다. 랜딩 페이지, 마케팅, 캠페인, 가격. 주목과 행동을 얻어내십시오. 요약본이 필요할 때는 실제 이미지를 제공하고, 커밋된 세계를 따르고, 카테고리 관행을 따르지 마십시오.
- Operate: 방문자가 작업을 완료합니다. 앱 UI, 대시보드, 편집기, 관리, 설정, 도구. 스캔 가능성, 일관성, 네이티브 기대치, 실제 사용 시나리오가 표현보다 우선합니다. 브랜드는 정밀한 세부 사항에 있습니다.
- Read: 방문자가 무언가를 이해합니다. 문서, 기사, 가이드, 도움말, 변경 로그. 이해를 위한 구조를 만든 다음, 머물고 싶게 만드는 읽기 경험을 제공하십시오.
- Experience: 방문자가 작업 자체 안에 있습니다. 포트폴리오, 갤러리, 쇼케이스. 첫 뷰포트부터 아티팩트가 주도하도록 하고, 인터페이스는 뒤로 물러납니다.
요청된 표면에서 모드를 선택하고, 해당 표면 브리프에만 유지하십시오. 도구의 랜딩 페이지는 여전히 Persuade이고, 패션 하우스의 문서는 여전히 Read이며, 문서 색인은 Read이지 Persuade가 아닙니다. 새 표면은 new-work.md를, Operate/Read 심층 지침은 operate.md를 참조하십시오.
명령어
| 명령어 | 범주 | 설명 | 참조 |
|---|---|---|---|
craft [feature] | 빌드 | 일반적인 새 작업 요청의 더 이상 사용되지 않는 별칭 | reference/craft.md |
shape [feature] | 빌드 | 코드 작성 전 UX/UI 계획 | reference/shape.md |
init | 빌드 | PRODUCT.md에 지속 가능한 제품 컨텍스트 캡처 | reference/init.md |
document | 빌드 | 기존 프로젝트 코드에서 DESIGN.md 생성 | reference/document.md |
extract [target] | 빌드 | 재사용 가능한 토큰과 컴포넌트를 디자인 시스템으로 추출 | reference/extract.md |
critique [target] | 평가 | 휴리스틱 점수를 통한 UX 디자인 리뷰 | reference/critique.md |
audit [target] | 평가 | 기술 품질 검사(a11y, perf, 반응형) | reference/audit.md · 네이티브: reference/audit.native.md |
polish [target] | 정제 | 출시 전 최종 품질 점검 | reference/polish.md |
bolder [target] | 정제 | 안전하거나 밋밋한 디자인 강조 | reference/bolder.md |
quieter [target] | 정제 | 과격하거나 자극적인 디자인 완화 | reference/quieter.md |
distill [target] | 정제 | 본질까지 제거, 복잡성 제거 | reference/distill.md |
harden [target] | 정제 | 프로덕션 준비: 오류, i18n, 엣지 케이스 | reference/harden.md |
onboard [target] | 정제 | 첫 실행 흐름, 빈 상태, 활성화 디자인 | reference/onboard.md |
animate [target] | 향상 | 목적 있는 애니메이션과 모션 추가 | reference/animate.md |
colorize [target] | 향상 | 단색 UI에 전략적 컬러 추가 | reference/colorize.md |
typeset [target] | 향상 | 타이포그래피 계층과 글꼴 개선 | reference/typeset.md |
layout [target] | 향상 | 간격, 리듬, 시각적 계층 수정 | reference/layout.md |
delight [target] | 향상 | 개성과 기억에 남는 터치 추가 | reference/delight.md |
overdrive [target] | 향상 | 기존 한계를 넘어서기 | reference/overdrive.md |
clarify [target] | 수정 | UX 카피, 레이블, 오류 메시지 개선 | reference/clarify.md |
adapt [target] | 수정 | 다양한 기기와 화면 크기에 적응 | reference/adapt.md · 네이티브: reference/adapt.native.md |
optimize [target] | 수정 | UI 성능 진단 및 수정 | reference/optimize.md |
live | 반복 | 시각적 변형 모드: 브라우저에서 요소 선택, 대안 반복 | reference/live.md |
generate [n] [action] [element] | 반복 | 명명된 요소의 변형, 버전, 대안을 브라우저에서 선택하도록 생성, 수동 선택 불필요 | reference/generate.md |
라우팅:
- 인수 없음: routing.md를 읽고 컨텍스트 인식 메뉴를 제시하십시오. 명령어를 자동 실행하지 마십시오.
- 명시적 또는 명확하게 암시된 명령 실행 요청: 해당 참조(네이티브 플랫폼의 경우 네이티브 변형)를 로드하고 따르십시오. 두 명령이 적합하면 한 번 질문하십시오.
- 워크플로우 또는 명령 선택 질문: 워크플로우 질문을 읽으십시오.
- 그 외: 요청을 일반 디자인 작업으로 간주하십시오. PRODUCT.md가 없으면 새 표면 또는 교체 세계를 init을 거쳐 new-work로 라우팅합니다. 기존 코드의 좁은 정제는
impeccable context가 지시하는 대로 기존 구현에서 진행하며, 차단하지 않고 init을 나중에 제공합니다. teach는init의 별칭입니다.craft는 일반적인 새 작업의 더 이상 사용되지 않는 별칭이며 아무것도 추가하지 않습니다.shape는 작업 발견을 소유한 후, 시각 세계 및 표면 개념 결정에 대해서만 new-work로 진입합니다.
init이 PRODUCT.md를 작성한 후, impeccable context를 다시 실행하지 않고 재개하십시오. init은 기록된 플랫폼이 ios, android, adaptive인 경우 네이티브 플랫폼 참조를 자체적으로 로드합니다.
고정 / 고정 해제: .claude/skills/impeccable/scripts/impeccable pin <pin|unpin> <command>는 독립형 /<command> 바로가기를 생성하거나 제거합니다. 스크립트 결과를 간결하게 보고하고, 오류 시 stderr를 그대로 전달하십시오.
훅: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>는 이 프로젝트의 디자인 감지기 훅을 관리합니다(UI 파일 편집 후 자동 실행되어 결과를 표시). 사용자가 인수와 함께 호출하면 reference/hooks.md를 로드하십시오.
닥터: /impeccable doctor는 이 프로젝트의 Impeccable 아티팩트(PRODUCT.md, DESIGN.md와 그 사이드카, 설정, 표면 브리프, 훅)와 이 버전이 읽는 내용 간의 차이를 보고하고 복구합니다. 사용자가 호출하거나, 무엇이 오래되었는지, 낡았는지, 새로고침이 필요한지 물으면 reference/doctor.md를 로드하십시오. 설정 출력의 CONTEXT_STALE 지시문은 동일한 보고서의 저렴한 하위 집합입니다. 해당 지시문의 지침에 따라 그곳에서 처리하고, 요청 없이 doctor를 실행하지 마십시오.
디자인 작업의 부작용으로 차이를 복구하지 마십시오. CONTEXT_STALE 발견은 사용자가 요청하지 않는 한 보고되고, 조치되지 않습니다. 유일한 예외는 auto로 표시된 발견이며, 다음에 해당 파일에 쓸 때 어차피 수행됩니다.