projects/{project-name}/
  manifest.yaml          # Project metadata, settings, status
  characters/
    {name}/
      profile.yaml       # Character description, reference images, voice profile
      references/         # Source images for this character
      outputs/            # Generated outputs
  workflows/              # Saved ComfyUI workflow JSONs
  assets/                 # External assets (audio, video, images)
  notes.md                # Production notes, what worked/didn't

name: "{project-name}"
description: "{description}"
created: "{ISO date}"
updated: "{ISO date}"
status: active  # active | paused | completed | archived

hardware:
  gpu: "RTX 5090"
  vram: 32

defaults:
  checkpoint: ""         # Filled after first successful generation
  upscaler: ""
  cfg: null
  sampler: ""
  scheduler: ""

characters: []           # List of character names
workflows: []            # List of saved workflow files

notes: ""

name: "{character-name}"
trigger_word: "{unique_trigger}"  # e.g., "sage_character"
created: "{ISO date}"

appearance:
  gender: ""
  age_range: ""
  ethnicity: ""
  hair: ""
  eyes: ""
  skin: ""
  build: ""
  distinguishing_features: []

personality:
  traits: []
  voice_description: ""

reference_images:
  source_type: ""        # 3d_render | photograph | illustration | generated
  count: 0
  path: "references/"

lora:
  trained: false
  model_file: ""
  trigger_word: ""
  best_strength: null

voice:
  cloned: false
  model: ""              # chatterbox | f5-tts | elevenlabs | rvc
  sample_file: ""
  settings: {}

generation_history:
  preferred_method: ""   # instantid | pulid | infiniteyou | kontext | lora
  best_settings:
    cfg: null
    steps: null
    sampler: ""
    ip_adapter_weight: null
    instantid_weight: null
  successful_prompts: []
  failed_approaches: []