# Investigations

This directory holds research reports, experiments, comparisons, and draft workflow proposals for Video Workbench.

Investigation files are not stable operating rules by themselves. Accepted conclusions must be promoted into `README.md`, `VIDEO_WORKBENCH.md`, `docs/`, or project templates before they become durable workflow rules.

## Current Records

```text
2026-06-23-gpt-image-2-advisor-prompt-quality/
2026-06-23-gpt-image-2-advisor-prompt-quality-v2-broader-use-cases/
2026-06-23-text-to-image-image-to-image-execution-boundary/
2026-06-24-s14-reference-capable-generation/
2026-06-24-thread-notification-wakeup/
```

Notes:

- The first prompt-quality investigation over-weighted character and MV identity scenarios. It is retained as historical evidence.
- The V2 prompt-quality investigation is the accepted basis for shifting final image prompt ownership to Codex.
- The text-to-image / image-to-image execution-boundary investigation records local workflow policy only. It does not validate final image quality.
- The S14 reference-capable generation investigation established the current default success channel: `gpt-image-2` Advisor prompt/spec, then load the real reference image into context, then generate with host `image_gen`. Its conclusions were promoted into `AGENTS.md` and `VIDEO_WORKBENCH.md`.
- The thread-notification wakeup investigation tests whether child sessions can wake the parent thread through a direct callback instead of parent-side polling. It is not yet promoted into the slide-task workflow.
- Any historical `makeup-still/` directory recommendation inside old investigation files is superseded by the current `visual-system/` rule.