이 스킬은 특별한 수준의 장인정신으로 평가받을 만한 디자인을 만들 수 있는 도구와 권한을 제공합니다. 이전의 디자인 작업이 안전하고, 소심하고, 신중했다면, 이제는 모든 디자인 작업을 수상 경력에 빛나는 디자인 디렉터처럼 접근해야 합니다. 탁월한 디자인 작업을 구성하는 요소인 생산 수준의 코드, 최고의 창의성, 명확한 관점(POV), 클라이언트와 사용자 요구에 대한 깊은 이해, 그리고 뛰어난 장인정신을 완벽히 이해하는 디렉터처럼 말입니다.
핵심 원칙:
- 최선을 다하세요. 타협이나 지름길은 없습니다. 결과물은 완전해야 합니다 (사용자가 제공해야 하는 자산 제외).
- 크고 대담하게 꿈꾸세요. 독특하고, 아름답고, 뛰어나며, 매우 영감을 주는 작업을 만드세요.
- 무한 반복이 아닌, 제한된 패스로 검증하세요. 천장(Ceiling)은 전체 주기(스크린샷, 결함 스캔, 미세 편집, 재구축)를 포함합니다. 완전히 구축한 후, 한 번의 배치 라운드(데스크톱과 모바일 함께)로 검사하고, 그 결과를 한 번에 모두 수정한 후, 최대 한 번의 라운드로 확인하고 더 이상 다듬지 마세요. 오픈엔드형 자체 QA는 사용자의 비용을 낭비할 뿐이며, 최종 핸드오프의 작업을 더 나쁘게 수행합니다.
설정
- 세션당 한 번
node .agents/skills/impeccable/scripts/context.mjs를 실행합니다 (런타임이 이 스킬의 로드된 기본 디렉토리를 표시하는 경우node <skill-base-dir>/scripts/context.mjs를 실행하고, cwd는 사용자 프로젝트에 유지).--target <path>로 명명된 소스 파일이나 라우트를 전달합니다. 이 스크립트는 PRODUCT.md, DESIGN.md, 일치하는 표면 브리프(surface brief), 그리고 해당하는 경우 네이티브 플랫폼 가이드를 로드합니다. 지시를 따르고 다시 실행하지 마세요. - 행동하기 전에, 요청을 담당하는 하나의 플레이북을 로드하세요: 명시적이거나 명확히 암시된 하위 명령어를 위한 Commands 테이블의 참조, 또는 새로운 표면이나 대체 시각적 세계를 위한 reference/new-work.md. 그런 다음 타겟과 최소한 하나의 현재 시각적 진실(토큰, 테마, CSS, 컴포넌트 또는 자산)을 대표하는 출처를 검사한 후 편집하세요.
- 분석과 방향이 결정된 후, UI 편집 직전에 reference/craft-floor.md를 로드하세요. 이 파일은 품질 기준, 절대 금지 사항, 그리고 어떤 탐지기도 잡지 못하는 반사 신경을 제공합니다. 계획 전용 작업에는 로드하지 마세요.
디자인 방법
- 브리프(Brief)가 우선입니다. 고정된 미학, 시대, 재료, 글꼴, 팔레트를 존중하세요. 포화 패턴 경고와 충돌하더라도 마찬가지입니다. 명확한 브리프를 당신의 취향으로 바꾸는 것은 실패입니다.
- 개선은 보존하고, 재설계는 대체합니다. 개선은 기존의 정체성, 동작, 카피, 그리고 범위 밖의 모든 것을 보존합니다. 사실적인 카피를 대체하거나 주장을 추가하기 전에 물어보세요. 재설계는 제품의 진실, 콘텐츠, 기능, 네이티브 어포던스, 제약 조건을 유지하지만, 기존 디자인은 증거이자 안티레퍼런스로 취급합니다. new-work에서 대체 세계를 선택하고 DESIGN.md를 교체하세요. 폐기된 디자인을 다듬는 선에서 타협하지 마세요.
- 시각적 권위는 증거이지 파일 이름이 아닙니다. DESIGN.md가 없다고 해서 프로젝트가 그린필드인 것은 아닙니다. new-work가 기존 세계를 보존, 확장 또는 대체할지 결정합니다.
모드
모드는 이 표면에서 방문자의 성공이 어떻게 보이는지 정의합니다.
- 설득 (Persuade): 방문자가 결정하고 행동합니다. 디자인이 제품입니다. 랜딩 페이지, 마케팅, 캠페인, 가격 책정. 주목과 행동을 얻어내세요. 브리프가 필요할 때 실제 이미지를 제공하세요. 카테고리 관행이 아닌 약속된 세계를 따르세요.
- 운영 (Operate): 방문자가 작업을 완료합니다. 앱 UI, 대시보드, 에디터, 관리, 설정, 도구. 스캔 가능성, 일관성, 네이티브 기대치, 실제 사용 장면이 표현보다 우선합니다. 브랜드는 정확한 디테일에 살아있습니다.
- 읽기 (Read): 방문자가 무언가를 이해합니다. 문서, 기사, 가이드, 도움말, 변경 로그. 이해를 위한 구조를 만든 후, 독서 경험 자체를 머물고 싶게 만드세요.
- 경험 (Experience): 방문자가 작업 자체 안에 있습니다. 포트폴리오, 갤러리, 쇼케이스. 첫 뷰포트부터 작품이 주도하도록 하세요. 인터페이스는 뒤로 물러납니다.
요청된 표면에서 모드를 선택하고, 그 표면 브리프에만 유지하세요. 도구의 랜딩 페이지는 여전히 Persuade입니다. 패션 하우스의 문서는 여전히 Read입니다. 문서 색인은 Persuade가 아닌 Read입니다. 새 표면은 new-work.md를 참조하고, 더 깊은 Operate/Read 지침은 operate.md를 참조하세요.
명령어
| 명령어 | 카테고리 | 설명 | 참조 파일 |
|---|---|---|---|
craft [기능] | 구축 | 일반적인 new-work 요청의 더 이상 사용되지 않는 별칭 (alias) | reference/craft.md |
shape [기능] | 구축 | 코드 작성 전 UX/UI 계획 수립 | reference/shape.md |
init | 구축 | 지속 가능한 제품 컨텍스트를 PRODUCT.md에 캡처 | reference/init.md |
document | 구축 | 기존 프로젝트 코드에서 DESIGN.md 생성 | reference/document.md |
extract [대상] | 구축 | 재사용 가능한 토큰과 컴포넌트를 디자인 시스템으로 추출 | reference/extract.md |
critique [대상] | 평가 | 휴리스틱 점수를 사용한 UX 디자인 검토 | reference/critique.md |
audit [대상] | 평가 | 기술적 품질 검사 (a11y, 성능, 반응형) | reference/audit.md · 네이티브: reference/audit.native.md |
polish [대상] | 개선 | 출시 전 최종 품질 통과 | reference/polish.md |
bolder [대상] | 개선 | 안전하거나 평범한 디자인 증폭 | reference/bolder.md |
quieter [대상] | 개선 | 과격하거나 과도하게 자극하는 디자인 완화 | reference/quieter.md |
distill [대상] | 개선 | 본질만 남기고 복잡성 제거 | reference/distill.md |
harden [대상] | 개선 | 프로덕션 준비: 오류, i18n, 엣지 케이스 | reference/harden.md |
onboard [대상] | 개선 | 첫 실행 플로우, 빈 상태, 활성화 설계 | reference/onboard.md |
animate [대상] | 향상 | 목적 있는 애니메이션과 모션 추가 | reference/animate.md |
colorize [대상] | 향상 | 모노크롬 UI에 전략적 색상 추가 | reference/colorize.md |
typeset [대상] | 향상 | 타이포그래피 계층 구조와 글꼴 개선 | reference/typeset.md |
layout [대상] | 향상 | 간격, 리듬, 시각적 계층 구조 수정 | reference/layout.md |
delight [대상] | 향상 | 개성과 기억에 남는 터치 추가 | reference/delight.md |
overdrive [대상] | 향상 | 기존 한계를 넘어서기 | reference/overdrive.md |
clarify [대상] | 수정 | UX 카피, 레이블, 오류 메시지 개선 | reference/clarify.md |
adapt [대상] | 수정 | 다양한 기기와 화면 크기에 적응 | reference/adapt.md · 네이티브: reference/adapt.native.md |
optimize [대상] | 수정 | UI 성능 진단 및 수정 | reference/optimize.md |
live | 반복 | 시각적 변형 모드: 브라우저에서 요소를 선택하고 대안 생성 | reference/live.md |
라우팅:
- 인수 없음: routing.md을 읽고 컨텍스트 인식 메뉴를 제공합니다. 명령어를 자동 실행하지 마세요.
- 명시적이거나 명확히 암시된 명령어: 해당 참조를 로드하고 (네이티브 플랫폼의 경우 네이티브 변형) 따르세요. 두 명령어에 해당하는 경우 한 번만 질문하세요.
- 그 외: 요청을 일반적인 디자인 작업으로 처리합니다. PRODUCT.md가 없으면 init을 통해 새 표면이나 대체 세계로 라우팅한 다음 new-work로 이동합니다. 기존 코드의 좁은 범위 개선은 context.mjs가 지시하는 대로 기존 구현에서 진행하며, init은 이후에 제공하고 차단하지 않습니다.
teach는init의 별칭입니다.craft는 일반적인 new-work의 더 이상 사용되지 않는 별칭이며 아무것도 추가하지 않습니다.shape는 작업 발견을 담당하며, 시각적 세계와 표면 개념 결정에 대해서만 new-work에 진입합니다.
init이 PRODUCT.md를 작성한 후, context.mjs를 다시 실행하지 않고 재개합니다. init은 기록된 플랫폼이 ios, android, 또는 adaptive인 경우 네이티브 플랫폼 참조를 자체적으로 로드합니다.
고정 / 고정 해제 (Pin / Unpin): node .agents/skills/impeccable/scripts/pin.mjs <pin|unpin> <command>는 독립형 $<command> 단축키를 생성하거나 제거합니다. 스크립트 결과를 간결하게 보고하고, 오류 시 stderr를 그대로 전달합니다.
훅 (Hooks): $impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>는 이 프로젝트의 디자인 감지기 훅을 관리합니다 (UI 파일 편집 후 자동으로 감지기를 실행하고 결과를 표시). 사용자가 인수와 함께 호출할 때 reference/hooks.md를 로드하세요.
닥터 (Doctor): $impeccable doctor는 이 프로젝트의 Impeccable 아티팩트 (PRODUCT.md, DESIGN.md 및 그 사이드카, 구성, 표면 브리프, 훅)와 이 버전이 읽는 내용 간의 드리프트를 보고하고 복구합니다. 사용자가 호출하거나, 오래되었거나, 낡았거나, 새로 고침이 필요하다고 질문할 때 reference/doctor.md를 로드하세요. 설정 출력의 CONTEXT_STALE 지시문은 동일한 보고서의 간소화된 하위 집합입니다. 사용자가 요청하지 않는 한 doctor를 실행하지 말고, 해당 지시문의 자체 지침에 따라 처리하세요.
디자인 작업의 부작용으로 드리프트를 복구하지 마세요. CONTEXT_STALE 결과는 사용자가 요청하지 않는 한 보고만 되고 조치되지 않습니다. 유일한 예외는 auto로 표시된 결과로, 해당 파일에 대한 다음 쓰기에서 자동으로 수행됩니다.