본문으로 건너뛰기

클로디 디자인 "디자인 시스템" 업로드 과정

세이지

2026.07.22

오늘 진행한 프로젝트(designlang 추출 → 토큰 교정 → 디자인 시스템 문서화 → claude.ai/design 업로드)를 사례 발표 양식에 맞춰 정리했습니다. 아래 내용을 그대로 복사해 쓰시면 됩니다.


소개 — 시도하고자 했던 것과 그 이유

"좋아하는 웹사이트의 디자인을, 감(感)이 아니라 실제 규칙으로 뽑아내 내 것으로 만들 수 있을까?" 를 실험했습니다.

평소 디자인 레퍼런스를 볼 때 "이 느낌 좋다"에서 멈추고, 막상 내 작업에 옮기려면 색·폰트·여백을 일일이 눈대중으로 따야 했습니다. 이번엔 국내 이메일 마케팅 서비스 스티비(stibee.com) 를 대상으로 삼아, ① 디자인 토큰을 자동 추출하고 → ② 추출 노이즈를 사람이 교정하고 → ③ 실제 상세페이지 컴포넌트와 PPTX 규칙에 매핑한 디자인 시스템으로 완성한 뒤 → ④ claude.ai/design에 팀이 함께 쓸 수 있는 프로젝트로 올리는 것까지 한 흐름으로 해봤습니다.

목표는 "예쁜 결과물 하나"가 아니라, 재사용 가능한 브랜드 규칙 자산을 만드는 것이었습니다.


진행 방법 — 어떤 도구를 어떻게 활용했나

사용 도구: Claude Code · designlang(오픈소스 디자인 추출 CLI) · claude.ai/design(디자인 시스템 호스팅)

전체 흐름은 4단계였습니다.

1) 환경 확인 & 자동 추출 — Node.js 설치를 확인하고, 헤드리스 브라우저로 실제 렌더된 CSS를 훑는 designlang을 돌렸습니다. URL 하나로 색·폰트·간격·모션·컴포넌트를 35개 포맷(디자인 토큰 JSON, Tailwind, Figma 변수 등)으로 뽑아줍니다.

npx designlang https://stibee.com

추출 결과 핵심 토큰: 원색 #ff6464, 서체 Pretendard, 머티리얼 flat, 컴포넌트 라이브러리 Ant Design.

2) 추출 노이즈 교정 — 여기가 이번 프로젝트의 핵심이었습니다. 빈도 기반 자동 추출이라 잘못 잡힌 값이 많았고, 이걸 Claude에게 짚게 했습니다. 사용한 프롬프트:

방금 designlang이 뽑은 결과를 바탕으로, 이 도구가 무엇을·어떻게·왜 하는지
직관적으로 설명해줘. 그리고 추출된 핵심 토큰(색·폰트·여백·컴포넌트)을 요약하고,
믿을 수 없는 노이즈(예: 이모지가 폰트로 잡히는 것)가 있으면 짚어줘.

실제로 걸러낸 노이즈 7건: 아이콘 폰트(stibeeicon10)가 서체로 오인, 본문 크기가 44px(실제 14px)로 잡힘, 흰 글자 on #ff6464가 대비 2.9:1로 WCAG 실패, 간격에 난수성 값 혼입 등.

3) 디자인 시스템 문서화 — 교정본을 실제 컴포넌트와 PPTX 규칙에 매핑해 하나의 HTML로 묶었습니다.

designlang이 뽑아준 토큰과 브랜드 문서를 원본 초안으로 삼아:
1. 추출 노이즈(폰트·색 대비 등) 교정하고 대안 제시
2. 이 토큰을 상세페이지(HTML) 실제 컴포넌트(히어로/가격표/CTA/카드/뱃지)에 매핑
3. PPTX 카탈로그용 규칙(표지·본문 슬라이드 색/폰트/여백) 별도 정리
4. 위를 하나의 HTML로 묶어 한눈에 살펴보게 해줘

4) claude.ai/design 업로드 — 컴포넌트별로 파일을 쪼개고 각 미리보기 HTML 첫 줄에 @dsCard 마커를 넣어, Design System 패널에 카드로 자동 등록되게 했습니다.

<!-- @dsCard group="Components" name="히어로" width="900" height="460" -->

