Communitygithub.com

ima2 UI/UX: 의도 발견, 패턴 및 제품 어휘

ima2 사용자를 위한 디자인 방향 발견 및 UX 판단. UI/UX 방향과 디자인 판단에 사용 — 모호한 시각적 브리핑, 온보딩, 빈 상태/오류 상태/로딩 상태, 레이아웃 어휘, 타이포그래피 줄바꿈, 파비콘, 로고, 브랜드 아이덴티티 선택. ima2-front와 함께 사용: 이 스킬이 디자인 방향을 결정하면 ima2-front를 로드하여 구현합니다.

UX: 의도 발견, 패턴 및 제품 어휘란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor 등)가 UI/UX 디자인 방향을 발견하고 판단할 수 있도록 설계된 전문 스킬입니다. 사용자의 모호한 요청(예: “깔끔하게”, “모던하게”)을 구체적인 디자인 방향으로 변환하고, 의도 발견 프로토콜을 통해 디자인 결정을 내립니다. ima2-gen CLI 도구를 기반으로 설치 및 실행되며, 디자인 방향이 결정되면 구현 전담 스킬인 ima2-front와 협력하여 작업을 완료합니다. 주요 기능으로는 디자인 읽기(Design Read) 생성, UX 상태(온보딩, 빈 상태, 에러 등) 처리, 레이아웃 및 내비게이션 아키텍처 선택, 색상 팔레트 생성, 파비콘/로고/브랜드 아이덴티티 설정, 타이포그래피 최적화, 그리고 반응형 내비게이션 패턴 적용 등이 포함됩니다. 또한 '게으른 사용자 게이트' 원칙을 적용하여 사용자 결정 부담을 최소화하고, 디자인 결정의 근거를 명확히 문서화합니다. 이 스킬은 Cursor, Claude Code, Codex, Windsurf 등 모든 주요 AI 코딩 도구와 호환됩니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lidge-ai/ima2-gen/tree/HEAD/skills/ima2-uiux

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

UX: 의도 발견, 패턴 및 제품 어휘은(는) 무엇을 하나요?

설정

npm install -g ima2-gen    # 전역 설치 (Node.js >= 20)
ima2 setup                 # 최초 인증 (GPT OAuth 권장)
ima2 serve                 # 로컬 서버 시작
ima2 ping                  # 확인
ima2 status                # 설정 및 OAuth 상태 확인

에이전트 부트스트랩: 먼저 ima2 ping을 실행합니다. 연결할 수 없으면: ima2 serve &. 설치되지 않은 경우: npm install -g ima2-gen && ima2 setup. ima2 skill path를 사용하여 스킬을 찾고, 디자인 방향은 ../ima2-uiux/SKILL.md(현재 파일), 구현 자산은 ../ima2-front/SKILL.md를 참조하세요.

다음과 같은 변경 상황에서 활성화됩니다:

  • 사용자의 디자인 방향이 모호할 때 ("깔끔하게", "모던하게", "just make it look good")
  • 온보딩, 빈 상태, 오류 상태 또는 로딩 상태 UI를 구축할 때
  • 사용자가 제품 미학을 언급할 때 ("Notion 느낌", "Linear처럼")
  • 새로운 디자인 시스템을 시작하거나 색상 팔레트를 생성할 때
  • 레이아웃 패턴이나 내비게이션 아키텍처를 선택할 때
  • 파비콘, 제품 로고 또는 브랜드 아이덴티티 요소를 설정할 때
  • 로고 다크 모드 변형, OG 이미지 또는 소셜 공유 메타 데이터를 처리할 때

사용자가 명확한 디자인 방향을 표현할 수 없을 때는 스타일별 참조보다 먼저 이 문서를 읽으세요. 반-슬롭 감지 및 금지된 패턴에 대해서는 ima2 skill front ref anti-slop, 특히 2026 그라디언트 예산과 단일 테마 금지 규칙을 참조하세요.

이모지 금지 (스텁): UI 시각 요소로 이모지를 사용하지 마세요 (STRICT). 표준 규칙, 범위 및 예외: ima2-front §5 / ima2 skill front ref anti-slop § 이모지 슬롭.

