carvercat/carvercat-motion

Carvercat 모션 그래픽

무언가 찾을 수 없나요? references/INDEX.md가 전체 스킬(제작, 앱, 효과, 드로잉, 지도, 워크플로우, 알려진 문제)에서 "X는 어디에 있는지" 알려줍니다.

Carvercat MCP 도구를 호출할 수 있는 모든 에이전트(Claude, GPT/Codex, Gemini 또는 따라 읽는 사람)와 함께 작동합니다. 여기 있는 어떤 것도 특정 공급업체에 의존하지 않습니다. 도구 이름에는 클라이언트 접두사가 붙을 수 있습니다(예: mcp__carvercat__carvercat_run).

0. 단위와 새 표면 (먼저 읽으십시오)

작성하는 모든 것은 설계 단위로 표시됩니다: 프레임의 왼쪽 상단에서 y축 아래 방향 px, 시계 방향 도, CSS 색상 및 이징, fontSize px, 시간은 프레임, "1.5s" 또는 "500ms" 형식. 하나의 검증된 호출(scene.apply, 먼저 드라이 런)로 전체 장면을 구축하고, CSS 스타일 선택자로 객체를 선택하며, 헬퍼(layout.*, text.fit, motion.apply, measure.*)를 사용하고, 전송 전에 carve.preflight {host}를 실행하십시오. 가이드: references/app/design-units.md. 이전 이름은 한 릴리스 동안 계속 작동하며 거기에 한 번 나열됩니다. 작성하지 마십시오.

0b. 건드리기 전에

• 이 머신에 설치된 Carvercat 앱을 찾고 이 스킬의 폴더를 설치된 상태로 사용하십시오. 크리에이티브 작업에는 이 스킬로 충분합니다. 고정된 이전 경로를 사용하지 마십시오.
• carvercat_session (첨부) 후 carvercat_state: 변경하기 전에 빌드, 열려 있는 프로젝트 및 컴포지션을 확인하십시오. carvercat_list가 ID를 제공합니다.
• 사용자에게 앱에서 클릭하지 말라고 요청하십시오. 컴포지션 전환 시 다음 명령이 리디렉션됩니다.
• 사용자의 문서를 지우고 다시 빌드하지 마십시오. 편집 가능한 .carverproj를 작업 대상 위치에 저장하십시오.

1. 모션 디자이너처럼 계획하기 (제작)

작업에 필요한 것만 읽으십시오:

필요 항목	읽을 자료
지속 시간, 이징, 12가지 원칙, 안무, 음악에 맞춘 페이싱, 안티패턴	references/craft/motion-principles.md; 각 원칙별 페이지: references/craft/principles/
타입 스케일, 읽기 시간, 시작 스타일, 강조; 측정된 트래킹, 행간 및 린트 임계값	references/craft/typography.md
어떤 전환, 지속 시간, 컷에서의 핸드오프	references/craft/transitions.md
SFX 및 음악: 이벤트당 하나의 클립, 레벨, 팝/후시 사양	references/craft/sound-design.md
9:16 / 소셜 안전 영역, 16:9 작업물 변환	references/craft/vertical-and-safe-areas.md
팔레트 역할, 대비, 그라데이션, 색상 값	references/craft/colour.md
브랜드 모션 시스템: 이징 패밀리, 지속 시간, 시그니처 무브, 브랜드 팩	references/craft/brand-systems.md
초점 지점, 읽기 순서, 그리드, 계층, 안전 영역	references/craft/composition-and-layout.md
브리핑 읽기: 사실, 프레임 예산, 스타일, 레시피	references/craft/reading-a-brief.md
브리핑에 어울리는 스타일 팩	references/craft/style-families.md
스타일별 측정된 프레임 수; 스타일별 검토 목록	references/craft/timing-by-style.md, references/craft/review-by-style.md
움직임이 작동하는 이유: 12가지 원칙과 그 이상, 디자인 기초, 기술, 장르, 타이밍, 워크플로우, 접근성, 역사 (각 페이지는 Carvercat에서 수행하는 방법으로 끝남)	../wiki/README.md, 머신 인덱스 ../wiki/index.json

모든 곳에 적용되는 규칙:

• 장면당 하나의 히어로.
• 보조 항목은 expo-out 또는 감속으로 들어옵니다.
• 나가기는 가속하며 입장 시간의 약 70%가 소요됩니다.
• 이웃 항목을 3~6프레임 간격으로 배치합니다.
• 모든 장면에는 입장, 중간의 약간의 움직임, 퇴장이 있습니다 (절대 정지 상태 유지 금지).
• 텍스트는 최소 max(25프레임, 단어당 10프레임) + 10프레임 동안 유지됩니다. Carvercat의 린트는 초당 17자(공백 제외), 최소 25개의 완전 불투명 프레임을 요구합니다.

2. 패턴 라이브러리부터 먼저 구축하기

