VidCraft Workflow

Deutsche Version

Back to overview

Recommended order

/vidcraft:next-step, /vidcraft:resume and /vidcraft:project-dashboard help along the way. Check skills such as voice-checker, timing-validator, brand-checker and accessibility-checker can be run at any time.

graph TD
    A["new-project"] --> B["project-conceptualizer"]
    B --> C["brief-creator"]
    C --> D["script-writer"]
    D --> E["script-reviewer"]
    E --> F["storyboard-creator"]
    F --> G["screenshot-planner"]
    G --> H["asset-collector"]
    H --> I["pre-generation-check"]
    I --> J["heygen-engineer / synthesia-engineer"]
    J --> K["Generate manually"]
    K --> L["video-reviewer"]
    L --> M["subtitle-generator"]
    M --> N["release-director"]

Status model

Status lives in the frontmatter of the respective file and is set by the skills. You can also change it deliberately with update_field.

Project:

Concept → Brief Complete → Research Done → Script Draft → Script Approved
→ Storyboard Done → Assets Ready → Generated → Reviewed → Published

Episode:

Not Started → Script Draft → Script Reviewed → Storyboard
→ Assets Collected → Ready for Generation → Generated → QA Passed → Final

Scene:

Outline → Script Written → Visual Defined → Assets Ready → Generated → Approved

The server normalizes status values when it builds the state cache. Short forms are mapped to project statuses: Storyboard becomes Storyboard Done, Draft becomes Script Draft, Approved becomes Script Approved, Brief becomes Brief Complete and Research becomes Research Done. This applies on all levels: an episode status Storyboard or a scene status Approved therefore appears in the query tools as Storyboard Done or Script Approved respectively. The file itself is left unchanged. Unknown values are passed through as they are.

Status to next skill

The mapping lives in knowledge/status-workflow.md and is read by resume (project level) and next-step (episode level).

With several episodes, next-step prefers scripts in status Script Draft first (they block the following steps), then episodes not yet started, then storyboards, assets and the pre-generation check.

The pre-generation check is mandatory before generation: if an episode is still Not Started or Script Draft, the gate reports BLOCKED. See Quality system.

Ideas

With create_video_idea (for example via doc-analyzer or researcher), ideas are stored as sections in {content_root}/IDEAS.md. /vidcraft:session-start lists them.