HyperFrames 프롬프트 빌더
마케팅 엔진 조각 모델(brief, task_kind, provider_override)과 HyperFrames 구성 계약 사이를 연결하는 전문가입니다. 형태상 higgsfield-prompt-builder 및 topview-prompt-builder를 미러링하여 동일한 디스패처를 사용하지만 대상이 다르므로 video-prompt-builder가 자체 로직을 변경하지 않고도 제공자를 교체할 수 있습니다.
호출 시점
video-prompt-builder가 비디오 제공자를hyperframes로 결정한 경우.task_kind가motion-typography,data-viz-reel,programmatic-short중 하나인 경우 (PROVIDERS.md에 정의된 hyperframes 네이티브 작업).- 조각이 프론트매터에
provider_override.video: hyperframes를 선언한 경우. - 승인된 스틸(gpt-image의 인용 카드, topview의 캐러셀)이 모션으로 업그레이드될 때 타입 시스템이 원본을 바이트 단위로 충실히 유지해야 하는 경우.
- 오케스트레이터가 새로운 변수 값(주간 KPI 릴, 일일 가격 업데이트, A/B 변형 카피)으로 동일한 구성을 AI 생성기 재프롬프트 없이 재렌더링해야 하는 경우.
입력
brief: 객체. 최소한headline,body?,cta?,aspect,duration_seconds를 포함한 조각 브리프.task_kind:"motion-typography" | "data-viz-reel" | "programmatic-short".piece_path: 문자열, 선택 사항..specs/pieces/<piece-id>.md경로. 프론트매터에provider_override,compliance_flags,variables가 포함될 수 있음.client_slug: 문자열..marketing-engine/clients/<slug>/design.md(또는 엔진 저장소의clients/<slug>/design.md)를 로드하는 데 사용.output_dir: 문자열. 프로젝트 및 최종 MP4 파일이 위치할 디렉토리 (기본값outputs/<client>/<date>/<piece-id>/).dry_run: 불리언, 선택 사항. true인 경우hyperframes-cli를 호출하지 않고 구성 명세와 렌더 인수를 반환.
프로세스
- 브랜드 컨텍스트 로드.
clients/<client_slug>/design.md를 읽고{ colors, type_pairing, spacing_scale, brand_voice }를 해석합니다. 없으면 진행을 거부하고 누락된 경로를 표시합니다. 브랜드 위반은 다운스트림에서 수정할 수 없습니다. - 오버라이드 해석.
piece_path가 설정되고 프론트매터에provider_override.video가 있으면hyperframes인지 확인하고, 그렇지 않으면 이 스킬이 실행 중이어서는 안 됩니다. - task_kind를 구성 템플릿에 매핑.
motion-typography→kinetic-type템플릿, 단일 씬, 타입 기반.data-viz-reel→nyt-graph템플릿, 선언된 숫자 변수가 있는 본문 씬.programmatic-short→play-mode템플릿, hook/body/cta, 모든 클라이언트 카피가 변수로 선언됨.
- 변수 선언. 재렌더링 시 변경될 수 있는 브리프의 모든 항목(헤드라인, 본문, KPI 숫자, CTA, 날짜 스탬프)을 명시적 타입, 레이블, 기본값과 함께
variables에 넣습니다. 변수로 처리할 수 있는 경우 하드코딩된 카피는 금지됩니다. - HyperFrames가 기대하는 형태로 구성 명세 구축:
{ composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }.composition_id는<piece-id>(슬러그 안전)에서 계산합니다. - HyperFrames-CLI가 기대하는 형태로 렌더 인수 구축:
{ project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }. 승인된 조각에는quality: "high", 첫 번째 검토에는"draft"를 선택합니다. - 비용 추정. 로컬 렌더 —
duration_seconds × workers × $0.00에서 추정 (실제 비용 없음,latency_estimate_min으로 소요 시간(분) 보고). - 해결 내역을
data/video-usage.jsonl에 기록{ ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }. dry_run이면hyperframes-cli호출 없이 반환합니다. 그렇지 않으면hyperframes(프로젝트 작성)를 호출한 다음hyperframes-cli(모드lint→inspect→render)를 순서대로 호출합니다.
출력
provider_used:"hyperframes".composition_spec: 객체.hyperframes스킬에 전달된 입력.render_args: 객체.hyperframes-cli스킬에 전달된 입력 (모드render).expected_artifact: 문자열.render후에 존재할 MP4 경로.latency_estimate_min: 숫자. 렌더 소요 시간 추정치(분).cost_estimate_usd: 0 (로컬 렌더, 운영 비용만 해당).
예제
예제 1: 주간 KPI 릴 (programmatic-short)
입력: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12 }, task_kind: "programmatic-short", client_slug: "saas-consultoria-imagem", piece_path: ".specs/pieces/2026-05-22-kpi.md" }
출력: composition_id: "kpi-weekly-2026-05-22", 세 개의 씬(hook/body/cta), 숫자 변수(leads, delta_pct)를 포함한 구성 명세; --strict --strict-variables --quality high --variables '{"leads":42,"delta_pct":12}'를 포함한 렌더 인수.
예제 2: 모션 인용 카드 (motion-typography)
입력: { brief: { headline: "Coloque a sua marca onde os olhos já estão.", aspect: "1:1", duration_seconds: 6 }, task_kind: "motion-typography", client_slug: "saas-consultoria-imagem" }
출력: 단일 kinetic-type 씬, 마스킹된 텍스트 진입, 활성 클라이언트의 design.md에서 가져온 디자인 토큰을 포함한 구성 명세; outputs/saas-consultoria-imagem/<date>/<piece-id>/final.mp4를 대상으로 하는 렌더 인수.
예제 3: 제공자 오버라이드
입력: provider_override.video: hyperframes를 가진 조각이지만 task_kind가 매트릭스에 없는 경우.
출력: 여전히 라우팅되며, task_kind 기본값을 programmatic-short로 설정하고, 폴백을 기록합니다.
비협상 규칙
- 디자인 토큰을 절대 임의로 생성하지 마세요.
design.md가 없으면 진행을 거부하세요. - 정적으로 보일지라도 항상 조각별 카피를
variable로 선언하세요. 구성은 코드 수정 없이 재렌더링 가능해야 합니다. - 항상 렌더 인수에
--strict-variables를 전달하세요. 변수 ID의 오타는 하드 실패입니다. lint → inspect → render순서를 우회하여hyperframes-cli를 직접 호출하지 마세요.
실패 모드
- 알 수 없는
task_kind: 기본값을programmatic-short로 설정하고 경고를 기록한 후 계속 진행합니다. design.md누락: 중단합니다. 팔레트를 선택하지 말고 운영자에게 파일을 추가하도록 요청하세요.- 브리프에 브랜드에서 금지된 주장(
compliance-<활성 클라이언트>기준)이 포함된 경우: 작성 전에 차단합니다. 컴플라이언스는 렌더 업스트림에서 실행됩니다. - HyperFrames CLI가 설치되지 않은 경우: 설치 명령어(
npm i -g hyperframes또는npx hyperframes@latest)를 표시하고 중단합니다.
관련 스킬
hyperframes: 구성 작성 규칙 (이 스킬에서 사용).hyperframes-cli: lint/inspect/render 실행 (이 스킬에서 사용).video-prompt-builder: 이 스킬을 선택하는 디스패처.qa-tech-specs: 최종 MP4에 대해 실행.compliance-<활성 클라이언트>/compliance-generic: 해결된 변수 및 렌더링된 아티팩트에 대해 실행.llm-router: 여기서 직접 사용되지는 않지만, 이 스킬이 구성 명세를 조립하기 전에 헤드라인/본문을 초안 작성하는 LLM을 선택할 수 있음.