patterns/README.md에는 0.0.72에서 검증된 25개의 프레셋과 5개의 템플릿이 있으며, 측정된 오버슈트 및 안착 프레임과 푸시, 줌-스루, 카드 스택, 하이라이트 스윕을 위한 레시피가 포함되어 있습니다. 팩은 ../library/templates/motion-patterns/에 있습니다. library.list {query:"expo"}로 설치 여부를 확인하십시오. 설치되지 않은 경우 사용자 Library 폴더(도움말 > Library 폴더 또는 library.folder)에 설치하고 templates/에 복사한 다음 library.reload를 실행하십시오. Carvercat 0.1.8+ 필요; patterns/README.md 참조. 0.1.8 이전에는 설치된 앱이 로드할 수 없습니다. 배치된 템플릿은 중첩 컴포지션이 됩니다 — 패턴 README 참조.

• 단일 객체: preset.apply {name, id}, 예: Rise - expo, Pop - spring, Stamp, Exit up - accelerate.
• 텍스트: Words rise - expo, Letters cascade - spring, Lines reveal - decelerate 등.
• 여러 객체: library.place {name, frame} 후 template.apply {id}. 예: Two-tone wipe, Colour iris, Lower third - accent bar, Logo - stamp reveal, Bar chart - grow.
• 하나의 컴포지션에서 여러 비트의 전체 작품: patterns/promo-assembly.md.
• 스타일 팩 (Motion Patterns과 동일한 설치): SaaS UI, Kinetic Typography, Data Viz, Corporate Brand, Minimal Luxury, Social Short-form 9:16, Cartoon Bounce, Funky, Futuristic HUD, Retro, Glitch, Sports, Explainer; references/craft/style-families.md로 선택하십시오. Rethink Sans가 설치되어 있어야 합니다(텍스트에 앱 번들 글꼴을 사용할 수 없음, KI-136). 각각 ../categories/ 아래에 실험실 및 쇼케이스 프로젝트가 있습니다.
• 일반적인 브리핑용 레시피(SaaS 런칭, 스포츠 점수 업데이트, 9:16 팁 릴, 연례 보고서 오프너, 분기별 결과, 럭셔리 티저, 설명 레슨, 운동 인용구 릴, 어린이 설명, 세일 프로모션, 기술 트레일러, 레트로 나이트, 음악 티저): 프레임별 샷 목록과 Library 템플릿만으로 구축된 검증된 샘플 프로젝트는 recipes/README.md에 있습니다.
• 정확한 곡선: 떠나는 키에 ease: "cubic-bezier(a, b, c, d)" (patterns/custom-curves.md).
• 스프링과 바운스: scripts/motion/curves.py가 키로 구워집니다.

3. 앱 조종하기

상시 규칙 (2026년 10월 23일): .carverproj JSON을 직접 편집한 후 edit.open {force:true}로 장면을 구축 및 변경하십시오. 전체 장면은 하나의 검증된 원자적 scene.apply로 MCP를 통해 전송됩니다. 프로젝트 파일은 이제 carvercat/2입니다 (px, y 아래 방향, 프레임; 저장할 때마다 기록되며, v1 파일도 여전히 열림). 아래 JSON 경로는 json_author/cc.py가 작성하고 앱이 여전히 로드하는 이전 v1 형태(분수, y 위 방향)를 설명합니다. 새 생성기를 작성하는 경우 carvercat/2를 작성하십시오 (cc_project.py, 레시피 빌더가 하는 대로). 파일이 할 수 없는 단계(텍스트 측정, 조회, 저장, Resolve 전송, 라이브 조정)에는 MCP를 사용하십시오. 절차 및 대체 방법: references/app/json-authoring.md.

references/app/design-units.md는 작업 가이드입니다: 단위, scene.apply, 선택자, anim.set (트윈, 이징, 스태거), CSS 용어의 효과, 헬퍼, 헤드리스 노트. references/app/mcp-essentials.md는 빌드 -> 조회 -> 확인 루프, 알아둘 가치가 있는 명령 및 시간을 낭비하는 함정(clip.move 덮어쓰기, ID가 컴포지션당 재시작됨)을 다룹니다. 기계 판독 가능 카탈로그는 carvercat://schema/design, carvercat://schema/commands 및 carvercat://schema/scene (앱 저장소의 schema/agent/json-schema/): 익숙하지 않은 키나 생성된 항목 ID를 사용하기 전에 항목을 읽으십시오. 인수나 생성된 항목 ID를 추측하지 마십시오.

스크립트 작업의 경우 유지 관리되는 Python 스크립트를 사용하십시오: ai/scripts/cc_client.py + cc_scene.py (references/app/creative-toolkit.md); 앱에도 자체 Python 헬퍼(carvercat_py)가 있습니다. 효과, 채우기/획, 그라데이션, 색상, 변형, 스태거 및 경로 트림은 references/app/creative-controls.md에 있습니다. 보류 중인 계획은 scene.apply {dry_run: true} 및 measure.*로 확인할 수 있습니다. 문서 외에는 아무것도 저장되지 않습니다. 실제 모양의 텍스트를 측정하십시오. 의도적으로 글꼴을 선택하십시오. 혼합 RTL 텍스트에서 별도의 LTR 숫자 실행을 포함합니다. 가이드의 모든 예제는 ai/scripts/verify_examples.py에 의해 헤드리스 Carvercat에 대해 실행됩니다.

