Deal a hand
deal_handStart here for a project: deal one matched card per slot for a creative job from a plain-language feeling. photo = one image (film, camera, color, light); still = image with title type; cover = album or poster art (film, color, type); video or reel = clip or short (film, camera, color, type, score, light); lyric = lyric video (same as reel); song = music only (score); site = website (film, color, type, web); game = key art, store capsule, sprites, UI and loop music (film, color, type, score); drama = a short drama ad where the ad is the show (film, camera, color, type, score, light, and three shots: hook, twist, payoff); all = every suit. Example: {"feeling": "lonely astronaut on a desert planet at dusk", "job": "video", "shots": 3}. Same seed + same inputs = same hand; a new seed re-deals; hold keeps chosen cards ({"film": "film-gold-200"}). For job drama the hand also carries three shots (hook close-up, twist reveal, payoff wide or push) and the look is dealt from the feeling, with the subject read as the product. Returns the hand (slot to card id and name), why each card was picked, clashes, and a site_url showing the hand with pictures. Next step: brief with the hand ids.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | What the hand is for (default photo); see the job list above. | photo |
| hold | No | Optional cards to keep, as {slot: card id}, e.g. {"film": "film-gold-200", "score": "score-bossa-nova"}. Slots: type, camera, film, color, score, web, light. | |
| seed | No | Optional integer for a repeatable deal. Omit for a fresh random deal. | |
| moods | No | Optional mood chips that weigh more than words. One or more of: cozy, eerie, nostalgic, epic, playful, tense, dreamy, gritty, elegant, kinetic, melancholy, hopeful, futuristic, handmade, serene, bold. | |
| shots | No | Optional, for video, reel, lyric or all: also pick a shot list of this many camera cards (the dealt camera first, then matched shots and moves). Pass them all to brief to get one SHOT block each. A drama hand always has 3 (hook, twist, payoff). | |
| aspect | No | Optional frame for the clash check, e.g. "2.39:1" for a film or "9:16" for a reel (default 9:16 for reel and lyric). Pass the same aspect to brief. | |
| feeling | No | The feeling or scene in plain words, e.g. "rainy cafe at night, melancholy". Words after "no"/"not" count against a card. For drama, the story's feeling or situation, e.g. "a quiet breakup at a dinner table". | |
| subject | No | Optional subject, e.g. "a jazz singer". It is folded into the feeling so scene and person words count. For drama, the product being advertised (used for the setting check, not for picking the look). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hand | No | slot to card id | |
| lint | No | ||
| note | No | why each card was picked | |
| site | No | ||
| weak | No | slots filled on little evidence | |
| error | No | Set instead of the fields above when the input was wrong. | |
| names | No | slot to card name | |
| shots | No | shot list camera ids when shots was asked | |
| images | No | slot to example image URL | |
| swapped | No | cards swapped to clear a clash | |
| job_used | No | the job the hand was dealt for | |
| site_url | No | opens the hand on directorslookbook.app | |
| warnings | No | holds or options that could not be honoured | |
| moods_read | No | ||
| alternatives | No | slot to other card ids worth a look | |
| neg_moods_read | No |