역할 분리: 이 스킬은 디자인 판단을 담당합니다: 의도 발견, 정보 아키텍처, UX 상태 의미, 타이포그래피/색상/레이아웃 방향, 제품 개성, 브랜드 어휘, 반-슬롭 패턴 판단 및 디자인 시스템 결정. ima2-front는 구현을 담당합니다: HTML/CSS/컴포넌트, 반응형 메커니즘, 접근성 연결, 런타임 동작 및 렌더링 검증. 여기서 디자인 방향을 결정한 후, ima2-front를 로드하여 구체적인 구현을 진행하세요.

외부/최신 디자인 증거: 라이브 제품 참조 주장, 최신 디자인 시스템 문서, 변경되었을 수 있는 브라우저 API 동작, 접근성 지침 또는 브라우저 렌더링 소스 증거가 필요한 경우, 웹을 검색하고 쿼리 재작성, 소스 가져오기 및 증거 상태 규칙을 따르세요. 후보 URL이 확보된 후에만 브라우저 fetch/open/text/get-dom/snapshot을 사용하세요.

C0/C1 작업 (소규모 로컬 패치): 소규모 패치의 경우 전체 참조 체인을 건너뛰세요.

규칙 클래스 참고 (UX-STYLE-01): 이 스킬에서 취향을 표현하는 모든 것 — 제품 개성, 디자인-이즘, 사전 설정 토큰, 미학적 어휘 — 은 STYLE_SAMPLE입니다: 참고할 예시일 뿐, 보편적인 요구 사항이 아닙니다. 객관적인 UX 정확성(상태 커버리지, 접근성, 가독성)은 ima2-front §1.5가 소유하며 STRICT/DEFAULT로 유지됩니다.

모듈식 참조

권장: 에이전트의 스킬 디렉토리에 스킬을 설치하세요.

ima2 skill install --dir <agent-skill-path>   # 에이전트가 자체 경로 제공
ima2 skill install --tmp                       # 임시 대체

에이전트가 자체 스킬 디렉토리를 결정하고 --dir로 전달합니다. 설치 후 SKILL.md와 references/는 디스크에 저장되어 기본 읽기가 가능합니다.

임시 읽기 (설치 없이):

