# HANDOFF REPORT: M2 CHARACTER BIBLES & DIRECTIVES SPECIFICATION MINING

> **Reporter**: teamwork_preview_spec_miner (M2 Character Bibles & Directives Spec Miner 1)  
> **Timestamp**: 2026-10-08T05:58:00Z  
> **Task**: Discover, probe, and codify specifications for updating `00_Project_Bible/CHARACTER_BIBLE.md` and formulating `00_Project_Bible/UNIVERSAL_ACTING_DIRECTIVES.md`.  
> **Handoff Type**: Hard (Task Complete)

---

## 1. OBSERVATION

1. **Authoritative Directives in `ORIGINAL_REQUEST.md`**:
   - Lines 27-34: "R4. Quy Chuẩn Diễn Xuất Toàn Dự Án: Nam Nhân Tuyệt Đối Không Rơi Lệ (Anti-Male-Tears Directive)... R5. Khắc Phục Triệt Để Lỗi Lệch Khẩu Hình (Lip-sync & Off-Screen Dialogue Guard)".
   - Lines 63-69: "[DIRECTIVE UPDATE TỪ ĐẠO DIỄN]: 1. VỀ THÚY KIỀU VÀ THÚY VÂN: Thúy Kiều và Thúy Vân là 2 chị em SONG SINH (cùng 16 tuổi đầu phim), đường nét khuôn mặt ngũ quan khá giống nhau (twin resemblance). Khác biệt cốt lõi ở 4 yếu tố: Thần thái (Aura), Tính cách (Personality), Trí thông minh & Tài năng (Intellect & Talent), Giọng nói (Voice)..."
   - Lines 70-74: "2. VỀ BỐI CẢNH & TẠO HÌNH SAI NHA: Bối cảnh thời trung cổ Đông Á thuần Á Đông... 100% người Á Đông, da vàng tóc đen mắt đen. Tuyệt đối CẤM hình ảnh sai nha mặc trang phục hiện đại (không giống cảnh sát/quân phục hiện đại) và tuyệt đối CẤM vóc dáng phương Tây/châu Âu. Trang phục sai nha chuẩn: Lính lệ/nha dịch phong kiến Á Đông: đội nón dấu sơn son chóp nhọn (hoặc mũ dạ lính lệ), áo chẽn nẹp vạt lính tráng có nẹp vải cổ truyền (không cúc bấm hay khóa kéo hiện đại), quần túm xà cạp vải, tay cầm gậy son bịt đồng, xích sắt rỉ sét, đao bản rộng cổ, nét mặt bặm trợn, thô kệch thuần Á Đông."
   - Lines 81-89: "QUY TẮC ĐẶT TÊN VERSIONING `_v*`: Tất cả các file video MP4 (bao gồm shot đơn lẻ, cảnh master, và các lần ghép thử nghiệm) BẮT BUỘC có hậu tố `_v<N>`... `<shot_id>_10s_v1.mp4`, `<scene_id>_master_v1.mp4`, `<ep_id>_grand_master_v1.mp4`."

2. **Current State of Project Files**:
   - `00_Project_Bible/CHARACTER_BIBLE.md`:
     * Lines 37-46 & 60-69: Already have initial descriptions of Thúy Kiều and Thúy Vân at age 16 with twin resemblance, but lack a systematic 4-Axis comparison table and prompt rules for twin two-shots.
     * Lines 186-196: Describes Sai Nha with prohibitions against western faces and modern clothes, but omits "đao bản rộng cổ" (broad sabers) and lacks negative prompts against modern police uniforms and modern gear.
     * Lacks a dedicated summary chapter on "QUY CHUẨN DIỄN XUẤT PHỔ QUÁT & BẢO TOÀN LỄ GIÁO".
   - `00_Project_Bible/UNIVERSAL_ACTING_DIRECTIVES.md`: Does not exist yet.
   - `00_Project_Bible/MASTER_BIBLE.md`: Does not contain the crowd acting terms "quần chúng", "du xuân", causing `test_f4_04` to fail.

