# HANDOFF REPORT — M1 SCREENPLAY ARCHITECTURE SPEC MINER

> **Sender**: `teamwork_preview_spec_miner` (M1 Screenplay Architecture Spec Miner)  
> **Target**: Orchestrator / Worker Agent  
> **Working Directory**: `c:\Projects\KieuStory\.agents\teamwork\spec_miner_m1_1`  
> **Timestamp**: 2026-10-08T04:28:30Z  
> **Type**: Hard Handoff (Task Complete)  

---

## 1. OBSERVATION

Dựa trên việc kiểm tra trực tiếp các tệp tin trong hệ thống:
1. **`FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`**:
   - Hiện chỉ có 14 Master Scenes phác thảo (C01 - C14, tổng cộng 287 dòng văn bản).
   - Chưa đánh mã Shot ID tiêu chuẩn (`ep01_sceneXX_shotYY`) trong kịch bản.
   - Tại dòng 195 (Scene 10 cũ): Nhân vật Kim Trọng bị ghi *"nắm chặt tay Kiều, nghẹn ngào rơi nước mắt"*, vi phạm trực tiếp chỉ thị tối cao Anti-Male-Tears (R4).
   - Tại Scene 08 (dòng 155-163): Chưa có chỉ thị khóa khẩu hình (Lip-sync guard R5) khi Kiều thoại ngoài khung hình (O.S.).
   - Scene 05 (dòng 85-113): Thiếu hẳn Nhịp 1 (tiểu khê tản bộ) và Nhịp 2 (thắc mắc tò mò tự nhiên), Kiều quỳ sụp khóc ngay lập tức, bỏ qua chi tiết "dấu hài in trên rêu".
2. **`FilmMaker/INDEX_VA_DANH_MUC_CANH_QUAY.md`**:
   - Dòng 7: Khai báo 55 Master Scenes.
   - Dòng 15-28: Tập 1 chỉ liệt kê 14 cảnh (C01 - C14) với các mô tả ngắn, chưa phản ánh đủ 188 shots và thời lượng 29m40s.
3. **`02_AI_Prompts/muse_ai_video_prompts.json`**:
   - Đang chỉ có 48 shots cho EP01 (cộng 4 shots prologue), thiếu hoàn toàn `ep01_scene03` (nhảy cóc từ scene02 sang scene04).
4. **`05_Production_Pipeline/assemble_ep01_feature.py`**:
   - Dòng 75: Ghép 15 thành phần (Intro + Prologue + 14 scenes) nhưng tổng thời lượng thực tế chỉ đạt ~7m30s - 8m30s.

---

## 2. LOGIC CHAIN

1. **Từ Quan sát 1 & 4**: Để đạt chuẩn điện ảnh 25 - 30 phút (cụ thể là 29m40s), mỗi cảnh cần mở rộng số lượng shot AI (mỗi shot dài 10 giây từ Muse.ai). Với 188 shots x 10s = 1,880s thô, áp dụng 0.5s audio crossfade giữa các shot sẽ cho thời lượng thực tế $1880 - (187 \times 0.5) = 1786.5\text{s} = 29\text{ phút } 46.5\text{ giây}$ (~29m40s), hoàn toàn thỏa mãn R1.
2. **Từ Quan sát 1 (Scene 05) & Yêu cầu R2**: Phân đoạn mộ Đạm Tiên trong nguyên tác Nguyễn Du (câu 51-132) gồm 3 nhịp cảm xúc rõ rệt. Cần tách và mở rộng Scene 05 thành đúng 27 shots (4m30s) bao gồm: Nhịp 1 (C05-A: Ngọn tiểu khê dẫn cảnh, 8 shots), Nhịp 2 (C05-B: Nấm mồ sè sè ngỡ ngàng hỏi thăm, 7 shots), Nhịp 3 (C05-C: Biến chuyển tâm lý, huyết lệ khóc thương, khắc thơ vỏ bàng, gió lốc và dấu hài in trên rêu, 12 shots).
3. **Từ Khảo sát Cấu trúc 3 Hồi**:
   - **Hồi 1 (Scenes 01-04)**: Khung truyện 198x & Bầu trời xuân Gia Tĩnh (C01: 21 shots) + Gia trang họ Vương nề nếp (C02: 15 shots) + Khuê phòng Kiều - Vân (C03: 15 shots) [C02 + C03 = 30 shots] + Hội Đạp Thanh mở rộng (C04: 12 shots) = **63 shots (10m30s)**.
   - **Hồi 2 (Scenes 05-09)**: Mộ Đạm Tiên 3 nhịp (C05: 27 shots) + Tương ngộ Kim Trọng rặng liễu (C06: 14 shots) + Thư phòng tương tư (C07: 8 shots) + Nhặt thoa cành đào (C08: 8 shots) + Kim Kiều tương kiến trao thoa (C09: 6 shots) = **63 shots (10m30s)**.
   - **Hồi 3 (Scenes 10-15)**: Vầng trăng thề nguyện (C10: 14 shots) + Chia ly Liêu Dương (C11: 10 shots) + Giông bão sấm chớp phá cổng (C12: 8 shots) + Đại biến Chiaroscuro ấm trà vỡ (C13: 12 shots) + Quyết định bán mình cứu cha (C14: 12 shots) + Cliffhanger gian thờ bọc bạc Mã Giám Sinh (C15: 6 shots) = **62 shots (10m20s)**.
   - Tổng cộng: $63 + 63 + 62 = \mathbf{188\text{ shots}}$!
