Communitygithub.com

Tosccony/design-dna-tool

디자인 프레스에서 인정받은 특정 분야의 레퍼런스 웹사이트를 조사하고, 4가지 렌즈 분석을 수행한 후 연구 노트로 저장합니다. 사용자가 참고 자료 없이 브리프만 가지고 있거나(또는 보강을 원할 때), `/research`를 호출할 때 사용하세요.

design-dna-tool란 무엇인가요?

이 스킬은 디자인 브레인스토밍 전에 '참고 자료가 없는' 상황을 해결하기 위해 설계되었습니다. 주어진 분야(예: 법률 회사, 프린트메이커, SaaS 랜딩 페이지 등)에 대해 Awwwards, FWA, Land-book과 같은 주요 디자인 프레스에서 인정받은 5개의 참고 웹사이트를 발견하고, 타이포그래피, 색상, 레이아웃, 모션의 4가지 렌즈를 통해 각 사이트를 분석합니다. 분석 결과는 교차 패턴으로 요약되고, 기존 프리셋 라이브러리와 연결되어 갭을 식별합니다. 최종 결과는 `docs/research/` 디렉토리에 마크다운 노트로 저장되어 향후 프로젝트에서 재사용 가능한 라이브러리 자산이 됩니다. 이 스킬은 주로 Claude Code 환경에서 WebSearch 및 WebFetch 도구를 사용하여 실행되며, `/new-mockup`의 브레인스토밍 단계에 직접 컨텍스트를 제공하거나 `/research` 명령어로 독립 실행할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Tosccony/design-dna-tool/tree/HEAD/.claude/skills/website-research

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

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

문서

웹사이트 조사

브레인스토밍 전 '참고 자료 없음'의 공백을 메우는 레시피입니다. 해당 분야의 디자인 프레스 참고 자료 5개를 가져와 /analyze와 동일한 네 가지 렌즈로 각각 분석하고, 교차 패턴을 도출하며, 프리셋 라이브러리로 연결하고, 전체 세션을 마크다운 노트로 저장하여 향후 프로젝트에서 활용할 수 있도록 합니다.

설계 근거는 docs/plans/2026-04-29-website-research-design.md에 있습니다. 이 스킬은 그 운영 레시피입니다.

사용 시기

  • /new-mockup의 1단계에서 사용자가 참조 지점이 없을 때(또는 도움을 요청할 때) 인라인으로 사용합니다.
  • /research <자유 형식 입력>을 통해 독립 실행형 인스피레이션 실행으로 사용합니다.
  • 사용자가 "[분야]에서 잘 되고 있는 것" 또는 "좋은 [유형] 사이트 예제를 알려줘"라고 물을 때 — /research라고 말하지 않아도 이 스킬이 적용됩니다.

다음의 경우에는 사용하지 마세요: 특정 사이트를 복제하는 경우(패턴을 추출할 뿐 자산은 추출하지 않음), 상업적 성공 조사(잘못된 신호 — 이유는 docs/plans/2026-04-29-website-research-design.md 참조), 또는 사용자가 이미 제공한 단일 참조를 분석하는 경우(/analyze 사용).

전제 조건

실행 전에 세 가지를 확인하세요:

  1. docs/research/ 디렉토리가 존재하는지 확인합니다. 존재해야 합니다 — 이 계획의 작업 1에서 생성합니다. 디렉토리가 없으면 즉시 mkdir -p docs/research/로 생성하고 계속 진행하세요. (멈추지 마세요 — 여기서는 자동 복구로 충분합니다.)
  2. 입력에 충분한 신호가 있는지 확인합니다. "SaaS"나 "e-커머스" 같은 단일 일반 단어는 너무 광범위합니다 — 아래 예외 케이스 #1을 참조하고, 실행 전에 구체화하도록 요청하세요.
  3. 도구 접근 권한을 확인합니다. WebSearch와 WebFetch를 사용할 수 있어야 합니다. 비활성화된 경우 다음 메시지와 함께 중단하세요: "웹 도구 호출이 비활성화되었습니다. /research는 후보를 발견하고 확인하기 위해 WebSearch와 WebFetch가 모두 필요합니다. 이를 활성화하거나 수동 참조 수집으로 대체하세요."

5단계 흐름

1. 입력 구문 분석

입력은 자유 형식입니다. 이를 읽고 다음을 추출하세요:

  • 분야(Vertical) — 비즈니스 또는 제품의 종류(로펌 / 프린트메이커 / SaaS 랜딩 / 머천다이징 / 에이전시 포트폴리오 / 에디토리얼 간행물 등).
  • 제약 조건(Constraints) — 후보 집합을 좁히는 형용사(모던 / 전통적 / 다크 / 라이트 / 프리미엄 / 플레이풀 / 미니멀리스트 / 조밀함 등).
  • 하드 제외 사항(Hard exclusions) — 사용자가 명시적으로 원하지 않는 것(예: "하지만 기업 스타일은 제외", "e-커머스 템플릿은 안 됨").

