video-workbench/handoff/2026-06-24-character-consis...

8.4 KiB

Character Consistency Workflow Review Handoff

Status

  • Date: 2026-06-24.
  • Project: projects/2026-06-23-在路上.
  • Task: projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/.
  • Purpose: hand off after the first s05 character-consistency workflow test and workflow-rule correction.
  • Current state: superseded by later workflow-reset decision before s21.

Supersession Note

Later user decision:

  • do not continue child-session agent 019ef77d-552b-7343-abe4-88921b35d7ea;
  • treat the previous s05 run as useful but procedurally defective because it overwrote an existing broad-run s05-v1-image.png;
  • patch the workflow docs and local task records before running s21;
  • future task execution must append the next unused slide version and must not overwrite existing slide artifacts.

The original continuation suggestion below is historical context only. Do not use it as the active next-step plan.

This handoff is not a CCPE invocation. It is for local Video Workbench slide task orchestration continuation.

Current User Decision

The user accepted the generated s05 image as usable:

projects/2026-06-23-在路上/slides/s05/s05-v1-image.png

Do not regenerate s05 unless the user explicitly asks for another sample.

Workflow Files Updated This Turn

Updated:

docs/workflows/slide-task-orchestration.md
docs/workflows/slide-task-templates.md

New handoff:

handoff/2026-06-24-character-consistency-workflow-review-handoff.md

The workflow docs now clarify:

  • gpt-image-2 is used as Advisor for prompt/spec construction in Video Workbench.
  • Normal project-bound generation does not need to prove Garden/API execution.
  • Expected generation evidence is:
    • Advisor prompt/spec record;
    • actual local reference image loaded into visible conversation context when references matter;
    • host built-in image generation called with the loaded image assigned a role such as Image 1;
    • host generated-image source path;
    • copied project image path;
    • review or return evidence.
  • Garden/API expected: no is the default unless the user explicitly changes the project policy.

Must Read First In Next Session

Read in this order:

  1. AGENTS.md
  2. VIDEO_WORKBENCH.md
  3. docs/workflows/slide-task-orchestration.md
  4. docs/workflows/slide-task-templates.md
  5. projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/task-plan.md
  6. projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/task-log.md
  7. projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/session-01/child-session-plan.md
  8. projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/session-01/child-session-handoff.md
  9. projects/2026-06-23-在路上/slides/s05/s05-v1-brief.md
  10. projects/2026-06-23-在路上/slides/s05/s05-v1-prompt.md
  11. projects/2026-06-23-在路上/slides/s05/s05-v1-review.md
  12. projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/session-01/returns/s05-v1-slide-agent-return.md
  13. projects/2026-06-23-在路上/intake/阶段五-人物一致性单镜.md
  14. projects/2026-06-23-在路上/visual-system/style/style-prompt-master.md
  15. projects/2026-06-23-在路上/visual-system/characters/character-reference-registry.md
  16. investigations/2026-06-24-s14-reference-capable-generation/reviews/summary-and-rule-implications.md

Active Agent / Session IDs

Deprecated child-session agent:

session-01 child-session agent id: 019ef77d-552b-7343-abe4-88921b35d7ea

Do not reuse this child-session id for the s21 reset test.

Completed s05 slide-agent:

s05 slide-agent id: 019ef781-1ff1-7073-80b0-3cf688104cdb

Earlier recommendation to continue this child-session is obsolete.

What Happened In The S05 Test

Planned architecture:

main session
-> child session
-> slide agent
-> prompt
-> visible-context reference load
-> host image_gen
-> review / return

Actual architecture:

main session
-> child session wrote s05 brief and packet
-> main session directly started s05 slide-agent
-> slide-agent wrote prompt, image, and review

This means the s05 test did not fully validate child-session-owned slide-agent spawning.

Original next-test recommendation, now obsolete:

  • do not send s21 to child-session agent 019ef77d-552b-7343-abe4-88921b35d7ea;
  • start a new child-session agent instead;
  • require that child session itself starts the s21 slide-agent if the runtime supports it;
  • if the child session cannot spawn the slide-agent, it must record runtime fallback required;
  • only then should main session start the slide-agent as fallback.

Problems Found This Turn

1. Main Session Started Slide-Agent Directly

The main session directly started s05 slide-agent instead of requiring the child session to do it.

Impact:

  • s05 asset is usable.
  • Workflow test is incomplete for the planned three-layer orchestration.
  • The next session must test the intended child-session-owned slide-agent launch.

2. Interrupted Return Mismatch

After s05-v1-prompt.md appeared, the main session assumed the slide-agent might be stuck and interrupted it.

Later evidence showed:

  • s05-v1-image.png had already been generated and copied;
  • s05-v1-review.md had already been written;
  • the first return text incorrectly said generation was blocked.

This was reconciled in:

projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/session-01/returns/s05-v1-slide-agent-return.md
projects/2026-06-23-在路上/slides/s05/s05-v1-review.md
projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/task-log.md

Next-session rule:

  • do not interrupt a slide-agent just because the prompt appeared first;
  • check for image, review, generated-image source, and return before interrupting;
  • if interrupting is necessary, inspect files after interruption before writing conclusions.

3. Advisor / Garden/API Boundary Was Ambiguous In Agent Reasoning

The workflow had already intended:

gpt-image-2 Advisor for prompt/spec
host image_gen for actual generation

But the review language drifted toward treating "not proving Garden/API" as a possible evidence gap.

This is wrong for current Video Workbench policy.

Correct rule:

Garden/API expected: no

Unless the user explicitly changes the project policy.

The updated workflow docs now make this explicit.

4. Review Was Generated Without Task-Plan Clarity

The user did not separately request review, but the packet allowed review after generation and identity-sensitive generated trials should default to local review.

Next-session rule:

  • task plan or packet should explicitly say whether review is required;
  • character-consistency / identity-sensitive generation defaults to local review unless disabled.

S05 Asset Summary

Generated image:

projects/2026-06-23-在路上/slides/s05/s05-v1-image.png

Generated host source:

C:\Users\wangq\.codex\generated_images\019ef781-1ff1-7073-80b0-3cf688104cdb\ig_087687f122f488ef016a3b446bd4fc8198bf390912b8aeb494.png

Main-session alternate reference-check candidate was generated but not copied into the project:

C:\Users\wangq\.codex\generated_images\019ef76c-7bc1-7550-91ce-51acd8d699f2\ig_064460e17256e2f6016a3b45364f20819abd5e6d125d5e7c5c.png

The project image hash matched the slide-agent generated host source during verification.

Continue character consistency workflow test.

Start a new child-session agent. Do not reuse:
019ef77d-552b-7343-abe4-88921b35d7ea

Next slide: s21.
Mode: prompt and generate.
Review: disabled for this test.
Artifact policy: append next unused s21-vN version; overwrite allowed: no.

This time require the child session to start the s21 slide-agent itself.
If the child session cannot spawn the slide-agent, record runtime fallback required and stop for main-session fallback.

Use updated docs/workflows rules.
Do not regenerate s05.

Verification Before Continuing

Before continuing, verify:

git status --short
Test-Path -LiteralPath 'docs/workflows/slide-task-orchestration.md'
Test-Path -LiteralPath 'docs/workflows/slide-task-templates.md'
Test-Path -LiteralPath 'projects/2026-06-23-在路上/tasks/2026-06-24-character-consistency/task-log.md'
Test-Path -LiteralPath 'projects/2026-06-23-在路上/slides/s05/s05-v1-image.png'
Test-Path -LiteralPath 'projects/2026-06-23-在路上/visual-system/characters/character-reference-registry.md'