motion-designer
1. 개요 (필수)
MOTION_BRIEF.md의 ## Segment: <id> 섹션에는 14개 필드(목적, 지속 시간, 브랜드, 장면, 시각적 아이디어, 타이포그래피, 움직임, 카메라, 배경, 전환, 사운드, 진입, 종료, 통합 대상)가 모두 있어야 합니다. 모션 언어: brands/<brand-id>/MOTION_LANGUAGE.md. 확인: npm run mos -- motion brief <pkg> <id>. 사용자에게 브리프를 표시한 후 → npm run mos -- approve <pkg> motion:<id> --quote "…" (--by delegated는 사용자가 명시적으로 모션을 위임한 경우에만 사용하며, 사용자의 말을 인용합니다).
2. 템플릿
템플릿은 video/hyperframes/templates/에 있습니다: 공유 템플릿(notification-card, bubble-transition)과 브랜드 템플릿(<brand-id>-*)이 있습니다. tokens.json의 토큰은 인라인으로 작성되며, 글꼴과 GSAP는 로컬에 있고, 텍스트는 data-composition-variables를 통해 전달됩니다. HyperFrames 구성 계약에 따라 새 템플릿을 빌드합니다(hyperframes-core / hyperframes-animation 스킬이 설치된 경우 해당 스킬을 따릅니다): window.__timelines["<id>"]에 일시 중지된 타임라인 하나, 결정론적이며, 동일한 속성에 CSS 변환과 GSAP를 사용하지 않고, 파일에 @font-face를 포함합니다. MOTION_LANGUAGE.md에서 요청하지 않는 한 다음은 금지됩니다: 일반 SaaS 애니메이션, 벤토 그리드, 무작위 그라데이션, 네온. 다른 회사의 UI나 상표를 복사하지 마십시오.
화면 텍스트는 브랜드 언어로 표시합니다. 실제 제품이 아닌 제품 비주얼(목업, 컨셉, 예시 UI, 가상 댓글)에는 정직성 라벨을 부착해야 하며, 목업을 실제 제품으로 제시하지 마십시오.
3. 세그먼트
npm run mos -- motion new <pkg> <id> --template <template> --duration <sec> --scene <scene-id> --var key=value …
npm run mos -- motion check <pkg> <id> # lint + 런타임 + 레이아웃 + 대비 검사, 오류 0개까지
npm run mos -- motion render <pkg> <id> # 투명 VP9 WebM, 알파 채널 검사, 입력 해시로 캐싱
렌더링은 로컬에서 수행됩니다. 명시적 허가 없이 media-use, 클라우드 렌더링, TTS 또는 생성을 실행하지 마십시오.
4. 통합
video/props.json에서 장면 {"kind":"motion","src":"content/<pkg>/video/motion/<id>/renders/<id>.webm","segmentId":"<id>","layer":"overlay", …}. Studio에서 프레임을 확인하고 npm run mos -- video still <pkg> <frame>을 사용하여 아래 레이어가 투명 영역을 통해 보여야 합니다. 알파 채널이 없으면 Remotion 컴포넌트(NotificationCard 등)로 대체합니다.