3. **Baseline Automated Test Execution (`python tests\run_all_tests.py`)**:
   - Test execution revealed 16 failures out of 155 tests (89.7% pass rate).
   - Specific Bible-related failures observed verbatim:
     * `test_f4_01_anti_male_tears_directive_in_bible`: `AssertionError: False is not true : Project Bible must codify Anti-Male-Tears directive` (evaluates regex `(Anti-Male-Tears|Nam nhân tuyệt đối không rơi lệ|quy chuẩn diễn xuất nam nhân)` against `CHARACTER_BIBLE.md` + `MASTER_BIBLE.md`).
     * `test_f4_02_male_stoic_micro_expressions_codified`: `AssertionError: False is not true : Project Bible must detail male stoic micro-expressions` (evaluates regex `(cơ mặt đanh|hàm bạnh|ánh mắt trĩu nặng|hơi thở nén|jaw clench|heavy gaze)` against `CHARACTER_BIBLE.md`).
     * `test_f4_04_crowd_and_extras_acting_rules`: `AssertionError: False is not true : Project Bible must specify crowd & extras behavior standards` (evaluates regex `(quần chúng|extras|đám đông|du xuân)` against `MASTER_BIBLE.md`).
     * `test_f4_f3_acting_directives_enforce_zero_male_tears`: `AssertionError: False is not true : Bible must explicitly codify the Anti-Male-Tears directive` (evaluates regex `(Anti-Male-Tears|Nam nhân tuyệt đối không rơi lệ|không được khóc)` against `CHARACTER_BIBLE.md`).
     * `test_f4_f6_acting_directives_codify_lip_sync_guard`: `AssertionError: False is not true : Bible must codify lip-sync / closed-lips directive` (evaluates regex `(khóa khẩu hình|closed.*lip|khép môi)` against `MASTER_BIBLE.md` + `CHARACTER_BIBLE.md`).

---

## 2. LOGIC CHAIN

1. **Step 1 (Requirement Tracing)**: The Director's updates in `ORIGINAL_REQUEST.md` (2026-10-08T05:21:27Z and 2026-10-08T05:38:03Z) mandate:
   - Defining Thúy Kiều and Thúy Vân as 16-year-old identical twins sharing facial features, while delineating them across 4 explicit axes (Aura, Personality, Intellect/Talent, Voice).
   - Designing Sai Nha as 100% East Asian feudal runners (Mạc/Ming era), barring modern and Western features, equipped with nón dấu sơn son, áo chẽn nẹp vạt lính tráng, xà cạp vải, gậy son bịt đồng, xích sắt, and đao bản rộng cổ.
   - Enforcing Anti-Male-Tears (0% tears, 4 stoic cues: cơ mặt đanh/hàm bạnh, ánh mắt trĩu nặng, ánh nhìn xa xăm, hơi thở nén sâu), Lip-Sync Guard (`[KHÓA KHẨU HÌNH BẮT BUỘC]`), Sweet-Spot Start Frames (720p contextual, zero reverse physics), and Video MP4 Versioning (`_v<N>`).

2. **Step 2 (Defect Diagnosis via Test Analysis)**:
   - As observed in Step 1.3, `test_f4_01`, `test_f4_02`, `test_f4_04`, `test_f4_f3`, and `test_f4_f6` fail because `00_Project_Bible/` currently lacks the explicit strings: `Anti-Male-Tears`, `cơ mặt đanh`, `hàm bạnh`, `ánh mắt trĩu nặng`, `hơi thở nén`, `khóa khẩu hình`, and `quần chúng/du xuân`.
   - Creating `UNIVERSAL_ACTING_DIRECTIVES.md` as the standalone master document in `00_Project_Bible/` AND adding a summary section in `CHARACTER_BIBLE.md` will simultaneously resolve all these failures while establishing the full director-level artistic guidance.

