플러그인 설치: 설정 또는 초기화 명령 전에, 이 스킬이 HyperFrames 플러그인 내에 있을 때 플러그인 실행 규칙을 따르세요. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.
일반 비디오
워크플로우가 방금 읽지 않은 경우 시작 시 npx hyperframes usage --json을 실행하고, 초안 작성 후 및 렌더링 전과 같은 주요 시점에 다시 확인하세요. 사용 가능한 윈도우와 재설정 시간을 읽으세요. 사용량을 알 수 없는 경우 추측 없이 알리고, 허용량을 추측하지 말고 사용자와 함께 범위 및 워크플로우 선택을 유지하세요.
이 워크플로우에 의존하기 전에 다음을 실행하세요:
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를 실행하세요. 내보낸 자산, 토큰, 컴포넌트 또는 스토리보드 프레임에서 빌드하세요. 원시 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/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로 작성된 배치/순서를 설정하세요. 각 비디오 세그먼트는 사운드를 유지합니다: 사운드는 클립에 남아 있습니다(data-has-audio="true"). 따라서 비디오를 자르면 사운드도 잘립니다. /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 "<the look, in plain English>" --json을 실행하고 계획이 해당 룩을 빌드하는 방법을 명명하기 전에 상위 결과를 읽으세요. 검색에는 아무것도 설치할 필요가 없습니다: 프로젝트, 사전add, 계정이 필요 없습니다. 모든 디렉토리에서 전체 호스팅 레지스트리(~400개의 블록 및 컴포넌트)의 순위를 매기므로 빌드 중간에 사용자가 요청한 룩에도 적용됩니다. 계획이 명명한 블록은 3단계에서 설치됩니다. 검색 결과에 적합한 항목이 없는 경우에만 룩을 직접 작성하세요. 다중 장면 계획은 디스패치 아티팩트로도 기록됩니다:STORYBOARD.md의 각 장면에 하나의## Frame N블록 —status: outline, 선언된src:, 청사진/규칙 인용, 장면 지속 시간, 대화/내레이션 요약, 장면 전환 ID. 기록된 계획은 렌더링에 사용되며 다른 추상화에 위임되지 않습니다. -
스케치.
storyboard: yes인 경우에만./hyperframes→references/storyboard-format.md에 따라 스토리보드를 생성하고review-loop.md를 통해 검토를 시작하세요.storyboard: no인 경우 리소스 낭비이므로 건너뛰세요. -
빌드. 계획이 설치를 명명한 블록을 설치하고, 나머지 구성 요소를 작성하거나 기존 프로젝트를 편집하세요. 각 장면에 대해:
hyperframes.json에서BRIEF.md(장면 지시 포함) 및STORYBOARD.md영역을 읽으세요./hyperframes-core의references/determinism-rules.md에 따라 각 장면에 대해 하나의 루트 HTML 프래그먼트를 생성하세요. 각 장면의 내부 시각적 구조를 위해/hyperframes-core→references/composition-patterns.md를 읽으세요./hyperframes-creative→references/video-composition.md에서 독창적인 시각적 아이디어를 읽으세요./media-use에서 미디어 변환을 읽으세요. 게이트: 빌드 후npx hyperframes check를 실행하세요. -
렌더링. 스토리보드가 없거나 승인된 스토리보드가 있는 경우에만. 렌더링 요청을 구성하려면
/hyperframes-core→references/rendering.md를 읽으세요. 게이트: 렌더링 전에npx hyperframes check --preflight를 실행하세요. -
검증. 렌더링이 완료된 후 출력을 검증하세요: 위치가 올바른지, 콘텐츠가 표시되는지. 수정해야 할 경우 워크플로우의 앞부분으로 돌아가서 계획을 명시적으로 업데이트하고 다시 빌드하세요.
-
게시.
../hyperframes/references/capability-menu.md에서 기능publish를 확인하세요. 사용자가 퍼블리싱을 요청한 경우에만 수행하세요.
6. 브리프 충실도 유지
다음이 아닌 한 브리프에 없는 것은 만들지 마세요:
- 계획 단계(§ 5.1)는 명시된 의도에서 보간하는 씬 레벨 구조를 추가합니다. 이 구조는 브리프 없이 브리프를 확장합니다.
- 검증(§ 5.5)은 렌더링된 푸티지와 브리프 메시지 간의 불일치를 플래그 지정하고 수정을 제안합니다.
- 브리프가 요청한 것으로 알려지지 않는 한(브리프에 없는 것) 스톡, 아카이브, 생성형 또는 타사 미디어를 소싱하지 마세요.
브리프가 명시적으로 요청하지 않은 한 시각적 ID, 글로벌 색상 팔레트, 타입 시스템 또는 레이아웃 그리드를 만들지 마세요. 브리프가 출처 해상도, 종횡비, 프레임 속도, 색상 공간, 오디오 채널 레이아웃 또는 마스터링 사양에 대해 침묵하는 경우 물리적 기본값을 사용하고 주위에 스토리를 만들지 마세요. 제안할 수 있지만, 거절을 한 번 수락하세요.
편집 및 수정: 사용자가 명시적인 편집, 요청 또는 조정을 제공할 때:
- 사용자의 정확한 언어를 반영하도록
BRIEF.md를 업데이트하고, 섹션을 재작성하거나 템플릿을 다시 로드하지 않음으로써 변경 사항의 범위를 좁힙니다. - 수정 후에는 검사기를 다시 실행하고 영향을 받은 아티팩트를 업데이트하세요. 이전 체크포인트로 돌아가지 마세요.
7. 매개변수 및 우선순위
우선순위가 없는 경우 가장 낮은 숫자가 가장 높은 우선순위입니다:
hyperframes.json에서userOverridesBRIEF.md에서 명시적 필드node <MEDIA_DIR>/scripts/prefs.mjs get --hyperframes <PROJECT_ROOT>를 통한 프로젝트별 기본 설정/media-use기본 설정이 적용된 물리적 기본값
의존성은 다음과 같습니다:
/hyperframes가 존재함/media-use가 설치되고 최신 상태여야 함