# Prompt patterns ## Writing the locks A lock is a fact that must be the same in episode 1 and episode 20. Write each one once, in `character.json`, and let `scripts/lock-text.mjs` turn them into the paste-in block. Never retype or paraphrase it in a later prompt. | Field | Write | Example | | --- | --- | --- | | `age` | An adult age range, in words | "a woman in her mid-30s" | | `face` | Shape, skin tone, eyes, brows, one distinguishing mark | "oval face, light olive skin with faint freckles across the nose, dark brown eyes, strong straight brows, a small mole under the left eye, tired but alert" | | `hair` | Colour, length, how it is worn | "dark brown, shoulder length, worn in a low knot at the nape with a few loose strands" | | `build` | Height and frame, never a weight | "average height, lean, narrow shoulders" | | `wardrobe` | Every garment with colour and cut | "a navy scrub top and matching navy scrub trousers over a fitted grey long-sleeve top, sleeves pushed to the elbows, plain white nursing shoes" | | `props` | The one or two things she always carries | "a small silver wristwatch with a round face and a thin black strap on her left wrist" | | `never` | One to six things that must not change | "the small silver watch on her left wrist", "the hair in a low knot at the nape" | - A strong, simple wardrobe colour does more for continuity than any face description: viewers track colour. Navy over grey holds better than "a smart casual outfit". - A small prop in `never` (a watch, a ring, a scar) is a deliberate trade. Small accessories are what models drop first, so the sheet makes them a lock the user can check on every still. Lock at most two; each extra one is another thing to fail. - Write what is there, not what it feels like. "Tired but alert" is the most the face field should say about mood. - A look is a medium: `photoreal`, `stylised-3d` or `clay`. Never a studio, a film or a living artist. `check-sheet.mjs` fails a field that names one. - Keep `lock_text` under 850 characters and `lock_text_short` under 260. The short one is for prompts with little room (a clip prompt, a cover subject): write your own with `--short` rather than trusting the automatic one. ## The sheet prompt `scripts/build-requests.mjs --stage sheet` fills `assets/prompt-template.md`. Its parts, in order: 1. The format: a 16:9 character model sheet for a film, one seamless plain light grey backdrop, evenly lit. 2. The look line for the medium. 3. The lock text, unchanged. 4. The people line: a fictional adult who resembles no real person, or (with a photo) the exact rule below. 5. The layout, in numbers: each column and portrait cell with its x and y range as percentages, and the four bands that must stay empty. 6. The sameness line: same face, hair, skin, build, outfit and props in all eight views. 7. The text rule: no words, letters, numbers, logos, labels or watermarks, on clothes, badges or backdrop. **Give numeric placement, but ask for what the model does.** The reel cover set run showed that "leave a calm band for the title" is ignored but "the band from 15 to 40 percent of the height is empty" is followed most of the time. On this sheet it was only half true: the model kept its own habits (figures about 15% apart, feet near 93% of the height, portraits about 17% wide) whatever the numbers. So `layout.json` carries the numbers it follows, the label bands sit under the feet at the bottom, and the compose step sets each label in the gap the art really left and measures the result. ## A photo as the base With `--photo`, the sheet is an edit: the photo is reference image 1, and the prompt adds: "The character must stay exactly the person in reference image 1: the same identity, age range, skin tone, hair, facial structure and body. Do not change their ethnicity or add or remove features. The expressions are natural to their face. The person is an adult." - Only the user, or a person whose written consent the user says they hold. Ask directly: "Is this you, or do you have this person's written consent to use their likeness in a generated character?" A clear yes goes in `--consent-quote` word for word. Never write the quote yourself and never choose this path on your own. - Refuse celebrities and public figures whatever the answer, and never make a character from a photo of a child. - The wardrobe in `character.json` is applied to the person: the sheet is for the series, not the photo's outfit. Say so up front. - The photo goes inline (`--inline`), never on a public link. ## Scene tests `--stage scene` makes three 16:9 stills with `nano-banana-pro` edit: the text-free sheet is reference image 1 (the photo is reference image 2 for a real person), the lock text follows, then the scene. Write each scene as place, light and one action: "a hospital corridor at 3 a.m., cold green strip lights and an empty trolley, the character walks towards the camera carrying a clipboard." Three places in three different lights is the test: a face that holds in a cool corridor, a wet street and a warm kitchen will hold in the series. Always say "show the face clearly in this scene's light" and "use the sheet only for the person": without it the model copies the grey backdrop and the standing pose. ## Failure modes and fixes | Seen | Fix (change one thing per attempt) | | --- | --- | | Feet or hands run into a label band | The labels move to the gap the art leaves, so this only fails when no gap is tall enough. Say "the figures are 8 percent smaller and end at 84 percent of the height", or move the bands in `layout.json` and make a draft again. | | Two figures touch or overlap | Say each column is 14 percent wide and each figure "stays well inside its column, with a clear gap to the next". | | Fewer than four full-length views, or a portrait missing | Name the cells again in a shorter prompt: put the layout first and the lock text after it. | | The four portraits look like four people | Add the face lock twice: once in the lock text, once as "the same face as the front view in every portrait". Re-roll at high quality; a low draft is not a test of this. | | The back view shows a face, or the profile faces the wrong way | Say "back view: the back of the head and the knot only, no face visible" and "profile: facing the left of the image". | | Text on a badge, a shirt or the backdrop | Add "plain clothing, no badge, no lanyard, no printed text of any kind" to the wardrobe, and say so in `never`. | | The outfit changes between views | Name every garment and colour once more in the sameness line; remove any garment the model keeps changing from the wardrobe. | | Bad hands | Say "hands relaxed, fingers together, five fingers each, held away from the body". Avoid props held in the hand on a sheet. | | A scene test drifts (hair loose, watch gone, mole lost) | Add the drifting detail to `never`, run `lock-text.mjs`, re-roll that scene. Never "fix" it by describing it differently. | | A scene adds a garment the lock does not have (a hood appeared when the scene said "hood down") | Take the word out of the scene prompt: a scene line is read as a wardrobe instruction. Name only what the lock already has, and add "no other clothing" if it persists. | | A scene copies the sheet's pose or grey backdrop | Add "do not copy the sheet's pose, backdrop or layout" and name the action in the scene. | | The photo's face turns into a generic one | Use a larger, sharper photo with one face, front on, and name the lock details that make them recognisable. Try one re-roll, then say what still differs. | | The model refuses the request | Remove any name of a real person, a celebrity or an artist, and check the age field. See `character-lib.mjs` rules. | At most 3 attempts per image, one change each, and say which. Deliver the best and say plainly what still differs.