본문으로 건너뛰기
5분 AI.
REPO DEEP DIVE · 2026-07-29 · VOLTAGENT/AWESOME-CLAUDE-DESIGN · 브랜드 68개의 DESIGN.md를 모아 Claude Design에 바로 먹이는 어썸 리스트

awesome-claude-design 딥다이브
— "빈 화면" 대신 68개 브랜드 취향으로 시작하기

문서·목록

빠른 판단

무엇
브랜드별 색·타이포그래피·레이아웃을 설명하는 외부 DESIGN.md 링크를 모은 카탈로그
이럴 때
브랜드 스타일을 참고한 UI를 만들 때 에이전트에 전달할 디자인 지침 문서를 찾아 비교할 때
도입 전 확인
컴포넌트나 문서 원본을 포함한 라이브러리가 아니라 외부 링크 목록이다
awesome-claude-design은 코드 저장소가 아니라 링크 모음집(어썸 리스트)이다. Anthropic이 내놓은 새 디자인 워크스페이스 Claude Design(claude.ai/design)에 업로드하면 색상·타이포그래피·컴포넌트·프리뷰 카드·실제 동작하는 UI 킷까지 한 번에 뽑아주는 DESIGN.md라는 한 장짜리 문서가 있다. 이 저장소는 그런 DESIGN.md 68개를 Claude·Stripe·Nike·Tesla 같은 유명 브랜드별로 큐레이션해 링크만 정리해 둔 것이다.

저장소 자체에는 코드도, 빌드 스크립트도, CI도 없다. 실물 파일은 README.md 하나(+ LICENSE)뿐이며, 실제 DESIGN.md 원문은 이 레포 밖의 getdesign.md라는 사이트에 있고, 그것을 소비해 UI를 생성하는 엔진도 이 레포 밖의 Claude Design이다. 즉 이 저장소는 "설계도"가 아니라 설계도로 가는 안내 지도다.

(저장소 VoltAgent/awesome-claude-design · 라이선스 MIT(2026, VoltAgent) · 파일 구성 README.md + LICENSE, 딱 2개 · 링크 항목 68개(DESIGN.md count 배지 값과 실측 일치, 9개 카테고리) · 최신 커밋 8f746b5, 2026-06-20(Necati Özmen, "Update README.md") · 별점 미인용)
목차
  1. 프로젝트 한 줄 요약
  2. 왜 지금 뜨는가
  3. 무엇을 해결하는가
  4. 전체 구조 한눈에 보기
  5. 핵심 분류 체계 — 68개 DESIGN.md 완전 해부
  6. 기술 스택과 자동화 (사실은 "자동화가 없다")
  7. 설치 · 사용 요구사항
  8. 실제 사용 흐름 — DESIGN.md 한 장이 UI 킷이 되기까지
  9. 함정과 오해 바로잡기
  10. 대안 비교
  11. 정리 — 누가 쓰면 좋은가
  12. 직접 해볼 수 있는 실습 과제
  13. 관련 기술 심화 학습 로드맵
  14. 핵심 키워드 사전

1프로젝트 한 줄 요약

한 문장으로: "68개 브랜드의 '디자인 취향 설명서'를 링크로 모아놓은 목록 — 코드 없음, 실물은 전부 외부에"

awesome-claude-design은 "라이브러리"가 아니라 "카탈로그"다. Claude·Stripe·Nike·Tesla·Notion 등 68개 브랜드에 대해, 그 브랜드 느낌을 흉내 낸 DESIGN.md 문서로 연결되는 링크를 정리해 둔 README.md 하나가 저장소의 전부다. DESIGN.md는 색상 팔레트·타이포그래피 규칙·컴포넌트 스타일·레이아웃 원칙 등을 사람이 아니라 AI 에이전트가 읽고 바로 행동에 옮길 수 있는 형식으로 적어둔 한 장짜리 마크다운 파일이다.

이걸 Anthropic의 Claude Design(claude.ai/design)에 업로드하면, Claude가 그 문서를 읽고 CSS 변수·타입 스케일·버튼/카드/내비게이션 같은 컴포넌트·프리뷰 카드·실제로 동작하는 UI 킷을 한 번에 만들어낸다. 이 저장소가 하는 일은 딱 하나, "어떤 DESIGN.md부터 시작할지 고르기 쉽게 진열해 두는 것"이다.

한 줄 비유

백지 대신 "68벌의 기성복 도안"에서 고르는 옷 가게

새 프로젝트의 디자인을 처음부터 짜는 건 맨몸으로 재봉틀 앞에 앉는 것과 비슷하다. 무엇을 만들지, 어떤 색·어떤 질감을 쓸지 전부 결정해야 한다.

awesome-claude-design은 그 대신 이미 재단된 도안 68벌이 걸린 옷걸이다. "스트라이프의 미니멀함"(Stripe), "테라코타의 편집자적 느낌"(Claude) 같은 도안을 골라 재봉틀(Claude Design)에 넣으면, 내 몸(프로젝트)에 맞춰 바로 재단해 준다. 이 저장소 자체는 옷을 만들지 않는다 — 옷걸이일 뿐이다.

