⚡ 빠른 가이드 — 루카스 박물관 15초 워크플로우

건물 브리프 + 참고 이미지 → 시네마틱 시공 영상 (빈 부지 → 기초 → 골조 → 외피 → 완공). Claude Code + Higgsfield CLI + ffmpeg 한 가지 워크플로우. 루카스 박물관 15초 영상에 쓴 셋업 그대로.

셋업 (한 번만)

1) 맨 밑에 있는 파일 다운로드 받고 폴더에 저장. 스킬 파일(SKILL.md) 스킬 폴더에 따로 저장 추천.

폴더 이름은 SKILL.md Claude Code 재시작. 나머지는 프로젝트 폴더에 저장.

2) Higgsfield CLI 설치 + 인증 (머신에 한 번만)

npm install -g @higgsfield/cli   # 크로스 플랫폼, Node.js 필요
higgsfield auth login            # 브라우저 OAuth 창이 열림
higgsfield account status        # 이메일·플랜·크레딧 표시되면 OK

CLI는 머신 레벨에서 실행되므로 모든 Bash 세션에서 그대로 호출 가능. MCP 동기화나 Claude Code 재시작 장난 없음. (MCP 경유로 가고 싶다면 아래 "전체 레퍼런스"의 방법 B 참고.)

사용 — Claude Code에서 한 줄

"[브리프]에 대한 건축 진행 영상 만들어줘. 참고 이미지 첨부했어."

예: "엘에이 루카스 박물관 시공 영상 15초로 만들어줘. 참고 이미지 첨부." 이미지 대신 웹사이트 링크나

유명한 건물이면 이름을 주고 알아서 구글 검색하고 사진 다운받으라고 함.

*처음할때 스킬이 제대로 깔렸는지 물어보고 폴더의 경로를 주며 이 스킬을 사용하여 만들어달라고 확인하기

자동 워크플로우 6단계

1. 위자드      언어 → 참고자료 → 패턴 → 승인 모드
2. 주체 DNA    + 지오메트리 락 (positive plan_shape, forbidden_shapes)
3. 매트릭스     주체 × 단계 (부지/기초/골조/외피/인테리어/완공)
4. 시퀀스      트랜지션, 길이, 오버레이 텍스트
5. 생성        gpt_image_2 (이미지보드) → seedance_2_0 풀 버전 (영상)
6. 조립        assemble_progress_video.py → 마스터 MP4

꼭 기억할 함정 3개

1) 지오메트리 락 — 형태 드리프트 막기 ★

Seedance가 이미지보드 셀끼리 보간하면서 건물 형태를 영상 중간에 바꿔버린다. 모든 video_prompt 상단에: