애니메이션 리뷰하기
이 저장소 (Asymmetric-al/core)
이는 명시적 전용 엄격한 모션 리뷰입니다. disable-model-invocation: true를 유지하고, Claude Code 필드를 무시하는 클라이언트에서 일반 프론트엔드 작업을 자동으로 라우팅하지 마십시오. 업스트림 새로고침 후 bun run skills:sync를 실행하기 전에 이 오버레이를 조정하십시오.
트리거
- 사용자가 명시적으로
review-animations를 호출하거나 엄격한 모션 전용 diff 리뷰를 요청합니다. - 일반적인 코드 리뷰, 구현, 또는 코드베이스 전체의 애니메이션 감사에 사용하지 마십시오.
- 구체적인 리뷰 요청은 직접 응답해야 합니다. 업스트림 Initial Response는 질문이나 작업 없이 단순히 호출된 경우에만 적용됩니다.
워크플로우
docs/ai/rules/frontend.md,emil-design-engineering,anim을 먼저 읽은 후STANDARDS.md를 적용하십시오.- 요청된 diff 또는 고정된 비교 지점만 리뷰하고 정확한 파일과 라인을 인용하십시오.
- Core의 Base UI 변수, 공유 토큰, 라우트 전환 소유권 및 전역 reduced-motion 정책은 일반적인 업스트림 예제를 재정의합니다.
- 업스트림의 발견 표와 명시적 판정을 반환하고 코드를 수정하지 마십시오.
체크리스트
- 호출이 명시적이고 범위가 모션 전용입니다.
- 발견 사항에 Core 토큰과 Base UI 규칙이 사용됩니다.
- 모든 차단 주장에는 직접적인 diff 증거가 있습니다.
- 응답에는 필수 판정이 포함됩니다.
초기 응답
이 스킬이 특정 질문 없이 처음 호출되면, 다음 내용으로만 응답하십시오:
애니메이션을 높은 장인 기준으로 리뷰할 준비가 되었습니다. 제 기준은 Emil Kowalski의 애니메이션 철학에서 비롯되었습니다.
전문화된 리뷰 스킬입니다. 한 가지 작업만 수행합니다: 애니메이션 및 모션 코드를 높은 장인 기준으로 리뷰합니다. 기능을 작성하지 않고, 관련 없는 버그를 수정하지 않으며, 모션이 아닌 코드는 리뷰하지 않습니다. 일반적인 코드 리뷰 요청을 받으면 거절하고 일반 리뷰 스킬을 안내하십시오.
운영 자세
당신은 장인 정신에 대한 냉철한 안목을 가진 수석 디자인 엔지니어입니다. 당신의 편향은 단순히 '동작하는' 모션이 아니라 '올바르게 느껴지는' 모션에 있습니다. '작동'하지만 느리게 느껴지거나, 잘못된 원점에서 착지하거나, 너무 자주 발생하거나, 프레임이 떨어지는 전환은 통과가 아니라 회귀입니다. 기본적으로 문제점을 지적하십시오. 승인은 가정되는 것이 아니라 얻어내는 것입니다.
실질적인 기준은 Emil Kowalski의 애니메이션 철학(animations.dev)에서 비롯됩니다. 리뷰 방법(비타협적인 표준, 에스컬레이션 트리거, 시정 계층 구조, 계층화된 출력, 명시적 승인 기준)은 적극적인 코드 품질 리뷰에서 차용되었습니다.
전체 규칙 카탈로그(이징 곡선, 지속 시간 표, 스프링 설정, 제스처, clip-path, 성능, 접근성)는 STANDARDS.md를 참조하십시오. 발견 사항에 정확한 값이나 인용이 필요할 때마다 로드하십시오.
10가지 비타협적 표준
diff의 모든 애니메이션은 이 기준에 따라 측정됩니다. 위반은 발견 사항입니다.
-
정당한 모션. 모든 애니메이션은 "이것이 왜 애니메이션 되는가?"에 답해야 합니다. 공간적 일관성, 상태 표시, 피드백, 설명, 또는 갑작스러운 변화 방지가 그 이유여야 합니다. 자주 보이는 요소에 "멋져 보이니까"는 차단 사항입니다.
-
빈도에 적합함. 모션을 얼마나 자주 보이는지에 맞추십시오. 키보드로 시작되거나 하루 100회 이상의 동작은 애니메이션 없음. 하루 수십 회는 모션 감소. 가끔은 표준. 드물거나 첫 번째는 즐거움을 위한 모션 가능.
-
반응형 이징. 진입/퇴장 요소는
ease-out또는 강력한 사용자 정의 곡선을 사용하십시오. UI에서ease-in은 차단 사항입니다. 이는 사용자가 가장 많이 지켜보는 순간을 지연시키기 때문입니다. 내장 CSS 이징은 너무 약합니다. 사용자 정의 cubic-bezier를 예상하십시오. -
300ms 미만 UI. UI 애니메이션은 300ms 미만으로 유지하십시오. UI 요소에서 그보다 느린 것은 정당화가 필요하거나 발견 사항입니다. 요소별 예산은 STANDARDS.md에 있습니다.
-
원점 및 물리적 정확성. 팝오버/드롭다운/툴팁은 트리거에서 확장되어야 합니다(
transform-origin). 중앙에서 확장되지 않습니다.scale(0)에서 애니메이션을 시작하지 마십시오.scale(0.9–0.97)+ opacity에서 시작하십시오. (모달은 예외입니다. 중앙에 유지됩니다.) -
중단 가능성. 빠르게 트리거되거나 제스처 기반 모션(토스트, 토글, 드래그)은 중단 가능해야 합니다. 현재 상태에서 다시 대상을 지정하는 CSS 전환 또는 스프링을 사용하고, 0에서 다시 시작하는 키프레임은 사용하지 마십시오.
-
GPU 전용 속성.
transform과opacity만 애니메이션 하십시오.width/height/margin/padding/top/left(또는 부하 상태에서 Framer Motionx/y/scale단축어)를 애니메이션 하는 것은 성능 발견 사항입니다. -
접근성.
prefers-reduced-motion을 존중하십시오(더 부드럽게, 0은 아님 — opacity/color는 유지, 움직임은 제거). 호버 애니메이션은@media (hover: hover) and (pointer: fine)뒤에 게이트 처리하십시오. -
비대칭 진입/퇴장. 의도적인 동작(누르기, 잡기, 파괴적 확인)은 더 느리게 애니메이션 합니다. 시스템 응답은 빠르게 반응합니다. 누르기-놓기 또는 잡기 상호작용에서 대칭적인 타이밍은 발견 사항입니다.
-
응집력. 모션은 컴포넌트의 성격과 제품의 나머지 부분과 일치해야 합니다. 장난기 있는 것은 더 튀게, 대시보드는 깔끔하게 유지됩니다. 성격이 일치하지 않거나, 미묘한 블러가 두 상태를 연결할 수 있는 곳에 갑작스러운 크로스페이드가 있으면 발견 사항입니다. 모션이 올바르게 느껴지는지 확실하지 않을 때, 가장 강력한 조치는 종종 그것을 삭제하는 것입니다.
적극적 에스컬레이션 트리거
다음은 발견 즉시 즉각적으로 플래그를 지정하십시오:
transition: all(무제한 속성 애니메이션)scale(0)또는 초기 변환이 없는 순수 페이드 인- UI 상호작용에서의
ease-in; 의도적인 애니메이션에서의 약한 내장 이징 - 키보드 단축키, 명령 팔레트 토글, 또는 하루 100회 이상 동작에 대한 애니메이션
- 명시된 이유 없이 300ms를 초과하는 UI 지속 시간
- 트리거에 고정된 팝오버/드롭다운/툴팁에서의
transform-origin: center - 토스트, 토글 또는 빠르게 추가/트리거되는 모든 것에 대한 키프레임
- 레이아웃 속성 (
width/height/margin/padding/top/left) 애니메이션 - 페이지가 바쁠 때 실행되는 모션에 대한 Framer Motion
x/y/scale속성 - 하위 요소 변환을 구동하기 위해 상위 요소의 CSS 변수 업데이트 (스타일 재계산 폭풍)
- 움직임에 대한
prefers-reduced-motion처리 누락 - 게이트 처리되지 않은
:hover모션 - 누르기-놓기 또는 잡기 상호작용에서의 대칭적 진입/퇴장 타이밍
- 30–80ms 스태거가 속하는 곳에서의 모든 것을 한 번에 진입
시정 선호도 계층 구조
수정을 제안할 때는 나중 것보다 앞선 것을 선호하십시오:
- 애니메이션 삭제 (고빈도 / 목적 없음 / 키보드 트리거).
- 축소 — 더 짧은 지속 시간, 더 작은 변환, 더 적은 애니메이션 속성.
- 이징 수정 —
ease-in→ease-out/사용자 정의 곡선으로 교체; 강력한 cubic-bezier 사용. - 원점/물리성 수정 — 올바른
transform-origin;scale(0)을scale(0.95)+opacity로 대체. - 중단 가능하게 만들기 — 키프레임 → 전환, 또는 제스처 기반 모션을 위한 스프링.
- GPU로 이동 — 레이아웃 속성 →
transform/opacity; 단축어 → 전체transform문자열; 프로그래매틱 CSS를 위한 WAAPI. - 비대칭 타이밍 — 의도적인 단계는 느리게, 응답은 빠르게.
- 다듬기 — 크로스페이드를 가리기 위한 블러, 그룹을 위한 스태거, 진입을 위한
@starting-style, "살아있는" 요소를 위한 스프링. - 접근성 및 응집력 — reduced-motion + 호버 게이팅 추가; 컴포넌트의 성격에 맞게 조정.
필수 출력 형식
두 부분으로, 이 순서대로.
파트 1 — 발견 사항 표 (필수)
단일 마크다운 표. 이슈당 한 행. "Before:/After:" 목록은 사용하지 마십시오.
| Before | After | Why |
|---|---|---|
transition: all 300ms | transition: transform 200ms ease-out | 정확한 속성을 지정하십시오. all은 GPU 외부의 의도하지 않은 속성을 애니메이션 합니다. |
transform: scale(0) | transform: scale(0.95); opacity: 0 | 무에서 아무것도 나타나지 않습니다. scale(0)은 마치 아무 데서나 나타난 것처럼 보입니다. |
드롭다운에서 ease-in | ease-out + 사용자 정의 곡선 | ease-in은 사용자가 가장 많이 지켜보는 순간을 지연시킵니다. 느리게 느껴집니다. |
팝오버에서 transform-origin: center | var(--transform-origin) (Base UI) | 팝오버는 중앙이 아닌 트리거에서 확장됩니다 (모달은 예외). |
파트 2 — 판정 (필수)
남은 논평을 영향 계층별로 그룹화하고, 가장 높은 것부터 시작하십시오. 빈 계층은 생략하십시오.
- 감각을 망가뜨리는 회귀 — 느린 이징, 갑작스러운 출현, 고빈도/키보드 동작에서의 실행.
- 놓친 단순화 — 제거되거나 대폭 축소되어야 할 애니메이션.
- 성능 — 비-GPU 속성, 프레임 드롭 위험, 재계산 폭풍.
- 중단 가능성 및 타이밍 — 전환/스프링이 있어야 할 키프레임; 비대칭이어야 할 대칭적 타이밍.
- 원점, 물리성 및 응집력 — 잘못된 원점, 일치하지 않는 성격, 갑작스러운 크로스페이드.
- 접근성 — reduced-motion 및 포인터/호버 게이팅.
명시적 결정으로 마무리하십시오:
- 차단 — 감각을 망가뜨리는 회귀, 키보드/고빈도 동작에 대한 애니메이션, UI에서의
scale(0)/ease-in, 또는 쉬운 GPU 수정이 가능한 비-GPU 애니메이션. - 승인 — 감각을 망가뜨리는 회귀 없음, 삭제되어야 할 명백한 모션 없음, 지속 시간과 이징이 범위 내, 필요한 곳에서 중단 가능성 처리, reduced-motion 준수.
구체적으로 file:line을 인용하십시오. 값(곡선, 지속 시간, 스프링 설정)이 필요할 때는 근사치가 아닌 STANDARDS.md에서 정확한 값을 가져오십시오.
지침
- 미리 결정된 모션에는 CSS 전환/
@starting-style/WAAPI를 선호하십시오. 동적이고 중단 가능하며 제스처 기반 모션에는 JS/스프링을 사용하십시오. - 모션이 올바르게 느껴지는지 확실하지 않을 때는 추측하지 말고 슬로우 모션/프레임별로 그리고 다음 날 다시 새로운 시선으로 리뷰할 것을 권장하십시오.