2왜 지금 뜨는가

Claude Design의 등장 · "에이전트가 읽는 스펙 파일" 유행 · 어썸 리스트 특유의 낮은 진입장벽

이 저장소가 주목받는 이유는 코드의 참신함이 아니라 타이밍에 있다. 세 가지로 정리된다.

① Claude Design이라는 신제품의 등장

README는 Claude Design을 "일회성 화면을 찍어내는 채팅창 대신, 프로젝트마다 지속되는 디자인 시스템(토큰·컴포넌트·프리뷰 자산)을 들고 있는 워크스페이스"로 소개한다. 새 제품이 나오면 그 제품에 무엇을 먹일지에 대한 "재료 모음"이 곧바로 가치를 가진다 — 이 저장소가 그 자리를 선점했다.

② "AGENTS.md 다음은 DESIGN.md"라는 흐름

README는 AGENTS.md(코딩 에이전트가 읽는, "어떻게 만들지")와 DESIGN.md(디자인 에이전트가 읽는, "어떻게 보일지")를 나란히 놓고 비교한다. "에이전트가 읽고 바로 행동할 수 있는 스펙 파일"을 프로젝트 루트에 두는 관행이 코딩을 넘어 디자인으로 번지는 흐름 한가운데 이 저장소가 있다. DESIGN.md 개념 자체는 Google Stitch가 먼저 제안했고, getdesign.md가 실제로 비교 가능한 컬렉션으로 구현했다고 README는 밝힌다.

③ 어썸 리스트 특유의 "만들기 쉽고 퍼지기 쉬움"

awesome.re 배지가 붙은 전형적인 Awesome List 포맷 — 마크다운 표와 불릿만으로 구성 — 이라 기여(새 브랜드 추가)와 확산(스타·포크·공유)의 장벽이 낮다. 게다가 배포사인 VoltAgent(AI 에이전트 프레임워크 회사)가 README 상단에 자사 제품 launchkit.getdesign.md 배너를 넣어 커뮤니티 자산이자 자사 마케팅 채널로 동시에 활용하고 있다.

누구를 위한 것인가
"디자이너 없이 그럴듯한 UI"가 필요한 사람들

1인 개발자, 사이드 프로젝트, MVP 데모처럼 전담 디자이너 없이도 "아무 브랜드나 베낀 듯한" 느낌을 피하면서 빠르게 그럴듯한 UI를 뽑아야 하는 상황에 정확히 맞춘 자료다.

3무엇을 해결하는가

"빈 디자인 브리프" 문제 · 일관성 없는 AI 생성 화면 문제 · 브랜드 PDF는 AI가 못 읽는다는 문제

README가 스스로 밝히는 문제의식은 "Skip the blank-page design brief"(빈 디자인 브리프를 건너뛰어라)다. 구체적으로 세 가지 실무 고통을 겨냥한다.

용어
DESIGN.md
브랜드의 시각 언어(색·타이포·컴포넌트·레이아웃 규칙과 그 이유)를 AI 에이전트가 바로 실행할 수 있는 형식으로 적은 한 장짜리 마크다운 파일. Google Stitch가 개념을 처음 제안했고, getdesign.md가 비교 가능한 컬렉션으로 만들었다.
용어
디자인 토큰 (design token)
"주요 버튼 색 = #7c3aed" 처럼, 디자인 결정을 이름 붙은 변수로 저장해 코드(CSS 변수 등)와 디자인 도구가 같은 값을 공유하게 하는 단위. Claude Design은 DESIGN.md를 읽어 이런 토큰들을 CSS로 뽑아낸다.

4전체 구조 한눈에 보기

저장소 안에는 파일이 2개뿐 — 진짜 작업은 두 개의 외부 서비스가 나눠서 한다

이 저장소를 직접 클론해 보면 README.md와 LICENSE, 딱 2개 파일뿐이다. src/도, package.json도, .github/workflows도 없다. 이 저장소가 "하는 일"은 정보 전달이 전부이고, 실제 파일 생성과 렌더링은 저장소 밖의 두 서비스가 나눠 맡는다.

┌───────────────────────────────────────────────────────────────┐ │ AWESOME-CLAUDE-DESIGN 이 저장소가 실제로 하는 일 │ └───────────────────────────────────────────────────────────────┘ [본 저장소] github.com/VoltAgent/awesome-claude-design README.md ───────────────────────────────────── · "Collection" 표 하나 — 9개 카테고리, 68개 브랜드 링크 · What is Claude Design? / What is DESIGN.md? / How it works · Tips for getting better output / License & disclaimer · 파일 실물은 없다. 전부 "다음 단계로 가는 링크"뿐 │ 클릭해서 이동 ▼ [외부 사이트 ①] getdesign.md/<brand>/design-md · 실제 DESIGN.md 원문이 저장돼 있는 곳(이 레포 밖) · 프리뷰 페이지에서 내용을 훑어보고 파일을 내려받음 │ Claude Design에 업로드 / 프로토타입 채팅에 첨부 ▼ [외부 제품 ②] claude.ai/design (Claude Design, Anthropic) · DESIGN.md를 읽어 색상·타입 스케일·컴포넌트·프리뷰·UI 킷을 생성 · 결과물은 프로젝트의 "Design System" 탭에 정리·보관