추출이 모호한 경우(예: 입력이 진정으로 "SaaS"뿐인 경우), 예외 케이스 #1을 적용하고 실행 전에 명확하게 질문을 하나 하세요.

사전 조회: 발견 전에 docs/research/*.md 파일을 나열하고 파일 이름과 첫 번째 줄 주제를 구문 분석된 분야와 일치시켜 확인하세요. 동일한 분야를 다루는 최근 노트가 있는 경우(빠르게 변화하는 SaaS 랜딩이나 AI 도구 같은 카테고리는 보통 3개월 미만, 로펌 같은 느린 카테고리는 6개월 미만 — 달력이 아닌 해당 분야의 디자인 프레스 캐논이 눈에 띄게 변했는지에 따라 기준), 이를 표면화하세요: "<filename> 파일을 <날짜>에 동일한 분야에서 찾았습니다. 재사용, 새로 실행, 또는 새 항목으로 보강하시겠습니까?" 재사용은 발견을 건너뜁니다. 새로 실행은 처음부터 시작합니다. 보강은 이전 노트의 후보를 시드로 사용하여 추가 사이트를 찾습니다.

2. 발견 (하이브리드)

두 가지 패스가 통합 후보 목록을 생성합니다.

패스 A — LLM 일반 지식. 훈련 데이터에서 5~10개의 사이트를 제안합니다. 다음 프롬프트 구조로 필터링하세요:

"[분야]에서 디자인 프레스의 모범 사례로 널리 인정받는 사이트(Awwwards, FWA, Land-book, Site Inspire, Brutalist Websites)를 나열하거나 실무자들이 참조하는 사이트를 나열하세요. [제약 조건]에 따라 필터링하세요. 이름 | URL | 인정받는 이유 한 줄 형식으로 출력하세요."

"정말 잘하는" 기준:

  • 1차: 디자인 프레스 인정(수상, 추천 배치) + 미적 장인정신(훌륭한 외관, 고려된 타이포그래피, 독창적인 레이아웃, 정교한 모션).
  • 2차: 실무자 평판(디자인 담론에서 참조됨).
  • 건너뜀: 상업적 성공 프록시(자금이 풍부한 브랜드는 평범한 사이트를 가질 수 있음 — 잘못된 신호).

디자인 프레스 인정 기준. 단일 Awwwards SOTD만으로는 충분하지 않습니다 — 너무 많은 사이트가 이를 받습니다. 다음 중 하나 이상을 요구하세요: (a) Awwwards/FWA/CSS Design Awards의 SOTM/SOTY, (b) Land-book / Site Inspire / Brutalist Websites / Page Collective의 에디터 픽, 또는 (c) 디자인 담론에서의 실무자 참조(Sidebar.io, Hover States, Frontend Focus 같은 디자인 뉴스레터에서 인용되거나 에이전시 사례 연구 / 디자이너 Twitter/Bluesky 스레드에서 참조됨). 자금과 상업적 성공은 상관관계가 있더라도 디자인 품질에 대해 아무것도 알려주지 않습니다.

패스 B — WebSearch 보완. 입력을 기반으로 1~2개의 쿼리를 구성합니다(예: "2025년 최고의 로펌 웹사이트 awwwards", "프리미엄 프린트메이커 웹사이트 인스피레이션"). 결과를 선별하세요: 디자인 간행물(Awwwards, FWA, Site Inspire, Land-book, Brutalist Websites, Sidebar.io, Typewolf, Page Collective), 에이전시 사례 연구 페이지, 실무자 게시물은 유지합니다. SEO 중심의 목록형 게시물("2025년 상위 10개 X 웹사이트"), 템플릿 마켓플레이스 갤러리(실제 사이트가 아닌 Wix/Squarespace/Webflow 쇼케이스 페이지의 템플릿), AI 요약 콘텐츠 팜은 제거합니다.

(명명된 출처가 404를 반환하거나 명백히 종료된 경우, 조용히 제거하고 다른 출처에 의존하세요 — 발견 출력의 일부로 죽은 출처 보고를 표면화하지 마세요.)

3~5개의 추가 후보를 가져옵니다.

중복 제거 + 확인. 두 목록을 결합합니다. 중복을 제거합니다. 각 남은 후보에 대해 WebFetch(단일 GET, 가벼운 접촉)를 실행하여 URL이 살아있는지 확인합니다. 죽은 URL은 버립니다. 확인된 목록을 기본적으로 5개 사이트로 제한합니다. 사용자는 스킬 프롬프트를 통해 재정의할 수 있습니다(--count 8 또는 자연어 "8개 사이트를 찾아줘").

3. 사이트별 분석

각 확인된 사이트에 대해 기존 /analyze 워크플로우를 인라인으로 실행합니다(슬래시 명령어를 호출하지 말고 — 네 가지 렌즈 패턴을 직접 적용하세요):

  • 타이포그래피: 서체 계열 특성, 두께 대비, 배율 비율, 자간.
  • 색상: 모드, 로직(hex 값이 아닌), 악센트가 자리를 잡은 이유.
  • 레이아웃: 히어로 패턴, 비대칭성, 밀도, 수직 리듬.
  • 모션: 이징 특성, 모션이 있는 위치, 밀도.

카테고리당 3~4개의 글머리 기호로 간결하고 구체적으로 작성하세요. 그런 다음 디자인 강점을 종합하는 "작동하는 이유" 문단을 하나 작성하세요.

"작동하는 이유"에서 금지된 표현: "모던하고 깔끔한", "굵은 타이포그래피", "우아한 디자인", "완벽한 균형", "놀라운 비주얼" — 이는 내용이 없는 표현입니다. 문단은 특정 트레이드오프나 명확하지 않은 선택을 언급해야 합니다(예: "응축된 디스플레이는 큰 역할을 하여 본문을 조용히 유지할 수 있게 하여 단일 두께의 본문에서도 계층을 잃지 않게 합니다").

윤리 알림: 패턴은 추출하되 자산은 추출하지 않습니다. 출력은 사이트를 그대로 복사하는 것을 절대 제안하지 않습니다 — 특정 레이아웃이나 이미지가 아닌 디자인 언어를 추출합니다.

4. 교차 패턴 집계

모든 사이트가 분석된 후, 세트 전체에서 공통적인 것을 요약하세요:

  • 타이포그래피: "5개 중 4개가 단일 서체 계열 시스템, 두께 기반 계층 구조를 사용합니다."
  • 색상: "5개 모두 다크 모드가 기본이며, 3개는 단색 + 하나의 악센트를 사용합니다."
  • 레이아웃: "비대칭 히어로가 지배적이며, 5개 중 4개는 6/6 분할을 피합니다."
  • 모션: "Expo-out 진입이 지배적이며, 5개 중 3개는 스크롤 기반 공개를 사용합니다."

프리셋 라이브러리로 연결: presets.ts를 읽고, 각 프리셋 카테고리에 대해 가장 가까운 기존 프리셋을 식별하고, 현재 프리셋이 다루지 않는 패턴에 대한 갭을 명시적으로 플래그 지정하세요. presets.ts에 이 스킬이 작성된 이후 새로운 프리셋 카테고리(예: 상호작용 프리미티브, 데이터 디스플레이 프리셋)가 추가된 경우, 이를 연결에 포함시키세요 — 네 가지 렌즈가 예측하지 못했다고 해서 건너뛰지 마세요. 잘못된 핏을 강제하는 것보다 갭을 플래그 지정하는 것이 낫습니다.

패턴이 약한 경우("5개 중 3개가 산세리프체 사용" — 웹의 95%에 해당, 쓸모없음), 명시적으로 말하세요. 일반적인 결과를 포장하지 마세요.

5. 연구 노트 저장

docs/research/<슬러그>-<YYYY-MM-DD>.md에 작성하세요. 여기서 슬러그는 케밥 케이스 키워드입니다. 경로가 이미 존재하는 경우(동일한 분야, 같은 날), -v2, -v3 등을 추가하여 경로가 비워질 때까지 반복하세요. 다음 구조를 그대로 사용하세요:

# 조사: <주제 / 분야>
**날짜:** YYYY-MM-DD · **브리프:** <사용자 입력 그대로>

## 분석된 후보
1. <사이트 이름> — <url> · <인정받는 이유 한 줄>
2. ...
(+ 이유와 함께 드롭된 모든 후보 목록)

## 사이트별 분석
### 1. <사이트 이름>
[네 가지 렌즈 분석: 카테고리당 3~4개의 글머리 기호]
**작동하는 이유:** <디자인 강점을 종합하는 1-2문장>

### 2. <사이트 이름>
...

## 교차 패턴
- **타이포그래피:** ...
- **색상:** ...
- **레이아웃:** ...
- **모션:** ...

## 프리셋 라이브러리 연결
- **가장 가까운 기존 프리셋:** ...
- **갭:** ... (또는 "없음 — 현재 프리셋이 패턴을 다룸")

## 권장 DNA 방향
<패턴과 갭을 고려하여 어떤 디자인 방향이 적합한지에 대한 2-3문장 — 최종 선택이 아닌 향후 DNA 제안의 시작점으로 표현하세요. 독립 실행형 /research 실행에는 브리프가 없을 수 있으므로 여기서 "브리프"라는 단어를 재사용하지 마세요.>

작성 후, 채팅에 짧은 요약을 게시하세요(전체 노트 아님 — 저장됨). /new-mockup에서 호출된 경우, 패턴 + 갭을 컨텍스트로 하여 브레인스토밍 단계로 핸드오프합니다. 독립 실행형인 경우 여기서 종료합니다.

예외 케이스

  1. 분야가 너무 광범위함. 입력이 하나 또는 두 개의 일반 명사("e-커머스", "SaaS")인 경우, 발견 전에 중단하고 구체화를 요청하세요: "e-커머스는 광범위합니다 — 브랜드 포지셔닝(프리미엄 / 플레이풀 / 실용적)과 제품 카테고리는 무엇인가요? 목록을 더 선명하게 만드는 데 도움이 됩니다." 사용자가 응답하면 다시 시작합니다.
  2. LLM이 제안한 모든 URL이 죽음. 훈련 데이터 컷오프로 인해 LLM이 제안한 URL의 약 10~20%가 이동되었거나 죽었을 수 있습니다. 확인 결과 목록이 3개 미만으로 떨어지면 WebSearch 전용 패스로 대체합니다. 그 후에도 3개 미만이면 갭을 인정하세요: "이 브리프에 대해 디자인 프레스 참조 5개를 안정적으로 찾을 수 없었습니다. 분석된 개의 후보가 있습니다. 이걸로 진행하시겠습니까, 아니면 직접 시작점이 있으신가요?"
  3. JS 렌더링 사이트. WebFetch는 렌더링되지 않은 HTML을 반환합니다. 최신 SPA는 빈 마크업(스크립트 태그 + 빈 <div id="root">)을 보여줄 수 있습니다. 이를 감지하고(의미 있는 콘텐츠가 추출되지 않음), 사이트를 "렌더링된 뷰 없이는 분석할 수 없습니다 — URL은 수동 검토를 위해 기록됨"으로 플래그 지정하고 나머지를 계속 진행합니다. 내용이 있는 것처럼 빈 DOM을 구문 분석하려고 시도하지 마세요.
  4. 패턴이 너무 일반적임. 추출된 패턴이 약할 때는 결과를 포장하지 말고 명시적으로 말하세요: "이 5개 사이트의 패턴은 대부분 일반적입니다. 분야가 너무 광범위하거나 이 틈새에 대한 디자인 프레스 캐논이 얇을 수 있습니다. 수동으로 추가 참조를 가져오거나 브리프를 구체화하는 것이 좋습니다."
  5. 보강 모드. 사용자가 1~2개의 참조를 가지고 있고 더 찾기 위해 조사가 필요한 경우("사이트 X가 있습니다, 비슷한 것을 더 찾아주세요"), 기존 URL을 시드 입력으로 받아들입니다. 후보 목록과 중복 제거합니다. 합집합에 대해 분석을 실행합니다. 기존 참조는 무시되지 않습니다.

범위 밖

이 스킬은 다음을 처리하지 않습니다:

  • 스크린샷 기반 멀티모달 분석. WebFetch는 HTML만으로 작동합니다. JS 렌더링 SPA는 이 스킬이 캡처하지 못하는 렌더링된 뷰가 필요할 수 있습니다.
  • 캐시된 세션 간 조사. 각 /research 실행은 새로 시작합니다.
  • 자동 태깅 / 아카이브 검색. 파일 이름 + grep이 검색 방법입니다.
  • 직접 갤러리 스크래핑(Awwwards, Land-book). 공개 API가 없으며, ToS에 민감합니다.
  • 상업적 성공 지표 또는 트래픽 데이터. 잘못된 신호 — 디자인 언어를 조사할 뿐 비즈니스 전략은 조사하지 않습니다.

성공 기준

/research 세션 후, 사용자는 5개의 확인된 디자인 프레스 수준 레퍼런스 사이트가 도구의 다른 모든 것과 동일한 렌즈로 분석되고, 패턴이 추출되며, 프리셋 라이브러리의 갭이 지목된 마크다운 노트를 저장합니다. 동일한 분야의 향후 프로젝트는 사전 조회를 통해 이 노트를 표면화하므로 조사 노력이 버려지지 않습니다.

관련 스킬