# Handoff Report: Gemini Banana Start Frame Prompt Registry Specification Mining (EP01 - 188 Shots)

> **Agent**: teamwork_preview_spec_miner (M2 Gemini Banana Start Frame Registry Spec Miner 2)  
> **Directory**: `c:\Projects\KieuStory\.agents\teamwork\spec_miner_m2_2`  
> **Target Milestone**: Milestone 2 - Universal Standards & Prompt Registry (Feature F7)  
> **Timestamp**: 2026-10-08T06:10:00Z  

---

## 1. Observation

1. **Screenplay Structure**:
   - Inspected `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`.
   - File contains exactly 15 scenes across 188 shot blocks spanning line 39 to line 1957.
   - Shot distribution verified: Scene 01 (21 shots), Scene 02 (15 shots), Scene 03 (15 shots), Scene 04 (12 shots), Scene 05 (27 shots: C05-A 8 shots, C05-B 7 shots, C05-C 12 shots), Scene 06 (14 shots), Scene 07 (8 shots), Scene 08 (8 shots), Scene 09 (6 shots), Scene 10 (14 shots), Scene 11 (10 shots), Scene 12 (8 shots), Scene 13 (12 shots), Scene 14 (12 shots), Scene 15 (6 shots). Total = 188 shots (29m40s total duration).

2. **Existing Prompt Registry**:
   - Inspected `02_AI_Prompts/gemini_banana_prompts.json` (321 lines).
   - Currently contains top-level keys `"project_name"`, `"ai_image_engine"`, `"version"`, `"master_style_anchor"`, `"characters"` (7 categories, 18 characters), `"environments"` (4 locations), and `"critical_keyframes"` (3 scenes).
   - Currently lacks per-shot Start Frame prompt registry keys for Episode 01.

3. **Universal Directives & Character Anchors**:
   - `00_Project_Bible/CHARACTER_BIBLE.md` lines 1-120: Codifies Thúy Kiều and Thúy Vân as identical twin sisters (both 16 years old), sharing identical delicate East Asian facial bone structure and porcelain skin, differentiated by aura (sharp/melancholic vs round/serene), robe colors (celadon jade green vs pure white), and accessories.
   - `00_Project_Bible/CHARACTER_BIBLE.md` §4: Codifies imperial bailiffs (Sai Nha) as 100% pure East Asian Vietnamese ancestry, wearing conical peaked helmets ("nón dấu sơn son chóp nhọn"), red-trimmed coarse grey tunics, leg wraps, wooden cudgels, and iron chains; explicitly prohibiting modern or Western police uniforms.
   - `ORIGINAL_REQUEST.md` §R3, §R4, §R5: Codifies 2-step sweet-spot start frame (720p 1280x720), elimination of raw indoor portraits in outdoor scenes, zero reverse physics (explicit forward directional vectors), Anti-Male-Tears Directive (feudal men do not cry; clenched jaws, stoic posture), and Lip-Sync / Off-Screen Dialogue Guard (closed lips when listening to off-screen speech).

4. **Automated Validation Results**:
   - Executed `python .agents/teamwork/spec_miner_m2_2/validate_registry.py`.
   - Tool output verbatim:
     ```
     Total registry entries: 188
     Total screenplay shots: 188
     ALL 188 SHOTS PASSED VALIDATION! Schema, anchors, resolution, and constraints 100% compliant.
     ```

---

## 2. Logic Chain

1. **Input Verification**: Screenplay `TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md` is the authoritative source defining every shot's camera framing, visual action, environment, and characters.
2. **Contract Conformance**: `PROJECT.md` §Interface Contracts defines the Gemini Banana schema as `{"character_anchor": "...", "environment_anchor": "...", "prompt": "...", "resolution": "1280x720"}`.
3. **Synthesis & Blending**: By combining the screenplay visual beat of each shot with the character anchor descriptions in `CHARACTER_BIBLE.md` and environment anchors in `ENVIRONMENT_BIBLE.md`, we eliminate isolated white/studio backgrounds and produce fully situated 720p contextual start frames.
4. **Physical & Historical Directives Enforcement**:
   - Explicit forward directional vectors were inserted into all action prompts, preventing reverse-physics hallucinations in subsequent Muse.ai I2V generation.
   - Twin aesthetics were codified for Kiều and Vân in Scene 03 and subsequent scenes.
   - Sai Nha prompts in Scenes 12 and 13 enforce authentic 16th century East Asian attire and peaked conical helmets.
   - Anti-Male-Tears directives were applied to all male characters across Scenes 02, 05, 06, 07, 11, 13, and 14.
   - Lip-Sync & Off-Screen Guard was applied to Scene 08 (Kim Trọng listening to Kiều's distant voice with closed lips).
5. **Output Generation**: All 188 entries were serialized to `.agents/teamwork/spec_miner_m2_2/gemini_banana_ep01_registry.json` and validated by automated assertions.

---

## 3. Caveats

- **File Placement Discipline**: In strict compliance with the Teamwork Workspace Convention, the 188-shot registry was generated inside `.agents/teamwork/spec_miner_m2_2/` and NOT written directly into `02_AI_Prompts/gemini_banana_prompts.json` (as spec miners do not implement project codebase changes).
- **Integration Readiness**: The file `gemini_banana_ep01_registry.json` is ready for immediate incorporation by the implementation agent or orchestrator into `02_AI_Prompts/gemini_banana_prompts.json`.

---

## 4. Conclusion

The specification mining and prompt registry formulation for Episode 01 (188 shots, `ep01_scene01_shot01` to `ep01_scene15_shot06`) is complete, robust, and 100% compliant with all project bibles, interface contracts, and director directives.

Key deliverables created:
1. `.agents/teamwork/spec_miner_m2_2/gemini_banana_ep01_registry.json` — Complete 188-shot prompt registry JSON.
2. `.agents/teamwork/spec_miner_m2_2/analysis.md` — Detailed architectural specification analysis, features discovered, edge cases, and blueprint.
3. `.agents/teamwork/spec_miner_m2_2/validate_registry.py` — Automated verification script.

---

## 5. Verification Method

To independently verify the completeness and compliance of the 188-shot registry, run:

```powershell
python .agents/teamwork/spec_miner_m2_2/validate_registry.py
```

Expected output:
```
Total registry entries: 188
Total screenplay shots: 188
ALL 188 SHOTS PASSED VALIDATION! Schema, anchors, resolution, and constraints 100% compliant.
```

Files to inspect:
- Registry JSON: `.agents/teamwork/spec_miner_m2_2/gemini_banana_ep01_registry.json`
- Analysis Document: `.agents/teamwork/spec_miner_m2_2/analysis.md`
- Screenplay Reference: `FilmMaker/TAP_01_XUAN_SAC_THE_NGUYEN_VA_GIONG_BAO_DOAN_TRUONG.md`