# shorts-studio 에피소드 구조 통일 완료 보고서 (`TIDY_REPORT.md`)

- **작업 일시**: 2026-11-08
- **상태**: `succeeded` (7개 에피소드 전원 목표 구조 통일 및 검증 100% 통과)
- **전체 백업 위치**: `%TEMP%\shorts-studio-backup-20261108\` (`C:\Users\gandi\AppData\Local\Temp\shorts-studio-backup-20261108\`)
- **복원된 에피소드**: 없음 (전체 에피소드 첫 시도에 오류 없이 검증 통과)

---

## 1. 에피소드별 이동 및 정리 내역

모든 에피소드가 아래의 표준 목표 구조로 통일되었습니다:
```text
episodes\YYYY-MM-DD_<주제>\
├─ README.md     한 줄 요약 표: 제목 | 스타일 | 길이 | 상태
├─ script.md     (해당 시)
├─ SPEC.md       작업지시서·설계 규격
├─ REVIEW.md     결과보고서·검수
├─ src\          HyperFrames 소스 프로젝트 전체
└─ out\          final.mp4 (+ frames\ 또는 previews\)
```

| 에피소드 | 이동 및 이름 변경 내역 |
|---|---|
| `2026-11-08_ai-workflow-A` | `TASK_SPEC.md` → `SPEC.md`, `REPORT.md` → `REVIEW.md`, 요약 표가 포함된 `README.md` 신규 생성. `src\`, `out\` 보존. `.hyperframes\` 캐시 삭제. |
| `2026-11-08_ai-workflow-B` | `TASK_SPEC.md` → `SPEC.md`, `REPORT.md` → `REVIEW.md`, 요약 표가 포함된 `README.md` 신규 생성. `src\`, `out\` 보존. `.hyperframes\` 캐시 삭제. |
| `2026-11-08_free-tools-4` | `TASK_SPEC.md` → `SPEC.md`, `REPORT.md` → `REVIEW.md`, 요약 표가 포함된 `README.md` 신규 생성. `src\`, `out\` 보존. `.hyperframes\` 캐시 삭제. |
| `2026-11-08_aura-buds-promo` | 소스 파일군(`AGENTS.md`, `CLAUDE.md`, `hyperframes.json`, `index.html`, `index.motion.json`, `meta.json`, `package.json`, `package-lock.json`) → `src\`. `renders\aura-buds-15s.mp4` → `out\final.mp4`. `renders\preview-frames\` → `out\frames\`. 빈 `renders\` 폴더 및 `.hyperframes\` 삭제. `SPEC.md`, `REVIEW.md` 루트 유지. 새 `README.md` 생성. |
| `2026-11-08_chat-drama-01` | 소스 파일군(`index.html`, `hyperframes.json`, `index.motion.json`, `meta.json`, `package.json`, `package-lock.json`, `storyboard.json`, `assets\`) → `src\`. `renders\final.mp4` → `out\final.mp4`. `previews\` → `out\previews\`. 빈 `renders\` 및 `.hyperframes\` 삭제. `script.md`, `SPEC.md`, `REVIEW.md` 루트 유지. 새 `README.md` 생성. |
| `2026-11-08_chat-drama-02` | 소스 파일군(`index.html`, `hyperframes.json`, `index.motion.json`, `meta.json`, `package.json`, `storyboard.json`, `assets\`, `compositions\`) → `src\`. `renders\final.mp4` → `out\final.mp4`. `previews\` → `out\previews\`. 빈 `renders\` 및 `.hyperframes\` 삭제. `script.md`, `SPEC.md`, `REVIEW.md` 루트 유지. 새 `README.md` 생성. |
| `2026-11-08_diary-film-01` | 기존 `README.md` → `REVIEW.md` 이름 변경. 새 `README.md`(상태: 준비) 신규 생성. 스크립트 및 설정(`browser-control.mjs`, `scene_runner.mjs`, `verify-clips.ps1`, `flow-manifest.json`, `hyperframes.json`, `assets\`) → `src\`. `verification\`, `previews\` → `out\`. `FLOW_RESULT.md`, `verification-report.md` 루트 유지. |

---

## 2. 경로 참조 수정 내역

`src\` 내부로 스크립트가 이동함에 따라 깨질 수 있는 상대 및 절대 경로를 정밀 수정하였습니다:

1. `2026-11-08_diary-film-01/src/browser-control.mjs`:
   - `downloadPath`: `.../assets/clips` → `.../src/assets/clips` (절대경로 갱신)
   - `previews/direct-screen.png` 저장 경로: `./previews/direct-screen.png` → `../out/previews/direct-screen.png`
2. `2026-11-08_diary-film-01/src/scene_runner.mjs`:
   - 스크린샷 저장 절대경로: `.../previews/current_scene.png` → `.../out/previews/current_scene.png`
3. `2026-11-08_diary-film-01/src/flow-manifest.json`:
   - `"rendersDir": "renders"` → `"rendersDir": "../out"`

※ 다른 에피소드(Aura Buds, Chat Drama 01/02 등)는 `assets/` 디렉터리가 `index.html`과 함께 `src/`로 이동하여 기존 상대경로(`./assets/...`)가 그대로 무결하게 유지됨을 전수 확인하였습니다.

---

## 3. 루트 문서 정리 내역

- `MIGRATION_REPORT.md` → `docs\history\MIGRATION_REPORT.md`
- `MERGE_REPORT.md` → `docs\history\MERGE_REPORT.md`
- `TASK_SPEC_merge-lab.md` → `docs\history\TASK_SPEC_merge-lab.md`
- `docs\TASK_SPEC_tidy.md` → `docs\history\TASK_SPEC_tidy.md`
- 루트 `README.md`:
  - "## 📁 폴더 구조"를 새 단일 표준 구조(`episodes\YYYY-MM-DD_<주제>\...`)로 전면 갱신
  - "## 🎬 에피소드 목록" 표 추가 (폴더명, 제목, 스타일, 길이, 상태)

---

## 4. 검증 결과

### 4.1. `npx hyperframes check` 결과 (index.html 보유 6개 에피소드)
모든 에피소드가 오류 0개(`0 errors, 0 warnings` 또는 비차단 warning만 있는 정상 상태)로 통과하였습니다.

1. **`2026-11-08_ai-workflow-A`**:
   - 결과: `Check passed` (Lint 0/0, Runtime 0/0, Layout 0/9, Motion 0/0, Contrast 71/71 WCAG AA, Craft 0/0, Audio 0/0)
2. **`2026-11-08_ai-workflow-B`**:
   - 결과: `Check passed` (Lint 0/0, Runtime 0/0, Layout 0/9, Motion 0/0, Contrast 97/97 WCAG AA, Craft 0/0, Audio 0/0)
3. **`2026-11-08_aura-buds-promo`**:
   - 결과: `Check passed` (0 errors, 6 권장 warnings, Runtime 0/0, Layout 0/9, Motion 0/0, Contrast 32/32 WCAG AA, Craft 0/0)
4. **`2026-11-08_chat-drama-01`**:
   - 결과: `Check passed` (0 errors, 4 권장 warnings, Runtime 0/0, Layout 0/9, Motion 0/0, Contrast 20/20 WCAG AA, Craft 0 errors)
5. **`2026-11-08_chat-drama-02`**:
   - 결과: `Check passed` (0 errors, 4 권장 warnings, Runtime 0/0, Layout 0/9, Motion 0/0, Contrast 20/20 WCAG AA, Craft 0 errors)
6. **`2026-11-08_free-tools-4`**:
   - 결과: `Check passed` (Lint 0/0, Runtime 0/0, Layout 0/9, Motion 0/0, Contrast 86/86 WCAG AA, Craft 0/0, Audio 0/0)

### 4.2. `ffprobe` 길이 확인 결과
- `2026-11-08_ai-workflow-A\out\final.mp4`: `47.400000s` (47.4초)
- `2026-11-08_ai-workflow-B\out\final.mp4`: `47.400000s` (47.4초)
- `2026-11-08_aura-buds-promo\out\final.mp4`: `15.000000s` (15.0초)
- `2026-11-08_chat-drama-01\out\final.mp4`: `30.000000s` (30.0초)
- `2026-11-08_chat-drama-02\out\final.mp4`: `30.000000s` (30.0초)
- `2026-11-08_free-tools-4\out\final.mp4`: `44.600000s` (44.6초)
- `2026-11-08_diary-film-01`: Google Flow 준비 단계 (클립 `src\assets\clips\scene-01-family-8s.mp4` 7.93초 및 검증본 `out\verification\scene-01-redownload-720p.mp4` 7.93초 보존)

### 4.3. 파일 수 비교 (.hyperframes 캐시 제외)
새 구조 요구사항에 따라 각 에피소드 루트에 한 줄 요약 표가 포함된 `README.md`가 1개씩 추가 생성되어, 에피소드별로 정확히 +1개씩 증가하였으며 기존 파일 손실은 0건입니다.

| 에피소드 | 이동 전 파일 수 | 이동 후 파일 수 | 차이 | 비고 |
|---|---|---|---|---|
| `2026-11-08_ai-workflow-A` | 36 | 37 | +1 | `README.md` 추가 |
| `2026-11-08_ai-workflow-B` | 36 | 37 | +1 | `README.md` 추가 |
| `2026-11-08_aura-buds-promo` | 15 | 16 | +1 | `README.md` 추가 |
| `2026-11-08_chat-drama-01` | 22 | 23 | +1 | `README.md` 추가 |
| `2026-11-08_chat-drama-02` | 31 | 32 | +1 | `README.md` 추가 |
| `2026-11-08_diary-film-01` | 12 | 13 | +1 | 기존 README→REVIEW, 새 `README.md` 추가 |
| `2026-11-08_free-tools-4` | 28 | 29 | +1 | `README.md` 추가 |
| **합계** | **180** | **187** | **+7** | **기존 파일 100% 무손실 보존** |
