# Prompt patterns `scripts/build-requests.mjs` builds every prompt from `assets/prompt-template.md`. You write three things in `screen.json`: the **description** and **features to keep** of the hero (once), and each screen's **pose** and **scene**. The script adds the look, the street, the composition, the grid rule, the reference lines, the people rule, the safety rule and the no-text rule. ## Anatomy of a screen prompt 1. **Frame:** "A vertical 9:16 illustration in the style of an open-world action-game loading screen: one hero in a cocky three-quarter pose in front of a busy city street." 2. **Look:** the preset's art direction (or the user's), word for word on every screen of a set. 3. **World:** what the street holds (palms, awnings, cars, a vendor cart), from the preset. 4. **Hero:** who it is and what must stay recognisable, with the reference image number. 5. **Pose and attitude:** the cocky body language for this screen. 6. **Scene:** where it stands on this screen. 7. **Composition:** the hero large on the side opposite the caption, with open street for the panel (from `style.side`). 8. **Grid rule:** everything important between 13 and 87 percent of the height and out of the right-hand 14 percent. 9. **References** (when there are any): the draft, screen 1 as the look anchor. 10. **People rule, safety rule, no-text rule.** ## Writing the description and what to keep One sentence for the description ("a small scruffy terrier mix called Patch"), one phrase for what must stay recognisable. Name things the model can compare with the photo, and say which side for anything one-sided. | Kind | Description | Keep | | --- | --- | --- | | Pet | a small scruffy terrier mix called Patch | a wiry cream and white coat, a black patch around the eye on the left of the picture, the other side of the face white, the upright ear on the left of the picture and the folded ear on the right, amber eyes, a black nose and a red collar | | Product | a matte green insulated bottle with a steel cap | its exact shape, the green colour, the steel cap, the printed lettering as in the photo | | Character | a tall fox in a yellow raincoat | the rust-orange fur, the white tail tip, the yellow raincoat with two buttons, round green glasses | | Person | the user, an adult with short dark curly hair and a beard | their face, hair, beard, skin tone and build | A product gets no face or limbs. Its pose is the way it stands on the kerb: slightly turned, lit from low sun, taller than the cart beside it. ## Writing the pose One sentence: stance, head, attitude, one accessory. Cocky and friendly. - Good: "standing tall on its hind legs in a three-quarter turn, chest out and chin up, tiny round sunglasses pushed low on its nose, one paw on its hip, a smug half-smile". - Good (product): "standing at a slight angle on the kerb, lit from the low sun, a tiny pair of sunglasses balanced on its cap" (props are fine, a face is not). - Avoid: weapons, fists raised to fight, anything criminal or menacing, anything that makes a real person look ridiculous or guilty. ## Writing the scene One sentence: the place and two or three props, from the friendly list. A hot dog cart, a retro convertible with no badge at the kerb, a skateboard, an ice-cream cart, a rooftop with a water tower, a boardwalk with a bicycle, a palm-lined crossing, a scooter. Same world on every screen of a set, a different corner of it each time. Never put words, quotes, a sign that reads something or a logo in the scene. `build-requests.mjs` warns about words and refuses crime or violence words. ## People `subject.kind` sets the rule: | Kind | What the prompt says | When | | --- | --- | --- | | `pet` | keep the animal recognisable: coat, markings, ear shape, eye colour | the default, and the most reliable | | `product` | keep the exact shape, colours, materials and printed lettering; no face or limbs | a product photo | | `character` | an invented design, from a description or from existing art (use `--photo` for the art) | a mascot or a character sheet | | `person` | stay exactly themselves: identity, age range, skin tone, hair, features, body; no changed ethnicity, no added or removed features, nothing embarrassing; the only person in the image | the user, or someone who agreed in plain words, an adult | A person needs `consent.basis` (`own-photo` or `written-consent`), `consent.adult_confirmed` and `consent.confirmed`, set only after the yes. `new-screen.mjs` writes them only when you pass `--consent` and `--adult-confirmed`. `build-requests.mjs` and `check-screens.mjs` both refuse a person without them. Never a celebrity or public figure, never a child, never a photo of someone who has not agreed. ## Drafts, then finals - **Draft** (`--stage draft`): quality low, 720 x 1280, about two cents with the photo. Use it to agree the pose, the scene, the likeness and the open space for the caption. - **Final** (`--stage final`): quality medium, 1088 x 1936. Do screen 1 first; its path goes in the screen's `art` and in `references.anchor`. Screens 2 onwards carry the photo, the anchor and their own draft: three references, the most a request takes. - **Second opinion:** `--model nano-banana-pro` for a final (flat $0.15, 2K). Use it when GPT Image 2 drifts from the markings or the face. - **High** quality is rarely worth it: the screen is seen on a phone. It costs about four times medium. ## Failure modes and fixes Change one thing per attempt, say which, and compare with the photo and with screen 1. | Problem | Fix | | --- | --- | | The hero drifts (patch on the wrong eye, ear wrong, wrong colour) | Name the feature and its side in `subject.keep` ("the black patch over the eye on the left of the picture"), then re-roll. If it repeats, `--model nano-banana-pro` | | Stray letters, a sign, a licence plate or a menu in the art | Remove the object that invites text from the scene (a menu board, a shop sign, a plate) and re-roll | | The hero sits on the caption's side, or is so wide that it runs under the panel | Say in the scene which side the cart or car and the dog are on ("on the right-hand side of the frame, the empty road on the left"), and check `style.side` matches. Narrow poses (standing, sitting, lounging on a bonnet) fit; a trot or a pose with an arm stretched towards the caption does not | | The hero is too big or too low | The composition line asks for a hero about 40 percent of the height; the model follows the head height and the side, not the feet. Leave the street empty on the caption side and check the draft before the final | | The plate on a parked car shows marks like letters | Turn the car so its front is not seen, or put it where the panel or strip will cover it, or re-roll. Check every car | | A crowd or a second character appears | Add "nobody else in the picture" to the scene; keep the street list to cars, palms and carts | | It looks glossy or 3D | Add "flat shapes, thick outlines, brush texture, no gloss" to your own look, or use a preset | | It looks like another game's cover | Drop any name or reference from the look; use a preset; remove stars, icons and interface marks; re-roll | | A cover look drifts across a set | Check `references.anchor` is set, then re-roll that screen only. Never repaint the others | | Melted paws, extra fingers | Re-roll; if it repeats, put the hands in a pocket or on the hip | | The draft pulls the old layout back | Drop that screen's `draft` from the plan and re-roll | | A set's drafts wander (the hero lands in the caption half) | Drafts carry the photo only, not screen 1. Say the side in each scene, as above, and re-roll the draft, not the final | | Refused by the safety check | Remove any real person's name, a brand or unsafe content. With a person, check consent is recorded and the photo is of an adult who agreed. Nothing to retry as is |