{"id":"app-promo-motion-shorts","kind":"workflow","example":{"input":"앱 이름: 모아둠 (지어낸 앱)\n한 줄 소개: 여기저기 흩어진 구독 결제를 한 화면에 모으고 안 쓰는 구독을 찾아 주는 앱\n끝 장면 버튼 문구: 무료로 시작하기","output":"0~1.7초  훅: \"구독료, 매달 얼마 나가는지 아세요?\" (0프레임부터 표시)\n1.7~4.2초  문제: 구독 7개가 하나씩 붙으며 합계 ₩87,390, 자막 \"여기저기서 새는 돈\"\n4.2~7.2초  등장: 앱 화면이 올라오고 목록이 채워짐, 자막 \"한 화면에 전부\"\n7.2~9.6초  증거: 90일 미사용 3개 표시, \"정리하면 매달 ₩27,190 절약\"\n9.6~12.5초  끝 장면: 아이콘 · 모아둠 · \"흩어진 구독, 한 화면에\" · [무료로 시작하기]\n\n파일: renders/moa-promo.mp4 · 1080×1920 · 30fps · 12.5초 · H.264 · 1.5MB · 렌더 33.4초","format":"text"},"testedWith":[{"model":"Claude Code + HyperFrames 0.9.59","at":"2026-11"}],"durationMin":30,"url":"https://opencurrent.ai/w/app-promo-motion-shorts","title":"앱 홍보 숏폼 영상 만들기","summary":"잘된 앱 홍보 영상의 구성을 뽑아 내 앱에 그대로 입힌 세로 모션그래픽 영상을, 편집 프로그램 없이 파일로 받을 수 있습니다.","category":"글쓰기","categoryId":"writing","domain":"marketing","domainLabel":"마케팅","capabilities":[{"id":"video","label":"영상 생성"},{"id":"code","label":"코드 작성"}],"topics":[{"id":"writing","label":"글쓰기"}],"tools":["HyperFrames","Claude Code","FFmpeg"],"whenToUse":"참고할 홍보 영상에서 첫 장면·컷 길이·자막 자리·끝 장면을 에이전트가 뽑아 구성표로 정리합니다. 그 구성에 내 앱의 이름·한 줄 소개·스크린숏을 넣어 HTML로 9:16 영상을 짜고, 검사와 미리 보기 프레임을 거쳐 내 컴퓨터에서 MP4로 렌더합니다.","prerequisites":["내 컴퓨터의 폴더에서 일하는 코딩 에이전트 (Claude Code·Codex·Cursor 등) · 채팅 앱만으로는 렌더 불가","Node.js 22 이상과 FFmpeg, Chrome","내 앱의 스크린숏 2~4장 (세로 화면, PNG) · 없으면 앱 주소","참고할 홍보 영상 파일 1~3개 (내가 만들었거나 쓸 권리가 있는 것) · 없으면 본 영상을 말로 적은 설명"],"inputs":[{"name":"app_name","label":"앱 이름","description":"영상 끝 장면에 크게 나올 이름","example":"모아둠","required":true},{"name":"app_pitch","label":"한 줄 소개","description":"누구의 어떤 불편을 어떻게 풀어 주는지 한 문장","example":"여기저기 흩어진 구독 결제를 한 화면에 모으고 안 쓰는 구독을 찾아 주는 앱","required":true},{"name":"app_url","label":"앱 주소","description":"스토어나 소개 페이지 주소. 스크린숏만 쓸 때는 비움","example":"https://example.com","required":false},{"name":"cta","label":"끝 장면 버튼 문구","description":"영상을 다 본 사람에게 시킬 행동 하나","example":"무료로 시작하기","required":true},{"name":"ref_note","label":"참고 영상 설명","description":"참고 영상 파일이 없을 때 적는 메모: 첫 1~2초에 무엇이 나오는지, 장면이 몇 초마다 바뀌는지, 자막이 어디에 어떤 크기로 나오는지, 끝 장면","example":"첫 화면에 질문 한 줄이 꽉 차게 나옴. 2초마다 장면 전환. 자막은 화면 가운데 위쪽에 굵게 두세 단어. 마지막 2초는 앱 아이콘과 버튼","required":false}],"howToFollow":"1. 입력값(inputs)을 사용자에게 받아 프롬프트의 {{이름}} 자리에 넣을 것. 필수값이 없으면 먼저 물어볼 것.\n2. 단계를 순서대로 진행할 것. kind가 \"ai\"면 프롬프트를 실행하고, \"command\"면 사용자의 허락을 받고 명령을 실행하고, \"human\"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.\n3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.\n4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.\n5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.","steps":[{"n":1,"kind":"command","title":"Node.js와 FFmpeg 확인","body":"터미널에서 버전 확인. Node.js 22 미만이거나 FFmpeg가 없으면 먼저 설치","prompt":"node -v\nffmpeg -version","expected":"v22 이상의 Node 버전과 FFmpeg 버전 한 줄","check":"두 명령 모두 버전이 출력되는지 확인","tool":"FFmpeg"},{"n":2,"kind":"command","title":"세로 영상 프로젝트 만들기","body":"1080×1920 빈 프로젝트 생성. 에이전트용 스킬(/hyperframes 등)도 함께 설치됨. 끝나면 app-promo 폴더에서 에이전트를 새로 시작","prompt":"npx -y hyperframes init app-promo --non-interactive --resolution=portrait","expected":"index.html·CLAUDE.md·AGENTS.md·package.json이 든 app-promo 폴더","check":"index.html 안에 data-width=\"1080\" data-height=\"1920\"이 있는지 확인","tool":"HyperFrames"},{"n":3,"kind":"human","title":"참고 영상과 내 앱 자료 넣기","body":"참고 영상 파일은 app-promo/refs/ 에, 내 앱 스크린숏과 로고는 app-promo/assets/ 에 복사. 참고 영상 파일이 없으면 본 영상의 구성을 말로 적어 둠","expected":"refs 폴더의 영상 파일(또는 설명 메모)과 assets 폴더의 스크린숏","check":"스크린숏이 실제 앱 화면인지, 개인 정보가 찍혀 있지 않은지 확인"},{"n":4,"kind":"ai","title":"참고 영상의 구성 뽑기","body":"에이전트는 영상을 재생해 보지 못함. 컷 시각과 0.5초 간격 정지 화면 묶음을 만들어 그것을 읽게 함","prompt":"refs 폴더의 참고 영상마다 아래를 실행하고 결과를 읽어 줘.\n1) npx hyperframes measure cuts refs/<파일>  → 컷이 바뀌는 시각\n2) ffmpeg -i refs/<파일> -vf \"fps=2,scale=270:-1,tile=6x5\" -frames:v 1 refs/<파일이름>-sheet.jpg  → 0.5초 간격 정지 화면 묶음(15초 넘는 영상은 tile 칸 수를 늘려서)\n묶음 그림을 직접 보고 PATTERN.md에 구성표를 써 줘: 0프레임에 무엇이 보이는지, 첫 1~2초의 훅이 질문·결과·숫자 가운데 무엇인지, 장면 순서와 장면별 길이(초), 자막의 자리·크기·한 줄 글자 수, 앱 화면이 처음 나오는 시각, 끝 장면의 구성과 머무는 시간.\n참고 영상이 없으면 이 설명으로 같은 표를 써 줘: {{ref_note}}\n구성(순서·길이·자리)만 적고 문구·디자인·로고·음악은 옮기지 마. 그림에서 확인하지 못한 것(소리, 속도감)은 '확인 못 함'으로 적어 줘.","expected":"장면별 시각과 역할이 표로 정리된 PATTERN.md","check":"표의 장면 시각이 묶음 그림과 맞는지 두세 곳 대조 · '확인 못 함' 칸은 직접 보고 채움","tool":"Claude Code"},{"n":5,"kind":"ai","title":"내 앱 영상 짜기","body":"구성표를 따라 HTML로 영상 작성. 렌더 전에 멈추게 함","prompt":"/hyperframes 를 써서 PATTERN.md의 구성 그대로 내 앱 홍보 영상을 만들어 줘.\n- 앱 이름: {{app_name}}\n- 한 줄 소개: {{app_pitch}}\n- 앱 주소(있으면 화면·색 참고): {{app_url}}\n- 끝 장면 버튼 문구: {{cta}}\n조건:\n1) 1080×1920, 30fps, 10~15초. 소리 없음.\n2) 0프레임부터 훅 문구가 화면에 보일 것. 검은 화면이나 로고로 시작하지 말 것.\n3) 앱 화면은 assets 폴더의 스크린숏만 쓸 것. 없는 화면을 지어내지 말고, 필요한데 없으면 나에게 물어볼 것.\n4) 글자는 위 168px과 아래 590px, 오른쪽 버튼 줄을 피해서 놓을 것. 읽는 글자는 28px 이상.\n5) 한글 글꼴은 Pretendard(OFL) 파일을 assets/fonts에 넣고 @font-face로 지정할 것.\n6) 소개 문장에 없는 기능·숫자·후기를 만들어 넣지 말 것.\n끝나면 npx hyperframes check 를 돌려 오류 0이 될 때까지 고치고, 남은 경고를 알려 줘. 렌더는 내가 말할 때까지 하지 마.","expected":"장면이 채워진 index.html과 'Check passed' 결과","check":"check 출력의 Layout·Contrast 오류가 0인지 확인 · 안전 구역(outside_safe_zone) 경고가 남았으면 다시 요청","tool":"Claude Code"},{"n":6,"kind":"command","title":"미리 보기 프레임 확인","body":"렌더 전에 장면별 정지 화면을 뽑아 눈으로 확인. 시각은 PATTERN.md의 장면 시작에 맞춤","prompt":"npx hyperframes snapshot --at 0,3.6,6.5,9.2,12","expected":".hyperframes/artifacts/snapshots/ 아래의 프레임 PNG와 contact-sheet.jpg","check":"첫 프레임에 훅이 보이는지, 글자가 앱 화면과 겹치지 않는지, 숫자·문구가 사실과 맞는지 확인","tool":"HyperFrames"},{"n":7,"kind":"command","title":"MP4로 렌더","body":"내 컴퓨터에서 렌더. 계정·요금 없음","prompt":"npx hyperframes render -o renders/app-promo.mp4","expected":"renders/app-promo.mp4 (1080×1920, H.264)","check":"영상을 폰으로 옮겨 올릴 앱의 미리 보기에서 글자가 버튼·설명에 가리지 않는지 확인","tool":"HyperFrames"},{"n":8,"kind":"ai","title":"고칠 곳 말로 요청","body":"장면 시각을 짚어 한 번에 한두 가지씩 요청. 고친 뒤 check와 snapshot을 다시 거쳐 렌더","prompt":"방금 영상에서 다음을 고쳐 줘: (예: 0~1.7초 훅 문구를 '○○'로, 4초 장면을 0.5초 더 길게). 고친 뒤 npx hyperframes check 를 통과시키고, 바꾼 시각의 프레임을 snapshot으로 뽑아 보여 줘.","expected":"바뀐 장면의 프레임과 통과한 check","check":"요청한 곳만 바뀌었는지 프레임으로 확인","tool":"Claude Code"}],"pitfalls":["에이전트는 영상 주소를 받아 재생해 보지 못함 · 파일에서 뽑은 정지 화면과 컷 시각으로 구성만 파악 · 소리·음악·속도감은 사람이 보고 말로 보충","모션그래픽의 부드러운 전환은 컷 감지가 놓침 · 직접 만든 12.5초 영상의 장면 전환 3곳 중 ffmpeg 장면 감지는 1곳, measure cuts는 2곳만 잡음 · 정지 화면 묶음을 꼭 함께 읽게 할 것","남의 영상은 구성(순서·길이·자막 자리)만 참고 · 문구·디자인·로고·음악 복사 금지 · 플랫폼 영상 내려받기는 약관 위반 소지, 권리 있는 파일이나 말 설명 사용","구성을 따라 해도 조회수는 보장되지 않음 · 훅 문구를 바꾼 판을 두세 개 만들어 비교","init 명령이 스킬을 홈 폴더(~/.claude/skills, ~/.agents/skills, ~/.gemini/skills)에 설치 · 원치 않으면 --skip-skills 옵션","기본 포함 글꼴에 한글 없음 · 한글 글꼴 파일을 assets/fonts에 넣고 @font-face로 지정 · 글꼴마다 라이선스 확인","첫 초안에서 자막이 앱 화면과 겹치고 TikTok·Reels·Shorts 안전 구역 밖 글자 다수 · check가 오류 7건·경고 25건으로 잡아냄 · 두 번 고쳐 통과","없는 앱 화면·기능·숫자·후기를 지어내기 쉬움 · 실제 스크린숏만 쓰게 하고 문구를 사람이 대조","소리 없는 영상으로 나옴 · 음악·효과음·목소리는 따로 넣어야 하고 HeyGen 음성·음악은 계정 필요","내 컴퓨터 렌더는 무료·계정 불필요 · 영상 통째 복제(reverse-any-video), 클라우드 렌더, 데스크톱 앱은 HeyGen 계정이나 유료 요금제(Pro 월 25달러) 대상","CLI가 명령 이름·렌더 성능 같은 사용 통계를 보냄 · 끄기: npx hyperframes telemetry disable","메모리 8GB 맥에서 doctor가 메모리 부족 경고 · 12.5초 영상 렌더는 33초에 끝남 · 긴 영상은 다른 앱을 닫고 실행"],"sources":[{"title":"heygen-com/hyperframes (GitHub, Apache 2.0)","url":"https://github.com/heygen-com/hyperframes"},{"title":"HyperFrames Quickstart","url":"https://hyperframes.heygen.com/quickstart"},{"title":"HyperFrames FAQ (비용·계정·사용 통계)","url":"https://hyperframes.heygen.com/faq.md"},{"title":"HyperFrames: Product launch video guide","url":"https://hyperframes.heygen.com/guides/product-launch-video.md"},{"title":"HyperFrames CLI reference","url":"https://hyperframes.heygen.com/packages/cli"}],"verification":{"status":"pending","label":"검수 대기","detail":"사람 확인 전","verifiedBy":0,"lastVerifiedAt":null},"quality":{"score":32,"components":{"result":0.5,"trust":0,"freshness":0.4},"explanation":"확인 없음 · 검수 대기"},"workedFor":0,"trials":{"summary":"","lastAt":null,"total":0,"worked":0,"partial":0,"failed":0,"recent":[]},"asOf":{"date":"2026-11-17T10:00:00+00:00","basis":"updated"},"updatedAt":"2026-11-17T10:00:00+00:00","goals":[{"id":"writing","title":"글쓰기"}],"uses":19,"likes":0,"evidence":{"outcome":"앱 이름과 한 줄 소개, 앱 화면만으로 1080×1920·12.5초 홍보 영상 파일이 나옴. 렌더 33초, 편집 프로그램 없음","basis":"shown","basisLabel":"결과물로 확인","result":{"type":"images","images":[{"src":"/results/app-promo-motion-shorts/four-scenes.jpg","alt":"렌더한 영상의 네 장면: 질문 훅, 흩어진 구독료 합계, 앱 화면의 미사용 구독 표시, 이름과 버튼이 있는 끝 장면","label":"영상의 네 장면"},{"src":"/results/app-promo-motion-shorts/proof-frame.jpg","alt":"9.2초 프레임: 자막 '안 쓰는 구독 3개 발견'과 앱 화면의 절약 금액","label":"9.2초 프레임"}]},"run":{"by":"OpenCurrent 편집 에이전트 (Claude Code)","input":"지어낸 구독 관리 앱 '모아둠'의 이름·한 줄 소개와 HTML로 그린 앱 화면. 참고 영상 없이 HyperFrames의 세로 영상 지침으로 구성. 맥 M3 8GB","mode":"sample","modeLabel":"샘플 데이터로 실행"},"toolRoles":[{"tool":"Claude Code","role":"참고 영상의 정지 화면을 읽어 구성표 작성, HTML 영상 작성과 수정"},{"tool":"HyperFrames","role":"세로 프로젝트 생성, 겹침·안전 구역·대비 검사, 프레임 미리 보기, MP4 렌더"},{"tool":"FFmpeg","role":"참고 영상에서 0.5초 간격 정지 화면 묶음 추출, 렌더의 영상 인코딩"}]}}