ima2 skill uiux refs              # 모든 참조 모듈 목록 및 줄 수 표시
ima2 skill uiux ref design-isms   # 하나의 모듈 출력 (파일명 일치)
파일읽을 시기내용
references/design-isms.md사용자가 스타일/운동을 언급할 때CSS 시그니처가 포함된 16가지 디자인 운동, Liquid Glass + Liquid Editorial 기본 키트(2025-2026) + AI Serif Editorial + Organic Capsule 포함 (2026-07-09 확인)
references/design-award-sources.md실제 디자인 참조가 필요할 때계층별 소싱 가이드: 수상 및 갤러리 사이트, 각 사이트의 장점, 검색 방법
references/compositional-patterns.md히어로, 내비게이션, 모션 또는 콘텐츠 구조를 구성할 때수상 연구를 기반으로 한 표준 구성 패턴, 반응형 및 접근성 게이트 포함
references/design-trends.md날짜 기반 유행, 신기술 또는 프로모션 상태 확인 시2026-07-14 축-주파수 스냅샷, 기술 신호, 시그니처 원장 및 재크롤 프로토콜
references/design-read-example.md디자인 읽기 형식 학습 또는 복습 시작성된 디자인 읽기 + 다이얼 설정 예시
references/product-personalities.md사용자가 제품을 언급할 때정확한 토큰이 포함된 10가지 제품 DNA 프로필, 2026 AI 제품 파스텔 + OpenAI 웜 산스 오가닉 + Anthropic 세리프 북시스 포함
references/layout-macrostructures.md페이지/컴포넌트 레이아웃 선택 시컴포넌트 레이아웃 + 페이지 수준 구성
references/ux-states.md상태를 가진 UI 구축 시온보딩, 빈 상태, 로딩, 오류, 점진적 공개
references/color-system.md색상/팔레트 생성 시OKLCH 기반 팔레트 생성, 색조 예산, 틴티드 뉴트럴, 다크 모드, 접근성
references/design-system-bootstrap.md새 프로젝트 / 디자인 시스템 시작 시토큰 아키텍처, 컴포넌트 계층, DESIGN.md 형식 (google-labs-code/design.md)
references/responsive-nav.md반응형 또는 내비게이션 작업 시중단점, 컨테이너 쿼리, 밀도별 내비게이션 패턴
references/ux-preflight.md배송 전UX 상태 확인 체크리스트
references/typography-line-breaks.md텍스트가 많은 UI에는 항상제목 줄바꿈 품질, 짧은 설명자 범주 (히어로 부제목, 카드 설명 — pretty 대신 balance 사용), 미망인 방지, ch 단위, 한국어 미망인 기준, -webkit-line-clamp 충돌
references/favicon-logo.md파비콘, 제품 로고 또는 브랜드 아이덴티티 작업 시파비콘 파일 세트, SVG 다크 모드, 내비게이션/푸터의 로고, 다크 모드 변형, OG 이미지, 브랜드 토큰, 일반적인 실수
references/logo-trust-sections.md통합/파트너/고객 로고 사용 시마키 대 그리드 결정, 안티패턴, 그레이스케일 처리, 배치
references/visual-hierarchy.md모든 레이아웃/구성 결정 시6가지 레버: 크기 규모, 두께 대비, 색상 강조, 간격, 위치, 밀도
references/form-patterns.md양식, 마법사, 인증, 파일 업로드 시유효성 검사 타이밍, 다단계, 비밀번호 UX, 파일 업로드, 검색/필터
references/mobile-native-ux.md네이티브 모바일 앱 UX 결정 시iOS HIG vs Material 3, 제스처, 딥 링킹, 한국어 개인정보 보호, 앱 스토어 UX
references/intent-discovery-ladder.mdUX-INTENT-01 선택적 심화 (1-6단계)분위기/밝기/밀도/형태/뷰포트/참조 사다리, 모호한 요청 명확화
references/korean-design-vocabulary.md한국어 디자인 브리핑 또는 한국어 우선 UI 시한국어 설명자 → CSS 토큰 변환, 빠른 매칭 테이블, 글꼴 선택 지침

게으른 사용자 게이트 (UX-LAZY-01, DEFAULT — 포니테일 규율을 UX에 적용)

인지적으로 검소한 사용자를 위해 설계하세요: 사용자는 읽지 않고 훑어보며; 만족할 만한 수준에서 결정을 내리고; 선택보다 하나의 명확한 다음 행동을 선호합니다. 사용자에게 노출되는 결정 지점(옵션, 설정, 단계, 확인, 입력 필드, 모드)을 제공하기 전에 포니테일 방식으로 그 존재를 정당화하세요. 순서:

  1. 아무것도 하지 않음: 올바른 기본값이 이 결정을 완전히 제거할 수 있나요?
  2. 삭제: 단계/필드가 완료율 비용(힉의 법칙)을 정당화하나요?
  3. 흡수: 시스템이 사용자 대신 복잡성을 처리할 수 있나요 (테슬러의 법칙)?
  4. 격하: 일부 사용자에게는 여전히 필요 → 점진적 공개, 절대 최상위 분기 금지.

모든 화면에는 하나의 기본 작업이 있습니다. 조건에 따라 다릅니다: 소비자/일회성 흐름은 결정을 최소화하고; 반복 작업 도구(밀집 프로필)는 반복 동작을 최소화합니다 — 전문가 제어를 마법사로 축소하는 것은 역효과입니다. STRICT 예외: 파괴적/되돌릴 수 없는 작업, 동의/개인정보/법적 사항, 결제 확인, 접근성 편의는 기본값으로 자동 처리되지 않습니다.

UX 상태 계약 (UX-STATE-01)

