# BÁO CÁO BÀN GIAO CÔNG VIỆC (HANDOFF REPORT) — MILESTONE 1 (M1)
## HOÀN TẤT TRIỂN KHAI TÁI CẤU TRÚC KỊCH BẢN TẬP 1 (EP01) — 188 SHOTS (29M40S)

> **Agent**: `teamwork_preview_worker` (`worker_m1_1`)  
> **Thư mục làm việc**: `c:\Projects\KieuStory\.agents\teamwork\worker_m1_1`  
> **Milestone**: M1 (Screenplay & Pacing Expansion)  
> **Thời điểm hoàn thành**: 2026-10-08T05:05:00Z  
> **Tác giả kiêm Chủ sở hữu IP**: **NGUYỄN SĨ SƠN** (08/08/1990, CCCD: 031090010018)  
> **Nguyên tác văn học**: *Đoạn Trường Tân Thanh (Truyện Kiều)* - Nguyễn Du (Public Domain)

---

### 1. OBSERVATION (Quan Sát Trực Tiếp)
- **Tệp nguồn trước khi sửa đổi**:
  * `FilmMaker/INDEX_VA_DANH_MUC_CANH_QUAY.md`: Ban đầu chỉ liệt kê 14 phân cảnh phác thảo cho Tập 1 (C01 đến C14), tổng số phân cảnh toàn bộ 6 tập là 55.
  * `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`: Bản phác thảo dài 287 dòng, không có mã shot ID chi tiết `ep01_sceneXX_shotYY`, chứa vi phạm chỉ thị R4 (dòng 195: `*(Nắm chặt tay Kiều, nghẹn ngào rơi nước mắt)*`, dòng 227: `tiếng thét nghẹn ngào của Vương Ông`, dòng 241: `*(Gào lên tuyệt vọng)*`), Cảnh 05 về mộ Đạm Tiên chỉ có 6 dòng tóm tắt chưa đúng 3 nhịp cảm xúc Nguyễn Du.
  * `03_Storyboards/Ep01_Gia_Bien_Storyboard.md`: Dòng 17 (Shot 05) chứa vi phạm `tiếng Vương Ông kêu nghẹn ngào`.
  * `01_Scripts_And_Episodes/EPISODE_GUIDE_30MIN.md`: Dòng 28 (Hồi 3) chứa `Tiếng khóc than xé lòng của gia đình Vương viên ngoại`.
- **Thực thi sửa đổi & Tệp sở hữu độc quyền**:
  * Đã mở rộng `FilmMaker/INDEX_VA_DANH_MUC_CANH_QUAY.md` lên 56 phân cảnh lớn toàn biên; phân cảnh Tập 1 được chuẩn hóa thành 15 cảnh (C01 - C15), 188 shots (29m40s) theo cấu trúc 3 hồi (Hồi 1: 63 shots, Hồi 2: 63 shots, Hồi 3: 62 shots); đồng bộ bảng đạo cụ chính (Props matrix).
  * Đã tái cấu trúc toàn diện `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` thành kịch bản điện ảnh chuẩn Hollywood dài 1956 dòng:
    - 15 master scenes với đầy đủ 188 shot headings (`##### Shot YY: ep01_sceneXX_shotYY (10s)`).
    - C02 & C03 mở rộng thành 30 shots gia phong đầm ấm (C02: 15 shots trà đạo, C03: 15 shots khuê phòng Kiều - Vân & dự cảm đàn tỳ bà).
    - C04 mở rộng 12 shots đại cảnh lễ hội Thanh minh.
    - C05 nhúng trọn vẹn 27 shots phân đoạn Mộ Đạm Tiên theo đúng 3 nhịp Nguyễn Du: C05-A (8 shots) ngọn tiểu khê dẫn cảnh; C05-B (7 shots) nấm mồ sè sè ngọn cỏ dầu dầu; C05-C (12 shots) biến chuyển tâm lý, huyết lệ khóc thương, thắp hương, trâm bạc khắc thơ, gió xoáy & **dấu hài in rêu rành rành**.
    - Triệt tiêu 100% lệ nam nhân: Kim Trọng (C11) cơ hàm bạnh chặt, ánh mắt trĩu nặng, lồng ngực nén sâu hơi thở, 0% nước mắt; Vương Quan (C13, C14) cắn răng bật máu, quai hàm đanh thép, phẫn nộ trước bạo quyền; Vương Ông (C13, C14) hai hàm răng nghiến chặt, tiếng thét uất nghẹn đanh thép.
    - Khóa khẩu hình tại Scene 08 Shot 08: `[KHÓA KHẨU HÌNH BẮT BUỘC]: Đôi môi nhân vật trong khung hình khép chặt tự nhiên khi có tiếng gọi từ xa`.
  * Đã cập nhật `03_Storyboards/Ep01_Gia_Bien_Storyboard.md` (Shot 05) thay `tiếng Vương Ông kêu nghẹn ngào` thành `tiếng Vương Ông uất nghẹn đanh thép, tiếng Vương Quan gằn giọng phẫn nộ: *"Cha ơi!"*`.
  * Đã cập nhật `01_Scripts_And_Episodes/EPISODE_GUIDE_30MIN.md` (Hồi 3) thay `Tiếng khóc than xé lòng` thành `Tiếng kêu oan uất nghẹn cùng tiếng nấc nghẹn đau đớn`.
