일반 비디오
이 워크플로우를 사용하기 전에 다음을 실행하세요:
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-core/references/brief-contract.md의 게이트를 적용하세요: 협업 모드에서는 로그인 또는 명시적인 오프라인 선택을 기다립니다. 자율 모드에서는 상태를 표시하고 사용 가능한 오프라인 제공자를 통해 계속 진행합니다. 필요한 기능을 충족할 수 있는 오프라인 제공자가 없으면 차단기를 표시하세요. 로컬 채택만으로는 인증 게이트가 필요하지 않습니다. - Figma: 입력이
figma.comURL인 경우 먼저/figma를 실행하세요. 내보낸 에셋, 토큰, 컴포넌트 또는 스토리보드 프레임에서 빌드하세요. 원시 Figma 커넥터 호출을 사용하지 마세요. SVG 정리, 미디어 출처 및 브랜드 토큰 바인딩을 건너뛰기 때문입니다.
이러한 어댑터는 /hyperframes에서 선택한 워크플로우를 변경하지 않습니다.
2. 프로젝트 상태부터 시작
일치하는 첫 번째 행을 적용하고, 낮은 상태 행을 평가하지 마세요:
| 상태 | 작업 |
|---|---|
| 특정 편집 | 편집하고, 기존 프로젝트 결정을 유지한 후 영향을 받는 검사를 다시 실행하세요. 탐색을 다시 열지 마세요. |
BRIEF.md 존재 | 읽으세요. workflow가 다른 워크플로우를 지정하고 flow가 companion이 아니면, 핸드오프하세요. 브리프에 대한 질문을 하지 마세요. |
브리프 없음, hyperframes.json 또는 STORYBOARD.md 존재 | 파일과 기록된 선호도로부터 재개하세요. 알려진 사실에서만 BRIEF.md를 백필하세요. |
| 새 생성 | /hyperframes와 그 의도 레이어를 실행하세요. workflow: general-video 또는 flow: companion에 대해서만 여기로 돌아오세요. |
새 프로젝트의 경우 브리프에서 케밥-케이스 디렉토리 이름을 선택하고 브리프를 작성하기 전에 스캐폴드하세요:
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video
그런 다음 ../hyperframes-core/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-core/references/brief-contract.md의 정식 용어만 사용하세요:
| 필드 | 의미 | 효과 |
|---|---|---|
flow | 누가 주도하는지 | automation: 경로를 선택하고 실행합니다. companion: 대화에서 공동 창작합니다. |
storyboard | 보드가 리뷰 표면인지 여부 | yes: 계획 및 스케치 리뷰를 실행합니다. no: 보드 없이 빌드합니다. |
파생된 mode | 체크포인트 게이트가 작동하는 방식 | 브리프 계약을 따릅니다. 사용자에게 모드 이름을 묻지 마세요. |
이러한 상태에 대한 동의어를 만들지 마세요. 진행 중인 "그냥 빌드해" 신호는 의도 레이어에서 처리되며 flow: automation, storyboard: no로 도착합니다.
flow: automation의 경우 경로를 선택하고 첫 번째 진행 업데이트에서 한 줄로 상태를 표시하세요.- 특정 편집의 경우 새로운 경로를 만들지 않고 편집하세요.
컴패니언 플로우
flow: companion의 경우:
BRIEF.md를 읽고 승인된## Assets및## Customizations와 프로젝트 아티팩트를 조정하세요. 아직 완료되지 않은 승인된 작업을 완료하세요. 완료된 작업은 그대로 두세요. 승인된 기능을 새로운 것처럼 다시 제공하지 마세요.- 계약자가 아닌 감독으로 도착하세요. 컴패니언을 선택한 사용자는 참여와 품질을 선택한 것입니다. 정직한 응답은 당신이 방어할 수 있는 가장 작은 버전이 아닌, 당신이 디자인할 수 있는 최고의 버전입니다. 첫 번째 계획은 천장 트리트먼트입니다: 스토리 아크 (가장 가까운 장르 렌즈 — 메뉴 § 장르 렌즈 차용), 디자인 사양, 각 장면의 모션 트리트먼트 이름 명시 (§ 5의 계획 규율), 전환, 오디오 아이덴티티 — 음악 및 사운드 마크, 또는 의도적인 침묵 — 사용자의 자료 배치, 디자인된 오프닝과 클로징. 각 레이어가 추가하는 내용을 한 줄로 말하세요. 비용이 많이 드는 것들 (렌더링 시간, 로그인, 청구)을 이름을 지정할 때 표시하세요. 사용자는 트리트먼트를 다듬습니다. 승인마다 조립해서는 안 됩니다.
- 천장은 개념에 속하며 도구 상자에 속하지 않습니다. 모든 레이어는 브리프의 메시지를 제공해야 합니다. 어떤 비디오든 같은 방식으로 꾸미는 트리트먼트는 장식입니다. 기술은 천장까지 올라갑니다. 콘텐츠는 요청된 것 이상으로 성장하지 않습니다 (§ 6).
- 체크포인트 사이에
../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 입력을 언급하거나 빌드가 필요에 도달할 때 관련 기능을 제공하세요. 각 패스의 업그레이드 채널로: 계획, 스케치 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다 ("장면 3의 통계에는 카운트업 트리트먼트가 필요합니다"). 제공하기 전에 읽으세요. 전체 카탈로그를 덤프하지 마세요. - 사용자가 기능을 수락한 후 해당 아티팩트를 생성하고 일치하는
BRIEF.md본문 섹션에 결정을 즉시 기록하세요. 사용자가 명시적으로 변경할 때만 프론트매터 필드를 다시 작성하고 확인된 선호도를 기록하세요. - 동일한 스토리보드, 검증, 최종 미리보기 및 렌더링 승인 게이트를 유지하세요. 컴패니언은 누가 조종하는지 변경할 뿐, 어떤 품질이 필요한지는 변경하지 않습니다.
4. 각 단계 전에 필요한 지식 로드
다음 읽기는 조건이 일치할 때 필수입니다:
| 조건 | 행동 전 읽기 |
|---|---|
| 모든 구성 HTML 또는 장면 레이아웃 | /hyperframes-core; references/determinism-rules.md를 레이아웃 계약에 사용하세요 |
| 중요하지 않은 생성 또는 시각적 트리트먼트 | /hyperframes-creative → references/house-style.md 및 references/video-composition.md |
| 모든 모션, 애니메이션 또는 장면 전환 | /hyperframes-animation; 일치하는 규칙, 어댑터, 청사진 또는 전환 참조로 라우팅을 따르세요 |
storyboard: yes | ../hyperframes-core/references/storyboard-format.md 및 ../hyperframes-core/references/review-loop.md |
| 모든 미디어 에셋 또는 작업 (내레이션, BGM, SFX, 캡션, 그레이딩 또는 변환 포함) | /media-use; 프레임워크 재생 및 배치를 위해 /hyperframes-core → references/variables-and-media.md도 읽으세요 |
| 다중 장면 어셈블리 | ../hyperframes-core/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에서 구성하는 명명된 규칙 — 모션 이름은 해당 인덱스에서 가져오며 결코 발명하지 않습니다. 스토리 진실이 어떤 장면이 존재하는지 결정하고, 인용이 이를 장식합니다. 다중 장면 계획은 디스패치 아티팩트로도 기록됩니다:STORYBOARD.md에 장면당 하나의## Frame N블록 —status: outline, 선언된src:, 청사진/규칙 인용 및 비트 텍스트 —storyboard: no일 때도 마찬가지입니다. 블록은 디스패치 단위이고, 보드는 리뷰 표면일 뿐입니다. -
요청 시 계획 검토.
storyboard: yes의 경우 해당 블록에 대해 공유 리뷰 루프를 실행하세요.storyboard: no의 경우 보드를 열지 않고 계속하세요. 계획 일시 중지가 발생하면, 하위 에이전트 위임 승인 (4단계 디스패치에 필요)을 해당 일시 중지에 통합하여 나중에 다시 멈추지 않도록 하세요. -
종속성 해결. 병렬 작업 전에 레지스트리 블록을 설치하세요. 사용자 자산을 준비하고, 기존 미디어를 채택하며, 브리프에 필요한 것만 해결하세요. 타이밍이 지속 시간을 결정할 때 오디오를 일찍 시작하세요.
-
장면 빌드. 짧은 단일 장면 작품의 경우, 모션을 추가하기 전에 가장 가시적인 순간에 장면을 구현하세요 (확인된 와이어프레임이 있는 경우, 그 최종 상태이며 다시 그리면 안 됨), 그런 다음 인용된 청사진 또는 규칙에서 애니메이션을 적용하세요 — 모션을 작성하기 전에 전체 레시피 본문 (
/hyperframes-animation→blueprints/<id>.md,rules/<id>.md)을 읽으세요.디스패치는 규모에 의해서만 비용을 정당화합니다. 패킷 작성 및 새 워커 컨텍스트 워밍업은 실제로 분 및 토큰이 소요됩니다: 최대 ~6개의 짧은 장면으로 구성된 영화는 이 컨텍스트에서 INLINE으로, 하나씩 차례로 더 빠르게 빌드됩니다 (측정 결과: 5개의 짧은 장면 ≈ 인라인 9분 vs 패킷화 약 21분). 계획이 이를 초과할 때만 — 더 많은 장면 또는 개별적으로 무거운 장면 — 팬아웃하고, 각 워커에게 2–3개의 장면을 주고 (하나가 아님), 모든 워커를 단일 웨이브로 생성하세요 (두 번째 웨이브는 거의 시간을 두 배로 만듭니다). 디스패치할 때:
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"빌더는 장면당 하나의 경계 패킷을
.hyperframes/frame-packets/아래에 작성합니다 (장면의 정확한 스토리보드 블록 + 청사진 본문 + 인용된 모든 규칙 레시피, 인라인) 및_role.md(../hyperframes-core/references/frame-worker.md의 지침에 따라).dispatch: true를 사용하여 초기 설정을 건너뛰고 각 워커를 시작하세요:정확한 프롬프트는
../hyperframes-core/references/frame-worker.md에 정의되어 있습니다 — 발명하지 마세요. -
합성 및 내보내기.
../hyperframes-core/references/production-loop.md를 따르세요. 프레임워크 재생 해결 외부에서 합성 프레임을 재생하지 마세요. 내보내기 전에../hyperframes-core/references/export.md를 읽으세요. 비디오 및 이미지 출력은<project>/exports/에 넣으세요.
6. 스타일 및 재현성 표준
검증 및 게이트에는 /hyperframes-core → references/determinism-rules.md를 준수하세요. 커스터마이제이션은 구성 파일이나 실행 시 인수를 통해 이루어지며, 프롬프트 내에서 하드코딩되지 않습니다.
- 브리프가
## Customizations를 지정하는 경우, 이후 패스가 우발적으로 재정의하지 않도록 중앙 구성에 기록하세요. ../hyperframes-core/references/brief-contract.md에 따라 활성화/비활성화할 수 있는 모든 출력 변형을 문서화하세요.../hyperframes-core/references/determinism-rules.md를 사용하여 모든 패스에서 재현 가능한 출력을 보장하세요.
7. 패스 구조 및 한도
이 워크플로우는 여러 반복 패스를 지원합니다:
- 1패스: 기본적인 편집 및 내보내기.
- 다중 패스:
STORYBOARD.md의 피드백에 따라 정제.
프로젝트가 지정된 한도를 초과할 때만 리소스 한도에 도달했다고 말하세요. 새로운 패스를 시작할 때 STORYBOARD.md 파일에서 시작하는 대신 기존 BRIEF.md로 빌드 체인을 재실행하세요.
8. 결론
이 워크플로우는 일반 비디오 편집 및 구성을 위한 포괄적인 접근 방식을 제공하며, 다양한 미디어 소스와 컴패니언 플로우를 지원하여 고품질의 협업 비디오 제작을 가능하게 합니다.