| 1 | # UI agent brief |
| 2 | |
| 3 | This shape is distilled from two sets of briefs. Clover Chat's round 2 had five |
| 4 | parallel agents land Clover's whole first deep review in about 30 minutes. The snow |
| 5 | globe dashboard's later rounds used the same shape. Keep the headings; fill in |
| 6 | the angle brackets. |
| 7 | |
| 8 | ``` |
| 9 | You own **<outcome>** in <app>, <one-line pitch>. The user is <owner> (<pronouns>). |
| 10 | <Where it lives>; read <README / the files you'll touch> first. |
| 11 | Running at <url or command>; restart with `<cmd>` if it's down. |
| 12 | |
| 13 | ## <Owner>'s words (verbatim) |
| 14 | "<quote>" |
| 15 | "<quote>" |
| 16 | → The job, as I read it: <what they are trying to achieve, in one or two lines>. |
| 17 | |
| 18 | ## What it looks like now |
| 19 | - <defect, with where it shows> |
| 20 | - <defect> |
| 21 | Reuse <existing component / page / chart style> rather than inventing a second one. |
| 22 | |
| 23 | ## Decisions already made |
| 24 | - <decision and its source> |
| 25 | |
| 26 | ## Deliverable |
| 27 | 1. <item>: <concrete change, states to cover, entry points> |
| 28 | 2. <item> |
| 29 | N. Anything else in your area that clearly breaks down when you use it: fix |
| 30 | it, without adding features beyond this list. |
| 31 | |
| 32 | ## Ownership |
| 33 | You own: <file: functions / CSS sections `.prefix-*` / data arrays>. |
| 34 | Others own: <agent → area>. Work in <your own checkout at path | the shared |
| 35 | working copy>. If it's shared: make small targeted edits, never rewrite a |
| 36 | shared file, and re-read and retry if an edit fails because the file changed. |
| 37 | |
| 38 | ## Hard rules |
| 39 | - <version-control and safety rules from the repo's AGENTS.md / CLAUDE.md>. |
| 40 | - Don't touch <other layers / crates / captures>. |
| 41 | - Invoke the ui-copy skill before writing any string a person will read. |
| 42 | - Never drive the user's screen, real data, clipboard or installed app. |
| 43 | - <project rules: build dir, scratch cleanup, forbidden actions> |
| 44 | |
| 45 | ## Verify |
| 46 | <driver command with PORT=<unique>>. Check light and dark, at <widths>, in |
| 47 | <states>, from <every entry point>. Per item, an acceptance probe that counts |
| 48 | effects: <e.g. "one click sends exactly one request", "focus survives a poll", |
| 49 | "actions re-enable after the stream dies">. Read every screenshot and iterate. |
| 50 | Then do a cleanup pass on your diff: no dead code, no unused CSS. |
| 51 | |
| 52 | ## Report (≤<N> lines, plus screenshot paths) |
| 53 | - Per item: done / skipped (why). |
| 54 | - <A small figure of the structure: menu items per network, flow, component API.> |
| 55 | - Taste calls: what you picked, and the alternative. |
| 56 | - 4–6 screenshot paths (light and dark, the key states). |
| 57 | - Anything you couldn't verify. |
| 58 | - Anything another agent must do, written as a message <owner> can forward. |
| 59 | ``` |