Communitygithub.com

simpletibr/simplicio-loop-marketing

마케팅 엔진 조각 브리프를 HyperFrames 스킬이 기대하는 입력 형태(구성 명세)와 hyperframes-cli 스킬이 렌더링하는 데 필요한 플래그로 변환합니다. 라우팅 매트릭스가 HyperFrames 제공자로 결정될 때 video-prompt-builder가 선택합니다.

simplicio-loop-marketing란 무엇인가요?

이 기술은 마케팅 엔진 조각 모델(brief, task_kind, provider_override)과 HyperFrames 구성 계약 간의 전문화된 브리지 역할을 합니다. video-prompt-builder 디스패처가 비디오 제공자를 'hyperframes'로 결정할 때 호출되며, motion-typography, data-viz-reel, programmatic-short 등 HyperFrames 네이티브 작업 유형을 처리합니다. 브랜드 컨텍스트를 로드하고, task_kind를 구성 템플릿에 매핑하며, 비용 추정을 수행하고, composition_spec과 render_args를 구축하여 hyperframes 및 hyperframes-cli 스킬에 전달합니다. 주요 특징으로는 재렌더링 가능한 구성을 위한 명시적 변수 선언, design.md 누락 시 중단, render_args에 strict-variables 전달 등의 비협상 규칙이 있습니다. Claude Code 환경에서 주로 사용되며, MP4 출력을 생성하고 사용 내역을 data/video-usage.jsonl에 기록합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/hyperframes-prompt-builder

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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를 호출하지 않고 구성 명세와 렌더 인수를 반환.

프로세스

  1. 브랜드 컨텍스트 로드. clients/<client_slug>/design.md를 읽고 { colors, type_pairing, spacing_scale, brand_voice }를 해석합니다. 없으면 진행을 거부하고 누락된 경로를 표시합니다. 브랜드 위반은 다운스트림에서 수정할 수 없습니다.
  2. 오버라이드 해석. piece_path가 설정되고 프론트매터에 provider_override.video가 있으면 hyperframes인지 확인하고, 그렇지 않으면 이 스킬이 실행 중이어서는 안 됩니다.
  3. task_kind를 구성 템플릿에 매핑.
    • motion-typography → kinetic-type 템플릿, 단일 씬, 타입 기반.
    • data-viz-reel → nyt-graph 템플릿, 선언된 숫자 변수가 있는 본문 씬.
    • programmatic-short → play-mode 템플릿, hook/body/cta, 모든 클라이언트 카피가 변수로 선언됨.
  4. 변수 선언. 재렌더링 시 변경될 수 있는 브리프의 모든 항목(헤드라인, 본문, KPI 숫자, CTA, 날짜 스탬프)을 명시적 타입, 레이블, 기본값과 함께 variables에 넣습니다. 변수로 처리할 수 있는 경우 하드코딩된 카피는 금지됩니다.
  5. HyperFrames가 기대하는 형태로 구성 명세 구축: { composition_id, aspect, duration_seconds, scenes, design_tokens, variables, assets, output_dir }. composition_id는 <piece-id>(슬러그 안전)에서 계산합니다.
  6. HyperFrames-CLI가 기대하는 형태로 렌더 인수 구축: { project_path, mode: "render", render_opts: { fps, quality, format, variables, strict: true, strict_variables: true, output } }. 승인된 조각에는 quality: "high", 첫 번째 검토에는 "draft"를 선택합니다.
  7. 비용 추정. 로컬 렌더 — duration_seconds × workers × $0.00에서 추정 (실제 비용 없음, latency_estimate_min으로 소요 시간(분) 보고).
  8. 해결 내역을 data/video-usage.jsonl에 기록 { ts, provider: "hyperframes", piece_id, task_kind, composition_id, dry_run }.
  9. 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을 선택할 수 있음.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

관련 스킬