Omni-Design Studio（3단계 결정론적 디자인 & 프로모 비디오 통합 스킬）은(는) 무엇을 하나요?

🎯 설계 철학（왜 하위 모델에서도 프로 품질이 나오는가?） 복잡한 판단(색채 추출・캐치카피 합성・비대칭 편집 조판・300DPI PDF/SVG 전개도・24fps 동영상 이징 & 음성 합성)을 모두 **build_omni_design.py 1개의 결정론적 Python 파이프라인(Formula-First)**에 담았습니다. AI 에이전트(상위・하위 모델 불문)는 아래 **「3단계 (①준비 ➔ ②사진 3장 생성 ➔ ③일괄 빌드)」**를 순서대로 실행하기만 하면, 항상 인간 디자이너 품질의 결과물을 출력할 수 있습니다.

🗺️ 전체 아키텍처 다이어그램（3단계 상태 머신）

flowchart TD
    Start(["👤 사용자 요청"]) --> Check{"컨셉・참조 이미지가<br>지정되었는가?"}

    %% Step 1
    Check -- "미지정（모호한 요청）" --> Ask["【Step 1A】5가지 핵심 질문 제시<br>build_omni_design.py --ask-concept"]
    Ask --> UserAns["사용자 응답 / 시트 작성"]
    Check -- "지정됨 / 응답 완료" --> PromptGen["【Step 1B】DNA 추출 & 사진 프롬프트 3개 출력<br>build_omni_design.py --print-image-prompts<br>(--ref-image / --ref-url / --concept-sheet)"]
    UserAns --> PromptGen

    %% Step 2
    PromptGen --> Harness{"실행 환경(하네스)은?"}
    Harness -- "Codex (Primary)" --> CodexImg["【Step 2A】Codex 내장 image_gen 도구 × 3회<br>(gpt-image-2.5-sunburst / 구독료 0원)<br>~/.codex/generated_images/ 에 자동 저장"]
    Harness -- "Antigravity" --> AgyImg["【Step 2B】image-generator 하위 에이전트 × 3장<br>(Imagen 4 Ultra / 구독료 0원)"]
    Harness -- "직접 보유 사진 / 없음" --> DirectBuild

    %% Step 3
    CodexImg --> DirectBuild["【Step 3】1개 명령 전 매체 빌드<br>build_omni_design.py --auto-codex-images --with-promo-video"]
    AgyImg --> DirectBuild

    DirectBuild --> Out(["📦 자유롭게 편집 가능한 완성 패키지 (0원)<br>① website.html / poster.html / packaging_mockup.html<br>（WordPress 스타일 비주얼 블록 & 캔버스 에디터 내장）<br>② website_preview.png / poster_300dpi.png / poster_print.pdf / packaging_3d_mockup.png / packaging_dieline.svg<br>③ promo_video_vertical_9x16.mp4 / landscape_16x9.mp4<br>④ promo_video_studio_9x16.html / 16x9.html（브라우저 자막 & 타임라인 편집 스튜디오）<br>⑤ promo_captions.srt / .vtt（Premiere・CapCut용 자막）& promo_audio_track.wav"])

⚡ 하위 모델에서도 절대 망설이지 않는 「3단계 실행 규칙」

스크립트 경로는 항상 아래 1개만을 사용합니다（다른 하위 스크립트는 내부에서 자동 호출됨）： SCRIPT="$HOME/.codex/skills/omni-design-studio/scripts/build_omni_design.py"

Step 1: 컨셉 확인 & 사진 생성 프롬프트 3개 획득

캐치카피나 컨셉이 미정인 경우는 먼저 다음을 실행하여 사용자에게 5가지 질문(타겟・3가지 혜택・누구에게×무엇에 의해×어떻게 될 수 있는지・기존 전제의 파괴➔진정한 해결책・Before/After)을 묻습니다：
```
python3 "$SCRIPT" --ask-concept
```
(템플릿 원본: templates/CONCEPT_QUESTION_SHEET.md)
브랜드명・참조 이미지（--ref-image / --ref-url）가 결정되면 --print-image-prompts를 붙여 실행하여 색채・취향 DNA에 조화된 3장의 사진용 프롬프트(JSON)를 획득합니다：
```
python3 "$SCRIPT" \
  --brand "브랜드명" \
  --category "상품 카테고리（예: 귀걸이・파인 주얼리）" \
  --ref-image "/path/to/reference.jpg" \
  --print-image-prompts
```
(※참조 이미지가 없는 경우 --ref-image를 생략하면 기본 인간 큐레이션 DNA organic_editorial의 색상・취향이 사용됩니다)

Step 2: 구독료 0원 최상위 모델로 사진 소재 3장 생성（텍스트 없는 사진）

Step 1에서 출력된 3개의 프롬프트(hero_image_prompt, poster_image_prompt, pack_image_prompt)를 사용하여, 텍스트를 포함하지 않는 순수한 상업용 스튜디오 사진 3장을 생성합니다（API 키 종량제 과금은 엄금・구독료 범위 내에서만）：

🅰️ Codex에서 실행 중인 경우（제1 우선: gpt-image-2.5-sunburst）: Codex 내장의 image_gen 도구를 3회 호출합니다（~/.codex/generated_images/에 자동 저장됨）。
🅱️ Antigravity에서 실행 중인 경우（Imagen 4 Ultra / Nano Banana 2.1）: invoke_subagent(TypeName="image-generator")을 호출하여 3장 생성하고, 저장 경로를 수신합니다。
🅲 사용자가 사진을 준비하는 경우: Step 1（--print-image-prompts를 뺀 실행）이 출력하는 「📋 에이전트로부터의 소재 요청（필요한 사진의 구도・권장 사이즈・AI 프롬프트 안）」을 그대로 사용자에게 전달합니다。