온보딩, 빈 상태, 로딩, 오류 또는 점진적 공개 작업의 경우, 본문은 스타일링 전에 상태 의미를 먼저 답해야 합니다. 심층 패턴은 references/ux-states.md에 있습니다.

  • 온보딩은 제품 전체가 아닌 첫 번째 의미 있는 행동을 가르칩니다.
  • 빈 상태는 상태가 존재하는 이유를 설명하고 다음 행동을 명명합니다.
  • 로딩은 알려진 구조에는 스켈레톤을, 짧은 알 수 없는 대기에는 스피너/프로그레스를 선택하고 가짜 완료를 피합니다.
  • 오류는 재시도, 복구 또는 에스컬레이션을 노출합니다. 사용자를 막다른 골목으로 몰지 마세요.
  • 점진적 공개는 무엇이 숨겨져 있는지, 왜 숨겨져 있는지, 어디에서 사용 가능해지는지 명명합니다.

IA 선택기 (UX-IA-01)

작업 형태별 기본 내비게이션 아키텍처; 반응형 세부 사항은 references/responsive-nav.md를 읽으세요.

작업 형태기본 IA
밀집된 데스크톱 반복 작업사이드바 + 명령 팔레트
중간 크기의 섹션 작업탭 또는 세그먼트 내비게이션
모바일 우선 소비자 흐름하단 내비게이션, 시트 또는 썸존 작업
마법사/인증/설정스테퍼 또는 스택 선형 흐름

1. 사용자 의도 발견 프로토콜

사용자의 디자인 요청이 모호할 때("깔끔하게 해줘", "모던하게", "just make it look good"), 일반적인 출력을 생성하지 마세요. 간결한 모호성 해소 흐름(UX-INTENT-01)을 실행하세요:

  1. 사용 가능한 신호를 사용하여 §2에서 디자인 읽기를 생성합니다.
  2. 하나의 결정이 여전히 방향을 막고 있다면, 이진/삼진 선택지가 있는 하나의 가장 명확한 분기를 질문합니다.
  3. 답변에 따라 진행합니다. 사용자가 답변하지 않고 작업을 계속할 수 있다면, 가장 도메인에 적합한 기본값을 선택하고 가정을 명시합니다. 표현적인 표면(랜딩/소비자/크리에이티브/AI 제품)에서는 그 기본값이 아래 '브리핑 없는 기본 방향'(UX-DEFAULT-ISM-01)입니다; 조용한 표면은 조용한 도메인 적합 기본값을 유지합니다.

사용자가 명시적인 디자인 사양을 제공했거나 5줄 이하 패치인 경우 이 섹션을 건너뜁니다.

브리핑 없는 기본 방향 (UX-DEFAULT-ISM-01, DEFAULT — 키트 콘텐츠 STYLE_SAMPLE)

이는 UX-INTENT-01 3단계의 FALLBACK이며, 우회가 아닙니다: 디자인 읽기 후 하나의 차단 분기가 해결되거나 답변되지 않은 후에만 발동되며, 적용된 방향은 항상 결과물에 명시적 가정으로 명시됩니다. 명명되고 구체적이며 도메인에 국한된 방향이 일반적인 LLM 기본값을 대체합니다. 유리/중앙 카드/베이지색 기본 취향을 새로운 레이블로 재도입해서는 안 됩니다.

