# Prompt patterns `scripts/build-requests.mjs` builds every prompt from `assets/prompt-template.md`. You write two things in `series.json`: the **look** (once) and each cover's **subject**. The script adds the composition band, the grid rule, the reference lines, the people rule and the no-text rule. ## Anatomy of a cover prompt 1. **Frame**: "A vertical 9:16 cover image for one episode of a short video series ... one of a matching set." 2. **Look**: the series' art direction, word for word on every cover. A `{{colour}}` in it becomes that cover's palette colour. 3. **Subject**: what this cover shows. 4. **Composition**: the calm band for the title, which depends on `style.position` (top 15 to 40 percent, middle 23 to 57 percent, bottom 40 to 65 percent), and where the subject goes. 5. **Grid rule**: keep everything important between 13 and 87 percent of the height and out of the right-hand 14 percent. 6. **References** (when there are any): the still, cover 1 as the look anchor, the approved draft. 7. **People rule**: from `series.people` (below). 8. **No text**: no words, letters, numbers, logos, signs, labels, captions, watermarks or interface. The title is drawn later in code. ## Writing the look One sentence, about 30 to 50 words: the backdrop or setting, the light (direction and hardness), the camera angle, the colour treatment, the finish (grain, print texture). Name things the model can see. Example (`bold-flat`, the sample): > one hero subject shot from directly above on a saturated flat {{colour}} paper backdrop, hard midday sunlight from the upper left casting one crisp shadow, minimal props, glossy true-to-life styling, high-contrast editorial look, fine natural film grain Avoid in the look: brand names, artists' names, a real place's name, "poster" or "magazine cover" (both invite lettering), neon signs, book spines, screens, packaging with print. Each of those tends to bring stray text. ## Writing each subject One sentence, 15 to 35 words: the hero thing for this episode, its container or setting, two or three props, and anything that shows the episode's hook. Keep the same kind of subject at the same scale on every cover. When a title wraps to three lines, make that cover's subject smaller and lower ("the tray small and low in the frame, its top edge no higher than halfway down the image") so the title block does not sit on it. | Title | Good subject | Weak subject | | --- | --- | --- | | Lemon garlic orzo | a shallow white ceramic bowl of creamy lemon garlic orzo with chopped parsley, a cut lemon half beside it and a fork resting on the rim | "orzo" (too thin: the model fills the frame with props) | | Crispy gnocchi traybake | a dark enamel baking tray of crispy golden gnocchi with blistered cherry tomatoes and torn basil leaves | "a tray with a sign saying crispy gnocchi" (asks for text) | | 3 desk stretches | a rolled sage-green yoga mat and a small white ceramic mug on a pale wooden desk corner | "a woman stretching at her desk, smiling at the camera" (a face, and people drift between covers) | Never put the title, quotes or any words in the subject. `build-requests.mjs` warns when a subject mentions words, a title or a logo. ## Stills from the creator's own videos A still is one frame from the creator's own video for that episode (export it as a JPEG first). The prompt says: keep its main subject, setting and arrangement recognisable, restyle it into the series look. Good for vlogs, travel and product series where the cover should show the real thing. - Only the creator's own footage, or footage they have the rights to. - If the frame shows a person, set `still_has_person: true` on that cover and follow the people rules below. - Crop out other people, number plates, screens and third-party logos before you use a frame. ## People `series.people` sets the rule the script adds to every prompt: | Value | What the prompt says | When | | --- | --- | --- | | `none` (default) | Nobody in the image (or no one beyond the reference frame) | Object, food, place and graphic covers: the safest and most consistent | | `fictional` | Any person is a fictional adult who does not resemble any real or famous person, never a child, no other people | Hands, a figure from behind, a small silhouette in a scene | | `real-with-consent` | The person in the still stays exactly themselves: same identity, age range, skin tone, hair, facial structure and body; no change of ethnicity, no added or removed features, no expression, injury or action they did not have | The creator's own face from their own footage, after they say yes | `real-with-consent` needs `series.consent_confirmed: true`, set only after the person shown (or everyone shown) has agreed in plain words to appear on the covers. Never use a photo of a celebrity, a public figure, a child, or anyone who has not agreed. Never make a cover suggest an endorsement, a result or a reaction that did not happen. `build-requests.mjs` and `check-covers.mjs` both refuse a still marked `still_has_person` without that consent. ## Drafts, then finals - **Drafts** (`--stage draft`): quality low, 720 x 1280, about half a cent each. Use them to agree the subjects, check the calm band is really calm and see the six side by side. Do all six at once. - **Finals** (`--stage final`): quality medium, 1088 x 1936. Do cover 1 first. When it is right, put its path in `references.anchor`; covers 2 onwards carry it as the look reference. Put each approved draft's path in that cover's `draft`: its final carries it too, so the agreed composition holds. At most 3 references per cover (still, anchor, draft). - **High** quality is rarely worth it: a cover is mostly seen small. It costs about four times medium. ## Failure modes and fixes | Problem | Fix (change one thing per attempt) | | --- | --- | | Stray letters, a sign or a label in the art | Remove the object that invites text from the subject (a jar, a menu, a screen, packaging) and re-roll | | The subject sits in the title band | Say "small in the lower middle of the frame" in the subject, or move `style.position` to match where the model puts it, and recompose | | The band is busy (pattern, props) | Add "plain empty backdrop above the subject" to the subject, or switch to the `block` treatment (free, recompose only) | | A cover drifts from the set (light, angle, finish) | Check `references.anchor` is set, then re-roll that cover only. Never repaint the others | | Subjects at different sizes | Name the container size ("a 20 cm bowl") and "fills about a third of the frame width" | | Melted cutlery, extra fingers | Re-roll; if it repeats, drop the item or the hand from the subject | | A still loses its subject | Say what must stay ("the red bicycle and the harbour wall") in the subject | | Refused by the safety check | Remove any real person's name, brand or unsafe content. With a person in a still, check consent is recorded. Nothing to retry as is |