디자인 크래프트은(는) 무엇을 하나요?
프론트엔드 디자인 및 구축을 위한 작업 방법입니다. SKILL.md는 모든 작업에 필요한 내용을 담고 있으며,
references/ 파일은 심화 내용, 수치 및 코드를 제공합니다. 마지막 표의 트리거가 적용될 때 해당 파일을 읽으세요.
범위: 새로운 페이지, 흐름 또는 컴포넌트는 1-8단계를 실행합니다. 작은 변경(상태 하나, 애니메이션 하나, 문자열 하나)은 해당 단계만 실행한 후 변경된 부분에 대해 8단계를 실행합니다.
필요의 순서
기능적 → 신뢰할 수 있는 → 사용 가능한 → 즐거운. 고장나거나, 느리거나, 혼란스러운 것에 즐거움을 더하지 마세요. 또한 최상위 레이어 없이 배송하지 마세요: 나중으로 미뤄진 개성은 거의 배송되지 않습니다.
1. 프레임 (코드 작성 전)
- 직무 스토리: [상황]일 때, [동기]를 위해 [결과]를 얻고 싶다. 상황이나 결과를 모르면 질문하거나, 요약에서 가정을 가설로 명시하세요.
- 브리핑이 요구하는 야망을 선택하고, 그곳에 노력을 집중하세요:
| 브리핑 | 투자할 부분 | 첫 번째 증명 |
|---|---|---|
| 브랜드 사이트, "프리미엄", "수상 수준", "애니메이션 가득" | 주제에 기반한 하나의 시그니처 인터랙션 (2단계) | 실제 콘텐츠에서 작동하는 인터랙션: 시작, 중간, 중단, 해제 |
| 런칭, 에디토리얼, 마케팅 페이지 | 제안이 명확하고 최고의 증거를 탐색할 수 있음 | 휴대폰에서 읽히는 첫 화면; 대기 없이 주요 작업에 도달 가능 |
| 앱, 도구, 대시보드 | 가장 어려운 결정, 실수 비용, 반복 사용 속도 | 데이터가 변화하는 현실적인 작업 + 하나의 실패 복구 |
| 컴포넌트 또는 디자인 시스템 | 두 가지 다른 소비자를 견디는 행동 계약 | 긴 콘텐츠를 가진 두 맥락에서의 동일한 컴포넌트 |
- 사실과 가정을 분리하세요. 도착 시 방문자의 감정 상태를 명명하세요; 분위기를 결정합니다.
- 기존 토큰, 컴포넌트, 패턴, 규칙을 확인하세요. 발명보다 재사용을 우선시하세요.
2. 주제에서 시그니처 찾기
표현적인 작업의 경우, 방문자가 로고가 가려져도 알아볼 수 있는 주제의 속성과 방문자가 그것을 조종할 수 있는 동사를 찾으세요. 맥주는 따르고, 거품이 일며 색상을 보여줍니다; 직물은 드레이프됩니다; 서체에는 축이 있습니다; 시계에는 무브먼트가 있습니다. 해당 속성을 중심으로 인터랙션을 디자인하세요.
- 대체 테스트: 관련 없는 브랜드로 바꿔보세요. 효과가 여전히 문제없이 작동한다면, 아직 주제에 관한 것이 아닙니다. 세부 사항을 추가하기 전에 주제로 돌아가세요.
- 네 박자: 무엇이 입력을 유도하는가 → 접촉 시 무엇이 반응하는가 → 지속적인 입력 아래 무엇이 드러나는가 → 해제 시 무엇이 남는가. 하나의 지속적인 객체가 네 가지를 모두 전달해야 합니다.
- 더 많은 효과가 "기본적으로 느껴진다"는 문제를 해결하지 않습니다. 대신 중심 아이디어나 메커니즘을 바꾸세요.
- 모든 제스처에는 동일한 정보에 도달하는 평범한 등가물(슬라이더, 버튼, 라디오 그룹)이 있어야 합니다.
3. 저렴하게 탐색하고, 가장 어려운 부분을 먼저 증명하세요
- 구조적으로 다른 접근 방식을 최소 세 가지 각각 몇 줄로 설명하세요. 하나를 선택하고 이유를 말하세요.
- 모션 전에 실제 콘텐츠로 정지 프레임을 구성하세요: 읽기 순서, 타입, 이미지, 주요 작업. 애니메이션 중간의 프레임도 의도적으로 보여야 합니다.
- 가장 위험한 주장(제스처, 스크롤 장면, 어려운 워크플로우)을 먼저 구축하고, 나머지 페이지를 그 주위에 구축하기 전에 실제 브라우저에서 확인하세요.
4. 시스템 우선
- 토큰이 컴포넌트보다 먼저입니다. 컴포넌트는 기본 요소(
--amber-400)를 별칭하는 의미론적 토큰(--color-action)을 사용합니다. 컴포넌트 스타일 내에 hex, px 또는 매직 넘버를 사용하지 마세요. - 4 기반 척도의 간격(4, 8, 12, 16, 24, 32, 48, 64). 본문 16px/1rem, 줄 높이 1.5; 제목 1.1-1.25. 하나의 모듈러 타입 비율. 최대 두 가지 서체(+ 고정폭). 변화하는 숫자에는 표 모양 숫자.
- 1-3개의 브랜드 색상, 중성색, 상태 색상. 모든 텍스트 쌍은 WCAG AA(본문 4.5:1, 대형/UI 3:1)를 통과해야 합니다. 색상이 유일한 신호가 되어서는 안 됩니다.
- 모션 토큰(지속 시간, 이징)은 색상 및 간격 옆에 위치합니다.
- Props는 의미를 이름으로 지정하고(
variant="destructive"), 모양이 아닙니다. 반복된 재정의는 누락된 변형을 의미합니다.
5. 모든 상태, 행복한 경로만이 아닙니다
인터랙티브 컴포넌트: 기본, 호버, focus-visible, 활성, 비활성, 로딩, 오류, 선택됨. 화면: 비어 있음, 로딩 중, 부분, 오류, 성공, 오프라인. 비동기 작업:
- 최신 요청이 우선됩니다; 느린 이전 응답이 최신 응답을 덮어쓰지 않아야 합니다.
- 실패 후에도 사용자의 입력을 유지하고, 로딩 중에는 이전 결과를 (희미하게) 계속 표시하세요.
- 빈 계정, 결과 없음, 가져오기 실패는 각각 다른 상태이며 다른 다음 작업이 있습니다.
키보드 조작 가능, 의미론적 HTML 우선, HTML이 표현할 수 없는 경우에만 ARIA, 모든 필드에 레이블, 모든 모달에서 눈에 띄게 빠져나올 수 있는 방법, 모달이 닫힐 때 포커스가 적절한 곳으로 돌아가야 합니다.
6. 감정, 카피 및 정직성
- 명확함이 재치보다 낫습니다. 농담이 한 문장을 더 필요로 한다면, 삭제하세요. 축약형, 평이한 단어.
- 목소리는 일정하고, 어조는 변합니다: 성공 시 따뜻하게, 오류 시 평범하고 차분하게, 민감한 입력 시 부드럽게.
- 오류: 무슨 일이 일어났는지, 왜, 다음에 무엇을 해야 하는지, 그리고 무엇이 유지되었는지. 결코 사용자를 탓하지 마세요. 여기에는 유머가 없습니다.
- 빈 상태는 초대합니다: 여기에 무엇이 나타날지와 하나의 명확한 첫 번째 작업.
- 최고점-끝점: 진정한 성취의 끝에 하나의 큰 즐거움을 배치하고, 결코 좌절의 골짜기에 배치하지 마세요.
- 높은 중요도 페이지에서는 방문자의 두려움을 명명하고 행동 유도 전에 각각에 답하세요.
- 이미지: 기본적으로 다양한 구성원; "우리가 누구를 배제하고 있는가?"라고 질문하세요.
- 정직성: 사람들이 실제라고 착각할 수 있는 AI 생성 이미지 및 데모 데이터에 레이블을 붙이세요. 카피는 이미지가 보여주는 것과 일치해야 합니다(5.0%를 출력하는 캔은 페이지에 5.0%라고 표시됨).
- 규제된 카테고리(알코올, 금융, 건강, 아동): 필요한 게이트나 공개를 추가하고 이미지가 카테고리의 광고 규범을 준수하는지 확인하세요(예: 알코올에 대해 성적 이미지 금지).
7. 모션
모든 애니메이션에는 작업이 있습니다: 맥락, 주의, 피드백 또는 개성. 작업이 없으면 애니메이션도 없습니다.
| 토큰 | 값 | 사용 |
|---|---|---|
--dur-1 | 100ms | 누름, 포커스, 토글 (≈ 지각적 최소치) |
--dur-2 | 200ms | 대부분의 UI 전환, 호버, 작은 입장 |
--dur-3 | 300ms | 패널, 서랍, 모달 |
--dur-4 | 400-500ms | 전체 화면 또는 히어로 안무 전용 |
--ease-out | cubic-bezier(0,0,.2,1) | 들어가기 / 주의 얻기 |
--ease-in | cubic-bezier(.4,0,1,1) | 떠나기 / 주의 잃기 (퇴장은 ~20-30% 더 짧게) |
--ease-in-out | cubic-bezier(.4,0,.2,1) | 화면 내 위치 사이 이동 |
| spring | 임계 감쇠, 재타겟 가능 | 제스처; 대상이 변경될 때 속도 유지 |
- 주요 작업을 안무로 차단하지 마세요. 프리로더나 인트로는 약 1초 이상 주요 작업을 보류해서는 안 되며, 재방문자는 건너뜁니다.
- 공간적 일관성: 사물은 온 방향으로 떠나고; 공유 요소는 제자리에서 변형됩니다.
- 스태거 30-60ms, 감쇠 지연(
base*√i) 사용; 전체 시퀀스를 ~300ms 이내로 유지하세요. - 스크롤 장면: 진행률은 섹션의 측정된 이동에 매핑되므로, 동일한 스크롤 위치는 항상 동일한 프레임을 제공하고, 위로 스크롤하면 깨끗이 역전되며, 중간에 대한 직접 링크가 작동합니다.
- 제스처: 진행률의 소유자는 하나; 그립은 포인터에 붙어 있어야 함; 해제 시 속도를 스프링에 위임; 비행 중 중단은 UI를 작동 가능하게 유지합니다.
transform과opacity만 애니메이션하세요.prefers-reduced-motion에서는 이동, 시차, 확대/축소 및 자동 재생을 제거하고 짧은 페이드는 유지하며, 사용자 주도 제스처는 계속 작동하게 하세요.- 실제 빌드를 망가뜨린 엔지니어링 함정 (속성 하나, 소유자 하나; 일시 중지된 스크롤 타임라인; 타임라인
내부의 스냅 레이블; 음수가 아닌 프레임 시간; 교체 가능한 에셋 사전 로딩):
references/motion-engineering.md.
8. 실제 브라우저에서 확인한 후, 인계
scripts/walk.py (Playwright + 로컬 Chrome)를 데스크톱, 휴대폰 및 축소 모션에서 실행하세요: 실제 포인터 드래그,
모든 섹션 스크롤, 콘솔 오류, 가로 방향 오버플로우. 숨겨지거나 최소화된 미리보기 창은
애니메이션 프레임을 조절하므로, 그 창에서 모션을 판단하지 마세요. 세부 사항: references/verification.md.
그런 다음 취향이 아닌 직무 스토리에 대해 비판하세요:
- 직무 스토리를 충족합니까? 주요 작업이 가장 눈에 띄고 모든 곳에서 접근 가능합니까?
- 모든 상태가 존재합니까 (5단계)? 키보드, 스크린 리더 레이블, 대비?
- 토큰만 사용됩니까? 기존 컴포넌트가 재사용됩니까?
- 카피가 6단계(정직성 레이블 포함)를 따릅니까?
- 모든 애니메이션에 작업, 올바른 이징 방향, 중단 경로 및 축소 모션 경로가 있습니까?
- 시그니처가 대체 테스트를 통과합니까? 끝에 배치된 하나의 최고점이 있습니까?
- 무엇을 잘라낼까요? 하나의 요소나 효과를 제거하고 개선되는지 확인하세요.
근거와 함께 인계하세요: 문제, 접근 방식, 거부된 대안 및 그 이유, 테스트된 내용 및 방법(에뮬레이션 대 실제
장치), 알려진 한계. 템플릿: references/process-and-teams.md 부록 B.
참조
| 읽을 파일 | 시기 |
|---|---|
references/motion-engineering.md | GSAP/ScrollTrigger/Lenis, 캔버스, 제스처 또는 스크롤 장면 작업 구축 시 |
references/verification.md | 시각적 또는 인터랙티브 작업 완료를 선언하기 전 |
references/imagery.md | 이미지 생성 또는 준비, 제품 컷아웃, 아트 디렉션 시 |
references/animation.md | 안무, 7가지 모션 원칙, 스태거 수학, 모션 토큰 관련 |
references/emotion.md | 디자인 페르소나, 온보딩, 즐거움, 신뢰 및 두려움, 중단 복사본 관련 |
references/design-systems.md | 토큰, 컴포넌트 API, 거버넌스, 버전 관리, 문서 관련 |
references/product-design.md | 리서치, 스토리 우선, 스케치, 피드백, 프로토타이핑, 테스트 관련 |
references/design-thinking.md | 공감/정의/아이데이션/프로토타입/테스트가 필요한 모호한 문제 관련 |
references/design-engineering.md | 프로토타입 충실도 선택, 디자인↔코드 핸드셰이크 관련 |
references/process-and-teams.md | 비판 세션, 근거 및 인계 템플릿, DesignOps 관련 |