표현적인 표면을 위한 기본 키트: Liquid Editorial (2026년 합성, 2026-07-07 Tier-2 트렌드 연구에서 결정 — 전체 시그니처는 references/design-isms.md §1.14 참조):

  • 구조: 타입 중심의 편집 구도(과장된 작성자 제목 스케일, 기본 그로테스크, 세리프 디스플레이는 UX-TYPE-01에 따른 편집적 근거가 있는 경우에만 사용), 플랫 그라디언트 워시보다 촉각적/사진적 질감, 비대칭 콘텐츠 가중 레이아웃.
  • 재료 악센트: Liquid Glass 또는 거의 불투명한 필 크롬은 부동 기능 레이어(내비게이션/툴바/칩 클러스터)에만 사용; 필 칩 콘텐츠 단위; 콘텐츠 레이어는 단색 유지 (ima2-front FE-LIQUID-LAYER-01). 필 크롬 내부의 하위 요소는 비활성 상태에서 캡슐 테두리/윤곽선 없음 — 채우기/틴트로만 강조 (ima2-front FE-PILL-NEST-01); 상단 바 스크롤 상태는 ima2-front/references/top-bar.md FE-TOPBAR-STATE-01에 따름.
  • 모션: 피드백 기준선 + 하나의 시그니처 모먼트(포인터 근접 칩 또는 스크롤 기반 표시) + 랜딩 버킷 표면에서 >= 1개의 지원 스크롤 표시(바닥 2, 천장 ~4 — ima2-front/references/motion.md FE-MOTION-BUCKET-01); 다른 곳에서는 모션 도메인 게이트에 따라 피드백 전용.
  • 색상: OKLCH 기반 단일 악센트 + 틴티드 뉴트럴(색조 예산, references/color-system.md).

도메인 게이트 (STRICT): 대시보드, 관리, 운영, 금융, 정부, B2B 반복 작업 도구는 기본적으로 이 키트를 절대 받지 않습니다 — "화려함"이 도메인 정확성을 대체하지 않습니다 (§ IA 선택기 + ima2-front 제품 밀도 프로필).

선택적 심화: 첫 번째 분기가 실패하거나 사용자가 명시적으로 안내된 탐색을 원할 때만 아래 사다리를 사용하세요.

  • 개방형 질문 대신 이진/삼진 선택지를 사용하세요.
  • 알려진 제품을 참조하세요 — 사용자는 표현하는 것보다 원하는 것을 더 빨리 인식합니다.
  • 다이어그램 스킬을 사용할 수 있는 경우: "참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요."
  • 사용자가 특정 제품 참조를 언급하면 나머지 단계를 건너뛰고 references/product-personalities.md를 통해 직접 매핑하세요.

전체 6단계 안내 사다리(분위기 → 밝기 → 밀도 → 형태 → 뷰포트 → 참조) 및 모호한 요청 명확화 테이블은 references/intent-discovery-ladder.md를 읽으세요. 위의 간결한 흐름만으로 더 깊은 안내 탐색이 필요할 때만 로드하세요.


2. 디자인 읽기 (새 페이지, 컴포넌트 또는 레이아웃에 필수. 5줄 이하 패치는 선택 사항 — 개발 §0.1 패치 고속 경로 참조)

프론트엔드 코드를 생성하기 전에 디자인 읽기를 생성하세요. 프로젝트에 DESIGN.md 파일이 있으면 먼저 읽으세요 — 그 토큰과 산문이 아래 모든 것을 재정의합니다.

네이티브 도구 지원 (구조/60): 디자인 읽기를 작성하기 전에 기존 화면, 경쟁사 캡처, 디자인 내보내기와 같은 시각적 참조를 view_image로 컨텍스트에 읽어들이고; 필요한 비트맵 자산(아이콘, 일러스트레이션, 모의 이미지)은 ima2로 생성하고(먼저 ima2 status 확인, 중단된 경우 ima2 serve 시도; ima2가 진정으로 사용 불가능할 때만 ima2가 기본 도구입니다); 그리고 브라우저 스크린샷 -> view_image를 통해 시각적 검증을 수행하세요.

출력 형식 (미니 DESIGN.md)

작성된 예시: references/design-read-example.md.

---
name: <프로젝트 이름>
colors:
  primary: "<16진수>"
  accent: "<16진수>"
  background: "<16진수>"
typography:
  heading: { fontFamily: <글꼴>, fontSize: <크기> }
  body: { fontFamily: <글꼴>, fontSize: <크기> }
---

이것을 다음과 같이 읽습니다: <청중>을 위한 <페이지 종류>, <분위기> 언어 사용. <1-2문장: 구체적인 참조, 형용사 금지. "1970년대 강의 유인물" > "모던하고 깔끔한">

해야 할 일: <브리핑에서 컨텍스트에 맞는 긍정적 요소> 하지 말아야 할 일: <컨텍스트에 맞는 부정적 요소>

관련 스킬