V4: add trailer V4 storyboard, update V3 script, add CLAUDE.md project guidelines

- fanren_trailer_v4.json: 18-shot storyboard with camera presets, shot chaining, beat sync
- produce_trailer_v3.py: improved phase handling and error recovery
- fanren_trailer_v3.json: minor config tweaks
- CLAUDE.md: project architecture, coding conventions, workflow rules

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: charliewwdev

CLAUDE.md

@@ -0,0 +1,43 @@
+# AnimateDiff V4 — Development Guidelines
+
+## Workflow Rules
+
+### Commit Early, Commit Often
+- Every completed module/feature MUST be committed before moving to the next
+- Never accumulate more than ~3 files of uncommitted changes
+- Use descriptive commit messages in English
+
+### Task Tracking
+- For multi-step work, always create a TaskList at the start
+- Update task status as work progresses (pending → in_progress → completed)
+- Before `/clear` or when context gets long, run `/compact` first
+
+### Context Preservation
+- When starting a large task, write the plan to `memory/WIP.md`
+- Update `WIP.md` after each milestone (commit)
+- Clear `WIP.md` when the task is fully complete
+- Keep `MEMORY.md` for stable, verified knowledge only
+
+### Code Conventions
+- Python 3.10+ (f-strings, type hints, walrus operator OK)
+- All new modules: include module docstring + `__all__` exports
+- Backend modules: subclass `BackendBase` from `core/base_pipeline.py`
+- PostProcess modules: follow existing pattern in `postprocess/`
+- Config: JSON storyboard format (see `examples/`)
+
+## Architecture
+
+```
+animatediff/
+├── backends/     # Video generation backends (wan, hunyuan, cogvideo, ltx, etc.)
+├── core/         # Pipeline infrastructure (base_pipeline, story_engine, vram, etc.)
+├── postprocess/  # Post-processing (upscale, interpolation, audio, deflicker, etc.)
+└── data/         # Static data (camera presets, LUTs, etc.)
+scripts/          # CLI entry points (animate.py, story.py, produce_trailer_*.py)
+examples/         # Storyboard JSON configs
+```
+
+## Key Constraints
+- MPS (Apple Silicon): float32 only, no CPU offload, no FP8/MoE models
+- RTX 4090 (24GB): Wan 2.2 5B at 832x480 with model_cpu_offload
+- Always test imports before committing new modules

examples/fanren_trailer_v3.json

@@ -38,28 +38,28 @@
   "characters": {
     "韩立_early": {
       "description": "young thin boy age 14, simple brown cloth, messy black hair, poor but determined dark eyes, thin face",
-      "image_path": null,
+      "image_path": "output/fanren-trailer-v3/portraits/韩立_early.jpg",
       "portrait_prompt": "cinematic medium shot of a young thin Chinese boy age 14, wearing simple ragged brown cloth, messy black hair, poor but determined dark eyes, thin face, standing in a mountain village, golden hour lighting, shallow depth of field, film grain, xianxia anime style, high detail, landscape 16:9 composition",
       "lora_path": null,
       "lora_scale": 1.0
     },
     "韩立_late": {
       "description": "young male cultivator age 16, grey disciple robes, hair tied in topknot, determined gaze, faint golden aura",
-      "image_path": null,
+      "image_path": "output/fanren-trailer-v3/portraits/韩立_late.jpg",
       "portrait_prompt": "cinematic medium shot of a young Chinese male cultivator age 16, grey disciple robes with dark trim, hair tied in topknot, determined gaze, faint golden spiritual aura, mountain backdrop, volumetric fog, rim lighting, xianxia anime style, high detail, landscape 16:9 composition",
       "lora_path": null,
       "lora_scale": 1.0
     },
     "墨大夫": {
       "description": "sinister old man with long white beard, dark green robes, sharp cunning eyes, hunched posture, alchemist",
-      "image_path": null,
+      "image_path": "output/fanren-trailer-v3/portraits/墨大夫.jpg",
       "portrait_prompt": "cinematic medium shot of a sinister old Chinese man alchemist, long white beard, dark green robes, sharp cunning eyes, hunched posture, dim candlelit alchemy room background, chiaroscuro lighting, xianxia anime style, high detail, landscape 16:9 composition",
       "lora_path": null,
       "lora_scale": 1.0
     },
     "厉飞雨": {
-      "description": "handsome young man in grey disciple robes, short black hair, warm smile, loyal friend, carrying a sword",
-      "image_path": null,
+      "description": "handsome young man in dark black robes, black hair with crown topknot, strong masculine face, thick eyebrows, loyal friend",
+      "image_path": "output/fanren-trailer-v3/portraits/厉飞雨.jpg",
       "portrait_prompt": "cinematic medium shot of a handsome young Chinese man in grey disciple robes, short black hair, warm friendly smile, sword strapped to back, cherry blossom trees background, soft morning light, xianxia anime style, high detail, landscape 16:9 composition",
       "lora_path": null,
       "lora_scale": 1.0