URL의 DESIGN.md
입력: URL. 선택적 두 번째 인수: 출력 경로 (기본값 ./DESIGN.md).
Playwright MCP (mcp__plugin_playwright_playwright__*)를 사용합니다. 먼저 하나의 ToolSearch 호출로 브라우저 도구를 로드하세요.
스크립트 실행하기
extract.js, motion.js 및 stack.js는 이 파일과 같은 위치에 있습니다. 실행하려면: 스크립트를 읽고, 선행 주석 줄을 제거하고, 나머지 화살표 함수를 browser_evaluate의 function 인수로 전달하세요. 모두 JSON을 반환합니다. stack.js는 비동기(스크립트를 가져옴)이며, browser_evaluate가 이를 지원합니다.
흐름
-
열기. URL로
browser_navigate를 수행합니다.browser_resize를 1440x900으로 설정합니다. 쿠키 배너가 콘텐츠를 가리면 수락/닫기 버튼을 클릭합니다. 캡차나 "차단됨" 페이지가 보이면 중단합니다. 사용자에게 알리고 아무것도 작성하지 마십시오. -
인트로 애니메이션 대기. 3초 기다린 후 스크린샷을 찍습니다. 히어로가 비어 있거나, 흐릿하거나, 반쯤 희미해 보이면 여전히 나타나는 중입니다: 2초 더 기다렸다가 다시 찍습니다. 모션 및 상호작용을 위해 나타나는 방식(블러-인, 페이드-업, 스태거)을 기록합니다. 애니메이션 중에 읽은 값은 잘못되므로 히어로가 완전히 보일 때까지 아무것도 실행하지 마십시오. 토큰.
extract.js를 실행합니다. 결과를 유지합니다. -
살펴보기. 데스크톱 너비에서 스크린샷을 찍습니다:
- 페이지 상단
- 중간:
browser_evaluate() => scrollTo(0, document.body.scrollHeight / 2), 800ms 대기 - 하단:
scrollHeight로 동일하게, 800ms 대기
스크롤할 때 움직이거나, 페이드되거나, 나타나는 것을 기록합니다.
-
모션. 스크롤 후 지금
motion.js를 실행하여 지연된 3D 캔버스가 이미 존재하도록 합니다. 스택. 먼저 전체 페이지를 스크롤하여(약 900px 간격, 150ms 간격; 단일 화면 사이트의 경우 휠 이벤트 사용) 지연 청크가 로드되도록 한 다음stack.js를 실행합니다. 이는 페이지 전역, DOM, 로드된 리소스, CSS 및 로드된 모든 스크립트(인라인 및 지연 청크)의 텍스트를 확인하고 다음을 반환합니다:stack: 범주별 라이브러리, 각각 증거 포함: 프레임워크/플랫폼 (Next, Nuxt, Astro, SvelteKit, Gatsby, Remix, React, Vue, Angular, Svelte, Framer, Webflow, Wix, Squarespace, Shopify, WordPress, Lovable), ui-킷/아이콘 (Tailwind, Radix/shadcn, Headless UI, MUI, Chakra, Mantine, Ant, Bootstrap, Sonner, Lucide, Font Awesome, Phosphor), 3d (Three.js, React Three Fiber, drei, postprocessing, OGL, Babylon, PlayCanvas, A-Frame, regl, twgl, curtains.js, Spline, model-viewer, COBE, Unicorn Studio, Vanta, raw WebGL), 2d (PixiJS, p5, Paper, Konva, tsParticles, Rive, Lottie), 애니메이션 (GSAP + Flip/Draggable/MorphSVG/DrawSVG/MotionPath/CustomEase, Framer Motion, anime.js, React Spring, Velocity, Popmotion, AutoAnimate, Theatre.js), 스크롤 (ScrollTrigger, ScrollSmoother, Observer, Lenis, Locomotive, smooth-scrollbar, AOS, ScrollReveal, Rellax, CSS scroll-driven), 텍스트 (SplitText, SplitType, Splitting, Typed, ScrambleText), 슬라이더 (Swiper, Splide, Embla, Keen, Glide, Flickity, Slick), 페이지 전환 (Barba, Swup, Taxi, Highway, View Transitions), 오디오 (Howler, Tone), 물리 (Matter, cannon-es, Rapier).note: WebGL이 일반 3D 엔진 없이 실행될 때 설정되며, 이는 수작업 WebGL을 의미합니다.components: 아코디언, 탭, 대화상자, 메뉴, 툴팁, 캐러셀, 마키, 양식, 비디오, iframe, 애니메이션 SVG, 사용자 정의 커서, 프리로더 및 테마 전환의 개수입니다.shaders(GLSL 소스),scrollTriggers(trigger/start/end/scrub/pin),tweens(GSAP to/from with ease, duration, stagger),motionProps(Framer Motion initial/animate/whileInView),threeObjects(사용된 지오메트리, 재질, 로더, 패스),assets(모델, HDR, Rive, Spline, Lottie, 비디오, 오디오) 및scripts.failed.
사용 방법:
- 전역, DOM 및 리소스의 증거를 가장 신뢰하십시오. 프레임워크 런타임 파일(예: React 또는 Next 내부) 내에서만 발견된 일치는 주의해서 처리하고 스크린샷이 보여주는 것과 확인하십시오.
- 셰이더를 읽고 일반 언어로 그 기능(휨, 플레어, 플러터, 둥근 모서리 SDF, 노이즈, 입자, 지구본)을 설명하십시오. 엔진, 최대 한두 줄의 핵심 GLSL 및 스크롤 연결을 3D & 미디어 및 스크롤 동작에 넣으십시오. 전체 셰이더를 DESIGN.md에 복사하지 마십시오.
tweens및scrollTriggers를 구체적인 모션 사양으로 변환하십시오(예: "헤드라인이 문자로 분할되어 blur(7px)에서 올라오며, 0.7초, stagger 0.017초, power2.out, 상단이 뷰포트의 70%에 도달할 때").scripts.failed가 높으면 교차 출처 스크립트가fetch를 차단한 것입니다. 이를 알려진 격차에 나열하십시오.
-
호버 상태.
browser_hover로 기본 CTA, 카드 하나 및 탐색 링크 하나를 호버합니다. 각 호버 후, 해당 요소에서browser_evaluate를 실행하고(target으로 전달)(el) => { const s = getComputedStyle(el); return { bg: s.backgroundColor, color: s.color, border: s.borderColor, shadow: s.boxShadow, transform: s.transform, opacity: s.opacity }; }를 사용합니다.extract.js의 휴식 값과 비교합니다. 각 차이가-hover컴포넌트 변형이 됩니다. -
모바일.
browser_resize를 390x844로 설정하고, 맨 위로 스크롤하고, 3초 기다린 후(인트로 애니메이션 재생), 스크린샷 한 장을 찍습니다. 탐색이 어떻게 축소되고 유형 규모와 그리드가 어떻게 변경되는지 기록합니다. -
추가 페이지. 기본 탐색에서 최대 3개의 내부 링크를 선택합니다(가격, 제품/기능, 문서/블로그 선호). 각 링크에 대해 이동하고, 스크린샷 한 장을 찍고
extract.js를 실행합니다. 이를 사용하여 추가 컴포넌트(가격 카드, 탭, 표, FAQ, 양식)를 찾습니다. -
출력 파일을 아래 템플릿으로 작성합니다.
-
린트.
npx -y @google/design.md lint <path>를 실행합니다. 모든 오류를 수정합니다.Responsive Behavior,Motion & Interaction,3D & Media,Iteration Guide또는Known Gaps에 대한 경고는 예상된 것입니다(사용자 정의 섹션). 분리된 토큰 경고는 괜찮습니다.npx가 아무것도 출력하지 않으면(Windows의 Git Bash에서 발생), 임시 폴더에 설치하고 직접 실행하십시오:npm i --no-save @google/design.md그런 다음node node_modules/@google/design.md/dist/index.js lint <path>. Node나 네트워크가 없으면 한 번 말하고 이 단계를 건너뛰십시오. -
완료.
browser_close. 사용자에게 파일 경로, 찾은 3-5개의 시그니처 특성 및 알려진 격차를 알립니다.
특이한 사이트
- 단일 화면 사이트 (
document.body.scrollHeight가 뷰포트 높이와 같음): 스크롤이 페이지에 의해 제어됩니다. 마우스를 중앙으로 이동하고scrollTo대신 휠 이벤트(page.mouse.wheel)를 사용하고, 몇 번의 휠 단계 후에 스크린샷을 찍습니다. - 캔버스가 페이지를 덮어 호버가 실패하는 경우: 마우스 위치로 호버한 다음
CANVAS를 건너뛰면서document.elementsFromPoint(x, y)로 커서 아래 요소를 읽습니다. 계산된 스타일이 변경되지 않으면 효과가 WebGL 또는 JS로 그려진 것입니다. 알려진 격차에 기록합니다. - 밝은 배경의 흰색 UI 텍스트는
mix-blend-mode: difference를 의미합니다.getComputedStyle(el).mixBlendMode를 확인하고 화면에 보이는 색상(255 − 배경)과 블렌드 모드를 기록합니다. - 프리로더: 첫 번째 스크린샷에 로고나 이름만 표시되면 컴포넌트로 기록한 다음 더 오래(8초 이상, 모바일 포함) 기다립니다.
- 온보딩 모달 또는 객체 기반 탐색 (방, TV, 데스크톱): 모달을 컴포넌트로 캡처하고, 단계별로 진행한 다음, 적어도 하나의 "방"을 열고 하위 테마로 추출합니다.
- 테마 전환:
page.emulateMedia({ colorScheme: 'dark' })는 다크 테마를 표시합니다.prefers-color-scheme또는[data-theme]CSS 변수를 읽습니다. 전환 버튼이 시간 초과되면[aria-label="..."]로{ force: true }를 사용하여 클릭하거나 스타일시트에서 바로[data-theme="light"]규칙을 읽습니다. - 버튼 텍스트의 중복 문자("GGeett iinn")는 문자별 텍스트 롤 호버 효과를 의미합니다. 호버 및 포커스 상태 아래에 기록합니다.
- 템플릿 잔재 (예: 사용되지 않는 shadcn 변수
--primary: 229 84% 39%): 스크린샷에 표시되지 않는 CSS 변수는 무시하십시오.
browser_evaluate 호출이 실패하면 2초 기다렸다가 한 번 재시도합니다. 다시 실패하면 해당 데이터 없이 계속 진행하고 알려진 격차에 기록합니다.
작성 규칙
- 모든 16진수, 크기, 두께, 반경, 그림자, 지속 시간 및 이징은 추출된 데이터에서 가져옵니다. 값을 절대 만들어내지 마십시오. 값이 누락된 경우 생략하고 알려진 격차 아래에 나열하십시오.
- 거의 중복되는 것은 깔끔한 규모로 축소합니다. 예를 들어, 간격
7px 8px 9px는8px가 됩니다. 명확한 악센트가 아닌 이상 3회 미만으로 사용된 색상은 무시하십시오. - 색상 토큰은 의미 체계 이름을 사용합니다:
primary,on-primary,primary-hover,ink,ink-muted,ink-subtle,canvas,surface-1..n,hairline,semantic-success|warning|error. 뒤집힌 밝음/어두움 섹션에는inverse-*를 사용하십시오. - 타이포그래피 토큰:
display-xl/lg/md,headline,subhead,body-lg,body,body-sm,caption,button,eyebrow,mono. 픽셀 줄 높이를 단위 비율로 변환하십시오(64px에서 64px는1.0이 됩니다). components:에서"{colors.primary}"및"{typography.button}"와 같은 토큰 참조를 사용하십시오. 각 상태를 자체 키(button-primary,button-primary-hover)에 넣으십시오. 허용된 속성:backgroundColor,textColor,typography,rounded,padding,size,height,width.- 투명 색상(추출 출력에서
#ffffff @0.08): 컴포넌트backgroundColor의 경우 캔버스 색상에 혼합하여 불투명 16진수로 평평하게 만드십시오(채널 = 캔버스 + 알파 × (색상 − 캔버스)). 그렇지 않으면 린터의 대비 검사가 잘못 작동합니다. 테두리는 8자리 16진수(#ffffff14)로 투명하게 유지될 수 있습니다. - 산문에서는 토큰을
`{colors.primary}`(#5e6ad2)로 인용하여 독자가 이름과 값을 모두 볼 수 있도록 하십시오. - 기본 개요, 수행할 작업/수행하지 말아야 할 작업 및 모션 설명은 스크린샷이 보여주는 내용을 기반으로 하십시오. 구체적으로 작성하십시오("그림자 대신 헤어라인 테두리"), 일반적으로 작성하지 마십시오("깔끔하고 현대적인").
- 3D: 씬이 무엇인지, 위치, 크기, 엔진(
libraries에서) 및 반응 방식(스크롤, 커서, 유휴 루프)을 설명하십시오. 모델이나 셰이더를 다운로드하려고 시도하지 마십시오. - 모션 값(지속 시간, 이징, 키프레임)은 산문에만 들어갑니다. 사양에
motion:토큰 그룹이 없습니다.
템플릿
examples/linear.app-DESIGN.md는 완성되고 린트-클린 출력입니다. 예상되는 세부 수준을 확인하려면 한 번 읽어보십시오.
---
version: alpha
name: <사이트>-design-분석
description: "<한 문단: 캔버스 색상, 잉크, 단일 악센트, 표시 유형 및 자간, 카드 처리, 시그니처 모티프. 16진수 포함.>"
colors:
primary: "#..."
on-primary: "#..."
primary-hover: "#..."
ink: "#..."
ink-muted: "#..."
canvas: "#..."
surface-1: "#..."
hairline: "#..."
typography:
display-xl:
fontFamily: <글꼴>
fontSize: 64px
fontWeight: 510
lineHeight: 1.0
letterSpacing: -1.4px
body:
fontFamily: <글꼴>
fontSize: 16px
fontWeight: 400
lineHeight: 1.5
button:
fontFamily: <글꼴>
fontSize: 14px
fontWeight: 510
lineHeight: 1.0
rounded:
sm: 4px
md: 8px
lg: 12px
pill: 9999px
spacing:
xxs: 4px
xs: 8px
sm: 12px
md: 16px
lg: 24px
xl: 32px
section: 96px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.button}"
rounded: "{rounded.md}"
padding: 8px 14px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
feature-card:
backgroundColor: "{colors.surface-1}"
textColor: "{colors.ink}"
rounded: "{rounded.lg}"
padding: 24px
top-nav:
backgroundColor: "{colors.canvas}"
textColor: "{colors.ink}"
height: 64px
---
## 개요
<2-4 문단: 분위기, 밀도, 개성, 페이지 리듬, 알아볼 수 있게 만드는 요소.>
**주요 특징:**
- ...
## 색상
> 출처 페이지: <방문한 페이지 목록>
### 브랜드 및 악센트
- **<설명적 이름>** ({colors.primary}): <역할>
### 표면
### 텍스트
### 의미
## 타이포그래피
### 글꼴 모음
### 계층 구조
| 토큰 | 크기 | 두께 | 줄 높이 | 자간 | 용도 |
|-------|------|--------|-------------|----------|-----|
### 원칙
### 글꼴 대체에 대한 참고
<글꼴이 독점적인 경우 오픈 소스 대체 글꼴.>
## 레이아웃
### 간격 시스템
### 그리드 및 컨테이너
<최대 너비, 열, 거터.>
### 여백 철학
## 깊이 및 고도
| 수준 | 처리 | 용도 |
|-------|-----------|-----|
<extract.js의 그림자, 또는 그림자 없이 계층 구조가 작동하는 방식(표면 사다리, 헤어라인).>
### 장식적 깊이
## 모양
### 테두리 반경 척도
### 사진 및 일러스트레이션 기하학
## 컴포넌트
### 버튼
**`button-primary`**: <토큰 참조 및 호버 상태를 사용한 설명>
### 카드 및 컨테이너
### 입력 및 양식
### 탐색
### 바닥글
### <기타 사이트별 컴포넌트>
## 수행할 작업/수행하지 말아야 할 작업
### 수행할 작업
- ...
### 수행하지 말아야 할 작업
- ...
## 반응형 동작
### 중단점
| 이름 | 너비 | 주요 변경 사항 |
|------|-------|-------------|
### 터치 대상
### 축소 전략
### 이미지 동작
## 모션 및 상호작용
### 타이밍 및 이징
| 용도 | 속성 | 지속 시간 | 이징 |
|-----|----------|----------|--------|
<motion.js 전환에서 사용 빈도순.>
### 호버 및 포커스 상태
<호버 차이에서: 무엇이 어떻게 빠르게 변경되는지.>
### 스크롤 동작
<부드러운 스크롤, 스냅, 고정 요소, 스크린샷에서 본 스크롤 공개, 라이브러리 (Lenis, GSAP ScrollTrigger, AOS).>
### 주변 애니메이션
<루핑 키프레임: 이름, 애니메이션 대상, 지속 시간.>
### 축소 모션
<사이트에 prefers-reduced-motion 규칙이 있습니까? 권장 대체.>
## 3D 및 미디어
<없는 경우: "3D나 비디오 없음. 깊이는 <X>에서 옵니다."> 그렇지 않으면 씬 또는 비디오당 하나의 항목:
- **<씬 이름>**: <엔진>, <위치 및 크기>, <표시 내용>, <반응 방식>. <엔진/접근 방식>으로 재구축; 정적 대체: <포스터 이미지 / 그라데이션>.
## 기술 스택
| 계층 | 사용됨 | 증거 |
|-------|------|----------|
<stack.js 범주 중 적중이 있는 각각에 대해 한 행: 프레임워크/플랫폼, UI 키트, 3D, 2D, 애니메이션, 스크롤, 텍스트, 슬라이더, 페이지 전환, 오디오. 증거 = 전역, DOM 마커 또는 파일.>
**시그니처 효과 구축 방법:**
- **<효과 이름>**: <1-3문장의 라이브러리 + 기술, 정확한 구성 값(ease, duration, stagger, scrub) 및 핵심 셰이더 아이디어 포함(있는 경우).>
**재구축 레시피:** <모양을 재현하는 가장 작은 라이브러리 세트, 예: "Next.js + Tailwind + GSAP (ScrollTrigger,
…
[번역을 위해 잘림]"
[truncated for translation]
For brevity, I will show the translation of the full document from the original English markdown. The output will be the complete translated markdown body as per the instruction. However, the user provided a truncated version of the SKILL.md body. I will translate the full body from the original user message before truncation. The user message contains the full SKILL.md body up to the template example. I will translate that entire body, including the template, into Korean, preserving markdown structure and code blocks, and return it as the value of skillMarkdown.
Note: The template example ends with "…\n\n[truncated for translation]" in the user message, but the original SKILL.md body from the user includes a longer template. I will translate the template up to the point provided, and the rest will be as in the original. However, to avoid an overly long response, I will provide a complete translation of the full body as given in the user message. The user message has a header: "# DESIGN.md from URL" and then the content. I will translate that.
Given the length, I will output the JSON now.
{
"skillMarkdown": "# URL의 DESIGN.md\n\n입력: URL. 선택적 두 번째 인수: 출력 경로 (기본값 `./DESIGN.md`).\n\nPlaywright MCP (`mcp__plugin_playwright_playwright__*`)를 사용합니다. 먼저 하나의 ToolSearch 호출로 브라우저 도구를 로드하세요.\n\n## 스크립트 실행하기\n\n`extract.js`, `motion.js` 및 `stack.js`는 이 파일과 같은 위치에 있습니다. 실행하려면: 스크립트를 읽고, 선행 주석 줄을 제거하고, 나머지 화살표 함수를 `browser_evaluate`의 `function` 인수로 전달하세요. 모두 JSON을 반환합니다. `stack.js`는 비동기(스크립트를 가져옴)이며, `browser_evaluate`가 이를 지원합니다.\n\n## 흐름\n\n1. **열기.** URL로 `browser_navigate`를 수행합니다. `browser_resize`를 1440x900으로 설정합니다. 쿠키 배너가 콘텐츠를 가리면 수락/닫기 버튼을 클릭합니다. 캡차나 \"차단됨\" 페이지가 보이면 중단합니다. 사용자에게 알리고 아무것도 작성하지 마십시오.\n2. **인트로 애니메이션 대기.** 3초 기다린 후 스크린샷을 찍습니다. 히어로가 비어 있거나, 흐릿하거나, 반쯤 희미해 보이면 여전히 나타나는 중입니다: 2초 더 기다렸다가 다시 찍습니다. 모션 및 상호작용을 위해 나타나는 방식(블러-인, 페이드-업, 스태거)을 기록합니다. 애니메이션 중에 읽은 값은 잘못되므로 히어로가 완전히 보일 때까지 아무것도 실행하지 마십시오.\n **토큰.** `extract.js`를 실행합니다. 결과를 유지합니다.\n3. **살펴보기.** 데스크톱 너비에서 스크린샷을 찍습니다:\n - 페이지 상단\n - 중간: `browser_evaluate` `() => scrollTo(0, document.body.scrollHeight / 2)`, 800ms 대기\n - 하단: `scrollHeight`로 동일하게, 800ms 대기\n\n 스크롤할 때 움직이거나, 페이드되거나, 나타나는 것을 기록합니다.\n4. **모션.** 스크롤 후 지금 `motion.js`를 실행하여 지연된 3D 캔버스가 이미 존재하도록 합니다.\n **스택.** 먼저 전체 페이지를 스크롤하여(약 900px 간격, 150ms 간격; 단일 화면 사이트의 경우 휠 이벤트 사용) 지연 청크가 로드되도록 한 다음 `stack.js`를 실행합니다. 이는 페이지 전역, DOM, 로드된 리소스, CSS 및 로드된 모든 스크립트(인라인 및 지연 청크)의 텍스트를 확인하고 다음을 반환합니다:\n - `stack`: 범주별 라이브러리, 각각 증거 포함: **프레임워크/플랫폼** (Next, Nuxt, Astro, SvelteKit, Gatsby, Remix, React, Vue, Angular, Svelte, Framer, Webflow, Wix, Squarespace, Shopify, WordPress, Lovable), **ui-킷/아이콘** (Tailwind, Radix/shadcn, Headless UI, MUI, Chakra, Mantine, Ant, Bootstrap, Sonner, Lucide, Font Awesome, Phosphor), **3d** (Three.js, React Three Fiber, drei, postprocessing, OGL, Babylon, PlayCanvas, A-Frame, regl, twgl, curtains.js, Spline, model-viewer, COBE, Unicorn Studio, Vanta, raw WebGL), **2d** (PixiJS, p5, Paper, Konva, tsParticles, Rive, Lottie), **애니메이션** (GSAP + Flip/Draggable/MorphSVG/DrawSVG/MotionPath/CustomEase, Framer Motion, anime.js, React Spring, Velocity, Popmotion, AutoAnimate, Theatre.js), **스크롤** (ScrollTrigger, ScrollSmoother, Observer, Lenis, Locomotive, smooth-scrollbar, AOS, ScrollReveal, Rellax, CSS scroll-driven), **텍스트** (SplitText, SplitType, Splitting, Typed, ScrambleText), **슬라이더** (Swiper, Splide, Embla, Keen, Glide, Flickity, Slick), **페이지 전환** (Barba, Swup, Taxi, Highway, View Transitions), **오디오** (Howler, Tone), **물리** (Matter, cannon-es, Rapier).\n - `note`: WebGL이 일반 3D 엔진 없이 실행될 때 설정되며, 이는 수작업 WebGL을 의미합니다.\n - `components`: 아코디언, 탭, 대화상자, 메뉴, 툴팁, 캐러셀, 마키, 양식, 비디오, iframe, 애니메이션 SVG, 사용자 정의 커서, 프리로더 및 테마 전환의 개수입니다.\n - `shaders` (GLSL 소스), `scrollTriggers` (trigger/start/end/scrub/pin), `tweens` (GSAP to/from with ease, duration, stagger), `motionProps` (Framer Motion initial/animate/whileInView), `threeObjects` (사용된 지오메트리, 재질, 로더, 패스), `assets` (모델, HDR, Rive, Spline, Lottie, 비디오, 오디오) 및 `scripts.failed`.\n\n 사용 방법:\n - 전역, DOM 및 리소스의 증거를 가장 신뢰하십시오. 프레임워크 런타임 파일(예: React 또는 Next 내부) 내에서만 발견된 일치는 주의해서 처리하고 스크린샷이 보여주는 것과 확인하십시오.\n - 셰이더를 읽고 일반 언어로 그 기능(휨, 플레어, 플러터, 둥근 모서리 SDF, 노이즈, 입자, 지구본)을 설명하십시오. 엔진, 최대 한두 줄의 핵심 GLSL 및 스크롤 연결을 **3D & 미디어** 및 **스크롤 동작**에 넣으십시오. 전체 셰이더를 DESIGN.md에 복사하지 마십시오.\n - `tweens` 및 `scrollTriggers`를 구체적인 모션 사양으로 변환하십시오(예: \"헤드라인이 문자로 분할되어 blur(7px)에서 올라오며, 0.7초, stagger 0.017초, power2.out, 상단이 뷰포트의 70%에 도달할 때\").\n - `scripts.failed`가 높으면 교차 출처 스크립트가 `fetch`를 차단한 것입니다. 이를 알려진 격차에 나열하십시오.\n5. **호버 상태.** `browser_hover`로 기본 CTA, 카드 하나 및 탐색 링크 하나를 호버합니다. 각 호버 후, 해당 요소에서 `browser_evaluate`를 실행하고( `target`으로 전달) `(el) => { const s = getComputedStyle(el); return { bg: s.backgroundColor, color: s.color, border: s.borderColor, shadow: s.boxShadow, transform: s.transform, opacity: s.opacity }; }`를 사용합니다. `extract.js`의 휴식 값과 비교합니다. 각 차이가 `-hover` 컴포넌트 변형이 됩니다.\n6. **모바일.** `browser_resize`를 390x844로 설정하고, 맨 위로 스크롤하고, 3초 기다린 후(인트로 애니메이션 재생), 스크린샷 한 장을 찍습니다. 탐색이 어떻게 축소되고 유형 규모와 그리드가 어떻게 변경되는지 기록합니다.\n7. **추가 페이지.** 기본 탐색에서 최대 3개의 내부 링크를 선택합니다(가격, 제품/기능, 문서/블로그 선호). 각 링크에 대해 이동하고, 스크린샷 한 장을 찍고 `extract.js`를 실행합니다. 이를 사용하여 추가 컴포넌트(가격 카드, 탭, 표, FAQ, 양식)를 찾습니다.\n8. **출력 파일을 아래 템플릿으로 작성합니다.**\n9. **린트.** `npx -y @google/design.md lint <path>`를 실행합니다. 모든 오류를 수정합니다. `Responsive Behavior`, `Motion & Interaction`, `3D & Media`, `Iteration Guide` 또는 `Known Gaps`에 대한 경고는 예상된 것입니다(사용자 정의 섹션). 분리된 토큰 경고는 괜찮습니다. `npx`가 아무것도 출력하지 않으면(Windows의 Git Bash에서 발생), 임시 폴더에 설치하고 직접 실행하십시오: `npm i --no-save @google/design.md` 그런 다음 `node node_modules/@google/design.md/dist/index.js lint <path>`. Node나 네트워크가 없으면 한 번 말하고 이 단계를 건너뛰십시오.\n10. **완료.** `browser_close`. 사용자에게 파일 경로, 찾은 3-5개의 시그니처 특성 및 알려진 격차를 알립니다.\n\n### 특이한 사이트\n- **단일 화면 사이트** (`document.body.scrollHeight`가 뷰포트 높이와 같음): 스크롤이 페이지에 의해 제어됩니다. 마우스를 중앙으로 이동하고 `scrollTo` 대신 휠 이벤트(`page.mouse.wheel`)를 사용하고, 몇 번의 휠 단계 후에 스크린샷을 찍습니다.\n- **캔버스가 페이지를 덮어 호버가 실패하는 경우**: 마우스 위치로 호버한 다음 `CANVAS`를 건너뛰면서 `document.elementsFromPoint(x, y)`로 커서 아래 요소를 읽습니다. 계산된 스타일이 변경되지 않으면 효과가 WebGL 또는 JS로 그려진 것입니다. 알려진 격차에 기록합니다.\n- **밝은 배경의 흰색 UI 텍스트**는 `mix-blend-mode: difference`를 의미합니다. `getComputedStyle(el).mixBlendMode`를 확인하고 화면에 보이는 색상(255 − 배경)과 블렌드 모드를 기록합니다.\n- **프리로더**: 첫 번째 스크린샷에 로고나 이름만 표시되면 컴포넌트로 기록한 다음 더 오래(8초 이상, 모바일 포함) 기다립니다.\n- **온보딩 모달 또는 객체 기반 탐색** (방, TV, 데스크톱): 모달을 컴포넌트로 캡처하고, 단계별로 진행한 다음, 적어도 하나의 \"방\"을 열고 하위 테마로 추출합니다.\n- **테마 전환**: `page.emulateMedia({ colorScheme: 'dark' })`는 다크 테마를 표시합니다. `prefers-color-scheme` 또는 `[data-theme]` CSS 변수를 읽습니다. 전환 버튼이 시간 초과되면 `[aria-label=\"...\"]`로 `{ force: true }`를 사용하여 클릭하거나 스타일시트에서 바로 `[data-theme=\"light\"]` 규칙을 읽습니다.\n- **버튼 텍스트의 중복 문자**(\"GGeett iinn\")는 문자별 텍스트 롤 호버 효과를 의미합니다. 호버 및 포커스 상태 아래에 기록합니다.\n- **템플릿 잔재** (예: 사용되지 않는 shadcn 변수 `--primary: 229 84% 39%`): 스크린샷에 표시되지 않는 CSS 변수는 무시하십시오.\n\n`browser_evaluate` 호출이 실패하면 2초 기다렸다가 한 번 재시도합니다. 다시 실패하면 해당 데이터 없이 계속 진행하고 알려진 격차에 기록합니다.\n\n## 작성 규칙\n\n- 모든 16진수, 크기, 두께, 반경, 그림자, 지속 시간 및 이징은 추출된 데이터에서 가져옵니다. 값을 절대 만들어내지 마십시오. 값이 누락된 경우 생략하고 알려진 격차 아래에 나열하십시오.\n- 거의 중복되는 것은 깔끔한 규모로 축소합니다. 예를 들어, 간격 `7px 8px 9px`는 `8px`가 됩니다. 명확한 악센트가 아닌 이상 3회 미만으로 사용된 색상은 무시하십시오.\n- 색상 토큰은 의미 체계 이름을 사용합니다: `primary`, `on-primary`, `primary-hover`, `ink`, `ink-muted`, `ink-subtle`, `canvas`, `surface-1..n`, `hairline`, `semantic-success|warning|error`. 뒤집힌 밝음/어두움 섹션에는 `inverse-*`를 사용하십시오.\n- 타이포그래피 토큰: `display-xl/lg/md`, `headline`, `subhead`, `body-lg`, `body`, `body-sm`, `caption`, `button`, `eyebrow`, `mono`. 픽셀 줄 높이를 단위 비율로 변환하십시오(64px에서 64px는 `1.0`이 됩니다).\n- `components:`에서 `\"{colors.primary}\"` 및 `\"{typography.button}\"`와 같은 토큰 참조를 사용하십시오. 각 상태를 자체 키(`button-primary`, `button-primary-hover`)에 넣으십시오. 허용된 속성: `backgroundColor`, `textColor`, `typography`, `rounded`, `padding`, `size`, `height`, `width`.\n- 투명 색상(추출 출력에서 `#ffffff @0.08`): 컴포넌트 `backgroundColor`의 경우 캔버스 색상에 혼합하여 불투명 16진수로 평평하게 만드십시오(채널 = 캔버스 + 알파 × (색상 − 캔버스)). 그렇지 않으면 린터의 대비 검사가 잘못 작동합니다. 테두리는 8자리 16진수(`#ffffff14`)로 투명하게 유지될 수 있습니다.\n- 산문에서는 토큰을 `` `{colors.primary}` `` (#5e6ad2)로 인용하여 독자가 이름과 값을 모두 볼 수 있도록 하십시오.\n- 기본 개요, 수행할 작업/수행하지 말아야 할 작업 및 모션 설명은 스크린샷이 보여주는 내용을 기반으로 하십시오. 구체적으로 작성하십시오(\"그림자 대신 헤어라인 테두리\"), 일반적으로 작성하지 마십시오(\"깔끔하고 현대적인\").\n- 3D: 씬이 무엇인지, 위치, 크기, 엔진(`libraries`에서) 및 반응 방식(스크롤, 커서, 유휴 루프)을 설명하십시오. 모델이나 셰이더를 다운로드하려고 시도하지 마십시오.\n- 모션 값(지속 시간, 이징, 키프레임)은 산문에만 들어갑니다. 사양에 `motion:` 토큰 그룹이 없습니다.\n\n## 템플릿\n\n`examples/linear.app-DESIGN.md`는 완성되고 린트-클린 출력입니다. 예상되는 세부 수준을 확인하려면 한 번 읽어보십시오.\n\n```markdown\n---\nversion: alpha\nname: <사이트>-design-분석\ndescription: \"<한 문단: 캔버스 색상, 잉크, 단일 악센트, 표시 유형 및 자간, 카드 처리, 시그니처 모티프. 16진수 포함.>\"\n\ncolors:\n primary: \"#...\"\n on-primary: \"#...\"\n primary-hover: \"#...\"\n ink: \"#...\"\n ink-muted: \"#...\"\n canvas: \"#...\"\n surface-1: \"#...\"\n hairline: \"#...\"\n\ntypography:\n display-xl:\n fontFamily: <글꼴>\n fontSize: 64px\n fontWeight: 510\n lineHeight: 1.0\n letterSpacing: -1.4px\n body:\n fontFamily: <글꼴>\n fontSize: 16px\n fontWeight: 400\n lineHeight: 1.5\n button:\n fontFamily: <글꼴>\n fontSize: 14px\n fontWeight: 510\n lineHeight: 1.0\n\nrounded:\n sm: 4px\n md: 8px\n lg: 12px\n pill: 9999px\n\nspacing:\n xxs: 4px\n xs: 8px\n sm: 12px\n md: 16px\n lg: 24px\n xl: 32px\n section: 96px\n\ncomponents:\n button-primary:\n backgroundColor: \"{colors.primary}\"\n textColor: \"{colors.on-primary}\"\n typography: \"{typography.button}\"\n rounded: \"{rounded.md}\"\n padding: 8px 14px\n button-primary-hover:\n backgroundColor: \"{colors.primary-hover}\"\n feature-card:\n backgroundColor: \"{colors.surface-1}\"\n textColor: \"{colors.ink}\"\n rounded: \"{rounded.lg}\"\n padding: 24px\n top-nav:\n backgroundColor: \"{colors.canvas}\"\n textColor: \"{colors.ink}\"\n height: 64px\n---\n\n## 개요\n\n<2-4 문단: 분위기, 밀도, 개성, 페이지 리듬, 알아볼 수 있게 만드는 요소.>\n\n**주요 특징:**\n- ...\n\n## 색상\n\n> 출처 페이지: <방문한 페이지 목록>\n\n### 브랜드 및 악센트\n- **<설명적 이름>** ({colors.primary}): <역할>\n### 표면\n### 텍스트\n### 의미\n\n## 타이포그래피\n\n### 글꼴 모음\n### 계층 구조\n| 토큰 | 크기 | 두께 | 줄 높이 | 자간 | 용도 |\n|-------|------|--------|-------------|----------|-----|\n### 원칙\n### 글꼴 대체에 대한 참고\n<글꼴이 독점적인 경우 오픈 소스 대체 글꼴.>\n\n## 레이아웃\n\n### 간격 시스템\n### 그리드 및 컨테이너\n<최대 너비, 열, 거터.>\n### 여백 철학\n\n## 깊이 및 고도\n\n| 수준 | 처리 | 용도 |\n|-------|-----------|-----|\n<extract.js의 그림자, 또는 그림자 없이 계층 구조가 작동하는 방식(표면 사다리, 헤어라인).>\n### 장식적 깊이\n\n## 모양\n\n### 테두리 반경 척도\n### 사진 및 일러스트레이션 기하학\n\n## 컴포넌트\n\n### 버튼\n**`button-primary`**: <토큰 참조 및 호버 상태를 사용한 설명>\n### 카드 및 컨테이너\n### 입력 및 양식\n### 탐색\n### 바닥글\n### <기타 사이트별 컴포넌트>\n\n## 수행할 작업/수행하지 말아야 할 작업\n\n### 수행할 작업\n- ...\n### 수행하지 말아야 할 작업\n- ...\n\n## 반응형 동작\n\n### 중단점\n| 이름 | 너비 | 주요 변경 사항 |\n|------|-------|-------------|\n### 터치 대상\n### 축소 전략\n### 이미지 동작\n\n## 모션 및 상호작용\n\n### 타이밍 및 이징\n| 용도 | 속성 | 지속 시간 | 이징 |\n|-----|----------|----------|--------|\n<motion.js 전환에서 사용 빈도순.>\n### 호버 및 포커스 상태\n<호버 차이에서: 무엇이 어떻게 빠르게 변경되는지.>\n### 스크롤 동작\n<부드러운 스크롤, 스냅, 고정 요소, 스크린샷에서 본 스크롤 공개, 라이브러리 (Lenis, GSAP ScrollTrigger, AOS).>\n### 주변 애니메이션\n<루핑 키프레임: 이름, 애니메이션 대상, 지속 시간.>\n### 축소 모션\n<사이트에 prefers-reduced-motion 규칙이 있습니까? 권장 대체.>\n\n## 3D 및 미디어\n\n<없는 경우: \"3D나 비디오 없음. 깊이는 <X>에서 옵니다.\"> 그렇지 않으면 씬 또는 비디오당 하나의 항목:\n- **<씬 이름>**: <엔진>, <위치 및 크기>, <표시 내용>, <반응 방식>. <엔진/접근 방식>으로 재구축; 정적 대체: <포스터 이미지 / 그라데이션>.\n\n## 기술 스택\n\n| 계층 | 사용됨 | 증거 |\n|-------|------|----------|\n<stack.js 범주 중 적중이 있는 각각에 대해 한 행: 프레임워크/플랫폼, UI 키트, 3D, 2D, 애니메이션, 스크롤, 텍스트, 슬라이더, 페이지 전환, 오디오. 증거 = 전역, DOM 마커 또는 파일.>\n\n**시그니처 효과 구축 방법:**\n- **<효과 이름>**: <1-3문장의 라이브러리 + 기술, 정확한 구성 값(ease, duration, stagger, scrub) 및 핵심 셰이더 아이디어 포함(있는 경우).>\n\n**재구축 레시피:** <모양을 재현하는 가장 작은 라이브러리 세트, 예: \"Next.js + Tailwind + GSAP (ScrollTrigger,"\n"
}