즉 구조를 한 문장으로 요약하면: "카탈로그(이 레포) → 원본 창고(getdesign.md) → 조립 공장(Claude Design)"의 3단 분업이다. 코드 저장소를 딥다이브할 때 흔히 기대하는 "아키텍처 다이어그램·모듈 의존성" 같은 것은 여기엔 없다 — 구조 자체가 "잘 정리된 목차"인 셈이다.

5핵심 분류 체계 — 68개 DESIGN.md 완전 해부

README.md의 ## Collection 절(103~197번째 줄) — 9개 카테고리 × 총 68개 브랜드

이 저장소의 진짜 핵심은 README.md 안의 ## Collection 절이다(파일 기준 101번째 줄부터 시작). 68개 브랜드가 "업종·성격" 축으로 9개 카테고리에 나뉘어 있고, 각 항목은 [**브랜드명**](getdesign.md/브랜드/design-md) - 한 줄 설명(용도 + 비주얼 톤) 형식의 마크다운 링크다. 실제로 세어 보면 카테고리별 개수는 다음과 같고, 합계는 상단 배지의 DESIGN.md count 68과 정확히 일치한다.

카테고리 (README 소제목)개수대표 항목 (일부)
AI & LLM Platforms12Claude, Cohere, ElevenLabs, Mistral AI, Ollama, xAI 등
Developer Tools & IDEs7Cursor, Raycast, Vercel, Warp, Superhuman 등
Backend, Database & DevOps8Supabase, MongoDB, Sentry, ClickHouse, HashiCorp 등
Productivity & SaaS7Linear, Notion, Cal.com, Zapier, Intercom 등
Design & Creative Tools6Figma, Framer, Miro, Webflow, Airtable, Clay
Fintech & Crypto7Stripe, Coinbase, Binance, Revolut, Wise, Mastercard, Kraken
E-commerce & Retail4Airbnb, Shopify, Nike, Meta
Media & Consumer Tech11Apple, Spotify, SpaceX, NVIDIA, Uber, WIRED, PlayStation 등
Automotive6Tesla, Ferrari, Lamborghini, BMW, Bugatti, Renault
합계68(README 상단 img.shields.io 배지 값과 실측 일치)