3b. 효과, 드로잉, 지도 및 전체 작업

필요 항목	읽을 자료
블러, 글로우(번 제한 있음), 그림자, 모션 블러, 그라데이션, 획/트림 그리기, 소프트 엣지 및 마스크 페더, 텍스트 아웃라인, 스태거, 마스크	references/effects/README.md
숨겨진 베이스먼트 매개변수, 승격, 매개변수 간 연결	references/effects/basement-promote-ropes.md
모든 모양(직사각형, 타원, 별, 다각형, 패스), 배열 및 그룹화	references/drawing/shapes.md
부품으로 구성된 캐릭터/객체: 관절로서의 앵커, 페어런팅, 피벗 또는 핸들로서의 널 객체(object.new {kind: "null"})	references/drawing/rigging.md
지도: 경계선, 도로, 핀, 경로, 링, 랜드마크 팝업, 화살표, 확대/축소	references/maps/maps.md
캡션 + VO, RTL/아랍어, Resolve 전달, 내보내기, 작업 루프	references/workflows/
무언가 오작동할 때	references/known-issues.md

모든 곳에 적용되는 효과 규칙: glow 강도 ≤ 0.8 (0.9는 클리핑, 1.0은 흰색으로 번아웃), 반경이 후광 범위를 설정합니다. 블러와 그림자는 히어로에만 깊이를 위해 사용합니다. 선에는 트림 그리기; UI 모양에는 26px의 softEdge, 주변광에는 160320px (references/effects/soft-edge.md, 페더 마스크 리빌 포함).

4. 완료라고 말하기 전에 확인하십시오

• 보기: 입장, 유지 및 퇴장 (carvercat_look). 측정: carvercat_inspect (timing, curves(오버슈트 및 안착), lint, expect, qc(플래시 확인)) 및 비 렌더링 헬퍼(measure.boxes, measure.overlaps {within: "safe"}, measure.contrast). 프리플라이트: 전송 전에 carve.preflight {host}.
• references/craft/review-checklist.md를 따라가십시오: 스토리, 타이밍, 텍스트, UI, 전환, 보기, 사운드, 위생.
• 먼저 대표 컴포지션 하나를 구축하고 검토한 다음 확장하십시오. 레시피는 시작점입니다: 브리핑과 푸티지에 맞게 계층, 이미지 및 타이밍을 조정하십시오. 안전 경계가 시각적 판단을 대체하지는 않습니다.
• 지연 또는 오디오 부족: references/app/performance.md.

5. 앱 외부에 있는 도구 (scripts/motion/, Python 3, 표준 라이브러리 + ffmpeg)

• vo_align.py: 음성 해설 → 단어 및 줄 프레임.
• sfx_kit.py / sfx_render.py: 합성 SFX (팝, 후시-히트, 틱, 임팩트...) → 큐당 하나의 WAV.
• music_bed.py: 컷에 맞는 배경 음악; mix_check.py: 스템 LUFS 및 참조 믹스.
• reformat.py: 16:9 프로젝트 → 9:16 컴포지션.
• carverproj.py: 프로젝트 JSON 헬퍼 (ID, 키).
• build_pattern_pack.py / comp_to_template.py: 팩 재생성.
• effects_param_tables.py: 효과 매개변수 테이블 재생성.
• ../maps/geo_paths.py / ../maps/map_overlay.py: 실제 지리 → 경로; 설명 오버레이 (핀, 링, 경로, 카드, 화살표).

6. 안전 및 전달

장면 ID(및 Scene.component 네임스페이스)를 사용하여 개정 시 동일한 객체를 업데이트하십시오. 동일한 문서를 다시 적용하면 차이점만 변경됩니다. 거부 후에는 이에 의존하는 작업을 중단하십시오. 알 수 없는 결과 후에는 추가 변경 전에 ID와 상태를 검사하십시오. 결과를 모르는 쓰기 또는 내보내기를 다시 재생하지 마십시오. Resolve 작업에는 사용자의 현재 권한이 필요합니다. 권한이 없으면 네이티브로만 작성하고 테스트하십시오. 권한이 부여되면 실제 프로젝트, 타임라인 및 포맷을 확인하고 원본 편집을 보존하며 복합 샘플을 검사하십시오. Carvercat 작업의 단위는 컴포지션입니다. Resolve 타임라인은 별개입니다. 전송 검사, 통합, 재배치 및 재링킹에 대해서는 references/app/media-recovery.md를 읽으십시오. 정리 참조 범위가 불완전한 경우 파일을 보관하십시오.

제작 참고 자료 뒤에 있는 아이디어에 대한 크레딧 및 라이선스: SOURCES.md.