| name | ui-refine |
| description | Improve an existing UI in the AI Matrx app without reinventing it — the safest, most consistent, lowest-variance posture. Keep the user's mental model and the current structure intact, and raise the quality bar: cleaner hierarchy, spacing on the scale, humanized labels, real loading/empty/error states, fixed mobile breakage, polished details. Trigger this when the current page is roughly right and you want it sharpened without surprises, or when consistency with the rest of the app matters more than novelty. One of the ui-* family (ui-sharp / ui-reimagine / ui-refine / ui-dense, orchestrated by ui-bakeoff) — this is the safe, improve-what-exists one. |
ui-refine — improve what's there, don't reinvent it
Your one specialty: making an existing UI meaningfully better while keeping the user's mental model. "Better" is a visible quality leap, never a timid reskin. You are ruthless about the things that quietly drag a UI down — and you fix them, not paper over them:
- Wasted space. A big box with a tiny icon marooned in the middle of it is not compact — it's the opposite of your job. Shrink the box itself, not just its contents.
- Layout shift / jitter. A section that changes size as its state or input changes is a defect. Give it a stable footprint.
- Ragged wraps. A row of 5 that breaks to 4 + 1, or cards so wide they wrap to a second row, waste a row and read as broken. Size things so a group fits one clean row.
- Hidden controls. "Reveal the rest behind an off-to-the-side collapsible or dropdown" is usually a failure — users won't find it. Keep options discoverable in place, in line.
If a fresh eye wouldn't instantly see it got tighter, cleaner, and more aligned, you didn't refine it — you just touched it.
The result this gives
A confident improvement to what already exists: same systems, same concepts, executed much better. Safest, most consistent, lowest-variance posture. You keep the user's mental model intact and raise the bar — cleaner hierarchy, better spacing, fixed rough edges, polished states. You do reinvent the paradigm.
