{
  "project_id": "26052026-001-Ngo-Quyen",
  "step": 5,
  "name": "Generate required character reference images first, then generate all scene images using approved character refs when recurring characters appear",
  "status": "required_refs_pending_boss_review_with_ngo_quyen_v3_16x9",
  "scene_classification_rules": {
    "needs_character_ref": [
      "recurring character",
      "central character",
      "clear/close character appearance",
      "identity/age/hair/costume/temperament must stay consistent"
    ],
    "does_not_need_character_ref": [
      "heading scene",
      "landscape",
      "map",
      "distant war boats",
      "crowd or silhouettes without recognizable faces",
      "symbolic/abstract scenes"
    ]
  },
  "character_refs": [
    {
      "name": "Ngô Quyền",
      "slug": "ngo_quyen",
      "priority": "required",
      "role": "main_character",
      "appearance": "Nam nhân Việt thế kỷ X, gương mặt cương nghị, mắt sâu và sắc, dáng cao khỏe, râu ngắn gọn, làn da rám nắng của người từng chinh chiến.",
      "costume": "Áo chiến tướng Việt cổ tông nâu sẫm/đỏ trầm, giáp da hoặc giáp vảy nhẹ, thắt lưng vải, choàng ngắn khi ra trận; khi thiết triều mặc áo bào trang nghiêm nhưng không quá hoa mỹ.",
      "temperament": "Điềm tĩnh, quyết đoán, có tầm nhìn chiến lược, khí chất thủ lĩnh mở nước; ít phô trương nhưng tạo cảm giác uy quyền.",
      "historical_cultural_context": "Hào trưởng Đường Lâm, con rể Dương Đình Nghệ, lãnh đạo cuộc kháng chiến chống Nam Hán và đặt nền móng độc lập tự chủ sau hơn một nghìn năm Bắc thuộc.",
      "output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/ngo_quyen_ref_v3_16x9.png",
      "approved": false,
      "used_in_scene_ids": [
        "scene_008",
        "scene_010",
        "scene_011",
        "scene_012",
        "scene_019",
        "scene_020",
        "scene_021",
        "scene_023",
        "scene_024",
        "scene_028",
        "scene_030",
        "scene_031",
        "scene_038",
        "scene_042",
        "scene_044",
        "scene_048",
        "scene_054",
        "scene_061",
        "scene_065",
        "scene_072",
        "scene_077",
        "scene_084",
        "scene_087",
        "scene_088",
        "scene_089",
        "scene_093",
        "scene_094",
        "scene_096",
        "scene_098",
        "scene_101",
        "scene_106",
        "scene_107",
        "scene_111",
        "scene_112",
        "scene_115",
        "scene_117",
        "scene_120",
        "scene_124",
        "scene_126",
        "scene_132",
        "scene_134",
        "scene_135",
        "scene_140",
        "scene_143"
      ],
      "prompt": "Create ONE historical Vietnamese character reference concept sheet, not a final scene. Style must match the provided reference images: sepia parchment background, aged paper, ink wash and watercolor, muted browns, charcoal, ochre, smoky gray, dark red accents, painterly linework. Layout: central full-body front view plus one three-quarter view, one shoulder portrait, small costume/armor/detail panels, optional small battlefield vignette; no modern labels, no readable text. Historical grounding: 10th century Vietnam around the Bach Dang campaign, Ngo dynasty / post-Tang regional context; Vietnamese/East Asian facial features; period-appropriate cloth, lamellar/leather armor, belts, boots, weapons; no fantasy armor, no Qing/Ming/Three Kingdoms costume drift, no European armor. Character identity: Ngô Quyền; role: main_character; age: ; appearance: Nam nhân Việt thế kỷ X, gương mặt cương nghị, mắt sâu và sắc, dáng cao khỏe, râu ngắn gọn, làn da rám nắng của người từng chinh chiến.; costume: Áo chiến tướng Việt cổ tông nâu sẫm/đỏ trầm, giáp da hoặc giáp vảy nhẹ, thắt lưng vải, choàng ngắn khi ra trận; khi thiết triều mặc áo bào trang nghiêm nhưng không quá hoa mỹ.; temperament: Điềm tĩnh, quyết đoán, có tầm nhìn chiến lược, khí chất thủ lĩnh mở nước; ít phô trương nhưng tạo cảm giác uy quyền.; historical/cultural context: Hào trưởng Đường Lâm, con rể Dương Đình Nghệ, lãnh đạo cuộc kháng chiến chống Nam Hán và đặt nền móng độc lập tự chủ sau hơn một nghìn năm Bắc thuộc.. Negative exclusions: no glossy digital poster, no 3D render, no anime, no fantasy glowing weapons, no modern objects, no watermark, no logo, no typography, no English/Chinese text, no clean white background.",
      "rule_use_ref": "Attach this approved character ref to recurring-character scene prompts where the character appears clearly or close enough for identity consistency.",
      "generated": true,
      "review_status": "pending_boss_review_v3_16x9",
      "style_validation": "vision_passed_character_reference_sheet_16x9",
      "previous_output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/ngo_quyen_ref_v2.png",
      "dimension": "1536x864",
      "aspect_ratio": "16:9"
    },
    {
      "name": "Dương Đình Nghệ",
      "slug": "duong_dinh_nghe",
      "priority": "recommended",
      "role": "supporting_character",
      "appearance": "Võ tướng lớn tuổi, gương mặt từng trải, râu dài vừa phải, ánh mắt nghiêm nghị, dáng vững chãi.",
      "costume": "Trang phục hào trưởng/quân chủ địa phương thế kỷ X, áo dài vải dày màu trầm, giáp nhẹ khi xuất hiện trong bối cảnh quân sự.",
      "temperament": "Chính trực, cứng cỏi, là biểu tượng của thế hệ đi trước nuôi chí tự chủ.",
      "historical_cultural_context": "Tiết độ sứ, người đánh đuổi quân Nam Hán năm 931, cha vợ của Ngô Quyền; cái chết của ông là biến cố mở đầu xung đột với Kiều Công Tiễn.",
      "output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/duong_dinh_nghe_ref.png",
      "approved": false,
      "used_in_scene_ids": [
        "scene_019",
        "scene_023",
        "scene_024",
        "scene_028",
        "scene_031",
        "scene_086",
        "scene_093",
        "scene_102",
        "scene_104"
      ],
      "prompt": "Single cinematic portrait reference of Dương Đình Nghệ, khoảng 50-60 tuổi trước khi bị sát hại, Võ tướng lớn tuổi, gương mặt từng trải, râu dài vừa phải, ánh mắt nghiêm nghị, dáng vững chãi.. Costume: Trang phục hào trưởng/quân chủ địa phương thế kỷ X, áo dài vải dày màu trầm, giáp nhẹ khi xuất hiện trong bối cảnh quân sự.. Temperament: Chính trực, cứng cỏi, là biểu tượng của thế hệ đi trước nuôi chí tự chủ.. Historical context: Tiết độ sứ, người đánh đuổi quân Nam Hán năm 931, cha vợ của Ngô Quyền; cái chết của ông là biến cố mở đầu xung đột với Kiều Công Tiễn.. 10th century Vietnam, documentary historical realism, consistent face identity, bust or half-body portrait, simple natural background, no character sheet, no turnaround, no design board, no lineup, no text, no modern objects, no fantasy armor.",
      "rule_use_ref": "Attach this approved character ref to recurring-character scene prompts where the character appears clearly or close enough for identity consistency."
    },
    {
      "name": "Kiều Công Tiễn",
      "slug": "kieu_cong_tien",
      "priority": "required",
      "role": "antagonist_supporting",
      "appearance": "Nam nhân trung niên, gương mặt căng thẳng, ánh mắt nghi kỵ, vẻ ngoài quan lại/quân tướng địa phương.",
      "costume": "Áo quan/quân phục địa phương thế kỷ X màu tối, thắt lưng da, phục sức vừa phải; có thể đặt trong không gian phủ đường u ám.",
      "temperament": "Tham vọng, bất an, phản trắc; tạo cảm giác người bị quyền lực và sợ hãi chi phối.",
      "historical_cultural_context": "Kẻ sát hại Dương Đình Nghệ và cầu viện Nam Hán, trở thành nguyên nhân trực tiếp khiến Ngô Quyền kéo quân ra Bắc.",
      "output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/kieu_cong_tien_ref_v2.png",
      "approved": false,
      "used_in_scene_ids": [
        "scene_028",
        "scene_031",
        "scene_039",
        "scene_099"
      ],
      "prompt": "Create ONE historical Vietnamese character reference concept sheet, not a final scene. Style must match the provided reference images: sepia parchment background, aged paper, ink wash and watercolor, muted browns, charcoal, ochre, smoky gray, dark red accents, painterly linework. Layout: central full-body front view plus one three-quarter view, one shoulder portrait, small costume/armor/detail panels, optional small battlefield vignette; no modern labels, no readable text. Historical grounding: 10th century Vietnam around the Bach Dang campaign, Ngo dynasty / post-Tang regional context; Vietnamese/East Asian facial features; period-appropriate cloth, lamellar/leather armor, belts, boots, weapons; no fantasy armor, no Qing/Ming/Three Kingdoms costume drift, no European armor. Character identity: Kiều Công Tiễn; role: antagonist_supporting; age: ; appearance: Nam nhân trung niên, gương mặt căng thẳng, ánh mắt nghi kỵ, vẻ ngoài quan lại/quân tướng địa phương.; costume: Áo quan/quân phục địa phương thế kỷ X màu tối, thắt lưng da, phục sức vừa phải; có thể đặt trong không gian phủ đường u ám.; temperament: Tham vọng, bất an, phản trắc; tạo cảm giác người bị quyền lực và sợ hãi chi phối.; historical/cultural context: Kẻ sát hại Dương Đình Nghệ và cầu viện Nam Hán, trở thành nguyên nhân trực tiếp khiến Ngô Quyền kéo quân ra Bắc.. Negative exclusions: no glossy digital poster, no 3D render, no anime, no fantasy glowing weapons, no modern objects, no watermark, no logo, no typography, no English/Chinese text, no clean white background.",
      "rule_use_ref": "Attach this approved character ref to recurring-character scene prompts where the character appears clearly or close enough for identity consistency.",
      "generated": true,
      "review_status": "pending_boss_review_v2",
      "style_validation": "vision_passed_character_reference_sheet"
    },
    {
      "name": "Lưu Hoằng Tháo",
      "slug": "luu_hoang_thao",
      "priority": "required",
      "role": "antagonist_supporting",
      "appearance": "Tướng trẻ Nam Hán, gương mặt tự tin, kiêu ngạo, dáng đứng của người quen được bảo vệ bởi quyền lực triều đình.",
      "costume": "Giáp tướng Nam Hán thế kỷ X, màu đen/đồng sẫm, mũ chiến, áo choàng ngắn; phong cách phương Bắc nhưng không fantasy.",
      "temperament": "Nóng vội, chủ quan, tin vào sức mạnh hạm đội; khí chất hoàng thân cầm quân nhưng thiếu kinh nghiệm địa thế.",
      "historical_cultural_context": "Con vua Nam Hán Lưu Cung, chỉ huy thủy quân tiến vào Bạch Đằng và tử trận trong trận đánh năm 938.",
      "output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/luu_hoang_thao_ref_v2.png",
      "approved": false,
      "used_in_scene_ids": [
        "scene_035",
        "scene_060",
        "scene_076"
      ],
      "prompt": "Create ONE historical Vietnamese character reference concept sheet, not a final scene. Style must match the provided reference images: sepia parchment background, aged paper, ink wash and watercolor, muted browns, charcoal, ochre, smoky gray, dark red accents, painterly linework. Layout: central full-body front view plus one three-quarter view, one shoulder portrait, small costume/armor/detail panels, optional small battlefield vignette; no modern labels, no readable text. Historical grounding: 10th century Vietnam around the Bach Dang campaign, Ngo dynasty / post-Tang regional context; Vietnamese/East Asian facial features; period-appropriate cloth, lamellar/leather armor, belts, boots, weapons; no fantasy armor, no Qing/Ming/Three Kingdoms costume drift, no European armor. Character identity: Lưu Hoằng Tháo; role: antagonist_supporting; age: ; appearance: Tướng trẻ Nam Hán, gương mặt tự tin, kiêu ngạo, dáng đứng của người quen được bảo vệ bởi quyền lực triều đình.; costume: Giáp tướng Nam Hán thế kỷ X, màu đen/đồng sẫm, mũ chiến, áo choàng ngắn; phong cách phương Bắc nhưng không fantasy.; temperament: Nóng vội, chủ quan, tin vào sức mạnh hạm đội; khí chất hoàng thân cầm quân nhưng thiếu kinh nghiệm địa thế.; historical/cultural context: Con vua Nam Hán Lưu Cung, chỉ huy thủy quân tiến vào Bạch Đằng và tử trận trong trận đánh năm 938.. Negative exclusions: no glossy digital poster, no 3D render, no anime, no fantasy glowing weapons, no modern objects, no watermark, no logo, no typography, no English/Chinese text, no clean white background.",
      "rule_use_ref": "Attach this approved character ref to recurring-character scene prompts where the character appears clearly or close enough for identity consistency.",
      "generated": true,
      "review_status": "pending_boss_review_v2",
      "style_validation": "vision_passed_character_reference_sheet"
    },
    {
      "name": "Lưu Cung",
      "slug": "luu_cung",
      "priority": "recommended",
      "role": "background_antagonist",
      "appearance": "Vua Nam Hán lớn tuổi, gương mặt lạnh và tính toán, dáng ngồi quyền lực trong triều điện.",
      "costume": "Long bào/triều phục Nam Hán thế kỷ X tông vàng sẫm hoặc đen đỏ, mũ miện phương Bắc giản lược theo hướng lịch sử.",
      "temperament": "Tham vọng bành trướng, kiêu hãnh, xem Giao Châu là vùng có thể tái chiếm.",
      "historical_cultural_context": "Vua Nam Hán, sai con là Lưu Hoằng Tháo đem thủy quân sang xâm lược Giao Châu.",
      "output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/luu_cung_ref.png",
      "approved": false,
      "used_in_scene_ids": [
        "scene_033",
        "scene_035",
        "scene_078"
      ],
      "prompt": "Single cinematic portrait reference of Lưu Cung, khoảng 50-60 tuổi, Vua Nam Hán lớn tuổi, gương mặt lạnh và tính toán, dáng ngồi quyền lực trong triều điện.. Costume: Long bào/triều phục Nam Hán thế kỷ X tông vàng sẫm hoặc đen đỏ, mũ miện phương Bắc giản lược theo hướng lịch sử.. Temperament: Tham vọng bành trướng, kiêu hãnh, xem Giao Châu là vùng có thể tái chiếm.. Historical context: Vua Nam Hán, sai con là Lưu Hoằng Tháo đem thủy quân sang xâm lược Giao Châu.. 10th century Vietnam, documentary historical realism, consistent face identity, bust or half-body portrait, simple natural background, no character sheet, no turnaround, no design board, no lineup, no text, no modern objects, no fantasy armor.",
      "rule_use_ref": "Attach this approved character ref to recurring-character scene prompts where the character appears clearly or close enough for identity consistency."
    },
    {
      "name": "Binh sĩ Việt / dân binh ven sông",
      "slug": "binh_si_viet",
      "priority": "recommended",
      "role": "group_character",
      "appearance": "Nam giới Việt cổ nhiều độ tuổi, thân hình rắn rỏi, da rám nắng, vẻ mặt quyết tâm; có người chèo thuyền, có người đóng cọc, có người cầm giáo.",
      "costume": "Áo vải nâu, chàm, xám; khăn vấn hoặc tóc búi; giáp nhẹ bằng da/tre/vải dày; vũ khí giáo, lao, cung, mái chèo.",
      "temperament": "Gan góc, bền bỉ, đoàn kết; đại diện sức dân trong trận Bạch Đằng.",
      "historical_cultural_context": "Lực lượng địa phương và quân của Ngô Quyền chuẩn bị bãi cọc, nhử địch và phản công trên sông Bạch Đằng.",
      "output_path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/binh_si_viet_ref.png",
      "approved": false,
      "used_in_scene_ids": [
        "scene_001",
        "scene_002",
        "scene_003",
        "scene_035",
        "scene_042",
        "scene_045",
        "scene_046",
        "scene_048",
        "scene_051",
        "scene_057",
        "scene_062",
        "scene_063",
        "scene_069",
        "scene_073",
        "scene_075",
        "scene_077",
        "scene_084",
        "scene_094",
        "scene_103",
        "scene_105",
        "scene_106",
        "scene_124",
        "scene_129",
        "scene_130",
        "scene_137",
        "scene_139",
        "scene_143"
      ],
      "prompt": "Single cinematic portrait reference of Binh sĩ Việt / dân binh ven sông, khoảng 18-45 tuổi, Nam giới Việt cổ nhiều độ tuổi, thân hình rắn rỏi, da rám nắng, vẻ mặt quyết tâm; có người chèo thuyền, có người đóng cọc, có người cầm giáo.. Costume: Áo vải nâu, chàm, xám; khăn vấn hoặc tóc búi; giáp nhẹ bằng da/tre/vải dày; vũ khí giáo, lao, cung, mái chèo.. Temperament: Gan góc, bền bỉ, đoàn kết; đại diện sức dân trong trận Bạch Đằng.. Historical context: Lực lượng địa phương và quân của Ngô Quyền chuẩn bị bãi cọc, nhử địch và phản công trên sông Bạch Đằng.. 10th century Vietnam, documentary historical realism, consistent face identity, bust or half-body portrait, simple natural background, no character sheet, no turnaround, no design board, no lineup, no text, no modern objects, no fantasy armor.",
      "rule_use_ref": "Attach this approved character ref to recurring-character scene prompts where the character appears clearly or close enough for identity consistency."
    }
  ],
  "scene_generation_rules": {
    "use_ref_when": "Scene has an approved recurring character visible clearly.",
    "no_ref_needed_when": "Scene is landscape, map, far crowd/boats, heading, symbolic, or no locked identity.",
    "style_ref_role": "visual language/style only",
    "character_ref_role": "identity only",
    "negative_prompt_required": [
      "character sheet",
      "turnaround sheet",
      "concept art board",
      "front/back pose sheet",
      "lineup",
      "floating costume parts",
      "isolated armor pieces",
      "reference layout",
      "design board"
    ],
    "positive_prompt_required": [
      "one cinematic narrative scene",
      "environment",
      "action or situation",
      "framing",
      "historical context matching narration beat"
    ]
  },
  "outputs": {
    "planning": "script/character_reference_plan.json",
    "character_refs": "characters/<slug>_ref.png",
    "scene_images": "images/scenes/scene_001.png ...",
    "logs": [
      "logs/generate_character_refs.log",
      "logs/generate_scene_images.log",
      "logs/step_05_summary.json"
    ]
  },
  "completion_conditions": [
    "required character refs generated",
    "refs validated/approved",
    "all scene images generated",
    "recurring-character scenes use approved refs",
    "no scene output becomes ref sheet/design board/lineup/model sheet"
  ],
  "last_generation_result": [
    {
      "slug": "ngo_quyen",
      "priority": "required",
      "exists": true,
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/ngo_quyen_ref.png",
      "size_bytes": 2327736,
      "image_type": "png"
    },
    {
      "slug": "duong_dinh_nghe",
      "priority": "recommended",
      "exists": false,
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/duong_dinh_nghe_ref.png",
      "size_bytes": 0,
      "image_type": null
    },
    {
      "slug": "kieu_cong_tien",
      "priority": "required",
      "exists": true,
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/kieu_cong_tien_ref.png",
      "size_bytes": 2139538,
      "image_type": "png"
    },
    {
      "slug": "luu_hoang_thao",
      "priority": "required",
      "exists": true,
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/luu_hoang_thao_ref.png",
      "size_bytes": 2279019,
      "image_type": "png"
    },
    {
      "slug": "luu_cung",
      "priority": "recommended",
      "exists": false,
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/luu_cung_ref.png",
      "size_bytes": 0,
      "image_type": null
    },
    {
      "slug": "binh_si_viet",
      "priority": "recommended",
      "exists": false,
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/binh_si_viet_ref.png",
      "size_bytes": 0,
      "image_type": null
    }
  ],
  "style_correction": "Previous refs were generated with wrong visual rules. Regenerate character refs using locked parchment concept-sheet style saved in data/style-guide/locked_visual_style.json and user-provided character-ref examples.",
  "style_source": "/data/video-pipeline/Youtube-Video-Maker/data/style-guide/locked_visual_style.json",
  "style_ref_dir": "/data/video-pipeline/Youtube-Video-Maker/data/style-ref/character-ref",
  "last_generation_result_v2": [
    {
      "slug": "ngo_quyen",
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/ngo_quyen_ref_v2.png",
      "exists": true,
      "size_bytes": 3438638,
      "image_type": "png"
    },
    {
      "slug": "kieu_cong_tien",
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/kieu_cong_tien_ref_v2.png",
      "exists": true,
      "size_bytes": 3236060,
      "image_type": "png"
    },
    {
      "slug": "luu_hoang_thao",
      "path": "/data/video-pipeline/Youtube-Video-Maker/Project/26052026-001-Ngo-Quyen/characters/luu_hoang_thao_ref_v2.png",
      "exists": true,
      "size_bytes": 3369719,
      "image_type": "png"
    }
  ]
}