이렇게 준비한 11개 파일(Foundations 3 + Components 5 + 토큰 2 + README)을 "우리 브랜드 디자인 시스템" 프로젝트로 새로 만들어 올렸습니다.

📸 캡처 남길 자리: ① designlang 실행 로그(35개 파일 생성 화면) ② 디자인 시스템 HTML 전체 뷰(색·타이포·컴포넌트) ③ claude.ai/design에 카드로 정리된 프로젝트 화면 — 이 3장을 넣으면 흐름이 한눈에 보입니다.


결과와 배운 점

결과물: 스티비 브랜드를 교정된 토큰 → 상세페이지 컴포넌트 5종 → PPTX 규칙 → claude.ai/design 팀 자산까지 한 번에 연결한 디자인 시스템 파이프라인을 완성했습니다.

배운 점 & 꿀팁

  • 자동 추출은 '초안'이지 '정답'이 아니다. 가장 큰 교훈이었어요. 툴이 뽑은 토큰을 그대로 믿으면 안 되고, 특히 색 대비·아이콘 폰트·본문 크기는 반드시 사람이 검증해야 합니다. Claude에게 "믿을 수 없는 노이즈를 짚어줘"라고 의심을 명시적으로 시키는 프롬프트가 결정적이었습니다.

  • 접근성은 대안까지 세트로. #ff6464가 대비 실패라는 지적에서 끝내지 않고, 텍스트용 강화색 #d92d2d(4.8:1 통과)를 분리해 "원색은 장식, 강화색은 텍스트"라는 규칙으로 정리하니 실무에 바로 쓸 수 있었습니다.

  • 결과물은 '재사용 단위'로 쪼개라. 통짜 HTML보다 @dsCard 카드 단위로 나누니 claude.ai/design에서 컴포넌트별로 관리·증분 업데이트가 가능해졌습니다.

시행착오

  • npx designlang 마지막 단계에서 "Extraction failed" 오류가 떴는데, 알고 보니 툴 자체 버그로 마무리 단계 하나만 실패한 것이고 결과 파일 35개는 정상 생성돼 있었습니다. → 오류 메시지에 놀라기 전에 실제 산출물을 먼저 확인하는 습관.

  • 한글 사이트를 영어 휴리스틱으로 분석해 CTA 동사를 엉뚱하게 saas로 뽑는 등, 언어 불일치로 인한 오분류도 있었습니다.

도움이 필요한 부분

  • 지금은 Pretendard가 뷰어 PC에 설치돼 있어야 정확히 보이는데(없으면 시스템 폰트로 폴백), 웹폰트를 안전하게 임베드(self-host / data URI) 하는 실무 팁이 있으면 공유 부탁드립니다.

앞으로의 계획

  • 버튼·인풋·내비게이션 등 컴포넌트를 추가해 디자인 시스템을 확장하고, 실제 상세페이지 1개를 이 토큰만으로 처음부터 끝까지 만들어보려 합니다.


도움 받은 글 (옵션)

  • designlang (오픈소스 디자인 추출 도구) — npx designlang <URL>

  • DESIGN.md 컨벤션 / DTCG(Design Tokens) 표준 포맷

  • (여기에 참고한 지피터스 글이나 스티비 브랜드 페이지 링크를 추가하세요)


발표용이라 캡처 3장 자리를 본문에 표시해 뒀습니다. 필요하시면 이 사례글을 지피터스에 바로 붙일 수 있도록 이미지 없는 순수 텍스트 버전이나, 더 짧은 요약 버전으로도 정리해 드릴게요.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

유피테르 프로필 이미지
유피테르2026.07.29

자동 추출 결과를 그대로 사용하지 않고 아이콘 폰트 오인식, 본문 크기 오류, 색 대비 실패까지 7건의 노이즈를 직접 검증해 교정하신 과정이 특히 인상적이었습니다. 원색과 텍스트용 강화색을 분리해 접근성 기준을 실제 디자인 규칙으로 연결하고, 컴포넌트를 @dsCard 카드 단위로 나눠 11개 파일의 팀 자산으로 완성하신 점도 정말 실용적이네요.

김민철 프로필 이미지
김민철2026.07.22

실습 잘 따라와주셔서 감사합니다~ 다음주 사례 발표도 기대하겠습니다 ㅎㅎ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기