RoleModel HyperFrames 브랜드
이미 HyperFrames 도구가 깊이 설치되어 있습니다. 처음부터 시작하지 말고 그 도구 목록에서 출발하세요. 이 스킬은 그 위에 브랜드 레이어만 추가합니다: 가치의 출처, 어떤 것을 사용할지, 그리고 하지 않는 일들.
도구 목록
두 세트가 설치되어 있으며, 이름이 겹칩니다. 어떤 것을 호출하는지 알아야 합니다.
공식 (HeyGen), ~/.claude/skills:
| 스킬 | 사용时机 |
|---|---|
hyperframes | 구성 작성, 타이밍, 미디어, 제작 워크플로 |
hyperframes-core | 구성 계약 및 data-* 타이밍 속성 |
hyperframes-animation | 모션 규칙, 씬 청사진, GSAP 및 기타 런타임 |
hyperframes-keyframes | 확대/축소, 카메라 이동, 재구성, seek-safe 키프레임 |
hyperframes-creative | 팔레트, 비트 계획, 내레이션, 구성 패턴 |
hyperframes-audio | 이미 배치된 트랙 믹싱 — 페이드, 덕킹, 오토메이션 |
hyperframes-cli | 초기화, 린트, 점검, 미리보기, 렌더링, 자막, TTS |
hyperframes-registry | 블록 및 컴포넌트 설치 |
media-use | 음악, SFX, 이미지, 음성 소싱 또는 생성 |
표준 (우리 것), ~/.claude/skills/synced:
| 스킬 | 사용时机 |
|---|---|
hyperframes | 우리 자체 구성 스킬 — design.md, house-style.md 읽음 |
hyperframes-cli | 우리 자체 CLI 노트 |
hyperframes-direction-harness | 방향이 확정되지 않았을 때 최종 index.html 작성 전에 |
optics-context | 제품 표면도 함께 다뤄야 할 때 |
gsap | GSAP 세부 사항 |
impeccable | 우리의 제작 기준 |
이름 충돌.
hyperframes와hyperframes-cli는 두 세트에 모두 존재합니다. 어떤 것을 가져올지가 중요할 때는 명시적으로 말하세요.
여기에 그들의 규칙을 다시 서술하지 마세요. 구성 계약, 린트 오류, 트랙 충돌, 일시 정지된 타임라인 — 모두 해당 스킬에 속하며 거기서 유지됩니다. 사본을 만들면 업스트림에서 릴리스가 나올 때마다 차이가 생기고 아무도 눈치채지 못합니다. 규칙이 누락되었다면 이 파일이 아니라 업스트림에서 수정하세요.
브랜드가 design.md를 통해 HyperFrames에 도달하는 방식
표준 hyperframes 스킬은 이미 프로젝트 루트의 design.md를 *"브랜드 색상, 폰트, 제약 조건의 진리 원천"*으로 읽고, 정확한 값을 사용하도록 지시받습니다. 그것이 연결 고리입니다. 사용하세요.
브랜드 저장소에서 하나를 생성합니다:
cp rolemodel-brand/dist/design.md <video-project>/design.md
이 파일은 rolemodel-brand/tokens/brand.json에서 scripts/build-tokens.mjs로 생성되므로, 다른 RoleModel 표면에서 사용하는 토큰과 불일치할 수 없습니다. 직접 편집하지 마세요 — brand.json을 변경하고 다시 실행하세요.
이 파일에는 색상, 타이포그래피, 전체 모션 스케일, 네 가지 모션 원칙, 그리고 아래의 제약 조건이 포함됩니다. 프로젝트에 추가되면 기존 스킬이 나머지를 처리합니다.
구성 자체의 CSS 사용자 정의 속성:
<link rel="stylesheet" href="rolemodel-brand/css/academy-theme.css">
<body data-theme="academy">
모션 토큰 선택
전체 값은 design.md에 있습니다. 선택 규칙은 짧습니다:
요소가 어떻게 보이는지가 아니라 무엇을 하는지에 따라 선택하세요.
- 무언가가 도착할 때 →
--duration-base+--ease-enter - 같은 것이 사라질 때 →
--duration-fast+--ease-exit. 떠나는 것은 항상 도착하는 것보다 빠릅니다. - 이미 화면에 있는 것이 위치나 크기를 바꿀 때 →
--ease-move - 의도적인 주목 유도 →
--ease-emphasis, 오버슈트가 허용되는 유일한 곡선 - 그룹 → 형제 요소 간에 하나의
--stagger, 절대 동시에 하지 않음
구성에 원시 지속 시간이나 원시 cubic-bezier를 절대 작성하지 마세요. 스튜디오가 색상에 적용하는 동일한 규칙입니다.
하지 않는 일
다음은 필수 사항입니다. 몇 가지는 툴킷의 npm run check로 강제되며, 모두 구성 스킬이 읽을 design.md에 있습니다.
- 방사형 그라데이션은 절대 사용하지 않음. 브랜드는 선형입니다 — 방향, 덩어리가 아닙니다.
- 프레임 와이프 없음. 씬 전환으로 흰색 또는 밝은 선 프레임, 테두리, 상자를 그리지 마세요. Claude는 프롬프트 없이도 이것을 사용합니다; 이는 템플릿 장식에 불과하며 우리 것이 아닙니다. 주의를 아무것도 향하지 않습니다. 컷으로 전환하거나,
--ease-enter로 들어오는 콘텐츠를 드러내세요. 프레임 주위에 상자를 그리지 않습니다. - 장식선, 밑줄, 구분선 없음. 제목에 밑줄을 긋거나, 섹션 사이에 키라인을 넣거나, 카드, 통계, 인용문, 하단 써드 주위에 테두리를 그리지 마세요. Claude는 구조를 나타내기 위해 이것을 사용합니다; 그것은 무언가가 추가되었음을 나타낼 뿐입니다. 분리는 공간, 무게, 배경에서 옵니다. 시스템에서 유일하게 허용된 규칙은 제목 아래의 짧은 브랜드 바이며,
rm-title이 그립니다 — 두 번째 것을 직접 추가하지 마세요. - 가장자리는 단색 테두리이며, 페이드가 아닙니다. 이것은 필요한 가장자리를 그리는 방법을 규정할 뿐, 추가할 권한을 주지 않습니다. 가장자리 없이도 모호하지 않다면, 가장자리는 없습니다.
- 주황색은 강조색일 뿐 — 배경으로 사용하지 마세요.
- 장식 없음. 요소가 정보를 전달하거나 주의를 유도하지 않으면 제거하세요.
방향이 확정되지 않았을 때
index.html 작성을 시작하지 마세요. hyperframes-direction-harness를 사용하세요 — 정확히 이를 위해 만들어졌으며, 구성 전에 검토 가능한 보드를 생성합니다:
01_intake.md → 02_design_direction.md → 03_critical_frame_plan.md
→ direction_board.html (Director Workbench, 검토)
→ 04_render_plan.md (검토 후에만 준비)
→ hyperframes 스킬에 전달
기존 구성의 작은 수정(오타, 타이밍 조정, 색상 하나, 린트 수정)에 대해서만 우회하세요.
어떤 도구가 어떤 문제를 해결하는가
HyperFrames는 구성합니다; 캡처하지 않습니다. 영상이 실제 제품 UI를 보여줘야 한다면, 잘못된 도구입니다.
| 입력 | 도구 | 최신 상태 유지? | |
|---|---|---|---|
| 녹화 | 화면 | openscreen | 아니요 — 수동으로 다시 녹화 |
| 구성 | 스크립트 또는 브리프 | HyperFrames | 브리프 재실행 |
| 테스트에서 | Playwright 트레이스 | playwright-recast | 예 — 테스트 재실행 |
캡처 위에 올라가는 타이틀 카드, 하단 써드, 모션 그래픽에는 HyperFrames를 사용하세요.
내레이션, 타이밍, 전달
구성 내에서 내레이션을 합성하지 마세요.
rm-voice <project> --script opener --voice af_nova
한 줄에 한 클립, 각각 측정된 SRT가 이미 알려진 지속 시간에서 작성되므로 타이밍이 정확하며, 복사 편집은 변경된 부분만 다시 합성합니다. Kokoro는 로컬에서 실행됩니다: API 키가 필요 없으며, 미출시 클라이언트 제품에 대한 정보는 기계를 떠나지 않습니다.
렌더와 내레이션 트랙은 다른 시계를 사용합니다. playwright-recast는 유휴 시간을 압축합니다; 내레이션은 단어가 걸리는 시간만큼 길어집니다. 22초 자막 트랙을 3.8초 렌더에 구우면 큐 1이 전체 클립 동안 대기하고 나머지는 조용히 드롭됩니다 — 작동한 것처럼 보입니다.
rm-mux --video demo.mp4 --audio narration.wav --srt narration.srt -o final.mp4
rm-share final.mp4 --project "Ridgeline Railing"
rm-share는 클라이언트가 계정 없이 열고 타임스탬프가 찍힌 댓글을 남길 수 있는 링크를 반환합니다. rm-share --check는 구성 여부를 알려줍니다.
클라이언트 프로젝트 전
export HYPERFRAMES_NO_TELEMETRY=1
텔레메트리는 기본적으로 켜져 있습니다. 프로젝트 이름과 비디오 콘텐츠는 수집되지 않지만, hyperframes auth login은 HeyGen 계정 이메일을 사용량에 연결하고 이전 익명 활동을 연결합니다. 스캐폴딩에서 옵트아웃을 설정하세요.
버전을 고정하세요. HyperFrames는 Apache-2.0입니다 — 시트 수, 회사 규모 제한이 없어 기본값이지만, 1.0 미만이며 명시된 호환성 보장 없이 거의 매일 릴리스됩니다. 오늘 렌더링되는 클라이언트 프로젝트는 6개월 후에도 동일하게 렌더링되어야 합니다.
크레딧
세 가지 수준의 프레이밍과 컷 → 스토리보드 → 모션 그래픽 파이프라인은 CC BY 4.0 라이선스로 사용된 RoboNuggets의 Jay의 hyperframes-helper에서 가져왔습니다. 이 내용을 재공유할 경우 저작자 표시를 유지하세요 — 이것이 라이선스 조건입니다.