pin-prototypes
Pin prototypes
A design tool's first answer for any well-known surface is the pattern-matched one — the inbox that looks like email — and asking for several surfaces in one prompt averages them. The skill's answer is a prompt set drafted from the brief: Prompt 0 for the visual language, run once; one prompt per surface that names what to show, what the pattern-matched answer would be, and what the brief settles; and a push-back table written before any output exists, so the review of an output is anchored by the brief rather than by the output. The human runs the prompts; the agent drafts, distils the standing header that keeps later sessions on the first session's language, and pins each accepted output — HTML and a full-length PNG, numbered to its prompt — into a folder nothing edits, so an accepted output stays the decision it was. Once an output is pinned, the precedence rule says which of brief and prototype an implementer takes at its word. When the project shows its pinned exports, a rebrand at build time maps the tool's palette onto the project's own through a total colour mapping that fails on any colour it does not know.
1. Draft
Read the brief in full — every section, not the summary — before writing a prompt; a surface the brief mentions once still gets a prompt. Then write one Markdown file of prompts in the shape of prompt-template.md:
- The template's preamble on how to run them, as written.
- Prompt 0, marked run once, followed immediately by the first surface prompt. Prompt 0 asks for the visual language and lists the brief's objects and surfaces.
- One prompt per surface, in the brief's order, numbered from 01. Each has three fixed parts: show — what to show at what realistic scale; push back — what the tool's pattern-matched answer would be and why it is wrong here; the brief settles — behaviour the brief specifies, which the prototype may not change.
- The push-back table: one row per surface, each row's entry copied from that prompt's push back part.
Done when every surface in the brief has a numbered prompt with all three parts and a row in the table, and the file opens with the preamble.
2. Run
Give the human the checklist: the drafted file's preamble as a numbered list, ending with "on the tell, stop and paste session 1's output back". The tell of a degraded session is a later surface coming back thinner than an earlier one — fewer states, less of the object list, layout that ignores what Prompt 0 established. Where the wizard skill is installed — a skill that walks a human through a checklist one step at a time — the checklist may go to it instead. Done when the human has the checklist and the tell in hand.