- **Kết quả kiểm thử tự động**:
  * Lệnh thực thi: `python tests/verify_m1_screenplay.py`
  * Đầu ra kiểm thử: `PASS: test_m1_screenplay completed successfully (188 shots, 15 scenes, 3 acts, 0 male crying, lip-sync guard verified).`
  * Mã thoát: `0`.

---

### 2. LOGIC CHAIN (Chuỗi Suy Luận Logic)
1. **Từ yêu cầu R1 (Thời lượng 25 - 30 phút, nhịp điệu điện ảnh)**:
   - Dựa trên phân tích của `spec_miner_m1_1`, thời lượng 29m40s đòi hỏi đúng 188 shots x 10s (với 0.5s audio crossfade giữa các shot).
   - Chia 188 shots vào 3 Hồi cân bằng: Hồi 1 (63 shots, C01-C04), Hồi 2 (63 shots, C05-C09), Hồi 3 (62 shots, C10-C15).
   - Tách biệt C02 (15 shots) và C03 (15 shots) tạo chiều sâu văn hóa gia phong và khuê các trước ngày hội xuân; mở rộng C04 lên 12 shots để người xem cảm nhận trọn vẹn không khí Thanh minh.
2. **Từ yêu cầu R2 (Mộ Đạm Tiên 3 nhịp chuẩn nguyên tác Nguyễn Du)**:
   - Dựa trên phân tích của `spec_miner_m1_2`, phân đoạn mộ Đạm Tiên không thể nén vội trong 6 shots mà phải có đủ 27 shots:
     * Nhịp 1 (C05-A, Shots 01-08): Bước lần theo ngọn tiểu khê, dòng nước uốn quanh, nhịp cầu gỗ rêu phong bắc ngang ghềnh đá.
     * Nhịp 2 (C05-B, Shots 09-15): Thắc mắc ngỡ ngàng trước nấm mồ sè sè bên gốc bàng già, ngọn cỏ dầu dầu nửa vàng nửa xanh, Kiều hỏi Vương Quan.
     * Nhịp 3 (C05-C, Shots 16-27): Chuỗi 5 shots biểu cảm vi mô (lắng nghe -> bàng hoàng -> ngấn lệ -> quỳ sụp khóc thương), thắp hương, trâm bạc khắc thơ rỉ nhựa cây, đối thoại triết lý ba chị em, cơn gió xoáy và kỳ tích tâm linh dấu hài thiếu nữ in rõ trên rêu xanh.
3. **Từ yêu cầu R4 (Anti-Male-Tears Directive - Nam nhân tuyệt đối không rơi lệ)**:
   - Dựa trên phân tích của `explorer_m1_3`, nam nhân phong kiến (quân tử, trượng phu, Nho gia) tuyệt đối không khóc hay ủy mị.
   - Thay thế toàn bộ mô tả khóc/nước mắt của Kim Trọng, Vương Quan, Vương Ông bằng: cơ hàm bạnh chặt (clenched jaw), ánh mắt trĩu nặng thâm trầm (stoic gaze), lồng ngực nén sâu hơi thở (compressed breath), hai hàm răng nghiến chặt, tiếng thét đanh thép phẫn nộ trước bạo quyền.
   - Đồng bộ hóa các tệp kịch bản phái sinh (`Ep01_Gia_Bien_Storyboard.md` và `EPISODE_GUIDE_30MIN.md`).
