웹사이트를 하이퍼프레임으로
웹사이트를 캡처하여 전문적인 동영상으로 제작합니다.
0단계 전에 경로를 확인하세요. 이 스킬은 일반 웹사이트를 활용하여/로부터 동영상을 만듭니다. 사용자가 실제로 제품을 마케팅/런칭/홍보하는 경우(해당 URL에서 가져온 경우라도 "당사 사이트 홍보"를 포함) →
/product-launch-video를 이용하세요. 사이트 없이 주제 설명 →/faceless-explainer; GitHub PR →/pr-to-video; 기존 동영상 파일 재편집/색상 재조정/순서 변경 → 범위를 벗어납니다. "동영상 만들어 줘"와 같은 모호한 요청이나 런칭인지 일반 사이트인지 확실하지 않은 경우? 먼저/hyperframes를 읽으세요 (전체 라우팅 테이블 + § HyperFrames로 할 수 없는 일).
사용자들이 보통 이렇게 말합니다:
- "이 웹사이트를 인스타그램용 15초 소셜 클립으로 바꿔줘"
- "https://... 에서 30초짜리 사이트 투어/쇼케이스를 만들어줘"
- "우리 홈페이지를 캡처해서 비주얼 그대로 동영상으로 만들어줘"
워크플로우는 7단계로 구성됩니다. 각 단계는 다음 단계로 넘어가기 위한 아티팩트를 생성합니다. 기본적으로 협업 방식이며, 💬로 표시된 게이트는 사용자에게 멈춰서 질문합니다. 사용자가 자율 모드("알아서 결정해 줘", "놀라게 해 줘")를 요청하면, 💬 사용자 선호도 게이트는 건너뜁니다. 이것이 어떻게 전파되는지는 step-2-brief.md를 참조하세요.
자율 모드가 "모든 게이트를 건너뛴다"는 의미는 아닙니다. 자동 모드는 사용자 선호도 질문(TTS 공급자, 음성, 색상 강조, 비트 수, 배경음악 유무, 자막 유무 등 에이전트가 사용자를 대신해 결정하는 항목)을 다룹니다. 품질 검증 게이트는 다루지 않습니다. 자동 모드에서도 다음은 건너뛸 수 없습니다:
- 자산 감사(3단계) – 콘택트 시트를 보고 각 자산에 대한 사용/건너뛰기 결정 이유 설명
- 비트별 HTML 읽기(5단계) – 비트별로 구조화된 증거 블록 제공
- DoD 체크리스트(6단계) – 애니메이션 맵, 경고별 WCAG 검증, 오디오/모션 재생 포함
- 정직한 공개 섹션(6단계) – "내가 확인하지 않은 것"이 최종 요약에 반드시 포함되어야 함
"자동 모드가 행동 선호를 강조하니까 X는 건너뛰어도 되겠다"고 생각한다면, 그리고 그 X가 검증 게이트(선호도 질문이 아닌 경우)라면, 그 추론은 잘못된 것입니다. 행동 선호는 무엇을 만들지 결정하는 데 적용되는 것이지, 검증할지 여부를 결정하는 데 적용되는 것이 아닙니다.
0단계: 브랜드 캡처 및 이해
참고: references/step-0-capture.md
사이트를 캡처한 다음 추출된 데이터를 읽어 브랜드와 제품을 이해합니다 – 무엇을 하는지, 누구를 위한 것인지, 어떤 어조로 말하는지, 어떤 분위기를 지니는지. 캡처된 자산은 나중에 사용할 브랜드 툴킷이지, 동영상을 구성하는 기본 요소는 아닙니다.
게이트: 사이트 요약 출력 – 자산/색상/폰트 목록보다 먼저 전략 우선(제품이 무엇을 하는지, 누구를 위한 것인지, 브랜드 어조)으로 작성.
1단계: 브랜드 아이덴티티
참고: references/step-1-design.md
DESIGN.md 작성 – 시각적 아이덴티티(색상, 타이포그래피, 컴포넌트 스타일, 레이아웃 원칙)를 다루는 브랜드 치트 시트. 정확한 계산 값은 design-styles.json을 사용하세요.
속도 옵션: 빠른 템포의 동영상(비트당 빌보드 스타일)의 경우 DESIGN.md는 색상 + 폰트 + Do/Don't 목록으로 구성된 50줄 요약본이면 충분하며, 300줄 분량의 문서는 필요 없습니다. 5단계의 하위 에이전트 프롬프트가 브랜드 값을 직접 붙여넣기 때문에 DESIGN.md의 깊이는 복잡한 구성에만 중요합니다.
게이트: 최소한 색상 팔레트, 폰트 선택, Do/Don't를 포함하는 DESIGN.md 파일이 존재하는 것.
2단계: 전략 및 메시징
참고: references/step-2-brief.md, references/capabilities.md (목차 스캔 – 필요할 때만 심층 섹션 참조)
시각적 요소나 자산을 논의하기 전에 사용자와 동영상이 전달해야 할 메시지에 대해 합의합니다. 사용자의 프롬프트를 분석하세요 – 아마 이미 동영상 유형과 스타일을 제시했을 것입니다. 빠진 것만 질문하세요: 이 동영상이 반드시 전달해야 할 한 가지, 내러티브 아크, 그리고 대상 청중.
게이트: 동영상 유형, 길이, 형식, 그리고 결정적으로 메시지와 내러티브 아크가 확정되어야 합니다. 이것들이 없으면 3단계에서 컨셉 중심의 스토리보드를 작성할 수 없습니다.
3단계: 스토리보드 + 스크립트 💬
참고: references/step-3-storyboard.md
스토리보드를 컨셉 중심으로 작성하세요: 메시지 → 내러티브 아크 → 아크를 구성하는 비트 → 비트별 기법 → 마지막에 브랜드 강조점 적용. 그런 다음 이에 맞는 내레이션 스크립트를 작성합니다. 비트별 요약과 함께 사용자에게 제시하고 승인할 때까지 반복합니다.
게이트: STORYBOARD.md + SCRIPT.md 파일이 존재하고 사용자가 계획을 승인했을 것.
4단계: 음성 해설, 타이밍 및 자막 💬
2단계에서 내레이션이 없다고 결정된 경우 – 배경음악에 대해 질문한 후 5단계로 건너뜁니다. 그렇지 않은 경우: 사용자에게 원하는 TTS 공급자(HeyGen TTS, ElevenLabs 또는 Kokoro)를 묻고, 오디오를 생성하고, 받아쓰고, 타임스탬프를 비트에 매핑합니다. 그런 다음 자막에 대해 질문합니다.
게이트: (a) 내레이션이 요청되지 않았고 스토리보드에 수동 비트 타이밍이 있거나, (b) narration.wav + transcript.json 파일이 존재하고 비트 타이밍이 실제 길이로 업데이트되었을 것.
5단계: 컴포지션 구축
참고: hyperframes 스킬을 로드하세요 – 모든 규칙이 중요합니다.
참고: references/step-5-build.md
index.html 및 스토리보드(3단계)에서 선택된 아키텍처와 페이싱에 따라 컴포지션을 구축합니다. 하위 에이전트가 각 비트에 대해 보고하기 전에 hyperframes lint 및 hyperframes snapshot을 실행합니다.
게이트: 모든 compositions/beat-N.html 파일이 기본 에이전트에 의해 DESIGN.md 및 STORYBOARD.md와 비교하여 처음부터 끝까지 읽혀야 합니다. 비트별 체크리스트는 step-5-build.md에 있습니다.
6단계: 검증 및 전달
참고: references/step-6-validate.md
린트, 검증, 동영상 길이에 맞게 스케일링된 스냅샷 촬영(공식: max(비트 수 × 3, ceil(동영상 길이(초) / 2))), 각각 검토합니다. 문제를 수정한 후 전달합니다. localhost Studio 프로젝트 URL을 전달하고, 명시적인 사용자 요청이 있을 때만 MP4로 렌더링합니다. 인계 시에만 Studio URL을 표시하세요 – 이것이 최종적이고 안정적인 미리보기이며, 빌드 단계의 스냅샷은 헤드리스 방식이므로 빌드 중간에 미리보기를 팝업하지 마세요.
자랑스러워할 만한 것을 전달하세요. 인계하기 전에 스스로에게 물어보세요: 이 동영상을 내 이름을 걸고 소셜 미디어에 게시할 수 있겠는가? 아니라면, 문제가 무엇인지 고치세요.
게이트: npx hyperframes lint와 npx hyperframes validate가 오류 없이 통과하고, 최종 응답에 활성 Studio 프로젝트 URL이 포함되어야 합니다.
빠른 참조
동영상 유형
동영상 유형별 일반적인 제약 조건 – 공식이 아닌 시작점으로 사용하세요. 비트 수는 대상 범위가 아닌 내용과 내레이션에 따라 결정되어야 합니다.
| 유형 | 일반적인 길이 | 길이 결정 요소 | 내레이션 |
|---|---|---|---|
| 소셜 광고(IG/TikTok) | 10–15초 | 플랫폼 제한 | 선택 사항 |
| 제품 데모 | 30–60초 | 스크립트 길이 | 전체 내레이션 |
| 기능 발표 | 15–30초 | 기능 복잡성 | 전체 내레이션 |
| 브랜드 릴 | 20–45초 | 음악 트랙 | 선택 사항, 음악 중심 |
| 런칭 티저 | 10–20초 | 후킹 에너지 | 최소 |
비트 수는 의도적으로 이 표에 포함되지 않았습니다. "소셜 광고 = 3-4비트"가 아닌 스토리보드에서 결정되어야 합니다. 복잡한 제품의 소셜 광고는 잘 배치된 5개의 비트가 필요할 수 있습니다. 하나의 강력한 시각적 테제를 가진 브랜드 릴은 3개가 필요할 수 있습니다.
형식
- 가로: 1920x1080 (기본값)
- 세로: 1080x1920 (인스타그램 스토리, TikTok)
- 정사각형: 1080x1080 (인스타그램 피드)
참고 파일
| 파일 | 읽을 시기 |
|---|---|
| step-0-capture.md | 0단계 – 캡처, 브랜드와 제품 이해, 전략 우선 사이트 요약 작성 |
| step-1-design.md | 1단계 – DESIGN.md 브랜드 치트 시트 작성 (5개 섹션, 250-350줄; 빌보드 스타일 소셜 광고용 50줄 고속 경로) |
| step-2-brief.md | 2단계 – 사용자와 메시지, 내러티브 아크, 대상 청중에 대한 합의 |
| capabilities.md | 2단계 및 5단계 – HyperFrames가 할 수 있는 전체 기능 목록 (24개 섹션). 브리핑 중에는 목차를 스캔하고, 빌드 중에는 특정 섹션 심층 분석 |
| step-3-storyboard.md | 3단계 – 스토리보드 + 스크립트 (결합) 및 사용자 검토 게이트 |
| step-4-vo.md | 4단계 – TTS 공급자 선택, 생성, 타이밍 |
| step-5-build.md | 5단계 – index.html + 컴포지션 빌드 |
| step-6-validate.md | 6단계 – 린트, 검증, 스냅샷 (동영상 길이에 맞게 스케일링), 미리보기 |
| techniques.md | 3단계 및 5단계 – 코드 패턴이 포함된 13가지 기본 애니메이션 기법 (복사-붙여넣기하지 말고 적응하여 사용) |
| html-in-canvas-patterns.md | 5단계 – HTML-in-Canvas 효과를 위한 완전한 코드 패턴 (hyperframes 스킬에 위치) |