# 작업지시서: automations\hyperframes-lab → apps\shorts-studio 병합 (사용자 승인 완료)

## 실행 규칙 (반드시)
- 모든 명령은 포그라운드로 실행하고 끝날 때까지 기다린다. 턴을 먼저 끝내지 말 것.
- 렌더 금지. 패키지 설치 금지. 아래 명시된 경로 외 수정·삭제 금지.
- **삭제는 3단계 검증을 통과한 뒤에만.** 검증 실패 시 삭제하지 말고 failed로 보고.

## 원본
`C:\Ai_Coding\automations\hyperframes-lab\` (Syncthing 동기화 폴더 안에 있음)
- `.agents\skills\hyperframes\` (로컬 스킬 + frame-presets)
- `aura-buds-promo\`, `chat-drama-01\`, `chat-drama-02\`, `diary-film-01\`
- `SPEC.md` (aura-buds-promo\SPEC.md 와 중복 추정)

## 1단계 — 복사 (캐시 제외)
robocopy 사용, 캐시 디렉터리 제외: `/XD node_modules bin` 는 **`.hyperframes\bin` 만** 제외되도록 주의(다른 이름의 bin 폴더가 있으면 목록에 기록 후 포함). 권장: 프로젝트별로 `robocopy <src> <dst> /E /XD "<src>\.hyperframes\bin" "<src>\node_modules"`.
| 원본 | 대상 |
|---|---|
| `hyperframes-lab\.agents\` | `C:\Ai_Coding\apps\shorts-studio\.agents\` |
| `aura-buds-promo\` | `apps\shorts-studio\episodes\2026-11-08_aura-buds-promo\` |
| `chat-drama-01\` | `episodes\2026-11-08_chat-drama-01\` |
| `chat-drama-02\` | `episodes\2026-11-08_chat-drama-02\` |
| `diary-film-01\` | `episodes\2026-11-08_diary-film-01\` |
- 루트 `SPEC.md`: aura-buds-promo\SPEC.md 와 해시(Get-FileHash) 비교 → 같으면 복사 안 함, 다르면 `episodes\2026-11-08_aura-buds-promo\SPEC_lab-root.md` 로 복사.
- 이미 대상에 같은 이름이 있으면 덮어쓰지 말고 중단·보고.

## 2단계 — 경로 정리
- 복사본의 .html/.js/.mjs/.json/.md/.ps1 에서 `automations\hyperframes-lab` 또는 `automations/hyperframes-lab` 절대경로 grep → 새 위치 기준으로 치환(가능하면 상대경로). 치환 내역 기록.

## 3단계 — 검증
- 파일 수·용량 비교표: 원본(캐시 제외 기준) vs 복사본 — 일치해야 함.
- index.html 이 있는 에피소드(aura-buds-promo, chat-drama-01, chat-drama-02)에서 `npx hyperframes check` 실행 → 오류 수 기록. (`.hyperframes\bin` 없이도 check가 동작하는지 = 캐시 재생성 여부 확인용. 실패하면 원문 기록)
- 각 `renders\*.mp4` ffprobe 길이 확인.

## 4단계 — 정리 (3단계 통과 시에만)
1. `C:\Ai_Coding\automations\hyperframes-lab\` 폴더 삭제.
2. `C:\Ai_Coding\automations\` 루트의 UUID 이름 mp4 3개(`7e4414d7-…mp4`, `c2ec4e6b-…mp4`, `de3350a0-…mp4`)를 아래 원본과 Get-FileHash 비교:
   `apps\shorts-studio\episodes\2026-11-08_ai-workflow-A\out\final.mp4`, `…_ai-workflow-B\out\final.mp4`, `…_free-tools-4\out\final.mp4`
   - 해시가 같은 것만 삭제. 다른 것은 삭제하지 말고 `episodes\_unsorted\` 로 이동 후 보고.
3. `apps\shorts-studio\README.md` 의 폴더 구조 설명에 `.agents\skills\hyperframes`(프레임 프리셋 포함)와 새 에피소드 4개를 추가.

## 완료 증거
`C:\Ai_Coding\apps\shorts-studio\MERGE_REPORT.md`: 복사 대상·제외한 캐시 용량, 비교표, 경로 치환 내역, check 결과, ffprobe 결과, mp4 해시 비교 결과와 삭제/이동 내역, 삭제한 폴더.

## 성공/실패 기준
- 1~4단계 완료 → succeeded. 3단계 검증 실패로 4단계를 건너뛰었다면 failed + 사유.
- worker_done에 --task-id, --dispatch-id 포함, --report-path C:\Ai_Coding\apps\shorts-studio\MERGE_REPORT.md