Step 3: 1개 명령으로 모든 디자인 & 프로모 비디오를 일괄 출력

이제 아래 1개 명령만 실행하면, WordPress처럼 브라우저에서 이미지・텍스트・요소・레이아웃을 자유자재로 편집할 수 있는 3개의 HTML, 고해상도 PNG/PDF/SVG, 그리고 후에 자막이나 영상을 자유롭게 편집할 수 있는 프로모션 비디오 세트가 모두 완성됩니다：

# Codex의 경우（--auto-codex-images로 Step 2의 생성 이미지를 자동 바인드）
python3 "$HOME/.codex/skills/omni-design-studio/scripts/build_omni_design.py" \
  --auto-codex-images \
  --target all \
  --with-promo-video \
  --brand "LUMIÈRE & CO." \
  --category "귀걸이・파인 주얼리" \
  --headline "Luminous Craft," \
  --subcopy "18K 리사이클 골드와 아코야 진주가 만들어내는 유기적인 귀걸이 컬렉션" \
  --out-dir ~/Downloads/omni_output_pack

# Antigravity / Claude Code 또는 개별 이미지 경로 지정의 경우
python3 "$HOME/.codex/skills/omni-design-studio/scripts/build_omni_design.py" \
  --target all \
  --with-promo-video \
  --brand "LUMIÈRE & CO." \
  --category "귀걸이・파인 주얼리" \
  --headline "Luminous Craft," \
  --subcopy "18K 리사이클 골드와 아코야 진주가 만들어내는 유기적인 귀걸이 컬렉션" \
  --hero-image /path/to/hero.jpg \
  --poster-image /path/to/poster.jpg \
  --pack-image /path/to/pack.jpg \
  --out-dir ~/Downloads/omni_output_pack

🎨 출력 후 WordPress 스타일 비주얼 편집 & 동영상 자막 편집 기능（표준 내장）

생성되는 3개의 디자인 파일(website.html, poster.html, packaging_mockup.html)과 동영상 스튜디오 파일(promo_video_studio_9x16.html, promo_video_studio_16x9.html)에는 cms_editor_runtime.py에 의해 WordPress(Gutenberg)/Studio 스타일의 비주얼 에디터（✦ OMNI WP-STUDIO） 가 자동 내장되어 있습니다. 브라우저에서 열기만 하면 다음과 같은 편집이 가능합니다：

텍스트 직접 편집（Inline WYSIWYG）: 제목・본문・뱃지・세로쓰기 카피를 클릭하여 그 자리에서 타이핑 수정, 글자 크기（A+/A-）・글자색・폰트 패밀리（명조 / 와 모던 / 고딕 / 브루탈리즘 / 스위스 그리드）를 원클릭 변경합니다.
이미지 교체 & 프레임 모양 변경: 이미지를 더블 클릭（또는 PC에서 드래그 & 드롭）하는 것만으로 다른 사진으로 즉시 교체 가능합니다. 프레임의 모양도 「아치 창 (Arch)」「둥근 모서리 카드 (Bento)」「직각 (Sharp)」「원형 (Circle)」으로 자유롭게 전환 가능합니다.
요소・블록・레이아웃 자유로운 이동: 선택한 요소의 상하좌우 이동（↑/↓/←/→）, 블록 복제（⧉）・삭제（🗑️）, 새로운 텍스트/이미지 블록 추가（＋ 텍스트 추가 / 🖼️ 이미지 추가）, 좌우 2컬럼 구성의 원클릭 반전（⇄ 레이아웃 반전）.
편집된 HTML 저장 & PDF 내보내기: 툴바의 💾 HTML 저장으로 편집 후 상태를 단일 HTML로 저장, 🖨️ PDF 출력으로 툴바를 자동 숨김 처리한 고해상도 PDF/인쇄 출력.
동영상 사후 편집・자막 편집（Post-Production Ready）:
- promo_video_studio_9x16.html / 16x9.html: 하단의 타임라인 바에서 Scene 1〜4를 시크・재생하면서, 동영상 내의 자막(캡션)・제목・사진을 직접 재작성하고, 📝 SRT 자막 저장 버튼으로 편집 후 자막 파일을 즉시 내보내기 가능합니다.
- promo_captions.srt / promo_captions.vtt / promo_audio_track.wav: Premiere Pro, CapCut, DaVinci Resolve, Final Cut Pro 등에 그대로 불러와 자막 교체나 BGM/내레이션 재편집이 가능합니다.

🛠️ 옵션 기능 참조（필요할 때만 사용）

하고 싶은 일	추가 플래그 / 명령
기입 완료된 컨셉 시트에서 카피 자동 반영	`--concept-sheet /path/to/CONCEPT_QUESTION_SHEET.md`
참조 이미지 / 참조 URL의 색상・취향・폰트 완전 재현	`--ref-image /path/to/sample.jpg` 또는 `--ref-url https://...`
디자인 스타일 수동 지정（기본값은 `organic_editorial`）	`--trend [organic_editorial \| japanese_luxury \| bento_glass \| neo_brutalism \| swiss_editorial \| cyber_pop]`
인간 디자이너 100선의 콘택트 시트 생성	`python3 .../scripts/curate_human_designs.py --out-dir ~/Downloads/curation_100`
양산 모드（Plan B: DeepSeek + Flux 약 0.6엔/점）	`--plan plan_b`（기본값은 `--plan plan_a` = 구독료 0원）

Omni-Design Studio（3단계 결정론적 디자인 & 프로모 비디오 통합 스킬）