Communitygithub.com

Cozythecoder/frontend-design-md

프로젝트 유형을 자동으로 감지하고, 의도를 분석한 후 60개 이상의 레퍼런스 패턴에서 최적의 디자인 시스템을 적용합니다.

frontend-design-md란 무엇인가요?

이 스킬은 웹 프로젝트의 파일을 스캔하여 프로젝트 유형(SaaS 랜딩, 대시보드, 전자상거래, 포트폴리오 등)을 자동으로 감지합니다. 사용자가 새로운 웹 프로젝트 파일을 생성하거나 수정할 때, 또는 "디자인 적용", "UI 개선"과 같은 명령을 내릴 때 활성화됩니다. 1단계 프로젝트 분석에서는 파일 내 키워드와 기존 디자인 토큰(색상, 타이포그래피, 여백)을 분석하여 60개 이상의 레퍼런스 패턴(Linear, Vercel, Stripe, Apple 등)과 매칭하고 신뢰도 점수를 계산합니다. 2단계 사전 점검 프로토콜에서는 프로젝트 컨텍스트 파일 생성, 에셋 검사, 기술적 제약 조건 검증을 수행합니다. 3단계에서는 선택된 디자인 시스템을 프로젝트에 맞게 적응시켜 색상, 타이포그래피, 여백, 컴포넌트를 매핑합니다. 마지막으로 4단계 검증을 통해 시각적 일관성, 접근성(명도 대비, 포커스 표시기), 성능을 확인합니다. Vue, Svelte, React 등 주요 프레임워크와 Tailwind, CSS-in-JS, SCSS 등 다양한 CSS 방식을 지원합니다. 사용자는 `.design-system` 설정 파일을 통해 자동 감지를 재정의할 수도 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

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

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

문서

디자인 시스템 인텔리전스 스킬

프로젝트 유형을 자동으로 감지하고, 의도를 분석한 후 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단계: 사전 점검 프로토콜

에셋 검사 체크리스트

디자인 시스템을 적용하기 전:

  1. project-context.md 확인

    • 프로젝트 루트에 존재하는가?
    • 없을 경우: 프로젝트 이름, 목표, 대상 독자가 포함된 템플릿으로 생성
  2. 현재 에셋 분석

    # 자동 실행
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    확인 사항:

    • 로고 존재? (SVG 선호)
    • 제품 이미지? (히어로용 투명 PNG?)
    • 색상 구성표 이미 정의됨?
    • 타이포그래피 이미 설정됨?
    • 기존 컴포넌트 라이브러리?
  3. 구성 계층 구조 결정

    • 히어로 요소: 가장 큰 시각적 요소 (제품 사진, 일러스트레이션, 헤드라인)
    • 지원 요소: 기능, 혜택, 사회적 증거
    • 액센트: 장식 요소, 패턴
  4. 기술적 제약 조건 검증

    • 프레임워크 감지 (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단계: 구현 체크리스트

우선순위에 따라 디자인 시스템 적용:

  1. 기반 (중요)

    • 색상 CSS 변수 매핑 완료
    • 타이포그래피 스케일 정의
    • 여백 시스템 설정
    • 기본 리셋/노멀라이즈 적용
  2. 레이아웃 (높음)

    • 섹션 간격 (히어로, 콘텐츠, 푸터)
    • 컨테이너 너비 (max-width, padding)
    • 그리드 시스템 (해당하는 경우)
  3. 컴포넌트 (중간)

    • 버튼 (기본, 보조, 고스트)
    • 카드 (사용하는 경우)
    • 폼/입력 필드 (사용하는 경우)
    • 내비게이션 (헤더, 푸터)
  4. 마감 (낮음)

    • 그림자/입체감
    • 테두리 반경 일관성
    • 포커스 상태
    • 호버 전환 효과

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 레이블 사용

성능 확인:

  • 레이아웃 스래싱 애니메이션 없음
  • 이미지 최적화됨
  • 사용자 정의 폰트 서브셋 처리됨

참고 자료

디자인 시스템 분석

적응 가이드

검증

카테고리별 패턴

스크립트

  • 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개 이상의 디자인 시스템 컬렉션을 자동 감지, 사전 점검, 검증 및 지능형 적응이 포함된 에픽 스타일 워크플로우와 통합합니다.

관련 스킬