# 작업지시서: shorts-studio 에피소드 구조 통일 (사용자 승인 완료)

## 실행 규칙 (반드시)
- 모든 명령은 포그라운드로 실행하고 끝날 때까지 기다린다. 턴을 먼저 끝내지 말 것.
- 편집 범위: `C:\Ai_Coding\apps\shorts-studio\` 내부만. 렌더 금지. 패키지 설치 금지.
- **작업 전 전체 백업**: `C:\Ai_Coding\apps\shorts-studio\` 를 `%TEMP%\shorts-studio-backup-20261108\` 로 robocopy /E 복사. 실패한 에피소드는 이 백업에서 원래 구조로 복원.
- 파일 내용(대본·설계·코드 로직)은 수정하지 말 것. **이동·이름변경·경로 참조 수정만** 허용.

## 목표 구조 (모든 에피소드 동일)
```
episodes\YYYY-MM-DD_<주제>\
├─ README.md     한 줄 요약 표: 제목 | 스타일 | 길이 | 상태
├─ script.md     (있으면)
├─ SPEC.md       작업지시서·설계 (TASK_SPEC.md 또는 SPEC.md → SPEC.md)
├─ REVIEW.md     결과보고·검수 (REPORT.md 또는 REVIEW.md → REVIEW.md)
├─ src\          HyperFrames 프로젝트 전체 (index.html, hyperframes.json, package*.json, index.motion.json, meta.json, storyboard.json, assets\, compositions\, 생성 스크립트 .py/.mjs/.ps1, AGENTS.md/CLAUDE.md 등)
└─ out\          final.mp4 (+ frames\ 또는 previews\)
```

## 에피소드별 작업
| 에피소드 | 할 일 |
|---|---|
| ai-workflow-A, ai-workflow-B, free-tools-4 | TASK_SPEC.md→SPEC.md, REPORT.md→REVIEW.md 이름 변경. README.md 추가. src·out는 그대로 |
| aura-buds-promo | 소스 파일 전부 → src\ (AGENTS.md·CLAUDE.md는 내용이 같으면 src\ 안에 둘 다 유지 — HyperFrames 에이전트 안내문). renders\*.mp4 → out\final.mp4 (여러 개면 대표 1개를 final.mp4, 나머지는 원래 이름으로 out\에), renders\preview-frames\ → out\frames\. SPEC.md·REVIEW.md는 루트 유지 |
| chat-drama-01, chat-drama-02 | 소스(index.html, *.json, assets\, compositions\) → src\. renders\final.mp4 → out\final.mp4, previews\ → out\previews\. script.md·SPEC.md·REVIEW.md 루트 유지 |
| diary-film-01 | 영상 미완성(Google Flow 준비 단계). 스크립트·json·hyperframes.json·assets\ → src\, verification\·previews\ → out\. README.md는 기존 내용을 **REVIEW.md 로 이름 변경**하고 새 README.md(상태: 준비)를 만듦. FLOW_RESULT.md·verification-report.md는 루트 유지 |
- 모든 에피소드의 `.hyperframes\` 캐시 폴더 삭제.

## 경로 수정
- src\로 옮긴 파일 안에서 상위 상대경로(`../renders`, `./renders`, `previews/` 등 출력 경로) 참조가 깨지면 새 위치(`../out/...`) 기준으로만 수정. 수정 내역 기록.

## 루트 정리
- `MIGRATION_REPORT.md`, `MERGE_REPORT.md`, `TASK_SPEC_merge-lab.md` → `docs\history\`
- 이 지시서(`docs\TASK_SPEC_tidy.md`)도 끝나면 `docs\history\`로.
- `README.md` 에 "## 에피소드 목록" 표 추가(기존 내용은 유지): 폴더명 | 제목 | 스타일(A/B/C 또는 lab 고유) | 길이(ffprobe) | 상태(완성/준비)
- README의 폴더 구조 설명을 새 에피소드 구조로 갱신.

## 검증 (필수)
- index.html 이 있는 6개 에피소드: `src\`에서 `npx hyperframes check` → 오류 0 이어야 함. 실패하면 그 에피소드만 백업에서 원래 구조로 복원하고 보고.
- 모든 out\final.mp4 ffprobe 길이 기록.
- 이동 전후 파일 수 비교(.hyperframes 제외) 일치.

## 완료 증거
`docs\history\TIDY_REPORT.md`: 에피소드별 이동 내역, 경로 수정 내역, check 결과 6개, ffprobe 결과, 파일 수 비교, 복원한 에피소드(있으면), 백업 위치.

## 성공/실패 기준
- 7개 에피소드 모두 새 구조 + check 통과 → succeeded. 일부 복원 시 succeeded로 보고하되 본문 첫 문장에 명시.
- worker_done에 --task-id, --dispatch-id 포함, --report-path C:\Ai_Coding\apps\shorts-studio\docs\history\TIDY_REPORT.md
