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

256 lines
8.4 KiB
Markdown

# 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:
```text
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:
```text
docs/workflows/slide-task-orchestration.md
docs/workflows/slide-task-templates.md
```
New handoff:
```text
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:
```text
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:
```text
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:
```text
main session
-> child session
-> slide agent
-> prompt
-> visible-context reference load
-> host image_gen
-> review / return
```
Actual architecture:
```text
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:
```text
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:
```text
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:
```text
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:
```text
projects/2026-06-23-在路上/slides/s05/s05-v1-image.png
```
Generated host source:
```text
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:
```text
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.
## Recommended Next User Message
```text
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:
```powershell
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'
```