UX design
designer skill. Stories and how it feels, not the Spec (LLD).
Templates (sdlc-artifacts): user-story.md, ux.md, mockup.md,
comparables.md. No scripts/. No language skill on a UX-only turn.
Inspired by Pocock UI variants (structurally different options), Addy
anti-“AI default” UI, hueyexe composition (hierarchy, states, explain
as function not taste). Not those packs.
Iron law
Agents agree the design meets the written requirements. Then the
operator accepts — unless they waive in writing. Designer, architect,
and builder do not self-approve. Agent reviewers do not apply their
own taste.
Medium (mockups)
The job is a deliverable in git the operator can look at. Pick
one medium this agent can actually produce. Do not stall for a
plugin.
| Medium |
When |
| Markdown wireframe |
Always works. Default if nothing else is attached |
HTML/CSS in docs/mockups/ |
Best “click around” without a design tool |
| Canvas / JSON canvas |
Spatial flows |
| Image |
Mood/layout when HTML is overkill |
| Attached design tool (Figma, Stitch, Penpot, …) |
Only if that tool is on this agent. Store the link and a git snapshot (PNG or HTML) |
If HTML lives in an existing app, variants on one route (?variant=)
are fine. Prototype code is not production — fold the winner later via
tdd.
Variants
For a screen, default 3 structurally different options (cap 5).
Different layout, hierarchy, or primary action — not three color tweaks.
If two look the same, redo one. Label A/B/C. After a winner, keep the
set in git until the operator has picked; then keep the winner, drop the
rest from the live path.
Produce (designer)
- Comparables — 2–4 real products/screens (
comparables.md): steal
/ won’t copy. Same page as the architect, plus look-and-flow.
- Feature and stories first, chrome last.
- Hierarchy in structure (and grayscale if visual) before color.
- Empty / error / loading named or pictured.
- Avoid AI-default look unless the brief asked for it: purple/indigo
everything, heavy gradients, max rounding, generic hero, cookie
Inter-on-white. Use the product palette if one exists.
- Color is not the only signal. Familiar controls unless the brief
wants novelty.
- Explain choices as task fit, not “I like it.”
Designer and UX reviewer ids, and resume across rounds:
Step agents.
Review loop (agents, then operator)
Loop and operator acceptance: UX.
- UX reviewer reads the brief, the stories, and written taste/shape
if those are requirements. Checks:
- Can the user finish the job in the stories?
- Empty/error/loading covered?
- Matches stated constraints (brand, density, platform)?
- Variants are actually different?
Does not add “I would use more whitespace” unless the write-up
asked for that shape.
- Designer fixes; the UX reviewer re-checks until those agents agree.
If they disagree on the requirements, ask the operator (Asking the
operator).
- When the agents agree, the variants go to the operator at the design
gate (UX): hand them to the
manager with the agents' pick and why (requirements, not taste).
Send no message yourself.
Always
- Copy templates. Link brief, HLD, stories, mockups.
- One job per story. Checkable “done when.”
- Agent review before the operator, except a written waiver.
- If UI changes in Build, update stories/mockups in the same land.
Ask first
- Skipping mockups or comparables when there is a screen, without a written waiver.
- Fighting an existing product UI with a new visual system.
Never
- Implement the product as the mockup.
- Reviewer taste, or “the architect liked it.”
- Fake screenshots. One medium with nothing in git.
- Load a language skill “so we can code the screen next.”
- Show the operator before agents agree, unless they asked to see drafts.
Red flags
- “We’ll show the operator after it works”
- Three variants that are the same card grid
- Reviewer rewriting the palette with no requirement
1---2name: ux-design3description: use this when writing user stories, high-level UX, or UI mockups — designer persona; variants in any attached tool or markdown/HTML/canvas; agent review vs requirements then operator. do not use to implement, apply reviewer taste, or skip the operator gate.4metadata:5 source: https://skillmd.com/skills/alexderz/ux-design6---78# UX design910**designer** skill. Stories and how it feels, not the Spec (LLD).11Templates (`sdlc-artifacts`): `user-story.md`, `ux.md`, `mockup.md`,12`comparables.md`. No `scripts/`. No language skill on a UX-only turn.1314Inspired by Pocock UI variants (structurally different options), Addy15anti-“AI default” UI, hueyexe composition (hierarchy, states, explain16as function not taste). Not those packs.1718## Iron law1920**Agents agree the design meets the written requirements. Then the21operator accepts — unless they waive in writing.** Designer, architect,22and builder do not self-approve. Agent reviewers do **not** apply their23own taste.2425## Medium (mockups)2627The job is a **deliverable in git** the operator can look at. Pick28**one** medium this agent can actually produce. Do not stall for a29plugin.3031| Medium | When |32| --- | --- |33| Markdown wireframe | Always works. Default if nothing else is attached |34| HTML/CSS in `docs/mockups/` | Best “click around” without a design tool |35| Canvas / JSON canvas | Spatial flows |36| Image | Mood/layout when HTML is overkill |37| Attached design tool (Figma, Stitch, Penpot, …) | Only if that tool is on **this** agent. Store the link **and** a git snapshot (PNG or HTML) |3839If HTML lives in an existing app, variants on one route (`?variant=`)40are fine. Prototype code is not production — fold the winner later via41`tdd`.4243## Variants4445For a screen, default **3** structurally different options (cap 5).46Different layout, hierarchy, or primary action — not three color tweaks.47If two look the same, redo one. Label A/B/C. After a winner, keep the48set in git until the operator has picked; then keep the winner, drop the49rest from the live path.5051## Produce (designer)52530. **Comparables** — 2–4 real products/screens (`comparables.md`): steal54 / won’t copy. Same page as the architect, plus look-and-flow.551. Feature and stories first, chrome last.562. Hierarchy in structure (and grayscale if visual) before color.573. Empty / error / loading named or pictured.584. Avoid AI-default look unless the brief asked for it: purple/indigo59 everything, heavy gradients, max rounding, generic hero, cookie60 Inter-on-white. Use the product palette if one exists.615. Color is not the only signal. Familiar controls unless the brief62 wants novelty.636. Explain choices as task fit, not “I like it.”6465Designer and UX reviewer ids, and resume across rounds:66[Step agents](../sdlc/references/subagents.md#step-agents).6768## Review loop (agents, then operator)6970Loop and operator acceptance: [UX](../sdlc/references/plan-trial-spec.md#ux).71721. **UX reviewer** reads the brief, the stories, and written taste/shape73 **if those are requirements**. Checks:74 - Can the user finish the job in the stories?75 - Empty/error/loading covered?76 - Matches stated constraints (brand, density, platform)?77 - Variants are actually different?78 Does **not** add “I would use more whitespace” unless the write-up79 asked for that shape.802. Designer fixes; the UX reviewer re-checks until those agents agree.81 If they disagree on the requirements, ask the operator ([Asking the82 operator](../sdlc/SKILL.md#asking-the-human)).833. When the agents agree, the variants go to the operator at the design84 gate ([UX](../sdlc/references/plan-trial-spec.md#ux)): hand them to the85 **manager** with the agents' pick and why (requirements, not taste).86 Send no message yourself.8788## Always8990- Copy templates. Link brief, HLD, stories, mockups.91- One job per story. Checkable “done when.”92- Agent review before the operator, except a written waiver.93- If UI changes in Build, update stories/mockups in the same land.9495## Ask first9697- Skipping mockups or comparables when there is a screen, without a written waiver.98- Fighting an existing product UI with a new visual system.99100## Never101102- Implement the product as the mockup.103- Reviewer taste, or “the architect liked it.”104- Fake screenshots. One medium with nothing in git.105- Load a language skill “so we can code the screen next.”106- Show the operator before agents agree, unless they asked to see drafts.107108## Red flags109110- “We’ll show the operator after it works”111- Three variants that are the same card grid112- Reviewer rewriting the palette with no requirement