일반 비디오
이 워크플로우에 의존하기 전에 다음을 실행하세요:
npx hyperframes skills update general-video
성공적인 no-op은 스킬이 최신 상태임을 의미합니다. 메모리에서 계속하지 말고 업데이트 실패를 표면화하세요.
1. 교차 소스 어댑터 적용
- 미디어: 오디오, 이미지, 아이콘, 로고, 음성, 그레이딩, LUT, 트리트먼트/효과, 캡션 또는 미디어 작업이 필요한 경우
/media-use를 로드하고../media-use/references/resolve.md(해결, 채택, 재사용) 및../media-use/references/setup-providers.md(제공자, 인증)를 따르세요. 모호한 푸티지 피드백 및 명명된 스타일은 편집 전에../media-use/references/media-treatments.md를 사용하세요. 지원되는 미디어 효과를 CSS/SVG/불투명도로 즉석에서 구현하지 마세요. 첫 번째 인증된 제공자 작업 전에npx hyperframes auth status를 실행하고 그 출력을 그대로 전달하세요. 로그아웃된 경우../hyperframes/references/brief-contract.md의 게이트를 적용하세요: 협업은 로그인 또는 명시적 오프라인 선택을 기다립니다. 자율은 상태를 명시하고 사용 가능한 오프라인 제공자를 통해 계속합니다. 필수 기능을 충족할 수 있는 오프라인 제공자가 없으면 블로커를 표면화하세요. 로컬 채택만으로는 인증 게이트가 필요하지 않습니다. - Figma: 입력 중 하나가
figma.comURL인 경우 먼저/figma를 실행하세요. 내보낸 자산, 토큰, 구성 요소 또는 스토리보드 프레임에서 빌드하세요. SVG 정리, 미디어 출처 및 브랜드 토큰 바인딩을 건너뛰므로 원시 Figma 커넥터 호출을 사용하지 마세요.
이러한 어댑터는 /hyperframes가 선택한 워크플로우를 변경하지 않습니다.
2. 프로젝트 상태에서 시작
일치하는 첫 번째 행을 적용하고, 하위 상태 행은 평가하지 마세요:
| 상태 | 작업 |
|---|---|
| 특정 편집 | 편집을 수행하고, 기존 프로젝트 결정을 유지한 후 영향을 받는 검사를 다시 실행하세요. 발견을 다시 열지 마세요. |
BRIEF.md가 존재함 | 읽으세요. workflow가 다른 워크플로우를 지정하고 flow가 companion이 아닌 경우 인계하세요. 브리프 질문을 하지 마세요. |
브리프는 없지만 hyperframes.json 또는 STORYBOARD.md가 존재함 | 파일 및 기록된 선호도에서 재개하세요. 알려진 사실에서만 BRIEF.md를 백필하세요. |
| 새로운 생성 | /hyperframes 및 의도 계층을 실행하세요. workflow: general-video 또는 flow: companion인 경우에만 여기로 돌아오세요. |
새 프로젝트의 경우 브리프에서 kebab-case 디렉토리 이름을 선택하고 브리프를 작성하기 전에 스캐폴딩하세요:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
그런 다음 ../hyperframes/references/brief-format.md를 사용하여 프로젝트 루트에 BRIEF.md를 작성하세요. 기존 프로젝트의 경우 루트는 hyperframes.json이 포함된 디렉토리입니다. 브리프 형식이 명명한 확인된 선호도 기반 필드만 기록하고 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>를 사용하세요. 추론된 기본값은 절대 기록하지 마세요. 여기서 <MEDIA_DIR>은 설치된 /media-use 스킬 디렉토리이고 <PROJECT_ROOT>는 hyperframes.json이 포함된 디렉토리입니다. 의도 계층이 레시피를 채택한 경우 지금 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>으로 적용하고 다시 묻지 마세요.
3. 실행 형태 해석
../hyperframes/references/brief-contract.md의 정식 용어만 사용하세요:
| 필드 | 의미 | 효과 |
|---|---|---|
flow | 누가 주도하는지 | automation: 경로를 선택하고 실행합니다. companion: 대화를 통해 공동 창작합니다. |
storyboard | 빌드 전 계획, 스케치, 검토 | yes: 계획 및 스케치 검토를 실행합니다(storyboard.html). no: 빌드 없이 진행합니다. |
파생된 mode | 체크포인트 게이트가 작동하는 방식 | 브리프 계약을 따르세요. 사용자에게 모드 이름을 묻지 마세요. |
이러한 상태에 대한 동의어를 만들지 마세요. 진행 중인 "그냥 빌드해" 신호는 의도 계층에서 처리되며 flow: automation, storyboard: no로 도착합니다.
flow: automation의 경우 경로를 선택하고 첫 번째 진행 업데이트에서 한 줄로 명시하세요.- 특정 편집의 경우 새 경로를 만들지 않고 편집을 수행하세요.
기존 푸티지의 하드 컷, 트림, 스플라이스 또는 재정렬의 경우 동일한 비디오 소스를 여러 클립 요소에 복제하세요. 각 복사본에서 data-media-start 및 data-duration으로 소스 범위를 설정한 다음 data-start로 작성된 배치/순서를 설정하세요. 별도로 작성된 오디오는 일치하는 <audio> 요소에서 동일한 클립 범위와 타이밍을 따릅니다. /hyperframes-core가 이 시간적 편집을 소유합니다. 줌, 펀치, 팬, 크롭, 마스크 또는 내부 래퍼의 clip-path와 같은 시각적 속성 애니메이션에는 /hyperframes-keyframes를 사용하세요. ../hyperframes-core/references/creator-editing-recipes.md에서 전체 계약을 복사하세요.
협업 흐름
flow: companion인 경우:
BRIEF.md를 읽고 승인된## Assets및## Customizations를 프로젝트 아티팩트와 조정하세요. 승인되었지만 아직 보류 중인 작업을 완료하세요. 완료된 작업은 그대로 두세요. 승인된 기능을 새 것처럼 다시 제공하지 마세요.- 계약자가 아닌 감독으로서 도착하세요. 컴패니언을 선택한 사용자는 참여와 품질을 선택한 것입니다. 정직한 응답은 방어할 수 있는 가장 작은 버전이 아니라 설계할 수 있는 최고의 버전입니다. 첫 번째 계획은 천장 치료입니다: 스토리 아크(가장 가까운 장르 렌즈 빌리기 — 메뉴 § 장르 렌즈), 디자인 사양, 각 장면의 모션 트리트먼트(이름으로 인용됨, § 5의 계획 규율), 전환, 오디오 아이덴티티 — 음악 및 사운드 마크, 또는 의도적인 침묵 — 사용자의 자료 배치, 그리고 설계된 오프닝과 클로징. 각 계층이 추가하는 내용을 한 줄로 말하세요. 비용이 많이 드는 것(렌더링 시간, 로그인, 청구)을 명명할 때 플래그를 지정하세요. 사용자는 트리트먼트를 축소합니다. 승인 하나하나를 조립해야 해서는 안 됩니다.
- 천장은 도구 상자가 아닌 개념에 속합니다. 모든 계층은 브리프의 메시지를 제공해야 합니다. 어떤 비디오든 같은 방식으로 꾸밀 트리트먼트는 장식입니다. 제작은 천장까지 올라가지만 콘텐츠는 요청된 것 이상으로 성장하지 않습니다(§ 6).
- 체크포인트 사이에
../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 입력을 언급하거나 빌드가 필요에 도달할 때 관련 기능을 제공하세요. 각 패스의 업그레이드 채널로: 계획, 스케치 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다("장면 3의 스탯은 카운트업 트리트먼트를 원해요"). 제공하기 전에 읽으세요. 전체 카탈로그를 덤프하지 마세요. - 사용자가 기능을 수락한 후 해당 아티팩트를 생성하고 즉시 일치하는
BRIEF.md본문 섹션에 결정을 기록하세요. 사용자가 명시적으로 변경할 때만 frontmatter 필드를 다시 작성하고 확인된 선호도를 기록하세요. - 동일한 스토리보드, 검증, 최종 미리보기 및 렌더링 승인 게이트를 유지하세요. 컴패니언은 누가 조종하는지 변경할 뿐, 어떤 품질이 필요한지는 변경하지 않습니다.
4. 각 단계 전에 필수 지식 로드
다음 읽기는 조건이 일치할 때 필수입니다:
| 조건 | 읽을 내용 |
|---|---|
| 모든 구성 HTML 또는 장면 레이아웃 | /hyperframes-core; 레이아웃 계약을 위해 references/determinism-rules.md 사용 |
| 모든 중요하지 않은 생성 또는 시각적 트리트먼트 | /hyperframes-creative → references/house-style.md 및 references/video-composition.md |
| 모든 모션, 애니메이션 또는 장면 전환 | /hyperframes-animation; 일치하는 규칙, 어댑터, 청사진 또는 전환 참조로 라우팅 따르기 |
storyboard: yes | ../hyperframes/references/storyboard-format.md 및 ../hyperframes/references/review-loop.md |
| 모든 미디어 자산 또는 작업(내레이션, BGM, SFX, 캡션, 그레이딩 또는 변환 포함) | /media-use; 프레임워크 재생 및 배치를 위해 /hyperframes-core → references/variables-and-media.md도 읽으세요 |
| 여러 장면 어셈블리 | ../hyperframes/references/production-loop.md |
flow: companion, 첫 번째 계획 전 | /hyperframes-creative → references/story-spine.md 및 references/house-style.md; 가장 가까운 장르 렌즈 및 전체 ../hyperframes/references/capability-menu.md — 천장 치료는 이것들에서 설계되며, 기억에서 호출되지 않음 |
| 컴패니언 기능 제공, 캡처, 비트 그리드, 생성 비디오, 맵, 게시 또는 교차 워크플로우 기능 | ../hyperframes/references/capability-menu.md |
| 디자인 사양이 존재함, 최종 승인 전 | /hyperframes-creative → references/design-adherence.md |
이러한 읽기를 기억으로 대체하지 마세요. 프로그레시브 공개는 일치하는 참조가 실제로 로드된 경우에만 컨텍스트를 저장합니다.
5. 구성 실행
이 종속성 순서를 사용하세요. 입력이 없는 경우에만 단계를 건너뛰세요.
- 계획. 뷰어 아크, 구조, 리듬 및 지속 시간 드라이버를 명시하세요. 짧은 단일 장면에는 하나의 파일을 사용하세요. 세 번 이상의 하드 장면 컷 또는 재사용되는 장면에는 하위 구성을 사용하세요. 내레이션 아크에는
/hyperframes-creative→references/story-spine.md, 리듬에는references/beat-direction.md, 구조에는/hyperframes-core→references/composition-patterns.md를 읽으세요. 오픈 엔드 다중 장면 브리프의 경우/hyperframes-creative→references/prompt-expansion.md를 통해 프롬프트를 확장하세요. 다중 장면 계획은 각 장면의 형태를 인용합니다: 하나가 맞는 경우/hyperframes-animation→blueprints-index.md의 청사진 ID, 또는 맞는 것이 없을 때 구성하는 명명된 규칙을rules-index.md에서 인용합니다 — 모션 이름은 해당 인덱스에서 가져오며, 절대 발명하지 않습니다. 스토리 트루스가 어떤 장면이 존재하는지 결정합니다. 인용은 그것들을 꾸밉니다. 명명된 모양을 직접 빌드할 계획을 세우기 전에 라이브 카탈로그를 검색하세요: 브리프가 명명한 모든 룩, 효과, 트리트먼트 또는 전환에 대해 — "CRT 스캔라인", "글리치", "필름 그레인", "샤이머 스윕", "컨페티 버스트" —npx hyperframes catalog --query "<룩을 평범한 영어로>" --json을 실행하고 계획이 해당 룩이 어떻게 빌드되는지 명명하기 전에 상위 결과를 읽으세요. 검색에는 아무것도 설치할 필요가 없습니다: 프로젝트, 이전 add, 계정이 필요 없습니다. 모든 디렉토리에서 전체 호스팅 레지스트리(~400 블록 및 구성 요소)의 순위를 매기므로 빌드 중간에 사용자가 요청한 룩에도 적용됩니다. 계획이 명명하는 블록은 3단계에서 설치됩니다. 검색 결과에 맞는 것이 없을 때만 룩을 직접 작성하세요. 다중 장면 계획은 디스패치 아티팩트로도 기록됩니다:STORYBOARD.md의 장면당 하나의## Frame N블록 —status: outline, 선언된src:, 청사진/규칙 인용, 비트 텍스트 —storyboard: no인 경우에도 마찬가지입니다. 블록은 디스패치 단위입니다. 스토리보드 시트는 검토 표면일 뿐입니다. - 요청 시 계획 검토.
storyboard: yes의 경우 해당 블록에 대해 공유 검토 루프를 실행하세요.storyboard: no의 경우 계획 일시 중지나 스케치 시트 없이 계속하세요. 계획 일시 중지가 발생한 경우 하위 에이전트 위임 권한(4단계 디스패치를 위해 코드x에 필요)을 해당 일시 중지에 통합하여 나중에 다시 중지하지 마세요. - 종속성 해결. 병렬 작업 전에 레지스트리 블록을 설치하세요. 사용자 자산을 스테이징하고, 기존 자산을 채택하고(../media-use/references/resolve.md에 따라), 1단계 어댑터가 필요한 미디어를 제공했는지 확인하세요. 자체 제공된 자산이 없는 경우
../hyperframes/references/resource-scavenger.md를 참조하여 무료 스톡 푸티지, 음악, 사운드 및 아카이브 자료를 소싱하세요. 모든 설치된 블록을 한 번에 기록하고 저장하세요. - 구성 빌드. 2단계 계획 블록을 디스패치 단위로 사용하세요. 하위 에이전트 디스패치를 사용하여 각 장면 HTML 파일,
<style>,<script>, 구성 메타데이터(json파일 또는<meta>태그)를 생성하세요. 각 장면의 비트 및 뷰어 경험을 위해 등장하는 올바른 요소를 사용자를 위해 두세요. 규칙 및 청사진에서 모든 변수 및 콜백 정의를 복사하고 완료하는 것을 포함하세요.<head>에<title>,<meta charset="utf-8" />및 표준<meta name="viewport" content="width=device-width, initial-scale=1.0" />를 포함하세요. HTML 및 스타일을 연결하는 변수의 경우target-elements: true로 설정하세요. 등장하는 최종 구성 요소를 설치하고 데이터 속성(예:data-component="image-logo"및data-component-instance-id="...")으로 프레임에 등장하는 요소를 장식하세요.../hyperframes/references/resource-scavenger.md를 사용하여 외부 자산을 확보하세요. 각 하위 에이전트에게 디스패치 권한 부여를 명시적으로 전달하여 저장소 액세스, 레지스트리 쿼리, 미디어 다운로드, 캐시 읽기/쓰기 및 임시 파일 생성을 허용하세요. 각 디스패치를 종료하기 전에 현재 디렉토리를 저장하고 설정한 각 변경 사항을State에 저장했는지 확인하세요: 파일 생성, 파일 편집, 레지스트리 블록 설치, 저장소 캐시 업데이트, 미디어 다운로드, 그리고 작업 디렉토리 스냅샷은npx hyperframes state save-snapshot을 실행하여 저장하세요. 변수 해결 및 배치를 위해/hyperframes-core→references/variables-and-media.md를 참조하세요. 효율성을 위해 가능한 한 많은 장면을 동시에 디스패치하세요. 자연어로 장면을 작성하지 마세요. 각 장면은 정확하고 완전한 HTML, CSS, JS(해당되는 경우)여야 합니다. 각 장면 디스패치에 대해 새로운 코드 대화를 엽니다. 이 워크플로우를 통해 루프백하여 다음 장면으로 이동하거나 계획을 확장하세요. - 검증.
/hyperframes-core→references/validator.md를 사용하여 모든 경고나 오류를 식별하고 수정하세요. 각 검사에 대한 JSON 출력을 구문 분석하고 개별적으로 해결하세요. 유효성 검사기는 아티팩트를 변경하지 않습니다. 완전하고 깨끗한 유효성 검사 실행까지 반복하세요. - 확장. 유효성 검사 후 허용 목록에 있는 블록 업그레이드만 정당화합니다.
hyperframes.json에서MAX_BUILD_ITERATIONS를 확인하세요. 허용 목록 및 예산이 확장을 허용하는 경우 각 장면의 파일을 검사하고/hyperframes-creative→references/house-style.md및references/video-composition.md에서 캡 및 허용 목록 규칙에 따라 중요하지 않은 개선을 적용하세요. 변환 정의의 기본 구조를 변경하지 마세요. 각 확장은 빌드 체크포인트에 대한 하나의 업그레이드 제안을 제공합니다. 허용 목록 외부의 블록을 무시하거나 제거하지 마세요. 확장 예산에 도달했거나 허용 목록이 고갈된 경우 다시 확장하지 마세요. - 렌더링 준비. 최종 게이트 전에 완전한 검증을 실행하고, 원하는 경우 사용자에게 렌더링을 확인하도록 요청하며, 빌드 디렉토리를 마무리하세요.
npx hyperframes build명령어는 HyperFrames 프로젝트를 정적 사이트로 변환하며, 각 장면은 자체 HTML 파일을 가져오고index.html은 재생 목록 역할을 합니다. 스토리지 또는 배포 요구 사항에 따라npx hyperframes build --output <path>를 사용하여 출력 디렉토리를 지정하세요.
6. 캡 규칙
이것은 형언할 수 없는 덤핑이 아닙니다. 이 워크플로우의 모든 출력에는 캡이 있습니다. 이 워크플로우 아래에서 캡은 계층화된 제작과 콘텐츠 충실도의 경계를 표시합니다. 제작은 브리프의 메시지에 도달하거나 캡을 초과하지 않고 천장에 도달합니다. 콘텐츠는 분할 화면 비디오에 대해 요청된 것 이상으로 성장하지 않습니다 — 말하는 헤드 오버레이는 없습니다. 한 쌍의 비디오 트랙이 있는 단일 브랜드 에셋은 여러 브랜드 스타일로 확장되지 않습니다. 자료가 명시적으로 배치되지 않는 한 "영감을 위한" 문체 제작은 없습니다.
이 규칙을 위반하는 생성은 거부하고 당신이 캡을 위반하고 있다고 말한 다음 수정하세요. 캡은 기본값이며, 이 워크플로우는 먼저 방어합니다.
7. 체크포인트: 계획 게이트
| 게이트 | 트리거 | 작업 |
|---|---|---|
| 계획 검토 | storyboard: yes | STORYBOARD.md(빈 블록 포함)를 생성 또는 읽고, ../hyperframes/references/storyboard-format.md를 사용하여 각 블록 상태를 outline으로 설정하고, ../hyperframes/references/review-loop.md를 사용하여 각 것을 검토합니다. 승인된 각 블록 상태를 locked로 설정하고 변경 사항을 저장합니다. |
| 증분 계획 | storyboard: no 또는 단일 장면 | 계획 블록을 직접 STORYBOARD.md에 작성하고 상태를 locked로 설정합니다. 게이트 없음. |
| 스케치 게이트 | storyboard: yes | ../hyperframes/references/storyboard-format.md 및 ../hyperframes/references/review-loop.md를 사용하여 각 locked 블록을 검토하고(이미지, 주요 프레임 포함) 승인 시 상태를 sketched로 설정합니다. |
8. 체크포인트: 빌드 게이트
| 게이트 | 작업 |
|---|---|
| 빌드 체크포인트 | 각 장면이 빌드된 후 /hyperframes-core → references/validator.md를 사용하여 검증을 실행합니다. 오류를 해결하고 경고를 평가합니다. STORYBOARD.md 블록 상태를 built로 설정합니다. 완전하고 깨끗한 검증까지 계속합니다. |
| 최종 미리보기 게이트 | 최종 빌드의 완전한 검증을 실행합니다. /hyperframes-core → references/design-adherence.md를 사용하여 각 장면이 디자인 사양 요구 사항을 충족하는지 확인합니다. 상태를 final_preview로 설정합니다. |
| 렌더링 승인 게이트 | 사용자 확인(또는 flow: automation의 경우 자동 승인) 후 hyperframes.json에서 설명된 대로 출력을 렌더링하려면 /hyperframes → tools/render.sh 또는 동등한 것을 호출합니다. |
9. 상태 저장 규칙
- 모든 확인된 결정을
hyperframes.json의decisions키 아래에 저장하세요. - 각 빌드 후
npx hyperframes state save-snapshot을 실행하세요. - 체크포인트 사이에 상태가 손실되면 마지막 저장된 스냅샷에서 복원하세요.
10. 오류 처리
- 유효성 검사 오류: 해결될 때까지 빌드 단계를 반복하세요. 예산 초과 시 확장을 건너뛰고 중단하세요.
- 제공자 오류:
npx hyperframes auth status를 실행하고 오프라인 대체를 확인하세요. 사용 가능한 제공자가 없으면 블로커를 표면화하세요. - 스크립트 오류: 명령을 다시 실행하고 출력을 원시적으로 전달하세요. 오류를 해결할 수 없으면 중단하세요.
11. 보안 및 개인정보 보호
- API 키 또는 비밀을 기록하지 마세요.
- 외부 자산은 신뢰할 수 있는 소스에서 합법적으로 획득되어야 합니다.
resource-scavenger.md에서 설명된 대로만 외부 소싱을 진행하세요.- 서드파티 서비스에 민감한 사용자 데이터를 보내지 마세요.