Compile a brief
briefTurn card ids into paste-ready prompt blocks, worded verbatim from the cards: IMAGE PROMPT, VIDEO PROMPT, PALETTE (hexes), TYPE, SUNO STYLE and SUNO EXCLUDE, SITE PROMPT, or for job game: KEY ART, CAPSULE, SPRITE/TILESET, UI MOCKUP, MUSIC; for job drama: SHOT blocks for the hook, twist and payoff plus BEATS (timing, shot, what happens, a placeholder line with its length rule), END CARD (title, promise, call to action, set in the type card), CAPTION RULES (safe band y 210 to 1345 on 1080x1920, nothing in the bottom 30%) and DON'T. Pass the ids from deal_hand (or find_styles), at most one card per suit, except camera: several camera cards make a shot list (one SHOT block each). A camera card of kind light lights every shot; a film card of kind fx adds a post effect. tool respells the blocks: midjourney (--ar, --style raw, --sref with the film card's example image), runway or kling (camera line first, 5 or 10 s clips), suno (music blocks only). seconds splits a running time over the shots, beats says what happens in each, vocals picks lyrics or instrumental. A lens card in a shot list shapes every shot. Example: {"hand_ids": ["film-gold-200", "camera-closeup", "color-golden-hour"], "job": "photo", "subject": "an older woman teaching a young man to dance", "tool": "midjourney"}. Drama example: {"hand_ids": ["type-futura", "film-vision3-500t", "color-blue-hour", "camera-closeup", "camera-pull", "camera-push"], "job": "drama", "subject": "a meal-kit app", "feeling": "a quiet breakup at a dinner table", "title": "Dinner for Two", "seconds": 30}. Also returns the don't-list, tone words, deliverables, lint warnings and a site_url.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | What the brief is for (default reel); use the job you dealt for. photo = a still image, video = reel, song = Suno blocks only, site = SITE PROMPT, game = key art set, drama = short drama ad (beats, end card, caption rules). | reel |
| tool | No | Target tool: any (plain prose), midjourney, runway or kling (camera line first, shots capped at 10 s), suno (music blocks only). | any |
| beats | No | Optional: what happens in each shot, in order, e.g. ["they sit in silence", "she slides a photo across the table"]. Beat n goes into SHOT n (or the one VIDEO PROMPT). | |
| title | No | Optional title lettering for the image or key art (set in the type card). For drama, the show or brand name on the end card. | |
| aspect | No | Optional aspect ratio, e.g. "16:9", "9:16", "4:5", "1:1", "2.39:1". Default 9:16 for reel and lyric, 16:9 for game. | |
| vocals | No | Optional for music: "lyrics" lifts vocal bans out of SUNO EXCLUDE so a sung track can exist; "instrumental" adds them. | |
| feeling | No | Drama only: the story's feeling or situation, e.g. "a quiet breakup at a dinner table". The hook opens on it and every shot carries it. | |
| seconds | No | Optional running time in seconds, e.g. 15 for a reel or 60 for a short: split across the SHOT blocks (or the one VIDEO PROMPT) as "Duration: N s." Drama: 15 to 60, default 30, timed hook, twist, payoff. | |
| subject | No | Who or what is in the shot, e.g. "a lighthouse keeper on a rocky coast". Without it the prompts say [your subject]. For drama, the product being advertised. | |
| hand_ids | Yes | Card ids from deal_hand or find_styles, e.g. ["film-gold-200", "camera-closeup", "color-golden-hour"]. One per suit, except several camera cards = a shot list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | the job as asked | |
| hand | No | ||
| lint | No | ||
| site | No | ||
| tool | No | the tool the blocks are spelled for | |
| error | No | Set instead of the fields above when the input was wrong. | |
| aspect | No | the frame the blocks use | |
| blocks | No | block name to paste-ready text | |
| ignored | No | suits the job does not use | |
| seconds | No | drama: the running time the beats are timed to | |
| handover | No | ||
| job_note | No | a note for this job | |
| site_url | No | opens the hand on directorslookbook.app | |
| beat_plan | No | drama: each beat with its seconds and shot | |
| shot_order | No | the SHOT block names in order | |
| substitute | No | set when a stand-in card covers a genre the library lacks | |
| job_internal | No | the deck term when it differs from the job asked (video = reel, photo = still) | |
| end_card_from | No | drama: the second the end card starts |