일반 비디오(General Video)
이 워크플로를 사용하기 전에 다음 명령을 실행하세요:
npx hyperframes skills update general-video
성공적인 no-op(변경 없음) 메시지는 스킬이 최신 상태임을 의미합니다. 메모리에서 이어서 작업하지 말고, 업데이트 실패가 발생하면 이를 표시하세요.
1. 교차 소스 어댑터 적용(Apply cross-cutting source adapters)
- 미디어(Media): 오디오, 이미지, 아이콘, 로고, 음성, 그레이딩, 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를 실행하세요. 내보낸 에셋, 토큰, 컴포넌트, 또는 스토리보드 프레임을 사용하여 빌드하세요. 원시 Figma 커넥터 호출은 SVG 정제, 미디어 출처 추적, 및 브랜드 토큰 바인딩을 건너뛰므로 사용하지 마세요.
이러한 어댑터는 /hyperframes가 선택한 워크플로를 변경하지 않습니다.
2. 프로젝트 상태에서 시작(Start from project state)
일치하는 첫 번째 행을 적용하고, 하위 상태 행은 평가하지 마세요:
| 상태(State) | 작업(Action) |
|---|---|
| 특정 편집(Specific edit) | 편집을 수행하고 기존 프로젝트 결정 사항을 유지한 후, 영향을 받는 검사를 다시 실행하세요. 디스커버리를 다시 열지 마세요. |
BRIEF.md 존재(Exists) | 읽으세요. workflow가 다른 워크플로를 지칭하고 flow가 companion이 아니면, 핸드오프하세요. 브리프 질문을 하지 마세요. |
브리프 없지만 hyperframes.json 또는 STORYBOARD.md 존재 | 파일과 기록된 선호도에서 재개하세요. 알려진 사실에서만 BRIEF.md를 백필하세요. |
| 새로 생성(Fresh creation) | /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. 실행 형태 해석(Interpret the run shape)
../hyperframes/references/brief-contract.md의 표준 용어만 사용하세요:
| 필드(Field) | 의미(Meaning) | 효과(Effect) |
|---|---|---|
flow | 주도권(Who drives) | automation: 경로를 선택하고 실행합니다. companion: 대화를 통해 공동 창작합니다. |
storyboard | 계획, 스케치, 리뷰 여부 | yes: 계획 및 스케치 리뷰(storyboard.html)를 실행합니다. no: 리뷰 없이 빌드합니다. |
파생된 mode | 체크포인트 게이트 작동 방식 | Brief contract를 따르세요. 사용자에게 모드 이름을 묻지 마세요. |
이러한 상태에 대한 동의어를 만들지 마세요. 진행 중인 "그냥 빌드해" 신호는 의도 레이어에 의해 처리되며 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에서 전체 계약을 복사하세요.
컴패니언 플로우(Companion flow)
flow: companion인 경우:
BRIEF.md를 읽고## Assets및## Customizations에서 수락된 항목을 프로젝트 산출물과 조정하세요. 아직 완료되지 않은 수락된 작업을 완료하고, 이미 완료된 작업은 그대로 두세요. 수락된 기능을 새로운 것처럼 다시 제안하지 마세요.- 감독(Director)으로 도착하세요, 계약자(Contractor)가 아닙니다. 컴패니언을 선택한 사용자는 참여와 품질을 원한 것입니다. 정직한 응답은 당신이 설계할 수 있는 최고 버전이지, 방어할 수 있는 가장 작은 버전이 아닙니다. 첫 번째 계획(plan)은 천장 처리(the ceiling treatment)입니다: 스토리 아크(가장 가까운 장르 렌즈 빌려오기 - 메뉴 § 장르 렌즈), 디자인 사양, 각 장면의 동작 처리를 이름으로 인용(§ 5의 계획 규율), 전환, 오디오 아이덴티티 — 음악과 사운드 마크, 또는 의도적인 침묵 — 사용자의 배치된 자료, 그리고 설계된 시작과 끝. 각 레이어가 무엇을 추가하는지 한 줄로 말하고, 비용이 많이 드는 것들(렌더 시간, 로그인, 과금)은 이름을 밝힐 때 플래그를 붙이세요. 사용자는 처리를 다듬습니다. 승인 하나하나를 조립해야 하는 일이 없어야 합니다.
- 천장은 툴박스가 아닌 개념에 속합니다. 모든 레이어는 브리프의 메시지를 위해 봉사해야 합니다. 모든 비디오를 같은 방식으로 꾸미는 처리는 장식입니다. 장인 정신은 천장까지 올라가지만, 콘텐츠는 요청된 것을 넘어 성장하지 않습니다(§ 6).
- 체크포인트 사이에서
../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 해당 입력을 언급하거나 빌드가 해당 필요에 도달할 때 관련 기능을 제안합니다. 각 패스의 업그레이드 채널로: 계획, 스케치, 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다("장면 3의 stat는 카운트-업 처리를 원합니다"). 제안하기 전에 읽으세요. 전체 카탈로그를 덤프하지 마세요. - 사용자가 기능을 수락한 후, 산출물을 생성하고 즉시 일치하는
BRIEF.md본문 섹션에 결정 사항을 기록하세요. 사용자가 명시적으로 변경할 때만 frontmatter 필드를 다시 쓰고 확인된 선호도를 기록하세요. - 동일한 스토리보드, 검증, 최종 미리보기, 및 렌더 승인 게이트를 유지하세요. 컴패니언은 누가 조종하는지 변경할 뿐, 어떤 품질이 필요한지는 변경하지 않습니다.
4. 각 단계 전에 필요한 지식 로드(Load required knowledge before each stage)
조건이 일치할 때 다음 읽기는 필수입니다:
| 조건(Condition) | 조치 전에 읽을 것(Read before acting) |
|---|---|
| 컴포지션 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. 컴포지션 실행(Execute the composition)
다음 의존성 순서를 사용하세요. 입력이 없을 때만 단계를 건너뛰세요.
- 계획(Plan). 뷰어 아크, 구조, 리듬, 및 지속 시간 드라이버를 명시하세요. 짧은 단일 장면에는 하나의 파일을 사용하세요. 세 개 이상의 하드 장면 컷 또는 재사용되는 장면에는 하위 컴포지션을 사용하세요. 서사 아크(narrated arcs)는
/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인 경우에도 마찬가지입니다. 블록은 디스패치 단위이고, 스토리보드 시트는 오직 리뷰 표면일 뿐입니다. - 요청 시 계획 검토(Review the plan when requested).
storyboard: yes의 경우, 해당 블록에 대해 공유 리뷰 루프를 실행하세요.storyboard: no의 경우, 계획 일시 중지나 스케치 시트 없이 계속 진행하세요. 계획 일시 중지가 발생한 경우, 하위 에이전트 위임 권한(4단계의 디스패치를 위해 codex에 필요)을 해당 일시 중지에 포함시켜 나중에 다시 멈추지 않도록 하세요. - 의존성 해결(Resolve dependencies). 병렬 작업 전에 레지스트리 블록을 설치하세요. 사용자 자산을 준비하고, 기존 항목을 채택하세요...
(참고: 원본 내용이 중간에 잘렸으나, 기술 스펙의 주요 구조와 핵심 규칙은 모두 번역되었습니다.)