4. **Từ yêu cầu R5 (Lip-Sync & Off-Screen Guard)**:
   - Tại Scene 08 Shot 08, khi Thúy Kiều cất tiếng hỏi từ xa bên kia tường hoa, Kim Trọng trong khung hình phải khóa chặt khẩu hình, giữ nét mặt lắng nghe ngạc nhiên và vui mừng, tuyệt đối không mấp máy môi.
   - Thêm chỉ thị tường minh: `[KHÓA KHẨU HÌNH BẮT BUỘC]: Đôi môi nhân vật trong khung hình khép chặt tự nhiên khi có tiếng gọi từ xa`.

---

### 3. CAVEATS (Lưu Ý & Giới Hạn)
- **Phạm vi sở hữu**: Worker M1 chỉ chỉnh sửa và chịu trách nhiệm độc quyền trên 4 tệp: `INDEX_VA_DANH_MUC_CANH_QUAY.md`, `TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`, `Ep01_Gia_Bien_Storyboard.md`, `EPISODE_GUIDE_30MIN.md`.
- **Cột mốc tiếp theo (M2)**: Bộ prompt JSON trong `02_AI_Prompts/gemini_banana_prompts.json` và `02_AI_Prompts/muse_ai_video_prompts.json` hiện vẫn đang chứa 48 shots cũ. Milestone M2 sẽ đồng bộ toàn bộ 188 shot IDs mới được tạo ra từ kịch bản này vào prompt registry.

---

### 4. CONCLUSION (Kết Luận)
- Toàn bộ 4 nhiệm vụ của Milestone M1 đã được hoàn thành 100% với chất lượng chuẩn điện ảnh cao cấp:
  1. `INDEX_VA_DANH_MUC_CANH_QUAY.md` phản ánh chính xác cấu trúc 15 cảnh, 188 shots (29m40s) của Tập 1 và 56 cảnh toàn biên 6 tập.
  2. `TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` mở rộng hoàn chỉnh 188 shots với chuẩn Hollywood sluglines, 4-stem audio, và parenthetical.
  3. Phân đoạn Mộ Đạm Tiên 27 shots (C05-A, C05-B, C05-C) tái hiện trung thành 100% áng thơ Nguyễn Du.
  4. Triệt tiêu hoàn toàn nước mắt nam giới trong EP01; bổ sung khóa khẩu hình Scene 08 Shot 08; đồng bộ hoàn hảo các tài liệu storyboard và episode guide liên quan.

---

### 5. VERIFICATION METHOD (Phương Pháp Kiểm Tra Độc Lập)
Để thẩm định độc lập kết quả bàn giao, Auditor hoặc Host Agent có thể chạy lệnh sau trong terminal:

```bash
# Chạy bộ kiểm thử tự động toàn diện cho Milestone M1:
python tests/verify_m1_screenplay.py
```

**Các tiêu chí kiểm tra trong test suite**:
1. Đếm số shots trong `TAP_01_*.md`: Phải đúng 188 shot headings độc nhất (`len(shots) == 188`).
2. Đếm số shots từng cảnh: C01 (21), C02 (15), C03 (15), C04 (12), C05 (27), C06 (14), C07 (8), C08 (8), C09 (6), C10 (14), C11 (10), C12 (8), C13 (12), C14 (12), C15 (6).
3. Cân bằng 3 Hồi: Hồi 1 (63 shots), Hồi 2 (63 shots), Hồi 3 (62 shots).
4. Phân đoạn Đạm Tiên (Scene 05): Đầy đủ 3 nhịp C05-A (tiểu khê), C05-B (sè sè nấm đất), C05-C (đau đớn thay phận đàn bà & dấu hài in rêu).
5. Khóa khẩu hình: Tồn tại chính xác chuỗi `[KHÓA KHẨU HÌNH BẮT BUỘC]: Đôi môi nhân vật trong khung hình khép chặt tự nhiên khi có tiếng gọi từ xa` tại Scene 08 Shot 08.
6. Triệt tiêu lệ nam nhân: 0 trường hợp Kim Trọng, Vương Quan, Vương Ông khóc hay rơi lệ trong toàn bộ kịch bản hành động Tập 1.
7. Ma trận cảnh quay: `INDEX_VA_DANH_MUC_CANH_QUAY.md` chứa `15 Phân cảnh | 188 Shots | Thời lượng: 29 phút 40 giây` và `56 Phân cảnh điện ảnh lớn`.