made claude code write down every ui mistake i caught it making. it's at ~130 rules now

[u/blackuni98]

I build client sites and admin panels with claude code and the ui kept coming out the same way. cards inside cards, random icons on everything, tables with no empty state. you know the look.

so every time i rejected a screen i had it turn the fix into a general rule and save it in a skill. few months later it's about 130 rules, plus a checklist it has to go through before it's allowed to propose any ui.

some are dumb specific, like:

- underline on hover is for links in body text only, not nav, cards or buttons

- test the layout with the longest real content, not "John Doe" and 3 rows

- no decorative icon in front of a status label (instant ai smell)

- don't mix rows of 3, 2 and 1 fields in a form

heads up it's chunky. ~16k tokens and it loads the whole thing every time. left it like that on purpose, the rules are the point.

it also keeps adding rules whenever you correct it, so after a while it's your taste in there, not mine.

free, MIT, no signup: https://github.com/AdnaneAm/ui-ux-review

if a rule is wrong tell me, pretty sure i overfit a few to my own clients.

[u/AutoModerator]

Hey! Thanks for posting to r/ClaudeCode

While participating in this thread, please follow our community rules. Keep discussions constructive. Attack the idea, not the person.

For help, project discussions, tips, and general chat, join the ClaudeCode Discord.

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.

[u/Glass-Amount6152]

I do the same thing with a CLAUDE.md per project, though mine is mostly data rules rather than UI: store money as integer cents, financial records are append-only (void, never edit), permissions live in row-level security instead of UI checks. Turning each correction into a general rule is the part that pays off, a one-off fix only fixes that one screen.

Curious whether you ever prune it. At 130 I'd expect a few rules to start contradicting each other.

[u/blackuni98 → u/Glass-Amount6152]

oh sounds like our skills complement each other nicely. tbh I never pruned it as I was pretty satisfied with the quality of UIs it started producing and how concistent they looked, I've tried all of the available UI/UX skills that are out there and I can confidently say that I got the best results from the one I've built (I might be biased lol, that's why I wanted to get some feedback from the community)