Ad brief intake

A vague brief produces a generic film. Fix the few decisions everything else depends on, then open the project so every later stage has one source of truth. The brief is validated by checkBrief in src/agent/checks.ts; rules marked checked are enforced there.

Workflow

1. Extract what the request already states and keep it verbatim: an aspect ratio (横版 / 横屏 = 16:9, 竖版 / 竖屏 or a vertical platform = 9:16, 方形 = 1:1) or a duration written in the request is not yours to change. A request that said 横版 once came back as 9:16; the pipeline now overrides the agent with the stated values (statedFormat), but do not make it necessary.

2. Resolve the blocking unknowns, in this order, in one message: the product (and whether a photo of it exists), the audience, the single message the viewer should remember. In a non-interactive run nobody can answer: decide them from the request.

3. Decide the rest yourself and say what you chose:

   • Aspect ratio: 16:9 by default - broadcast, web pre-roll and the big screen; 9:16 only when the request says 竖版 / 竖屏 or names a vertical platform (抖音, 快手, 小红书, 视频号, TikTok, Reels, Shorts); 1:1 for marketplaces.
   • Duration: 30 s by default - the master, from which the 15 s and 6 s cutdowns are cut. Any multiple of 5 from 5 to 30 (checked), because clips are generated in 5 s segments and each beat is one clip.
   • Tone, in English; the compliance category (general, food, health_food, cosmetics, medical, checked); the industry the product is shot as (below).
   • Delivery: native 1080p at 60 fps. Record resolution (1080p, 2k, 4k, 6k) and fps (24 for a film look, 30, 60, 120) only when the request asks.

4. Open the project:

   cinefoundry project init --id <lowercase-dashed-id> --title "<短中文标题>" --brief "<one-paragraph brief>" --ratio 16:9 --duration 30