디자인 시스템 인텔리전스 스킬
프로젝트 유형을 자동으로 감지하고, 의도를 분석한 후 60개 이상의 레퍼런스 패턴에서 최적의 디자인 시스템을 적용합니다.
자동 감지 트리거
이 스킬은 다음 상황에서 활성화됩니다:
- 사용자가 웹 프로젝트 파일(HTML, CSS, JS, JSX, Vue, Svelte)을 생성/수정할 때
- 사용자가 "디자인 적용", "보기 좋게 만들어", "UI 개선", "디자인 시스템 적용"이라고 말할 때
- 사용자가 특정 카테고리(랜딩 페이지, 대시보드, 포트폴리오, 전자상거래)를 언급할 때
- 프로젝트에 명시적인 디자인 시스템이 지정되지 않은 경우
1단계: 프로젝트 분석(자동)
디자인 시스템을 선택하기 전에 항상 분석을 실행하세요.
1단계: 프로젝트 카테고리 감지
프로젝트 파일을 스캔하여 유형을 결정합니다:
# 지표 확인
detections = {
'saas-landing': ['pricing', 'signup', 'features', 'hero', 'testimonials'],
'dashboard-app': ['dashboard', 'chart', 'table', 'sidebar', 'widget'],
'e-commerce': ['product', 'cart', 'checkout', 'shop', 'inventory'],
'portfolio': ['portfolio', 'gallery', 'project', 'creative', 'art'],
'content-publication': ['blog', 'article', 'post', 'content', 'newsletter'],
'brand-showcase': ['brand', 'story', 'about', 'mission', 'values'],
'developer-tool': ['api', 'docs', 'code', 'terminal', 'github'],
'service-business': ['service', 'contact', 'process', 'team', 'consulting']
}
2단계: 현재 상태 분석
기존 디자인 토큰 확인:
- CSS/SCSS/Tailwind 설정 파일의 색상
- 타이포그래피 (font-family, font-size 선언)
- 여백 (margin, padding, gap 패턴)
- 컴포넌트 (버튼 클래스, 카드 클래스)
3단계: 디자인 시스템 라이브러리 매칭
60개 이상의 레퍼런스 패턴과 비교:
| 프로젝트 유형 | 권장 디자인 시스템 |
|---|---|
| SaaS 랜딩 | linear.app, vercel.com, supabase.com, stripe.com, notion.so |
| 대시보드/앱 | linear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard |
| 전자상거래 | apple.com, shopify.com, nike.com |
| 포트폴리오 | framer.com, webflow.com, cargo.site |
| 콘텐츠/블로그 | medium.com, substack.com, stripe.com/blog |
| 개발자 도구 | vercel.com, github.com, docs.rs, nextjs.org |
| 서비스 비즈니스 | cursor.com, intercom.com, webflow.com |
| 브랜드/에이전시 | tesla.com, apple.com, nike.com |
4단계: 신뢰도 점수 계산
매칭 신뢰도 계산:
confidence = (
category_match * 0.40 + # 콘텐츠가 일치하는가?
token_similarity * 0.30 + # 색상/타이포그래피 중복?
component_patterns * 0.20 + # 버튼/카드 패턴?
layout_structure * 0.10 # 그리드/플렉스 패턴?
)
신뢰도 > 0.75: 상위 매칭 자동 제안
신뢰도 0.50-0.75: 2-3가지 대안 제시
신뢰도 < 0.50: 사용자에게 카테고리 선호도 요청
2단계: 사전 점검 프로토콜
에셋 검사 체크리스트
디자인 시스템을 적용하기 전:
-
project-context.md 확인
- 프로젝트 루트에 존재하는가?
- 없을 경우: 프로젝트 이름, 목표, 대상 독자가 포함된 템플릿으로 생성
-
현재 에셋 분석
# 자동 실행 python3 ~/.claude/skills/design-systems/scripts/inspect-project.py확인 사항:
- 로고 존재? (SVG 선호)
- 제품 이미지? (히어로용 투명 PNG?)
- 색상 구성표 이미 정의됨?
- 타이포그래피 이미 설정됨?
- 기존 컴포넌트 라이브러리?
-
구성 계층 구조 결정
- 히어로 요소: 가장 큰 시각적 요소 (제품 사진, 일러스트레이션, 헤드라인)
- 지원 요소: 기능, 혜택, 사회적 증거
- 액센트: 장식 요소, 패턴
-
기술적 제약 조건 검증
- 프레임워크 감지 (React, Vue, vanilla 등)
- CSS 접근 방식 (Tailwind, CSS-in-JS, SCSS 등)
- 애니메이션 기능 (GSAP 로드됨? Framer Motion?)
- 성능 예산 (모바일 우선? 데스크톱?)
3단계: 디자인 시스템 적용
1단계: 선택 및 로드
분석에 따라 권장 DESIGN.md 로드:
권장: Linear.app 디자인 시스템
신뢰도: 87%
매칭 이유:
- SaaS 랜딩 페이지 감지 (pricing, features 섹션)
- 다크 모드 선호 감지
- 깔끔한 타이포그래피 (Inter 유사) 발견
- 카드 기반 레이아웃 패턴 존재
2단계: 프로젝트에 적응
원본을 그대로 복사하지 마세요. 프로젝트 분석에 따라 적응:
색상:
- 프로젝트에 브랜드 색상이 있는 경우: 디자인 시스템 역할에 매핑
- 색상이 없는 경우: 디자인 시스템 팔레트를 직접 사용
- 예: "파란색 #3B82F6 → 기본 악센트 역할"
타이포그래피:
- Inter/시스템 폰트를 사용하는 경우: 디자인 시스템 스케일 유지
- 다른 폰트를 사용하는 경우: 크기/두께 적응
- 예: "Roboto → Inter 대체 → 두께 400→500 조정"
여백:
- 기존 여백 스케일 확인
- 디자인 시스템에 매핑하거나 일관성이 있으면 유지
컴포넌트:
- 기존 클래스를 디자인 시스템 패턴에 매핑
- 예: "당신의 .btn-primary → 디자인 시스템 기본 버튼"
3단계: 구현 체크리스트
우선순위에 따라 디자인 시스템 적용:
-
기반 (중요)
- 색상 CSS 변수 매핑 완료
- 타이포그래피 스케일 정의
- 여백 시스템 설정
- 기본 리셋/노멀라이즈 적용
-
레이아웃 (높음)
- 섹션 간격 (히어로, 콘텐츠, 푸터)
- 컨테이너 너비 (max-width, padding)
- 그리드 시스템 (해당하는 경우)
-
컴포넌트 (중간)
- 버튼 (기본, 보조, 고스트)
- 카드 (사용하는 경우)
- 폼/입력 필드 (사용하는 경우)
- 내비게이션 (헤더, 푸터)
-
마감 (낮음)
- 그림자/입체감
- 테두리 반경 일관성
- 포커스 상태
- 호버 전환 효과
4단계: 검증
품질 게이트
적용 후 실행:
시각적 일관성 확인:
# 위반 사항 확인
violations = []
# 1. 색상 개수
if unique_colors > 8:
violations.append("색상이 너무 많습니다 - 팔레트를 단순화하세요")
# 2. 타이포그래피 스케일
if font_sizes > 12:
violations.append("타이포그래피가 체계적이지 않습니다 - 크기를 통일하세요")
# 3. 여백 일관성
if spacing_base not in [4, 8, 16]:
violations.append("여백이 4/8px 그리드를 따르지 않습니다")
# 4. 터치 대상
if touch_targets < 44:
violations.append("터치 대상이 44px 미만입니다")
접근성 확인:
- 텍스트 명도 대비 >= 4.5:1
- 포커스 표시기 보임
- 동작 감소 설정 존중
- 필요한 곳에 ARIA 레이블 사용
성능 확인:
- 레이아웃 스래싱 애니메이션 없음
- 이미지 최적화됨
- 사용자 정의 폰트 서브셋 처리됨
참고 자료
디자인 시스템 분석
- category-detection.md - 프로젝트 유형 감지 방법
- token-extraction.md - 기존 디자인 토큰 추출
- matching-algorithm.md - 신뢰도 점수 계산 로직
적응 가이드
- color-adaptation.md - 기존 색상을 디자인 시스템에 매핑
- typography-adaptation.md - 폰트 패밀리 대체
- spacing-adaptation.md - 여백 시스템 매핑
- component-mapping.md - 클래스 이름 변환
검증
- quality-gates.md - 11가지 필수 규칙
- accessibility-checks.md - A11y 검증
- performance-checks.md - 성능 예산
카테고리별 패턴
- saas-landing.md - SaaS 랜딩 페이지 패턴
- dashboard-app.md - 대시보드 UI 패턴
- e-commerce.md - 제품/전자상거래 패턴
- portfolio.md - 크리에이티브 포트폴리오 패턴
- content-site.md - 블로그/콘텐츠 패턴
스크립트
scripts/analyze-project.py— 카테고리 및 현재 토큰 감지scripts/match-design-system.py— 라이브러리와 비교scripts/validate-application.py— 품질 게이트scripts/generate-adaptation.py— 기존 설계를 디자인 시스템에 매핑scripts/inspect-assets.py— 이미지, 로고, 브랜드 에셋 확인
디자인 시스템 라이브러리
60개 이상의 시스템이 ../design-systems/ 디렉토리에 카테고리별로 구성되어 있습니다:
SaaS / 개발자 도구
- linear.app (다크, Inter, 510 두께)
- vercel.com (Geist, 그림자-테두리)
- supabase.com (따뜻함, postgres 영감)
- stripe.com (콘텐츠 풍부, 그라데이션)
- notion.so (친근함, 둥근 모서리)
- github.com (기능적, 조밀함)
- cursor.com (에디터 중심, 구문 색상)
전자상거래 / 제품
- apple.com (SF Pro, 이진 대비, 알약 모양 CTA)
- shopify.com (양극화, Polaris 토큰)
- nike.com (대담함, 역동적, 이미지 우선)
크리에이티브 / 포트폴리오
- framer.com (장난기, 그라데이션, 탱탱함)
- webflow.com (전문적, 구조적)
콘텐츠 / 출판
- medium.com (읽기 중심, 세리프 본문)
- substack.com (따뜻함, 뉴스레터 중심)
엔터프라이즈
- ibm.com (Carbon 디자인, 체계적)
- salesforce.com (기능적, 조밀함)
자동차 / 명품
- tesla.com (미니멀, 제품 중심)
- ferrari.com (극적, 빨간 악센트)
- bmw.com (기술적, 정밀)
사용 흐름
사용자: "내 SaaS를 위한 랜딩 페이지를 만들어 줘"
↓
스킬: 프로젝트 분석...
감지: SaaS 랜딩 의도
현재 상태: 디자인 시스템 없음
↓
스킬: Linear.app 추천 (87% 일치)
대안 제시: vercel.com, stripe.com
↓
사용자: "Linear 스타일로 해 줘"
↓
스킬: 사전 점검 프로토콜 실행
- project-context.md 생성
- 에셋 분석
- 기술 스택 확인
↓
스킬: Linear 디자인 시스템 적용
- 색상 토큰 매핑
- 타이포그래피 스케일 설정
- 컴포넌트 구현
↓
스킬: 출력 검증
- 색상 명도 대비 확인
- 여백 일관성
- 품질 게이트 검토
↓
출력: Linear에서 영감을 받은 디자인의 프로젝트
설정
프로젝트 루트에 .design-system 파일을 생성하여 자동 감지를 재정의할 수 있습니다:
{
"system": "linear.app",
"theme": "dark",
"adaptations": {
"primaryColor": "#3B82F6",
"fontFamily": "Inter"
}
}
이 스킬은 60개 이상의 디자인 시스템 컬렉션을 자동 감지, 사전 점검, 검증 및 지능형 적응이 포함된 에픽 스타일 워크플로우와 통합합니다.