PaPoo
cover

Claude Code Won’t Save Your UI Taste

What struck me most here is not the advice itself, but the premise that coding agents are somehow the main reason apps drift into a messy visual pile. I don’t buy that as a full explanation. Claude Code can absolutely accelerate inconsistency, but usually it’s exposing a design system problem that was already there: loose component boundaries, no shared tokens, and too much “just make this page look good” prompting. The model is doing what it can with the shape of the repo in front of it.

That said, the author is right about one uncomfortable thing: if you let an agent invent UI locally, it will. Not because it’s rebellious, just because local optima are easy. A button that looks fine on this screen, a dropdown that matches this card, a font size that feels right here. The result is the classic agent-owned UI sprawl. I’ve seen that pattern too, and it gets worse when the codebase doesn’t clearly scream “use these components, not your own.”

What I actually found useful in the piece is the emphasis on hard constraints, not vague style guidance. If you want Claude Code to behave, you need more than a note in a prompt. You need a shared component library or at least a very obvious UI folder, plus a repo-level convention that makes it awkward to drift. The article’s suggestion to update agent instructions and reviewer prompts is sensible. I’d go further and make the preferred path the easy path: tokens, primitives, and reusable components that are hard to bypass by accident.

I’m less convinced by the confidence around the refactor timeline. “A day or two” for centralizing a messy UI sounds optimistic unless the app is tiny or the design surface is shallow. Also, the idea that a separate review agent can reliably catch every missed button or font inconsistency feels a bit too neat. It might help, sure, but it’s still a probabilistic cleanup pass, not a guarantee. Human review is probably still doing the real work there.

The bigger lesson, I think, is that Claude Code doesn’t create design discipline for you. It amplifies whatever discipline already exists. If your repo has a strong design system, it can help enforce it. If not, it will happily make the chaos faster.


Reference: How to Build Consistent Designs with Claude Code | Towards Data Science

同じ著者の記事