디자인 랩 스킬
이 스킬은 전체 디자인 탐색 워크플로우(인터뷰, 변형 생성, 피드백 수집, 개선, 미리보기 및 최종 결정)를 구현합니다.
중요: 정리 동작
프로세스가 종료되면 모든 임시 파일이 반드시 삭제되어야 합니다. 다음 상황에 해당합니다:
- 사용자가 최종 디자인을 확정 → 정리 후 계획 생성
- 사용자가 중단/취소 → 즉시 정리, 계획 생성하지 않음
절대 .claude-design/ 또는 __design_lab 경로를 남겨두지 마십시오. 사용자가 언제든 "취소", "중단", "그만", "괜찮아"라고 말하면 확인 후 모든 임시 아티팩트를 삭제하십시오.
단계 0: 사전 탐지
인터뷰를 시작하기 전에 자동으로 다음을 탐지합니다:
패키지 매니저
프로젝트 루트에서 잠금 파일 확인:
pnpm-lock.yaml→pnpm사용yarn.lock→yarn사용package-lock.json→npm사용bun.lockb→bun사용
프레임워크 탐지
설정 파일 확인:
next.config.js또는next.config.mjs또는next.config.ts→ Next.jsapp/디렉토리 확인 → App Routerpages/디렉토리 확인 → Pages Router
vite.config.js또는vite.config.ts→ Viteremix.config.js→ Remixnuxt.config.js또는nuxt.config.ts→ Nuxtastro.config.mjs→ Astro
스타일링 시스템 탐지
package.json 종속성 및 설정 파일 확인:
tailwind.config.js또는tailwind.config.ts→ Tailwind CSS@mui/material이 종속성에 있음 → Material UI@chakra-ui/react가 종속성에 있음 → Chakra UIantd가 종속성에 있음 → Ant Designstyled-components가 종속성에 있음 → styled-components@emotion/react가 종속성에 있음 → Emotion.css또는.module.css파일 → CSS Modules
디자인 메모리 확인
기존 디자인 메모리 파일 확인:
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
발견하면 읽어서 기본값을 미리 채우고 중복 질문을 건너뜁니다.
시각적 스타일 추론 (중요)
일반/사전 정의된 스타일을 사용하지 마십시오. 프로젝트에서 시각적 언어를 추출하십시오:
Tailwind가 탐지되면, tailwind.config.js 또는 tailwind.config.ts를 읽습니다:
// 추출하여 사용:
theme.colors // 색상 팔레트
theme.spacing // 간격 스케일
theme.borderRadius // 테두리 반경 값
theme.fontFamily // 타이포그래피
theme.boxShadow // 그림자 시스템
CSS 변수가 있으면, globals.css, variables.css 또는 :root 정의를 읽습니다:
:root {
--color-* /* 색상 토큰 */
--spacing-* /* 간격 토큰 */
--font-* /* 타이포그래피 토큰 */
--radius-* /* 테두리 반경 토큰 */
}
UI 라이브러리가 탐지되면 (MUI, Chakra, Ant), 테마 설정을 읽습니다:
- MUI:
theme.ts또는createTheme()호출 - Chakra:
theme/index.ts또는extendTheme()호출 - Ant:
ConfigProvider테마 prop
항상 기존 컴포넌트를 스캔하여 패턴을 이해합니다:
- 2-3개의 기존 버튼 찾기 → 스타일링 패턴 기록
- 2-3개의 기존 카드 찾기 → 패딩, 테두리, 그림자 기록
- 기존 폼 찾기 → 입력 스타일, 레이블 배치 기록
- 기존 타이포그래피 찾기 → 제목 크기, 본문 텍스트 기록
추론된 스타일을 디자인 브리프에 저장하여 모든 변형에서 일관되게 사용합니다.
단계 1: 인터뷰
모든 인터뷰 단계에 AskUserQuestion 도구를 사용하십시오. 디자인 메모리가 있으면 그에 따라 질문을 조정합니다.
단계 1.1: 범위 및 대상
다음 질문을 합니다 (단일 AskUserQuestion에 여러 질문을 결합 가능):
질문 1: 범위
- 헤더: "범위"
- 질문: "단일 컴포넌트를 디자인할까요, 아니면 전체 페이지를 디자인할까요?"
- 옵션:
- "컴포넌트" - 재사용 가능한 UI 요소 (버튼, 카드, 폼, 모달 등)
- "페이지" - 완전한 페이지 또는 화면 레이아웃
질문 2: 신규 또는 재설계
- 헤더: "유형"
- 질문: "새로운 디자인인가요, 아니면 기존 것을 재설계하는 것인가요?"
- 옵션:
- "신규" - 처음부터 새로 만듦
- "재설계" - 기존 컴포넌트/페이지 개선
"재설계"를 선택한 경우, 물어볼 질문: 질문 3: 기존 경로
- 헤더: "위치"
- 질문: "기존 UI의 파일 경로 또는 경로는 무엇인가요?"
- 옵션: (사용자가 "기타"를 통해 제공)
대상이 명확하지 않으면, 저장소 패턴을 기반으로 이름을 제안하고 확인합니다.
단계 1.2: 문제점 및 영감
질문 1: 문제점
- 헤더: "문제점"
- 질문: "현재 디자인의 가장 큰 문제점은 무엇인가요? (또는 이 새 디자인이 피해야 할 것은?)"
- 옵션:
- "너무 복잡함/빽빽함" - 정보 과부하, 스캔하기 어려움
- "계층 구조가 불명확함" - 주요 작업이 눈에 띄지 않음
- "모바일 경험 부족" - 작은 화면에서 제대로 작동하지 않음
- "구식 디자인" - 브랜드와 일관성이 없거나 낡아 보임
- multiSelect: true
질문 2: 시각적 영감
- 헤더: "시각적 스타일"
- 질문: "시각적 영감을 위해 참고할 제품이나 브랜드는 무엇인가요?"
- 옵션:
- "Stripe" - 깔끔함, 미니멀함, 신뢰감
- "Linear" - 빽빽함, 키보드 우선, 개발자 중심
- "Notion" - 유연함, 콘텐츠 중심, 유쾌함
- "Apple" - 프리미엄, 여백이 많음, 정교함
- multiSelect: true
질문 3: 기능적 영감
- 헤더: "상호작용"
- 질문: "어떤 상호작용 패턴을 모방해야 할까요?"
- 옵션:
- "인라인 편집" - 모달 없이 제자리에서 편집
- "점진적 공개" - 필요에 따라 더 많은 정보 표시
- "낙관적 업데이트" - 즉각적인 피드백, 백그라운드에서 동기화
- "키보드 단축키" - 고급 사용자 효율성 향상
단계 1.3: 브랜드 및 스타일 방향
질문 1: 브랜드 형용사
- 헤더: "브랜드 톤"
- 질문: "원하는 브랜드 느낌을 설명하는 형용사 3-5개는 무엇인가요?"
- 옵션:
- "미니멀" - 깔끔함, 단순함, 정리됨
- "프리미엄" - 고급스러움, 세련됨, 정교함
- "유쾌함" - 재미있음, 친근함, 접근하기 쉬움
- "실용적" - 기능적, 효율적, 불필요한 것 없음
- multiSelect: true
질문 2: 밀도
- 헤더: "밀도"
- 질문: "선호하는 정보 밀도는 무엇인가요?"
- 옵션:
- "조밀한" - 더 많은 정보 표시, 간격 좁힘
- "편안한" - 균형 잡힌 간격, 쉬운 스캔
- "여유로운" - 넉넉한 여백, 집중된 주의
질문 3: 다크 모드
- 헤더: "다크 모드"
- 질문: "다크 모드가 필요한가요?"
- 옵션:
- "예" - 반드시 다크 모드 지원
- "아니오" - 라이트 모드만
- "있으면 좋음" - 쉽다면 지원, 필수는 아님
단계 1.4: 페르소나 및 잡스-투-비-던
질문 1: 주요 사용자
- 헤더: "사용자"
- 질문: "주요 최종 사용자는 누구인가요?"
- 옵션:
- "개발자" - 기술적, 키보드 지향
- "디자이너" - 시각적, 세부 지향
- "비즈니스 사용자" - 효율성 중심, 덜 기술적
- "최종 소비자" - 일반 대중, 다양한 기술 수준
질문 2: 맥락
- 헤더: "맥락"
- 질문: "주요 사용 맥락은 무엇인가요?"
- 옵션:
- "데스크톱 우선" - 주로 큰 화면에서 사용
- "모바일 우선" - 주로 휴대폰에서 사용
- "둘 다 동등" - 모든 기기에서 잘 작동해야 함
질문 3: 주요 작업
- 헤더: "주요 작업"
- 질문: "사용자가 반드시 완료해야 하는 상위 3가지 작업은 무엇인가요?"
- (사용자가 "기타"를 통해 제공 - 열린 질문)
단계 1.5: 제약 조건
질문 1: 유지해야 할 요소
- 헤더: "유지"
- 질문: "반드시 유지해야 할 요소가 있나요?"
- 옵션:
- "기존 복사본/라벨" - 현재 텍스트 유지
- "현재 필드/입력" - 폼 구조 유지
- "내비게이션 구조" - 현재 내비게이션 유지
- "없음" - 모든 것을 자유롭게 변경 가능
질문 2: 기술적 제약
- 헤더: "제약 조건"
- 질문: "기술적 제약 사항이 있나요?"
- 옵션:
- "새로운 종속성 없음" - 기존 라이브러리만 사용
- "기존 컴포넌트 사용" - 현재 디자인 시스템 기반으로 구축
- "접근성 준수 (WCAG)" - 엄격한 접근성 요구 사항
- "없음" - 특별한 제약 없음
- multiSelect: true
단계 2: 디자인 브리프 생성
인터뷰 후, 구조화된 디자인 브리프를 JSON으로 생성하여 .claude-design/design-brief.json에 저장합니다:
{
"scope": "component|page",
"isRedesign": true|false,
"targetPath": "src/components/Example.tsx",
"targetName": "Example",
"painPoints": ["너무 빽빽함", "주요 작업이 불명확함"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["인라인 검증"]
},
"brand": {
"adjectives": ["미니멀", "신뢰감"],
"density": "편안한",
"darkMode": true
},
"persona": {
"primary": "개발자",
"context": "desktop-first",
"keyTasks": ["결제 완료", "주문 검토", "할인 적용"]
},
"constraints": {
"mustKeep": ["기존 필드"],
"technical": ["새로운 종속성 없음", "WCAG 접근성 준수"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
진행하기 전에 사용자에게 요약을 표시합니다.
단계 3: 디자인 랩 생성
디렉토리 구조
모든 파일을 .claude-design/ 아래에 생성합니다:
.claude-design/
├── lab/
│ ├── page.tsx # 메인 랩 페이지 (프레임워크별)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # 랩 레이아웃 래퍼
│ ├── feedback/ # 인터랙티브 피드백 시스템
│ │ ├── types.ts # TypeScript 인터페이스
│ │ ├── selector-utils.ts # 요소 식별
│ │ ├── format-utils.ts # 피드백 형식 지정
│ │ ├── FeedbackOverlay.tsx # 메인 오버레이 컴포넌트
│ │ └── index.ts # 모듈 내보내기
│ └── data/
│ └── fixtures.ts # 공유 모의 데이터
├── design-brief.json
└── run-log.md
피드백 시스템 설정 (중요 - 절대 건너뛰지 마십시오)
FeedbackOverlay는 디자인 랩의 핵심 기능입니다. 이것이 없으면 사용자가 인터랙티브 피드백을 제공할 수 없습니다. FeedbackOverlay 없이 디자인 랩을 절대 생성하지 마십시오.
안정성 전략: 다양한 프로젝트 설정에서 임포트 경로 문제를 피하기 위해, FeedbackOverlay를 경로 디렉토리(예: app/design-lab/FeedbackOverlay.tsx)에 직접 생성하고 .claude-design/에는 생성하지 마십시오. 이렇게 하면 간단한 상대 경로 임포트(./FeedbackOverlay)가 항상 작동합니다.
경로 디렉토리의 필수 파일:
app/design-lab/ # 또는 app/__design_lab/ (밑줄이 작동하는 경우)
├── page.tsx # 변형이 포함된 메인 랩 페이지
└── FeedbackOverlay.tsx # 독립형 오버레이 컴포넌트 (템플릿에서 복사)
템플릿 출처: design-and-refine/templates/feedback/FeedbackOverlay.tsx
이 접근 방식의 이유:
.claude-design/경로는 번들러 설정 때문에 실패할 수 있음- 같은 디렉토리의 상대 경로 임포트는 항상 작동함
- 경로 디렉토리는 정리 중에 어차피 삭제됨
경로 통합
Next.js App Router:
app/__design_lab/page.tsx를 생성하여 .claude-design/lab/에서 임포트합니다.
Next.js Pages Router:
pages/__design_lab.tsx를 생성하여 .claude-design/lab/에서 임포트합니다.
Vite React:
- React Router가 있는 경우:
/__design_lab경로 추가 - 라우터가 없는 경우:
App.tsx에?design_lab=true쿼리 파라미터 기반 조건부 렌더링 생성
기타 프레임워크: 탐지된 프레임워크에 가장 적합한 임시 경로를 생성합니다.
변형 생성 지침
중요: UX, 상호작용 및 모션 모범 사례를 위해 DESIGN_PRINCIPLES.md를 읽으십시오. 그러나 사전 정의된 시각적 스타일을 사용하지 말고 프로젝트에서 추론하십시오.
보편적 원칙 적용 (DESIGN_PRINCIPLES.md에서):
- UX: Nielsen의 휴리스틱, 인지 부하 감소, 점진적 공개
- 컴포넌트 동작: 버튼 상태, 폼 구조, 카드 구조
- 상호작용: 피드백 패턴, 상태 처리, 낙관적 업데이트
- 모션: 타이밍 (150-300ms), 이징 (ease-out 진입, ease-in 종료)
- 접근성: 포커스 상태, ARIA 패턴, 터치 대상 (최소 44px)
프로젝트에서 시각적 스타일 추론:
- 색상 → Tailwind 설정, CSS 변수 또는 기존 컴포넌트에서
- 타이포그래피 → 코드베이스의 기존 제목, 본문 텍스트에서
- 간격 → 프로젝트의 간격 스케일 또는 기존 패턴에서
- 테두리 반경 → 기존 카드, 버튼, 입력 필드에서
- 그림자 → 기존 그림자 컴포넌트에서
각 변형은 서로 다른 디자인 축을 탐색해야 합니다. 사소한 변형을 만들지 말고 의미 있게 구별되도록 하십시오. 모든 변형에 프로젝트의 기존 시각적 언어를 사용하십시오.
변형 A: 정보 계층 구조 초점
- 콘텐츠 계층 구조 재구성 (가장 중요한 것은?)
- 게슈탈트 근접성 적용 — 관련 항목을 더 가깝게 그룹화
- 뷰당 하나의 주요 작업
- 기존 타이포그래피 스케일을 사용하여 명확한 수준 생성
변형 B: 레이아웃 모델 탐색
- 다른 레이아웃 접근 방식 시도 (카드 vs 리스트 vs 테이블 vs 분할 창)
- DESIGN_PRINCIPLES의 카드 구조 또는 테이블 동작 패턴 적용
- 각 중단점에서 반응형 동작 고려
- 프로젝트의 기존 그리드/레이아웃 시스템 사용
변형 C: 밀도 변형
- 브리프가 "편안한"이면 더 조밀한 버전 시도
- 브리프가 "조밀한"이면 더 여유로운 버전 시도
- 프로젝트의 기존 간격 토큰을 사용하되 다르게 적용
- 트레이드오프 보여주기: 더 많은 데이터 표시 vs 더 쉬운 스캔
변형 D: 상호작용 모델
- 다른 상호작용 패턴 (모달 vs 인라인 vs 패널 vs 드로어)
- 피드백 패턴 적용: 즉시 → 진행 중 → 완료
- 필요한 모든 상태 구현 (로딩, 오류, 빈 상태, 비활성화)
- 비파괴적 작업의 경우 낙관적 업데이트 고려
변형 E: 표현 방향
- 인터뷰에서 사용자가 설명한 브랜드 방향 밀어내기
- 프로젝트의 기존 디자인 토큰을 다르게 사용하는 방법 탐색
- 그림자, 테두리, 배경색의 사용 정도 조절
- 의미를 더하는 곳에 모션 적용 (호버, 포커스, 전환)
랩 페이지 요구 사항
디자인 랩 페이지에는 다음이 포함되어야 합니다:
-
헤더에 다음 포함:
- 디자인 브리프 요약 (대상, 범위, 주요 요구 사항)
- 검토를 위한 지침
-
변형 그리드에 다음 포함:
- 명확한 라벨 (A, B, C, D, E)
- 각 변형에 대한 간단한 설명 ("왜 이것이 존재하는가")
- 실제 렌더링된 변형