general-video — 일반 합성 제작
빌드 전에 경로를 확인하세요. 이는 사용자 지정 합성 제작을 위한 **폴백(fallback)**입니다. 입력이 특화된 워크플로우에 명확히 맞는 경우, 해당 워크플로우를 우선 사용하세요: 마케팅 제품 →
/product-launch-video; 일반 사이트 →/website-to-video; 주제 설명 →/faceless-explainer; GitHub PR →/pr-to-video; 기존 영상 →/embedded-captions·/graphic-overlays; 짧은 내레이션 없는 모션 그래픽 →/motion-graphics; Remotion 포팅 →/remotion-to-hyperframes. 범위 밖: 실시간/렌더 시점 데이터, 완성된 비디오의 NLE 스타일 편집, 또는 HyperFrames가 캡처할 수 없는 영상 제작. 확실하지 않다면? 먼저/hyperframes를 읽으세요.
정확히 요청된 대로 빌드하세요. 타이틀 카드는 타이틀 카드일 뿐입니다 — 타이틀 카드 + 세 개의 추가 장면 + 배경 음악 + 자막이 아닙니다. 추가 장면이나 요소가 작품을 진정으로 향상시킨다면 _제안_하세요; 조용히 추가하지 마세요. 작은 수정(색상 수정, 하나의 지속 시간 조정, 한 요소 추가)의 경우 계획 단계를 건너뛰고 바로 빌드하세요.
접근 방식
탐색 — 개방형 요청 전용
모호하고 탐색적인 요청( "브랜드를 위한 무언가 만들어 주세요", "멋진 인트로")의 경우 — 색상을 고르기 전에 의도를 이해하세요:
- 대상 — 누가 시청하나요? 개발자 / 임원 / 일반 소비자?
- 플랫폼 — 어디에서 재생되나요? 소셜(15초) / 웹사이트 히어로 / 제품 데모 / 내부용?
- 우선순위 — 무엇이 가장 중요한가요? 모션 품질 / 콘텐츠 정확성 / 브랜드 충실도 / 속도?
- 변형 — 하나의 최선 버전, 또는 의미 있게 다른 2-3개의 옵션(페이스, 에너지 또는 구조가 다른 — 단순한 색상 변경이 아닌)?
구체적인 요청( "타이틀 카드 추가", "장면 3의 타이밍 수정")의 경우 탐색을 건너뛰세요.
1단계 — 디자인 시스템 → hyperframes-creative
먼저 시각적 아이덴티티를 확립하세요. 프로젝트에 디자인 스펙이 있다면 그것을 읽으세요(우선순위 frame.md → design.md → DESIGN.md; 정확한 색상, 글꼴, 제약 조건을 담은 브랜드 진실로 취급하세요).
스펙이 없는 경우, 색상이나 글꼴을 선택하기 전에 반드시 hyperframes-creative/references/house-style.md와 hyperframes-creative/references/video-composition.md를 모두 읽어야 합니다. house-style.md는 "프롬프트 해석 / 실제 콘텐츠 생성" 시작점, lazy-default 목록, 레이어 레시피를 제공합니다. video-composition.md는 비디오-매체의 밀도 / 스케일 / 전경 디테일(데이터 막대, 등록 표시, 고정폭 메타데이터, "8-10개 요소, 사용자가 요청하지 않은 두 가지")을 제공하며, 이는 "제작된" 결과물과 "생성된" 결과물을 구분합니다. 하나만 읽는 것이 가장 흔한 실수입니다 — video-composition.md는 에이전트가 건너뛰는 문서이며, 평평하고 중앙 정렬된 웹 페이지 같은 출력을 방지하는 바로 그 문서입니다. 스스로 팔레트를 발명하고 이것들을 건너뛰지 마세요; hyperframes-creative로 진입하는 것은 선택적 분기가 아니라 필수입니다. 거기서 필요에 따라 명명된 스타일/분위기 → references/visual-styles.md, 또는 대화형 선택기 → references/design-picker.md도 참고하세요. 스펙/스타일은 브랜드를 정의하며, 합성 규칙을 정의하지 않습니다.
각도 찾기 (모호한 브리프, 스펙 없음): 색상을 고르기 전에, 한 문장을 쓰세요 — 이 이름/단어/주제가 무엇을 연상시키며, 어떤 시각적 세계(은유, 설정, 도구, 모티프)가 그것을 표현하나요? 예: 사이버 보안 도구 → 금고 문 / 경계 스캔 라인 / 자물쇠 텀블러; 명상 앱 → 밀물, 호흡, 느린 빛의 확산. 대상의 _의미_를 읽고, 문자 그대로의 재스타일링보다 구체적인 각도를 선택하세요. 이는 확장이 올바르게 생략되는 단일 장면 작품에서 프롬프트 확장(2단계)의 저렴한 대체물이며 — 디자인된 컨셉과 그라데이션 위의 일반 로고의 차이입니다.
<하드-게이트> 어떤 합성 HTML을 작성하기 전에, 다음 네 가지를 모두 확인했는지 검증하세요:
- 시각적 아이덴티티 — 스펙 또는
house-style.md에 근거하며, 즉석에서 발명된 것이 아닙니다. (#333,#3b82f6, 또는Roboto를 사용하고 있나요? 건너뛴 것입니다.) - 한 문장의 컨셉 각도 ( "각도 찾기" 단계) — 사소한 편집 이상의 작업에 대해, 프롬프트 단어의 문자 그대로의 재스타일링이 아닙니다.
- 임베드 목록의 글꼴 페어링 (
hyperframes-creative/references/typography.md→ "임베드되는 글꼴") — 목적을 가지고 선택했으며, 기본적으로Inter/Helvetica Neue/system-ui가 아니고, 임베드되지 않은 디스플레이 글꼴을 그냥 렌더링되길 바라며 사용하지 않습니다(번들되지 않은 이름은 로컬에서 자동 캡처되는 경우에만 임베드되며, 클라우드 렌더는 캡처하지 않습니다). video-composition.md의 전경/밀도 계획 — 모서리 앵커, 8-10개 요소, 전경 메타데이터, 배경 텍스처 규칙. (평평한 색상 위에 중앙 정렬된 스택에 ~6개 미만의 요소와 모서리 앵커 디테일이 없나요? 건너뛴 것입니다 — 그것이 일반적인 신호입니다.) </하드-게이트>
2단계 — 프롬프트 확장 → hyperframes-creative
모든 여러 장면 합성에 대해 실행하세요(단일 장면 작품과 사소한 편집은 건너뜁니다). 디자인 스펙 + 하우스 스타일을 기준으로 요청을 일관된 중간 표현으로 변환하여, 다운스트림 작업이 동일하게 읽히도록 합니다. hyperframes-creative/references/prompt-expansion.md 참조.
3단계 — 계획
HTML을 작성하기 전에, 높은 수준에서 생각하세요:
- 무엇 — 시청자 경험: 내러티브 아크, 핵심 순간, 감정적 비트.
- 구조 — 얼마나 많은 합성, 서브-컴포지션 vs 인라인, 어떤 트랙이 비디오/오디오/오버레이/자막을 전달하는지. 모놀리식 단일 파일 vs 모듈식 서브-컴포지션 호출은
hyperframes-core/references/composition-patterns.md§ 두 가지 아키텍처 참조 (경험 법칙: ≥3개의 하드 씬 컷, 또는 재사용되는 씬 → 모듈화; 짧은 단일 장면은 하나의 파일 유지). - 리듬 — 구현하기 전에 패턴에 이름을 붙이세요 (예:
빠름-빠름-느림-셰이더-홀드);hyperframes-creative/references/beat-direction.md참조. - 타이밍 — 어떤 클립이 지속 시간을 결정하는지, 전환이 어디에 위치하는지, 페이싱.
- 레이아웃 — 먼저 최종 상태를 빌드하세요 (아래 참조).
- 애니메이션 — 그런 다음
hyperframes-animation을 통해 모션을 추가하세요.
애니메이션 전 레이아웃
각 요소를 가장 눈에 띄는 순간 — 완전히 진입하고, 올바르게 배치되고, 아직 나가지 않은 상태 — 에서의 위치에 배치하세요. 먼저 정적 HTML + CSS로 작성하세요. 아직 GSAP 없음.
이유: 요소를 애니메이션 시작 상태(화면 밖, 0으로 스케일, 투명도 0)에 배치하고 도달할 위치로 트윈하면 최종 레이아웃을 추측하는 것입니다 — 겹침은 렌더링될 때까지 보이지 않습니다. 먼저 최종 상태를 빌드하면 모션을 추가하기 전에 레이아웃 문제를 보고 수정할 수 있습니다.
- 각 장면의 히어로 프레임을 식별하세요 — 가장 많은 요소가 동시에 보이는 순간. 그것이 당신이 빌드할 레이아웃입니다.
- 해당 프레임에 대한 정적 CSS를 작성하세요. 콘텐츠 컨테이너는 절대 오프셋이 아닌 패딩으로 장면을 채워야 합니다:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 패딩이 콘텐츠를 배치합니다; 어떤 장면 크기도 채웁니다 */
gap: 24px;
box-sizing: border-box;
}
콘텐츠 컨테이너에 position: absolute; top: Npx를 절대 사용하지 마세요 — 콘텐츠가 공간보다 더 길면 오버플로됩니다. 절대 위치 지정은 장식용으로만 예약하세요.
⚠ 위의
width/height: 100%는 모든 조상이 해결된 높이를 가질 때만 작동합니다. 루트<div data-composition-id>와 그와.scene-content사이의 모든 래퍼는 크기가 지정되어야 합니다(루트에position: relative; width: 1920px; height: 1080px—hyperframes-core→ "루트는 크기가 지정되어야 함" 참조). 이것을 건너뛰면 플렉스 컨테이너가 약 0으로 축소되고, 콘텐츠가 왼쪽 상단 모서리에 쌓이며, 첫 번째 글리프가 x=0에서 잘립니다 — 반면lint/inspect는 여전히 0개의 문제를 보고합니다. 그리고 항상.scene-content에padding(≥80px)을 유지하세요: 이것은 타이틀-세이프 여백입니다. 절대 벌거벗은gap으로 대체하지 마세요.
- 진입 추가 —
gsap.from()을 사용하여 CSS 위치를 향해 화면 밖/보이지 않는 상태에서 애니메이션합니다 (서브-컴포지션에서는 시작 상태가 명시적이도록gsap.fromTo()를 선호합니다;hyperframes-core/references/sub-compositions.md참조). CSS 위치는 기본 진실입니다; 트윈은 그곳으로의 여정입니다. - 종료는 전환으로 처리됩니다 —
hyperframes-animation/transitions/의 씬 전환 규칙에 따라, 마지막 장면만 요소를 밖으로 애니메이션합니다; 장면 사이에서 전환 자체가 종료입니다.
시간을 가로지르는 공유 공간: 요소 A가 요소 B가 같은 영역에 들어오기 전에 나간다면, 둘 다 각자의 히어로 프레임에 대해 올바른 CSS 위치가 필요합니다 — 타임라인 순서가 공존을 방지하고, 레이아웃 단계가 의도치 않은 겹침을 잡아냅니다. 레이어된 글로우/섀도우와 z-스택 깊이는 의도적인 겹침입니다; 이 단계는 의도하지 않은 충돌(두 개의 헤드라인이 서로 위에, 콘텐츠가 프레임 밖으로 번짐)을 잡는 것입니다.
빌드 — 도메인 스킬에 위임
이 스킬의 전체 표면(설명 참조)을 참조에 매핑합니다 — 완전하지 않음; 의도가 나열되지 않은 경우 hyperframes-creative (모양/컨셉), hyperframes-animation (모션), hyperframes-core (계약), hyperframes-media (오디오/자막)을 통해 라우팅하세요. 첫 번째 행은 추가적입니다 — 그것과 당신의 의도 행을 모두 읽고, 하나만 읽지 마세요.
| 빌드… | 먼저 읽기 (순서대로) |
|---|---|
| 항상 — 모든 중요한 작품에 대해, 아래 의도 행에 더하여 | hyperframes-creative/references/house-style.md + references/video-composition.md (또한 1단계 / 하드-게이트에서 게이트됨; "생성된 것이 아닌 제작된" 전경 디테일) |
| 키네틱 타이포그래피 / 텍스트 중심 | hyperframes-animation/techniques.md (키네틱 타입) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 타이틀 카드 / 로우써드 / 오버레이 / PiP / 텍스트 뒤 피사체 | hyperframes-creative/references/composition-patterns.md + (중앙/크기 조정 프레임의 경우) hyperframes-core → "루트는 크기가 지정되어야 함" |
| 로고 / 브랜드 마크 리빌 | hyperframes-animation/rules/svg-path-draw.md (드로우 온) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 데이터 / 통계 / 숫자 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 제품 / 앱 / UI 데모 | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 오디오 반응형 / 음악 기반 | hyperframes-creative/references/audio-reactive.md (밴드 미리 추출; 모션에 매핑) |
| 내레이션 / 보이스오버 / 자막 / 자막(subtitles) | hyperframes-media (tts, transcribe, 자막 제작) → hyperframes-core를 통해 자산 배치 |
| 여러 장면 / 전환 | hyperframes-animation/transitions/overview.md 그 다음 transitions/catalog.md (개요만으로 끝나지 않음 — GSAP 레시피는 카탈로그에 있음) |
| 모듈식 / 서브-컴포지션 | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
출력 체크리스트 → hyperframes-cli
-
npx hyperframes lint및npx hyperframes validate통과 (결과에 따라 차단) - 스펙(
frame.md/design.md)이 존재하면 디자인 준수 확인 — 체크리스트는hyperframes-creative/references/design-adherence.md -
npx hyperframes inspect통과, 또는 모든 오버플로가 의도적으로 표시됨 - 대비 경고 처리됨; 여러 장면 작업의 경우 애니메이션 맵(
hyperframes-animation/scripts/animation-map.mjs) 검토 - 미리보기 제공; 명시적 요청 시에만 MP4로 렌더링
- 핸드오프 시에만 미리보기 표시 (안정적이고 최종 미리보기임); 빌드 중간에 팝업하지 마세요 — 빌드 단계 스냅샷은 headless입니다
이 워크플로우가 아닌 경우
- 마케팅/런칭/프로모션되는 특정 제품 / 회사 / SaaS / 웹사이트 →
/product-launch-video - 설명되는 컨셉 / 주제 / 기사 / X 작동 방식, 제품 없음 →
/faceless-explainer - GitHub PR / 코드 변경 →
/pr-to-video - 자막을 추가할 기존 토킹헤드 비디오 →
/embedded-captions - 기존 Remotion 합성 포팅 →
/remotion-to-hyperframes - 완성된 비디오 파일을 NLE처럼 편집/커팅 → 범위 밖 (HyperFrames는 HTML과 미디어를 결정론적 타임라인으로 합성하며, 영상을 편집하지 않습니다)