4. **Từ Quan sát 1 (Dòng 195 & R4)**: Phải loại bỏ hoàn toàn hành động rơi nước mắt của Kim Trọng (C11), Vương Quan (C05, C13, C14), Vương Ông (C14). Đau đớn biểu hiện qua quai hàm đanh lại, siết chặt dây cương, ánh mắt trĩu nặng thâm trầm.
5. **Từ Quan sát 1 (Dòng 155-163 & R5)**: Tại Scene 08 (Shot 08), khi Kiều cất tiếng hỏi tìm thoa kim từ bên kia tường hoa, trong khung hình quay Kim Trọng phải bổ sung chỉ thị kỹ thuật nghiêm ngặt: `[KHÓA KHẨU HÌNH BẮT BUỘC]: Đôi môi Kim Trọng khép chặt tự nhiên, ánh mắt sáng lên lắng nghe, tuyệt đối không mấp máy môi`.

---

## 3. CAVEATS

- **Chưa chỉnh sửa trực tiếp vào mã nguồn**: Spec Miner tuân thủ nguyên tắc Read-Only, toàn bộ bản thiết kế được ghi vào `analysis.md` để Worker Agent triển khai văn bản thực tế.
- **Tập tin Prompt Registry (`02_AI_Prompts/`)**: Thuộc phạm vi của Milestone M2. Tuy nhiên, mã Shot ID trong kịch bản mới (`ep01_scene01_shot01` đến `ep01_scene15_shot06`) đã được chuẩn hóa 100% để M2 kế thừa trực tiếp mà không cần sửa đổi.

---

## 4. CONCLUSION

1. Đã hoàn thành lập bản đồ kiến trúc 15 Phân cảnh điện ảnh mới cho EP01 đạt chuẩn 188 shots (29m40s) theo cấu trúc 3 Hồi cân bằng (Hồi 1: 63 shots, Hồi 2: 63 shots, Hồi 3: 62 shots).
2. Đã giải quyết triệt để 100% yêu cầu R1 (Pacing 25-30m), R2 (Mộ Đạm Tiên 3 nhịp đầy đủ câu 51-132), R4 (Anti-Male-Tears cho toàn bộ nam nhân), R5 (Khóa khẩu hình góc máy ngoài), R6 (Âm thanh 4 lớp L-Cut).
3. Đã xác lập đầy đủ bảng thay đổi văn bản (Textual Deltas) cho `FilmMaker/INDEX_VA_DANH_MUC_CANH_QUAY.md` và `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`.
4. Báo cáo chi tiết toàn diện đã được lưu tại: `c:\Projects\KieuStory\.agents\teamwork\spec_miner_m1_1\analysis.md`.

---

## 5. VERIFICATION METHOD

Worker Agent hoặc người kiểm thử có thể kiểm tra độc lập các tiêu chí sau:
1. **Kiểm tra số cảnh và shot mapping**:
   - Đọc `c:\Projects\KieuStory\.agents\teamwork\spec_miner_m1_1\analysis.md` Mục 4 và Mục 5.
   - Xác nhận: 15 cảnh (CẢNH 01 đến CẢNH 15), tổng 188 shots.
2. **Kiểm tra tính tuân thủ R2 (Mộ Đạm Tiên)**:
   - Xác nhận Cảnh 05 có đủ 3 nhịp: Nhịp 1 (C05-A, shots 01-08), Nhịp 2 (C05-B, shots 09-15), Nhịp 3 (C05-C, shots 16-27 bao gồm chi tiết dấu hài in trên rêu xanh).
3. **Kiểm tra tính tuân thủ R4 (Anti-Male-Tears)**:
   - Xác nhận Cảnh 11 (Kim Trọng chia ly) không có từ ngữ "rơi nước mắt" hay "khóc".
4. **Kiểm tra tính tuân thủ R5 (Khóa khẩu hình)**:
   - Xác nhận Cảnh 08 (Shot 08) có thẻ `[KHÓA KHẨU HÌNH BẮT BUỘC]`.