4.3 KiB
Video Workbench Context Handoff
This document preserves the current working agreements for Video Workbench so future Codex sessions do not depend on copied chat history.
Confirmed Architecture
Knowledge Vault = source archive and model/essay library
Writing Workbench = deep article production workspace
Video Workbench = local video/slide execution workspace
CCPE System = actor, skill, model, runtime, and interface supplier
Skills Vault = reusable automation skill supplier
Video Workbench is a sibling of Writing Workbench. It should not be folded into article production because the target output, rhythm, assets, and evaluation criteria are different.
Video Workbench keeps local project notes, execution outputs, and handoff records. It does not own canonical prompts, agent definitions, reusable automation source code, or production/business agent implementation for deployable systems.
Collaboration Contract
GPT / ChatGPT = planning and execution-package authoring
User = decisions and accepted input placement
Codex = file mapping, project notes, execution, generated assets
Most content files should come from GPT output accepted by the user and placed in projects/<project>/intake/. Codex-maintained files should be short continuation aids and execution records.
Project Shape
Use one project root:
projects/<project-id>/
Do not move projects between status folders. Record status in project.md.
Do not decide series vs standalone through directory placement. Record series membership in project.md; add projects/_series/ only when a real series needs shared files or an index.
Recommended project-local structure:
projects/<project-id>/
project.md
intake/
slides/
slides.md
s01/
s02/
Use root handoff/ for repo-level, cross-project, series-level, or context-window handoff notes.
Project Files
project.md is a Codex-maintained small note. It should link to intake files instead of duplicating the outline, storyboard, or execution package.
intake/ holds GPT planning material, user-provided source material, references, execution packages, and other accepted input files.
slides/slides.md is the slide/page/shot mapping and progress tracker. It is the Video Workbench equivalent of a lightweight drafting tracker.
slides/sNN/ keeps all files for one slide, page, or shot together: prompts, narration, generated images, generated audio, and local notes.
Text Encoding
All local Markdown, JSON, YAML, text, prompt, discussion, and handoff files are UTF-8 unless a file explicitly declares another encoding.
Use explicit UTF-8 when reading these files from PowerShell:
Get-Content -LiteralPath <path> -Encoding UTF8
Select-String -Path <path> -Pattern <pattern> -Encoding UTF8
Dimensional Output Rule
The user's method:
Extract one or two points from a deep article or model.
Connect them to a public-facing concern.
Produce a video usually under 10 minutes.
Use about 220 Chinese characters per minute as the narration budget.
Editing and publishing remain manual unless explicitly automated later. Image-to-video remains manual or semi-manual for now.
Capability-Request Mode
When an agent, skill, runtime, model card, invocation protocol, or deterministic automation tool is missing, create a supplier ticket and pause the dependent part of the work.
Tickets go to:
requirements/ccpe/
requirements/skills-vault/
CCPE supplies local work agents, runtime rules, model cards, invocation contracts, governed cognitive assets, and external capability registrations.
The single CCPE external interface is:
C:\Users\wangq\Documents\Codex\ccpe-system\Interface.md
Read that file first, then follow it to the consumer setup contract. Do not use older Agent, Lite, Skill, Runtime, or protocol paths as default startup paths.
Skills-vault supplies deterministic automation tools, scripts, batch utilities, exporters, and installable automation skills.
New Session Instruction
Use this in a new Video Workbench session:
Please read AGENTS.md, README.md, VIDEO_WORKBENCH.md, docs/context-handoff.md, and docs/ccpe-system-handoff.md first, then continue work on Video Workbench according to those conventions.