각 항목의 설명 한 줄은 "용도 + 비주얼 키워드" 조합으로 통일돼 있다. 예를 들어 [**Claude**](https://getdesign.md/claude/design-md) - Anthropic's AI assistant. Warm terracotta accent, clean editorial layout, [**Tesla**](https://getdesign.md/tesla/design-md) - Electric vehicles. Radical subtraction, cinematic full-viewport photography, Universal Sans처럼, 무엇을 하는 회사인지와 "어떤 느낌인지"를 함께 훑어보고 취향에 맞는 것을 고를 수 있게 해 둔 것이 이 분류의 목적이다.

링크가 가리키는 DESIGN.md 자체의 내부 스키마 (README 199~213번째 줄)

이 저장소 안에는 DESIGN.md 원문이 없지만, README는 "Claude가 DESIGN.md에서 무엇을 읽어가는지"를 9개 섹션 표로 문서화해 둔다. 즉 68개 링크가 가리키는 문서들은 전부 이 스키마를 따른다고 명시돼 있다(실물 검증은 getdesign.md 사이트에서만 가능하다).

#섹션Claude가 읽어가는 목적
1Visual Theme & Atmosphere전체 톤·밀도·분위기 설정
2Color Palette & Roles의미 있는 이름 + 헥스값을 가진 CSS 변수 출력
3Typography Rules타입 스케일 구성 + 구글 폰트 대체재 선정
4Component Stylings버튼·인풋·카드·내비게이션과 상태(hover 등) 생성
5Layout Principles여백 스케일·그리드·레이아웃 리듬
6Depth & Elevation그림자 토큰과 표면 위계
7Do's and Don'ts새 화면을 생성할 때 지켜야 할 가드레일
8Responsive Behavior브레이크포인트·터치 타깃·접힘 동작
9Agent Prompt Guide생성된 SKILL.md에 심어둘 재사용 프롬프트
읽을 때 주의
"분류 체계"의 실체는 README 안의 표 두 개뿐이다

일반적인 코드 저장소라면 이 섹션에서 실제 소스 파일 경로·스키마 정의 코드를 인용하겠지만, 이 저장소는 README.md 자체가 유일한 데이터다. 위에서 인용한 두 표(Collection 목록, 9개 섹션 스펙)가 이 저장소가 가진 "분류 체계"의 전부이며, 더 깊은 스키마(실제 DESIGN.md 파일 안의 정확한 마크다운 구조)는 getdesign.md 사이트에 가야만 확인할 수 있다.

6기술 스택과 자동화 (사실은 "자동화가 없다")

빌드도, CI도, 생성 스크립트도 없다 — 진짜 엔진은 전부 레포 밖에 있다

코드 저장소 딥다이브의 관례를 따르자면 이 섹션에서 프레임워크·빌드 도구·CI 파이프라인을 나열해야 하지만, 이 저장소에는 그런 것이 전혀 없다. find로 훑어봐도 .github/workflows, package.json, 스크립트 폴더가 존재하지 않는다. "기술 스택"이라 부를 만한 것은 사실상 마크다운 + Shields.io 배지 + awesome.re 배지가 전부다.

구성 요소실체
이 저장소README.md(마크다운) + LICENSE(MIT 텍스트). 코드·빌드·테스트 없음
배지awesome.re(어썸 리스트 인증) · img.shields.io(DESIGN.md count, Last update) · Discord 초대 배지 — 전부 정적 이미지/외부 API 링크일 뿐, 저장소 안에서 자동 계산되지 않음
실제 파일 저장·서빙getdesign.md (VoltAgent 계열 사이트) — 68개 DESIGN.md 원문과 프리뷰 페이지를 호스팅
실제 "생성 엔진"Claude Design(claude.ai/design, Anthropic) — DESIGN.md를 입력받아 LLM으로 색상·컴포넌트·UI 킷을 스캐폴딩
연계 상업 제품launchkit.getdesign.md — README 상단에 배너로 소개된 VoltAgent의 별도 제품(스타터킷 판매 성격)
중요한 경계
"DESIGN.md count 68" 배지는 자동 집계가 아니다

일반적인 CI 배지(테스트 커버리지 등)는 빌드 때마다 자동 갱신되지만, 이 배지는 img.shields.io의 정적 텍스트 배지(DESIGN.md%20count-68-10b981)로 사람이 README를 고칠 때 수동으로 숫자를 맞춰 넣는 방식이다. 실제로 이번 분석에서 README의 링크 항목을 직접 세어 68개임을 확인했고 배지 값과 일치했지만, 이는 "자동 검증 파이프라인이 있어서"가 아니라 "관리자가 잘 맞춰뒀기 때문"이라는 점을 구분해야 한다.

7설치 · 사용 요구사항

저장소 자체는 "설치"가 필요 없다 — 필요한 건 Claude Design 접근 권한뿐
항목요구사항
이 저장소를 보는 것브라우저만 있으면 충분. 클론해도 얻는 건 README.md·LICENSE 텍스트뿐, 실행할 것이 없음
DESIGN.md 원문 받기getdesign.md/<brand>/design-md 프리뷰 페이지 방문 → 내용 확인 → 파일 다운로드
실제 스캐폴딩 실행claude.ai/design 계정 필요(Claude Design은 별도 워크스페이스이며 일반 claude.ai 채팅과는 다른 화면·플랜 제약이 있을 수 있음)
업로드 방법 Aclaude.ai/design/#org → Create new design system → "Set up your design system" 화면의 Add assets에 DESIGN.md 업로드
업로드 방법 B대시보드에서 새 프로토타입 생성 → 채팅에 DESIGN.md 첨부 → "Create a design system from this DESIGN.md" 라고 입력
결과물을 활용하려면일반적인 웹 개발 환경(HTML/CSS, 정적 서버 등) — 산출물이 colors_and_type.css·index.html 등 표준 웹 자산이므로 특별한 런타임은 필요 없음
진입장벽이 낮은 이유
서버도, 의존성 설치도 없다

일반적인 오픈소스 프로젝트처럼 npm install이나 환경변수 설정이 필요 없다. 이 자료를 쓰는 데 필요한 건 "브라우저 + Claude Design 접근 권한"뿐이라는 점이 어썸 리스트로서의 진짜 강점이다.

8실제 사용 흐름 — DESIGN.md 한 장이 UI 킷이 되기까지

README의 "How it works" 절을 그대로 따라가는 4단계
단계 1

Collection 표에서 취향에 맞는 브랜드 고르기

예를 들어 "핀테크인데 차분한 느낌"을 원한다면 Fintech & Crypto 카테고리의 Wise("밝은 초록 악센트, 친근하고 명확")나 Stripe("시그니처 보라 그라디언트")를 고른다. 68개 한 줄 설명이 곧 "미리보기 없는 미리보기" 역할을 한다.

단계 2

getdesign.md 프리뷰 페이지에서 DESIGN.md 내려받기

링크를 클릭하면 getdesign.md/<brand>/design-md로 이동해 실제 문서 내용을 미리 훑어본 뒤 파일을 다운로드한다.

단계 3

Claude Design에 두 가지 방식 중 하나로 먹이기

방법 A(시스템부터 시작): claude.ai/design/#org에서 새 디자인 시스템을 만들고 "Set up your design system" 화면의 Add assets에 업로드한다. 방법 B(프로토타입부터 시작): 새 프로토타입 채팅에 파일을 첨부하고 "Create a design system from this DESIGN.md"라고 요청한다.

단계 4

몇 분 안에 완성되는 스타터 패키지 확인

README에 따르면 결과물은 README.md(브랜드 맥락·톤·비주얼 기반), colors_and_type.css(CSS 변수·타입 스케일·유틸리티 클래스), 대체 구글 폰트, preview/ 카드(색상·타이포·간격·컴포넌트·브랜드), 실제 동작하는 UI 킷(index.html+컴포넌트), 그리고 다음 프로젝트에도 재사용할 수 있는 SKILL.md로 구성된다.

비유

이 흐름은 "도안 고르기 → 원단 받기 → 재봉 맡기기 → 완제품 + 패턴지(SKILL.md) 함께 받기"와 같다. 특히 SKILL.md를 따로 저장해 두면, 다음 프로젝트에서 파일을 다시 올릴 필요 없이 같은 "패턴지"로 같은 느낌을 재소환할 수 있다는 것이 README의 팁이다.

README의 "Tips for getting better output" 절은 실사용 시 네 가지를 조언한다: 새 프로젝트는 깨끗한 상태에서 시작할 것(브랜드를 섞으면 토큰이 흐려짐), 시스템이 잡힌 뒤에도 계속 화면을 요청할 것("이제 가격 페이지 만들어줘" 등은 자동으로 브랜드 톤을 유지함), 라이트/다크·컴팩트/컴포터블 등 변형(variant)을 요청할 것, 그리고 SKILL.md를 자신의 스킬 폴더에 저장해 재사용할 것.

9함정과 오해 바로잡기

"이 레포를 클론하면 파일이 나온다"는 생각이 가장 흔한 함정
함정 ①
이 저장소를 클론해도 DESIGN.md 실물은 하나도 없다

68개 항목 전부가 getdesign.md로 나가는 외부 링크다. 저장소 자체에는 .md 디자인 파일이 존재하지 않으므로, "레포를 다운받아 바로 쓴다"는 접근은 통하지 않는다. 반드시 각 링크를 클릭해 외부 사이트에서 내려받아야 한다.

함정 ②
"공식 디자인 시스템"이 아니다 — 상표권 주의

README의 License & disclaimer 절(224~230번째 줄)은 명확히 밝힌다: DESIGN.md 파일들은 "공개적으로 관찰 가능한 디자인 패턴에서 영감을 받은 큐레이션된 출발점"일 뿐, 언급된 회사들의 공식 디자인 시스템이 아니며 그 회사들의 승인·후원을 받지 않았다. 상표·로고·독점 서체는 각 회사 소유이며, 실제 서비스에 쓰기 전에는 상표·저작권·브랜드 사용 정책을 직접 확인해야 한다고 명시돼 있다. 저장소(README+LICENSE) 자체만 MIT이지, 브랜드 아이덴티티 자체가 MIT로 풀린 게 아니다.

함정 ③
Claude Design ≠ 일반 claude.ai 채팅 / Claude Code

이 자료를 쓰려면 claude.ai/design이라는 별도 워크스페이스에 접근할 수 있어야 한다. 일반 Claude 대화창이나 Claude Code(터미널 에이전트)와는 다른 제품이므로, 접근 가능 여부·플랜 제약을 먼저 확인해야 헛수고를 피할 수 있다.

함정 ④
"68개"라는 숫자는 자동 검증되지 않는다

배지 값과 실제 항목 수가 이번 분석 시점(커밋 8f746b5)에는 일치했지만, 이는 자동 CI가 아니라 사람이 README를 고칠 때마다 배지 텍스트를 함께 수정하는 수동 방식이다. 새 브랜드가 PR로 추가된 후 배지 갱신이 누락되면 숫자가 어긋날 수 있으니, 정확한 개수가 중요하다면 항상 ## Collection 절을 직접 세어 확인하는 것이 안전하다.

10대안 비교

Figma 커뮤니티 템플릿 · shadcn 테마 프리셋 · 브랜드 가이드 PDF와 무엇이 다른가
대안특징DESIGN.md(이 저장소)와 차이
Figma 커뮤니티 UI 킷시각적 캔버스, 컴포넌트를 눈으로 보고 복제Figma 사용법을 알아야 하고 사람이 직접 수작업 복제. DESIGN.md는 텍스트라 에이전트가 곧바로 파싱·실행
shadcn/ui 테마 프리셋(예: 커뮤니티 테마 생성기)컴포넌트 코드와 색상 프리셋을 즉시 제공버튼·카드 같은 "부품"은 주지만 브랜드 보이스·레이아웃 철학·Do's and Don'ts 같은 맥락(rationale)은 빠져 있는 경우가 많음
브랜드 가이드 PDF사람을 위한 톤·무드 설명("친근하면서도 프리미엄하게")README가 직접 지적하듯 에이전트가 다음 결정을 내리기엔 너무 느슨함 — 구체적 토큰이 없음
Google Stitch (DESIGN.md 개념의 원조)DESIGN.md 개념을 최초로 제안getdesign.md/이 저장소는 그 개념을 브랜드별로 비교 가능한 컬렉션으로 구체화하고, Claude Design 소비에 맞춰 큐레이션했다는 점이 다름
처음부터 직접 DESIGN.md 작성내 브랜드에 완전히 맞는 문서를 새로 씀가장 정확하지만 시간이 걸림 — 이 저장소는 "비슷한 느낌에서 출발해 다듬는" 지름길을 제공
이 저장소가 잘하는 것
"탐색 비용"을 극단적으로 낮춘 진열장

68개를 업종·톤별로 미리 분류해 한 줄 설명까지 붙여 뒀기 때문에, "어떤 느낌을 원하는지도 아직 모르겠다"는 단계에서 둘러보며 감을 잡기에 가장 적합하다. 다른 대안들은 "이미 뭘 원하는지 안다"는 전제가 강한 편이다.

11정리 — 누가 쓰면 좋은가

디자이너 없는 1인·소규모 팀의 "첫 화면" 문제를 빠르게 넘기고 싶은 사람

awesome-claude-design은 "코드를 배우는 저장소"가 아니라 "의사결정을 빠르게 하도록 도와주는 진열장"이다. 딥다이브하며 확인한 핵심은 세 가지다: ① 저장소 실물은 README.md·LICENSE 두 파일뿐이고 자동화·CI가 전혀 없다, ② 68개 링크는 전부 getdesign.md(원본)와 Claude Design(생성 엔진)이라는 외부 서비스로 이어지는 안내판이다, ③ 실사용에는 Claude Design 접근 권한과, 결과물을 실제 서비스에 쓸 때의 상표권 주의가 반드시 필요하다.

12직접 해볼 수 있는 실습 과제

파일의 경계 확인부터 목록 검증과 디자인 명세 작성까지, 로컬 자료로 진행하는 네 가지 과제

아래 명령은 이미 클론한 awesome-claude-design의 루트에서 실행한다. 검색에는 rg, 목록 집계에는 Python 3를 사용한다. 모든 명령은 로컬 파일을 읽고 결과를 터미널에 표시하며, 비교표와 명세 초안은 실습 답안으로 정리한다.

과제 1

저장소와 외부 서비스의 역할 나누기 입문

목표: 클론으로 얻는 자료와 README가 소개하는 외부 파일·생성물을 구별한다.

  1. 다음 명령으로 커밋에 포함된 파일, README의 큰 제목, 라이선스 본문을 확인한다.
git ls-tree -r --name-only HEAD
rg -n '^## ' README.md
cat LICENSE
  1. README.md의 How it works를 읽고, 목록에서 고르기 → 외부 원문 받기 → Claude Design에 전달하기를 순서대로 적는다. 링크는 열지 않는다.
  2. README.md와 LICENSE는 로컬 자료로, DESIGN.md는 외부에서 받는 입력으로, colors_and_type.css·preview/·SKILL.md는 README가 설명하는 생성물로 분류한다.

완료 기준: 각 파일이 어디에서 생기는지 설명한 역할표를 만든다. 특히 생성물의 README.md와 이 저장소의 README.md는 이름이 같아도 역할이 다르다는 점을 짚는다.

과제 2

한 줄 설명으로 디자인 후보 비교하기 입문에서 중급

목표: 브랜드의 유명세 대신, 만들 화면에 필요한 분위기와 읽기 경험을 근거로 출발점을 고른다.

  1. 가상의 독서 기록 앱을 대상으로 정하고, 긴 설명을 편하게 읽기·주요 행동을 쉽게 찾기처럼 필요한 조건을 먼저 적는다.
  2. 다음 명령으로 Collection에 있는 Claude·Ollama·Stripe의 설명을 찾는다.
rg -n '^- \[\*\*(Claude|Ollama|Stripe)\*\*\]' README.md
  1. 후보마다 설명에 적힌 색감·화면 분위기·용도를 옮겨 적고, 앱에 맞는 이유와 맞지 않는 이유를 비교한다.
  2. README에 직접 적힌 내용과 자신의 해석을 구분한다. 정확한 색상값이나 간격처럼 이 한 줄만으로 알 수 없는 정보는 확인 필요로 표시한다.

완료 기준: 후보 세 개의 비교표와 최종 선택 이유를 작성한다. 선택 이유에는 README에서 찾은 근거가 있어야 하며, 확인하지 않은 원문 토큰을 실제 값처럼 적지 않는다.

과제 3

목록과 배지를 로컬에서 교차 검증하기 중급

목표: 마크다운 목록을 읽어 카테고리별 항목 수, 중복 주소, 개수 배지의 일치 여부를 직접 확인한다.

  1. README.md의 Collection에서 카테고리는 세 단계 제목, 브랜드는 굵은 이름을 가진 링크 목록으로 표현된다는 점을 확인한다.
  2. 아래 코드를 실행한다. 저장소에 들어 있는 스크립트가 아니라, 이번 실습에서 파일 저장 없이 실행하는 집계 코드다.
python3 -B -c '
from collections import Counter
from pathlib import Path
import re

text = Path("README.md").read_text(encoding="utf-8")
collection = text.split("## Collection", 1)[1].split("\n## ", 1)[0]
groups = Counter()
urls = []
category = None
for line in collection.splitlines():
    if line.startswith("### "):
        category = line[4:].strip()
    match = re.fullmatch(r"- \[\*\*(.+?)\*\*\]\(([^)]+)\) - (.+)", line)
    if match and category is not None:
        groups[category] += 1
        urls.append(match[2])
for category, count in groups.items():
    print(category, count)
badge = re.search(r"DESIGN\.md%20count-(\d+)-", text)
print("목록 항목:", len(urls))
print("중복 주소:", len(urls) - len(set(urls)))
print("배지 일치:", badge is not None and int(badge[1]) == len(urls))
'
  1. 카테고리별 출력의 합을 전체 항목 수와 비교하고, 개수 배지에 적힌 수와도 맞는지 확인한다. 전체 파일 대신 Collection만 집계하는 이유도 설명한다.
  2. 중복 판정은 주소 문자열이 같은 경우만 잡는다는 점을 적는다. 링크 대상의 응답이나 실제 문서 내용은 이 코드의 검사 범위에 포함되지 않는다.

완료 기준: 카테고리별 집계표와 검증 결과를 얻는다. 현재 자료에서는 중복 주소가 0, 배지 일치가 True인지 확인하고, 목록 형식이 바뀌면 정규 표현식도 다시 확인해야 한다는 한계를 설명한다.

과제 4

분위기를 검토 가능한 디자인 명세로 바꾸기 심화

목표: 선택한 분위기를 색상·문자·컴포넌트·화면 규칙으로 풀고, 결과물을 어떻게 확인할지까지 설계한다.

  1. 아래 명령으로 README가 설명하는 문서의 구성과 변형·재사용 원칙을 읽는다.
sed -n '/^## What Claude produces from a DESIGN.md/,/^## Tips for getting better output/p' README.md
sed -n '/^## Tips for getting better output/,/^## License/p' README.md
  1. 과제 2의 앱을 대상으로 README의 아홉 구성 항목에 대응하는 명세 초안을 답안에 작성한다. 각 항목에는 결정한 규칙과 그 이유를 함께 적는다. 원문이 없는 부분은 학습자가 정한 연습 규칙임을 밝힌다.
  2. 버튼·입력란·카드에 필요한 상태와 좁은 화면에서의 배치 원칙을 적는다. 이어 밝은 화면과 어두운 화면에서 바꿀 색상 역할, 그대로 유지할 규칙을 구분한다.
  3. README가 설명하는 생성물의 검토 기준을 만든다. colors_and_type.css는 역할에 맞는 변수와 글자 크기 단계, index.html은 컴포넌트 상태와 화면 배치, SKILL.md는 다음 작업에 전달할 규칙을 확인하는 식이다.

완료 기준: 아홉 항목을 빠짐없이 다룬 명세 초안과 생성물별 확인표를 작성한다. 실제로 파일을 생성하거나 Claude Design을 실행했다는 전제 없이도, 다른 사람이 무엇을 만들고 무엇을 확인해야 할지 이해할 수 있어야 한다.

13관련 기술 심화 학습 로드맵

마크다운 목록 읽기에서 디자인 시스템의 규칙과 재사용 계획까지 이어지는 6주 과정

이 저장소의 학습 재료는 README.md와 LICENSE다. 외부 파일을 받거나 생성 서비스를 실행하지 않아도, 정보 분류·문서 검증·디자인 명세 작성으로 학습 범위를 넓힐 수 있다. 아래 결과물은 각 주차의 실습 답안이며, 읽을 절 이름은 README의 제목을 기준으로 한다.

주차와 배울 개념이 레포에서 읽을 자료주차별 결과물
1주차 · 마크다운과 자료의 경계 README.md 전체 구조와 How it works, LICENSE. 제목·목록·링크가 안내 문서를 만드는 방식을 읽는다. 커밋의 파일 목록과 역할표. 로컬 문서, 외부 입력, 외부 생성물을 구별한다.
2주차 · 분류와 디자인 브리프 README.md의 Collection. 업종별 분류와 한 줄 설명에서 선택 기준을 찾는다. 가상 앱의 요구 조건과 후보 비교표. 설명에 있는 근거와 자신의 해석을 나눠 적는다.
3주차 · 텍스트 파싱과 품질 검사 README.md의 Collection 및 상단 개수 배지. 제목과 링크 목록의 형식을 분석한다. 카테고리별 집계, 중복 주소, 배지 비교 결과. 로컬 목록 검사로 알 수 없는 사항도 기록한다.
4주차 · 토큰과 규칙의 이유 README.md의 What is DESIGN.md?, What Claude produces from a DESIGN.md. 색상 역할·글자 크기 단계·간격 규칙을 연결한다. 아홉 항목의 명세 초안. 각 결정에 용도와 이유를 붙이고, 직접 정한 연습 규칙을 표시한다.
5주차 · 상태와 반응형 설계 README.md의 문서 구성 표와 Tips for getting better output. 컴포넌트 상태·화면 폭·밝기 변형을 함께 생각한다. 버튼·입력란·카드의 상태표와 좁은 화면·넓은 화면의 배치 규칙. 변형에서도 유지할 공통 규칙을 적는다.
6주차 · 검토와 재사용 README.md의 How it works, Tips for getting better output, License & disclaimer와 LICENSE. 생성물별 확인표와 SKILL.md로 전달할 규칙 목록. 저장소의 라이선스와 브랜드 관련 고지를 구분해 요약한다.

마지막에는 후보를 고른 이유, 명세의 규칙, 생성물의 확인 기준을 서로 대조한다. 예를 들어 읽기 편한 화면이 목표였다면, 그 목표가 글자 크기 단계·줄 간격·화면 배치 규칙과 검토 항목으로 이어지는지 설명할 수 있어야 한다.

14핵심 키워드 사전

목록을 읽고 디자인 명세와 생성물의 역할을 이해하는 데 필요한 열네 가지 용어
어썸 리스트
도서관의 추천 목록처럼, 유용한 자료로 가는 링크를 주제별로 모은 문서다. 이 레포에서는 README.md의 Collection이 그 역할을 하며, 링크 대상의 디자인 문서 자체를 보관하지는 않는다.
마크다운
제목·목록·링크 같은 구조를 간단한 문자 기호로 적는 문서 형식이다. 이 레포의 README.md는 제목으로 카테고리를 나누고 링크 목록으로 브랜드를 안내한다.
DESIGN.md
화면의 색·글자·배치 규칙과 그 이유를 에이전트가 활용하도록 적는 마크다운 문서다. 이 레포에서는 실제 파일 대신 해당 문서를 받을 수 있는 외부 경로와 활용 방법을 소개한다.
디자인 시스템
여러 화면이 같은 제품처럼 보이도록 색상·글자·부품·사용 규칙을 함께 정한 공통 기준이다. README는 Claude Design이 이 기준을 프로젝트에 유지하며 새 화면을 만드는 작업 공간이라고 설명한다.
디자인 토큰
색상이나 간격 같은 디자인 결정에 이름을 붙여 재사용하는 작은 단위다. README는 DESIGN.md의 결정을 바탕으로 색상 변수와 글자 크기 단계 등을 생성한다고 설명한다.
CSS 사용자 정의 속성
CSS에서 이름 붙인 값을 저장하고 여러 스타일에서 다시 쓰는 변수다. README가 소개하는 colors_and_type.css에는 이런 변수와 글자 크기 단계, 반복해서 쓸 스타일 규칙이 담긴다.
글자 크기 단계
제목·본문·보조 설명의 크기를 일정한 단계로 정해 읽는 순서를 드러내는 규칙이다. README의 Typography Rules는 이 단계와 대체 글꼴을 정하는 입력으로 설명된다.
컴포넌트 상태
버튼이나 입력란이 기본 상태, 포인터를 올린 상태 등에서 어떻게 달라지는지를 뜻한다. README의 Component Stylings는 부품의 모양뿐 아니라 이런 상태까지 생성하기 위한 항목이다.
반응형 동작
화면 폭이 달라질 때 배치나 접힘 방식, 누를 영역을 어떻게 바꿀지 정하는 규칙이다. README의 Responsive Behavior가 이를 다루며, 구체적인 기준값은 이 목록만으로 알 수 없다.
규칙의 이유
어떤 값을 쓰는지만 적지 않고 왜 그 결정을 했는지 함께 설명하는 근거다. README는 토큰·규칙·이유를 같은 문서에 두면 문서에 없는 새 상황에서도 에이전트가 일관된 판단을 하는 데 도움이 된다고 설명한다.
가드레일
도로의 난간처럼 작업이 정한 방향을 벗어나지 않도록 두는 허용·금지 규칙이다. README의 Do's and Don'ts는 새 화면을 만들 때 지킬 기준을 전달하는 항목이다.
스캐폴딩
완성할 화면에 필요한 기본 파일과 부품의 뼈대를 먼저 만드는 작업이다. 이 레포의 README는 그 일을 Claude Design이 맡는다고 설명하며, 저장소 안에 생성 스크립트를 제공하지는 않는다.
변형
같은 기본 규칙을 유지하면서 밝은 화면과 어두운 화면, 조밀한 배치와 여유로운 배치처럼 쓰임을 달리한 형태다. README의 사용 팁에서는 기본 토큰을 출발점으로 이런 변형을 요청하도록 안내한다.
SKILL.md
다음 작업에서도 같은 디자인 방향을 전달하도록 규칙과 요청 방식을 담아 재사용하는 파일이다. README는 이를 Claude Design의 생성물로 소개하며, 이 레포 안에 이미 들어 있는 스킬 파일을 뜻하지는 않는다.