3. **Step 3 (Formulation of Solution Chunks)**:
   - Text Chunk 1: "MA TRẬN ĐỐI CHIẾU 4 TRỤC SONG SINH THÚY KIỀU & THÚY VÂN" added to Nhóm 1 of `CHARACTER_BIBLE.md`.
   - Text Chunk 2: Enhanced "Lính Sai Nha (Lính Lệ Nha Môn Trung Cổ - Tuyệt Đối Thuần Á Đông & Cổ Phong)" in Nhóm 5 of `CHARACTER_BIBLE.md` with broad sabers ("đao bản rộng cổ"), authentic fabric puttees, and negative prompts banning modern uniforms and caucasian features.
   - Text Chunk 3: "QUY CHUẨN DIỄN XUẤT PHỔ QUÁT & BẢO TOÀN LỄ GIÁO" added to the end of `CHARACTER_BIBLE.md` to guarantee test harness compliance.
   - Comprehensive Document: `00_Project_Bible/UNIVERSAL_ACTING_DIRECTIVES.md` drafted in full with all 5 core sections (Anti-Male-Tears, Female & Crowd Acting, Lip-Sync Guard, Sweet-Spot 720p Start Frames, MP4 Versioning `_v<N>`).

---

## 3. CAVEATS

- **Read-Only Role**: In accordance with the SPECIFICATION MINER role and Teamwork workspace rules, this agent has NOT modified any files outside `.agents/teamwork/spec_miner_m2_1/`. The complete, exact text chunks have been documented in `analysis.md` and this handoff report for the implementing worker agent to apply.
- **Master Bible Minor Addition**: `test_f4_04` tests `MASTER_BIBLE.md` specifically for crowd keywords (`quần chúng`, `du xuân`). The worker updating the bibles should also insert a brief crowd acting mention into `MASTER_BIBLE.md`.

---

## 4. CONCLUSION

- The specifications for Milestone 2 Character Bibles and Universal Acting Directives are fully mined, codified, and validated against authoritative requirements.
- Full drop-in text chunks for `00_Project_Bible/CHARACTER_BIBLE.md` and the complete text for `00_Project_Bible/UNIVERSAL_ACTING_DIRECTIVES.md` are ready in `analysis.md` (§4.2 and §5).
- Implementing these chunks will directly convert 5 failing test cases (`test_f4_01`, `test_f4_02`, `test_f4_04`, `test_f4_f3`, `test_f4_f6`) to passing, bringing Milestone 2 to full compliance.

---

## 5. VERIFICATION METHOD

To independently verify the implementation once applied:

1. **Verify Text Files Existence and Contents**:
   - Check `00_Project_Bible/UNIVERSAL_ACTING_DIRECTIVES.md` exists and contains:
     * `Anti-Male-Tears`
     * `cơ mặt đanh lại`, `quai hàm bạnh chặt`, `ánh mắt trĩu nặng`, `hơi thở nén sâu`
     * `[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, không mấp máy`
     * `Sweet-Spot Start Frame` (1280x720 / 720x1280)
     * `_v<N>` naming convention
   - Check `00_Project_Bible/CHARACTER_BIBLE.md` contains the Twin Dynamics 4-Axis Matrix table, the updated Sai Nha section with "đao bản rộng cổ", and the acting summary.

2. **Execute Automated Test Suite**:
   ```powershell
   python tests\run_all_tests.py --tier 1
   python tests\run_all_tests.py --tier 3
   ```
   *Expected outcome for F4 tests*:
   - `test_f4_01_anti_male_tears_directive_in_bible` ➔ PASS
   - `test_f4_02_male_stoic_micro_expressions_codified` ➔ PASS
   - `test_f4_03_female_nuanced_acting_standards` ➔ PASS
   - `test_f4_04_crowd_and_extras_acting_rules` ➔ PASS
   - `test_f4_05_historical_feudal_decorum_mandate` ➔ PASS
   - `test_f4_f3_acting_directives_enforce_zero_male_tears` ➔ PASS
   - `test_f4_f6_acting_directives_codify_lip_sync_guard` ➔ PASS