Claude Motion System — 사용자 마스터 가이드
전체 가이드는 GUIA-MAESTRA.md(같은 폴더, 20개 섹션)에 있습니다. 전체를 로드하지 마세요: 작업에 필요한 섹션만 읽으세요(Grep으로 # N. 헤더를 찾아 해당 부분을 읽습니다).
주요 규칙 (§0)
프로젝트의 시각적 요소를 디자인, 생성, 애니메이션, 편집 또는 렌더링하기 전에 MOTION.md 전체를 읽으세요(리포지토리 루트에 있음). 파일이 없거나, 비어 있거나, 실제 디자인을 더 이상 반영하지 않는다면, 먼저 프로젝트를 감사하고 파일을 만들거나 업데이트하세요. 모션은 정보, 계층 구조, 내러티브 및 브랜드를 강화합니다. 장식이나 일반적인 AI 데모가 아닙니다.
루틴
- 발견하기 (§3): README, CLAUDE.md, package.json, CSS/Tailwind 토큰, 컴포넌트 및 레이아웃, 로고, 폰트, 에셋, 스크린샷, Figma, 기존 비디오 및 오디오. 답변해야 할 사항: 개성, 주요 색상 및 기능 색상, 실제 사용된 타이포그래피, 계층 구조, 일관된 움직임, 절대 변경되어서는 안 되는 것.
- 분류하기 (§3): A: 모션이 필요 없음(아무것도 설치하지 않음) · B: 데모 가능성이 있는 앱(
MOTION.md생성, 비디오 프로젝트 없음) · C: 활성 모션/비디오(HyperFrames 및 QA 준비) · D: After Effects 사용(추가로 AE MCP). MOTION.md(§5): 목적, 아이덴티티, 색상, 타이포그래피, 그리드, 모션 언어(원칙, 타이밍, 이징, 금지 사항), 컴포넌트별 모션, 카메라/3D, 오디오, 컷, 포맷 및 품질 기준. 실제 아이덴티티를 기반으로 구축됩니다. 디자인 시스템을 보완하며 대체하지 않습니다. 제품이 변경되면 프로덕션 전에 수정됩니다.- 새로운 조각:
BRIEF.md(§6) →STORYBOARD.md(§7). 각 장면은 내러티브, 정보 제공 또는 브랜드 기능을 수행합니다. - 오디오 (§8): 음악은 편집 시계입니다 — 신뢰할 수 있는 비트, 프레이즈, 드롭, 침묵; 비트 그리드를 강제하지 마세요.
- 구현하기 (§9): HyperFrames(
/hyperframes를 입력으로 사용) 또는 프로젝트에 이미 있는 엔진을 사용하세요. 엔진을 중복하지 마세요 (§13): 리포지토리에 자체 모션 엔진이 이미 있으면 그것을 사용하세요. - QA (§11): doctor → lint → check → 중요 프레임 스냅샷(직접 확인) → 전체 미리보기 → 렌더 →
ffprobe및 최종 파일 검토. 컴파일만 된다고 "완료"가 아닙니다. - "싸구려처럼 보이지 않는" 기준 (§12) 및 완료 정의 (§17): MOTION-READY 및 DELIVERY-READY.
보안 및 기술 부채 규칙
- 비디오를 생성하지 않는 프로젝트에는 비디오 종속성을 설치하지 마세요(§3, §13).
- 타사
npx(HyperFrames, After Effects MCP)는 실제로 프로덕션할 때만 사용하고 사용자의 승인을 받으세요. - MCP를 통한 After Effects는
.aep파일이 존재하거나 전달물에서 요구하는 경우에만 사용하세요. 수정하기 전에 백업하세요(§10). - 실제 브랜드 에셋을 사용하세요. 로고, 데이터, 스크린샷, 클레임을 절대 만들어내지 마세요(§15). 클라이언트 데이터는 승인 없이 시각적 조각에 절대 포함하지 마세요.
- 포맷에 맞게 재구성하세요(16:9, 9:16, 1:1). 무작정 자르지 마세요(§16).
가이드 색인
| § | 주제 |
|---|---|
| 0 | 마스터 명령 |
| 1 | 비디오가 가르치는 것 (HyperFrames, MOTION.md, 음악, After Effects) |
| 2 | 글로벌 + 프로젝트별 아키텍처 |
| 3 | 부트스트랩: 발견 및 분류 |
| 4 | HyperFrames 설치/확인 |
| 5 | MOTION.md 템플릿 |
| 6 | BRIEF.md |
| 7 | STORYBOARD.md |
| 8 | 편집 시계로서의 오디오 |
| 9 | HyperFrames를 사용한 구현 |
| 10 | MCP를 통한 After Effects |
| 11 | 필수 QA 파이프라인 |
| 12 | "싸구려처럼 보이지 않는" 기준 |
| 13 | 기술 부채 금지 |
| 14 | 권장 구성 |
| 15 | 에셋 정책 |
| 16 | 멀티포맷 |
| 17 | "완료"의 정의 |
| 18 | 리포지토리 준비를 위한 단일 프롬프트 |
| 19 | 참조 명령어 |
| 20 | 최종 원칙 |