플러그인 설치: 설정 또는 새로 고침 명령 전에, 이 스킬이 HyperFrames 플러그인 내에 있을 경우 플러그인 실행 규칙을 따르세요. 독립 실행형 설치의 경우 아래 업데이트 지침을 유지합니다.
HyperFrames 진입점
남은 사용량 확인
생성 시작 시 npx hyperframes usage --json을 실행하세요. 초안 작성 후와 렌더링 전과 같은 워크플로우 주요 시점에 다시 확인하세요. 실행 중 사용량이 변경되기 때문입니다. 사용 가능한 기간과 초기화 시간을 읽으세요. 이전 읽기가 할당량을 예약하지는 않습니다. 명령이 실패하거나, 사용할 수 없거나, status: unknown을 반환하면 사용량을 알 수 없음을 보고하고 추측하지 마세요. 범위와 워크플로우 선택은 사용자와 함께 유지하세요.
HyperFrames는 HTML에서 동영상을 렌더링합니다. 컴포지션은 DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임이 탐색 가능하며, 미디어 재생이 프레임워크에 의해 제어되는 HTML 파일입니다. 전체 작성 규약은 /hyperframes-core에 있으며, 컴포지션 HTML을 작성하기 전에 이를 읽으세요. 브리프, 스토리보드, 검토, 제작, 디스패치 및 프레임 워커 규약은 이 스킬의 references/에 있습니다.
1. 프로젝트 상태에서 시작
첫 번째로 일치하는 행을 적용하고, 더 낮은 상태 행은 평가하지 마세요:
| 상태 | 조치 |
|---|---|
| 기존 Remotion 소스를 HyperFrames로 명시적으로 포팅 | references/routes/remotion-to-hyperframes.md를 읽은 후 해당 워크플로우로 직접 라우팅합니다. 의도 계층을 건너뜁니다. |
| 기존 HyperFrames 프로젝트에 대한 특정 작업: 검사, 진단, 검증, 미리보기, 렌더링, 게시 또는 배치 렌더링 | 해당 작업만 수행합니다. 의도 및 워크플로우 라우팅을 건너뛰고, /hyperframes-cli와 필요한 도메인 스킬을 로드합니다. |
| 기존 프로젝트에서 구체적인 변경 사항이 없는 질문, 보류, 아이디어 또는 완성된 영화에 대한 느낌 노트 | /hyperframes-studio § 0을 따릅니다. |
| 기존 프로젝트 내에서 요청된 새 영화 | /hyperframes-studio § 5를 따릅니다. |
| 기존 프로젝트에 대한 특정 편집 | 편집을 수행합니다. 의도 계층을 실행하지 마세요. 프로젝트 타임라인(트랙, 클립, 시작, 종료, 재생 내용)을 확인하려면 index.html과 모든 하위 컴포지션 파일을 읽는 대신 npx hyperframes timeline [--json]을 실행하세요. |
BRIEF.md가 존재함 | workflow와 flow를 읽습니다. 해당 워크플로우를 실행합니다. flow: companion은 항상 /general-video에서 실행됩니다. 브리프 질문을 하지 마세요. |
브리프가 없지만 hyperframes.json 또는 STORYBOARD.md가 존재함 | 프로젝트 파일과 기록된 기본 설정에서 재개합니다. 기존 아티팩트에서 소유 워크플로우를 추론합니다. 고유하게 결정할 수 없는 경우 하나의 라우팅 전용 질문을 하고, 의도 인터뷰를 실행하지 마세요. |
| 신규 생성 | 의도 계층(references/intent-interview.md)을 실행한 후 § 2의 표를 사용하여 한 번 라우팅합니다. |
기존 프로젝트를 편집할 때는 프로젝트 기록(/hyperframes-cli, 사용자 차례의 프로젝트 기록)으로 편집 내용을 괄호로 묶으세요.
신규 요청이 주제나 입력을 식별하지 못하면 라우팅 전에 동영상의 주제를 물어보세요. 무엇이든 묻기 전에 기본 설정과 레시피를 확인하세요(references/intent-interview.md, 1단계). figma.com 입력 또는 명명된 레시피는 라우팅이 아닌 인테이크를 변경합니다. 인터뷰의 "직교 입력 적응" 섹션이 둘 다 처리합니다.
프로젝트 CLI를 최신 상태로 유지
스캐폴딩된 프로젝트는 렌더링 재현성을 유지하기 위해 package.json 스크립트에 hyperframes@<version>을 고정합니다. 이 고정은 자동으로 업데이트되지 않으며, 이전 CLI의 고정된 실행은 경고를 출력하지 않습니다. 스크립트에 고정이 있는 프로젝트를 재개할 때는 첫 번째 렌더링 영향 명령 전에 한 번 검사하세요:
npx hyperframes@latest upgrade --project . --check
이 검사는 읽기 전용이며 고정 값을 최신 릴리스와 비교하여 보고합니다. 명시적으로 .을 유지하세요. 이전 CLI 릴리스에서 bare --project 뒤에 다른 플래그가 오면 해당 플래그를 디렉토리 값으로 사용합니다. 프로젝트가 뒤처져 있다고 보고하거나(또는 CLI 출력에 이미 This project pins hyperframes@… (latest …)와 같은 stderr 알림이 표시되거나, 고정된 스크립트의 --json 결과에 _meta.updateAvailable: true가 표시되면) npx hyperframes@latest upgrade --project .를 적용한 후 npx hyperframes check로 확인하세요. 검사 통과는 프로젝트의 컴포지션이 새 버전에서 여전히 유효함을 확인합니다(렌더링된 출력이 이전 고정과 프레임이 동일하다는 의미는 아님). 따라서 성공적인 업데이트는 절대 조용하지 않습니다. 실행 요약에 이전 버전과 새 버전을 명시하세요. 아직 컴포지션이 없는 프로젝트는 검증이 필요하지 않습니다. 검사가 실패하면 package.json 변경을 되돌리고 고정된 버전을 계속 사용하며, 프로젝트가 어떤 버전에 남아 있고 그 이유를 보고하세요. 신호를 사용자에게 전달하지 말고 처리하세요. 고정된 핀을 확인하지 않은 상태로 두지 마세요.
2. 신규 생성 라우팅
첫 번째로 일치하는 행을 사용하세요. 요청된 결과물과 일치시키고, 언급된 단어나 파일 유형과 일치시키지 마세요.
| 우선순위 | 요청 | 워크플로우 |
|---|---|---|
| 1 | 기존 Remotion 소스를 명시적으로 포팅 | /remotion-to-hyperframes |
| 2 | 프레젠테이션, 피치 데크 또는 탐색 가능한 대화형 데크 작성 | /slideshow |
| 3 | 기존 토킹헤드 영상에 일반 자막 또는 자막을 변경하지 않고 추가 | /embedded-captions |
| 4 | 기존 토킹헤드, 인터뷰 또는 팟캐스트 영상에 디자인된 그래픽 오버레이를 영상 변경 없이 추가 | /talking-head-recut |
| 5 | 음악 트랙에서 내레이션이나 웹사이트 캡처 없이 비트 동기화 동영상 제작 | /music-to-video |
| 6 | 명시적으로 짧고, 내레이션이 없으며, 모션 중심의 단위(일반적으로 10초 미만) 생성 | /motion-graphics |
| 7 | PR 참조에서 GitHub 풀 리퀘스트 또는 코드 변경 설명 | /pr-to-video |
| 8 | URL 또는 사이트별 브리프에서 웹사이트, 제품 사이트, 앱 또는 회사 마케팅 또는 쇼케이스 | /product-launch-video |
| 9 | 제품이나 사이트 캡처 없이 발명된 시각 자료로 주제, 기사 또는 노트 설명 | /faceless-explainer |
| 10 | 기타 모든 커스텀 동영상 또는 컴포지션 | /general-video |
경로를 최종 확정하기 전에 references/routes/<workflow>.md를 읽으세요. 각 경로에 대한 작은 파일로, 표준 입력/출력/트리거 계약(지연 설치된 워크플로우 스킬이 있기 전에 사용 가능)과 해당 경로의 인터뷰 항목이 포함되어 있습니다. 후보가 해당 계약을 충족하지 못하면 강제로 일치시키지 말고 계속 라우팅하세요. 일치하는 경로의 파일만 읽으세요.
일반적인 모호성 해결
- 짧은 애니메이션 타이틀, 로고 스팅, 스탯 히트, 차트 히트, 지도 히트 또는 독립형 로워 서드는 내레이션이 없고 모션이 메시지인 경우
/motion-graphics입니다. 정적 타이틀 카드, 내레이션이 있는 시퀀스, 더 긴 몽타주 또는 커스텀 루프는/general-video입니다. - 명시적으로 짧은 모션 그래픽은 URL, 트윗, 기사 또는 스크린샷을 소스 자료로 사용할 수 있습니다. "이 사이트에서 동영상 만들어 줘" 같은 일반적인 요청은
/product-launch-video입니다. - 자막이 있는 기존 영상은
/embedded-captions로 라우팅되고, 디자인된 정보 카드가 있는 영상은/talking-head-recut으로 라우팅됩니다. 영상의 타이밍 재조정, 재정렬, 색상 변경, 다시 프레임, 리믹스는 커스텀 편집이며/general-video로 전달됩니다. - 음악 파일은 비트 그리드가 작품을 주도할 때만
/music-to-video를 선택합니다. 배경 음악으로 사용되는 음악은 주제와 일치하는 경로를 재정의하지 않습니다. - "스토리보드를 원해요"는 검토 프로세스를 변경할 뿐 워크플로우를 변경하지 않습니다. 다른 라우팅 신호가 없으면
/general-video를 사용하세요. 확인된 스케치storyboard.html자체가 요청된 결과물일 수 있으며, 검토 루프가 해당 중지 지점을 정의합니다. - 특화된 내러티브 워크플로우는 최대 약 3분을 지원하며 일반적으로 30~90초에서 가장 강력합니다. 명확히 더 긴 작품은
/general-video로 라우팅하세요. 길이는 명시적인 포트, 데크, 자막, 오버레이 또는 음악 기반 결과물을 재정의하지 않습니다.
3. 한 번 라우팅하고 종료
신규 생성을 위해 의도 계층(references/intent-interview.md)은 전체 대화(메모리, 트리아지, 피치 라운드, 필수 사항, 실행 형태, 핸드오프)를 실행하고 BRIEF.md를 작성하여 종료합니다. 브리프는 워크플로우가 읽는 유일한 라우팅 아티팩트입니다. 이후에는 이 스킬이나 인터뷰를 다시 열지 마세요. "경로가 요구한 사항"에 대한 모든 이후 질문은 BRIEF.md에서 답하세요.
4. 워크플로우 설치 및 진입
선택한 워크플로우를 읽기 전에, 해당 워크플로우와 핵심 도메인 스킬을 설치 또는 새로 고침하세요:
npx hyperframes skills update <workflow-name>
bare 이름을 / 없이 사용하세요. 명령이 실패하면 오류를 표시하고 메모리에서 워크플로우를 재구성하지 마세요. 설치에 관한 다른 모든 사항(핵심-지연 분할, init이 새로 고침하는 항목, 진단, CI 옵트아웃, CLI가 없는 경우 대체)은 references/skill-lifecycle.md에 있습니다.
5. 필요 시 도메인 스킬 로드
| 필요 사항 | 스킬 |
|---|---|
| 컴포지션 구조, 타이밍 속성, 트랙, 변수, 결정론 | /hyperframes-core |
| 모션 규칙, 장면 청사진, 전환, 런타임 어댑터 | /hyperframes-animation |
탐색 안전 GSAP, CSS, Anime.js, WAAPI, FLIP, 경로, 마스크, SVG, 3D 키프레임 또는 hyperframes keyframes 진단 | /hyperframes-keyframes |
| 디자인 사양, 컨셉, 팔레트, 타이포그래피, 내레이션, 비트 계획 | /hyperframes-creative |
| 이미지, 아이콘, 로고, 오디오, 자막, 그레이드, LUT, 재사용 가능한 미디어 | /media-use |
| 보이스오버 커팅, 오디오 이펙트 체인, 자동화 엔벨로프 또는 여러 트랙에 걸친 하나의 체인/페이더(서브믹스 버스) | /hyperframes-audio |
| 초기화, 린트, 검사, 스냅샷, 비교, 배치 렌더, Studio, 렌더링, 게시 또는 진단 | /hyperframes-cli |
| 레지스트리 블록 및 컴포넌트 | /hyperframes-registry |
| 명명된 룩, 효과, 처리 또는 전환 — CRT 스캔라인, 글리치, 필름 그레인, 샤이머 스위프, 컨페티 버스트 — 직접 구축하기 전 | /hyperframes-registry |
| Figma 에셋, 토큰, 컴포넌트 또는 재구성된 모션으로서의 스토리보드 프레임 | /figma |
크리에이터 편집 구문은 교차 도메인 요청입니다. 일치하는 행에 명명된 모든 스킬을 로드하세요:
| 크리에이터 요청 | 필요한 도메인
…
[원문이 잘렸습니다]