π The Full Schemata of UI/UX Design
SkillDocs & knowledgeComplete UI/UX design capability β a wiki-style knowledge map of design theory (UX laws, Nielsen heuristics, usability, visual hierarchy, typography, contrast/WCAG, design systems, aesthetics-vs-conversion) fused with a hands-on execution playbook for building distinctive, production-grade frontend interfaces. Use when designing or building any UI (websites, landing pages, dashboards, components, apps), reviewing or critiquing UI/UX, diagnosing why a design doesn't convert, or styling/beautifying web interfaces. Grounds every visual decision in UX principles and avoids generic AI aesthetics.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the π The Full Schemata of UI/UX Design skill
What this skill tells your AI
The instructions your AI receives, as published by syahiidkamil/software-engineer-ai-agent-atlas in .claude/skills/super-ui-ux-design/SKILL.md and read by ahelβs review.
A wiki-style knowledge map. Each section is a node. Follow the links, build the schema in your head, then go break it against real users.
Format notes: Internal links like Visual Hierarchy jump between nodes. Mermaid blocks render in Obsidian, GitHub, Notion, and most modern markdown viewers.
πΊοΈ The Master Map
Start here. Everything below hangs off this tree.
mindmap
root((DESIGN))
Problem Solving
Define the problem
Constraints
Trade-offs
Iteration
UX["UX (Experience)"]
Research
Information Architecture
Interaction Design
Usability
Mental Models
UX Laws & Heuristics
UI["UI (Interface)"]
Visual Hierarchy
Layout & Grids
Typography
Color & Contrast
Components
Design Systems
Tokens
Components
Patterns
Documentation
Business Layer
Conversion
Retention
Trust & Credibility
Aesthetics vs Performance
Learning Layer
Constructivism
Schemata
Mental Models
Jakob's Law
π§© Node 0 β What Is Design?
Definition: Design is the intentional shaping of something (a product, a screen, a service, a process) to achieve a purpose under constraints.
The keyword is intentional. Decoration happens to look nice. Design exists to do something.
Herbert Simon, in The Sciences of the Artificial, framed it roughly as: anyone who devises a course of action to change an existing situation into a preferred one is designing. By that definition, a doctor writing a treatment plan is designing. So is an engineer, a teacher, and yes, the person arranging buttons on a checkout page.
So... is design about problem solving?
Yes, with one important nuance.
Design is problem solving, but it's a specific flavor of it. Most design problems are what theorists call wicked problems (Rittel & Webber, 1973):
- There is no single correct answer, only better and worse ones
- The problem definition itself shifts as you work on it
- Every solution creates new constraints
- You can't fully test a solution without shipping it
This is why design is iterative by nature. You don't "solve" a checkout flow the way you solve a math equation. You propose, test, learn, and revise.
flowchart LR
A[Existing Situation] -->|"Understand the problem"| B[Problem Definition]
B -->|"Generate options"| C[Proposed Solution]
C -->|"Test with reality"| D{Did it work?}
D -->|"No / Partially"| B
D -->|"Yes"| E[Preferred Situation]
E -.->|"World changes, new problems"| A
β οΈ The nuance: "Design = problem solving" is true but incomplete. Design also involves problem finding (framing what's actually wrong) and meaning making (why should anyone care?). A perfectly solved wrong problem is still a failure.
See also: The Double Diamond, Wicked problems vs puzzles
π§ Node 1 β Constructivism & Schemata (Why This Document Is Shaped Like This)
You asked about Constructivism and schemata. Both matter twice here: once for how you learn design, and once for how your users experience your design.
Constructivism (the learning theory)
Definition: Knowledge isn't transferred into your head like a file copy. You construct it by connecting new information to what you already know. Key figures: Jean Piaget (cognitive constructivism), Lev Vygotsky (social constructivism).
Piaget's two core mechanisms:
| Mechanism | What happens | Design-learning example |
|---|---|---|
| Assimilation | New info fits into an existing schema | "Oh, a design token is just a variable. I know variables." |
| Accommodation | New info breaks the schema, forcing you to rebuild it | "Wait, beautiful design lowered conversion? My schema 'pretty = good' is wrong." |
Schemata (the mental structures)
Definition: A schema (plural: schemata) is an organized mental framework: a cluster of related concepts, expectations, and patterns. The term comes from Piaget and from Frederic Bartlett's memory research (1932).
A wiki is basically a schema made visible. Nodes, links, hierarchy. That's why this document is wiki-shaped: the format mirrors the cognitive structure you're trying to build.
The bridge to UX: users have schemata too
Here is the punchline. In UX, a user's schema is called a mental model, and it's one of the most powerful forces in interface design.
flowchart TD
A["Schema Theory<br/>(Piaget, Bartlett)"] --> B["Mental Models<br/>(how users THINK a system works)"]
B --> C["Jakob's Law<br/>'Users spend most of their time on OTHER sites'"]
C --> D["Design implication:<br/>Match conventions unless you have<br/>a very good reason not to"]
B --> E["Norman's Gulf of Execution<br/>(user can't figure out HOW to act)"]
B --> F["Norman's Gulf of Evaluation<br/>(user can't tell WHAT happened)"]
E --> G[Confusion, abandonment]
F --> G
When your interface matches the user's schema, it feels "intuitive." When it violates the schema, the user must accommodate (rebuild their mental model), and accommodation costs effort. Users mostly refuse to pay that cost. They just leave.
π‘ Rule of thumb: "Intuitive" is not a property of your design. It's a property of the match between your design and the user's existing schemata.
See also: UX Laws, Why ugly sites convert
π Node 2 β UI vs UX (They Are Not the Same Thing)
UX (User Experience): The entire journey: how someone discovers, learns, uses, struggles with, and feels about a product. UX includes things you never see on screen: loading speed, support emails, the pricing page, the cancellation flow.
UI (User Interface): The concrete surface a person touches: screens, buttons, typography, colors, spacing, motion.
A classic way to relate them:
flowchart TB
subgraph UX["UX β the whole experience"]
direction TB
R[Research & Strategy] --> IA[Information Architecture]
IA --> IXD[Interaction Design]
IXD --> UI_node
subgraph UI_node["UI β the visible surface"]
V[Visual Design]
T[Typography]
C[Color & Contrast]
CO[Components]
end
IXD --> U[Usability Testing]
U --> R
end
Common metaphor: UX is the architecture and structural engineering of a house; UI is the interior finishing. A gorgeous interior in a house with no plumbing is still a bad house. (And yes, the metaphor leaks: in practice UI decisions feed back into UX. The layers talk to each other.)
| UX | UI | |
|---|---|---|
| Core question | Does this solve the right problem, smoothly? | Is this clear, legible, and pleasant to operate? |
| Artifacts | Personas, journey maps, flows, wireframes, test reports | Mockups, design systems, components, prototypes |
| Measured by | Task success, time on task, retention, NPS, support tickets | Legibility, scannability, error rate per screen, accessibility |
| Fails like | "I don't understand what this app is for" | "I can't read this gray text on white" |
See also: Usability, Visual Hierarchy
ποΈ Node 3 β The Principles of UX
You asked directly: what is the principle of UX? There isn't one principle; there are a few canonical frameworks. Learn these three and you've covered most of the field's foundations.
3.1 Don Norman's design principles (The Design of Everyday Things)
- Visibility β Can the user see what actions are possible?
- Feedback β Does the system respond to every action, immediately and clearly?
- Affordances β Does the object's form suggest how to use it? (A handle affords pulling.)
- Signifiers β Explicit signals of where to act (a "Push" label, an underlined link)
- Mapping β Does the control's layout match its effect? (Stove knobs arranged like the burners.)
- Constraints β Does the design prevent wrong actions? (Grayed-out buttons, plugs that only fit one way.)
- Conceptual model β Does the user end up with an accurate schema of how the system works?
3.2 Nielsen's 10 Usability Heuristics (1994, still the industry standard)
- Visibility of system status
- Match between system and the real world
- User control and freedom (undo, escape hatches)
- Consistency and standards
- Error prevention
- Recognition rather than recall
- Flexibility and efficiency of use (shortcuts for experts)
- Aesthetic and minimalist design
- Help users recognize, diagnose, and recover from errors
- Help and documentation
π‘ Memorize #6. "Recognition rather than recall" explains half of all good UI decisions: show options instead of making users remember them. It's schema theory in action: recognition only requires activating an existing schema; recall requires reconstructing one.
3.3 The UX Hierarchy of Needs
Borrowed from Maslow. You cannot skip levels. Delight built on broken functionality is lipstick on a 404.
flowchart BT
A["1. FUNCTIONAL<br/>It works. No crashes, no dead ends."] --> B["2. RELIABLE<br/>It works consistently, every time."]
B --> C["3. USABLE<br/>It works without a manual."]
C --> D["4. CONVENIENT<br/>It fits into my life and habits."]
D --> E["5. PLEASURABLE<br/>It feels good. I'd recommend it."]
E --> F["6. MEANINGFUL<br/>It matters to my identity or values."]
See also: Usability, Aesthetics vs Conversion
βοΈ Node 4 β The Laws & Heuristics of UX
These are the empirical regularities of human-computer interaction. Treat them like physics for interfaces. (Reference: lawsofux.com)
| Law | Statement | Practical move |
|---|---|---|
| Jakob's Law | Users spend most of their time on other products, so they expect yours to work the same way | Follow conventions for nav, carts, forms. Innovate on value, not on where the logout button lives |
| Hick's Law | Decision time grows with the number and complexity of choices | Cut options. One primary CTA per screen. Progressive disclosure for the rest |
| Fitts's Law | Time to hit a target depends on its distance and size | Make tap targets big (44Γ44px+) and put frequent actions within thumb reach |
| Miller's Law | Working memory holds about 7Β±2 chunks | Chunk phone numbers, group form fields, break long flows into steps |
| Tesler's Law | Every system has irreducible complexity; someone must absorb it | Absorb complexity in the design, not in the user. Smart defaults > 12 settings |
| AestheticβUsability Effect | People perceive attractive designs as more usable, even when they aren't | Beauty buys forgiveness for small flaws. It also masks real flaws in testing. Double-edged πͺ |
| Von Restorff Effect | The item that differs from the rest gets remembered | Make the primary action visually distinct. Only one thing can be distinct |
| PeakβEnd Rule | Experiences are judged by their peak moment and their ending | Polish the success state and the offboarding, not just the funnel entrance |
| Doherty Threshold | Keep system response under ~400ms to hold attention | Performance IS UX. Use skeletons and optimistic UI when you can't be fast |
| Goal-Gradient Effect | Motivation increases as people near a goal | Show progress bars; pre-fill the first step ("2 of 5 complete") |
flowchart LR
subgraph Perception
VR[Von Restorff]
AU[Aesthetic-Usability]
end
subgraph Cognition
H[Hick's Law]
M[Miller's Law]
J[Jakob's Law]
end
subgraph Motor["Motor / Time"]
F[Fitts's Law]
D[Doherty Threshold]
end
subgraph Memory["Memory / Emotion"]
P[Peak-End Rule]
G[Goal-Gradient]
end
Perception --> X((User<br/>Behavior))
Cognition --> X
Motor --> X
Memory --> X
π§ͺ Node 5 β Usability
Definition (ISO 9241-11): The extent to which a product can be used by specified users to achieve specified goals with effectiveness, efficiency, and satisfaction in a specified context of use.
Break that down:
- Effectiveness β Can they complete the task at all? (Task success rate)
- Efficiency β How much time/effort does it take? (Time on task, clicks, errors)
- Satisfaction β How do they feel about it? (SUS score, ratings, retention)
Nielsen adds two more attributes worth tracking: learnability (how fast can a first-timer get it?) and memorability (after a month away, do they still remember how?).
Morville's UX Honeycomb
A checklist for whether an experience is actually complete:
Useful Β· Usable Β· Desirable Β· Findable Β· Accessible Β· Credible Β· Valuable
Notice that desirable (aesthetics) is one cell out of seven. This becomes important in Node 8.
How you actually test usability
- Define tasks β real goals, not feature tours ("buy a blue shirt under $30," not "explore our filters")
- 5 users β Nielsen's research: ~5 users uncover the majority of usability problems; iterate and test again rather than testing 20 at once
- Think-aloud protocol β users narrate while doing; you shut up and watch
- Measure β success rate, time, errors, where they hesitated
- Fix, retest β usability is a loop, not a gate
flowchart LR
A[Define tasks] --> B[Recruit ~5 users]
B --> C[Observe & measure]
C --> D[Prioritize issues]
D --> E[Fix design]
E --> A
See also: Nielsen's Heuristics, The Design Process
π¨ Node 6 β The UI Layer: Hierarchy, Layout, Contrast
You named these specifically, so here's each one as its own sub-node.
6.1 Visual Hierarchy
Definition: The deliberate ordering of elements so the eye lands on things in the sequence you intend.
Hierarchy is built from a small set of levers:
| Lever | How it signals importance |
|---|---|
| Size | Bigger = more important. The H1 should be unmistakable |
| Weight | Bold pulls the eye before regular text does |
| Color & contrast | High-contrast elements come forward; muted ones recede |
| Position | Top-left start (in LTR languages); F-pattern and Z-pattern scanning |
| Whitespace | Isolation = emphasis. Space around an element is a spotlight |
| Imagery | Faces and photos beat text for first attention. Eye-gaze in photos steers attention |
π§ͺ The squint test: Blur your eyes at the screen. Whatever still stands out is your real hierarchy. If everything stands out, nothing does. If the decorative blob outshines your CTA, you've found a conversion leak.
6.2 Layout & Grids
- Grid systems β 12-column grids dominate web layout because 12 divides cleanly by 2, 3, 4, and 6
- Spacing scale β Use a consistent scale (4pt or 8pt system). Random spacing reads as sloppy even when users can't say why
- Alignment β Every element should align with something. Strong edges create invisible structure
- Proximity (Gestalt) β Things near each other are perceived as related. Group label with its field, price with its product
- Reading patterns β F-pattern for text-heavy pages, Z-pattern for sparse landing pages. Put critical content on the path, not off it
Gestalt principles (the perception engine under all layout)
Proximity Β· Similarity Β· Continuity Β· Closure Β· Figure/Ground Β· Common Region Β· Common Fate
These are pre-attentive: the user's brain applies them before conscious thought. You don't get to opt out, so use them on purpose.
6.3 Contrast Ratio (Accessibility, WCAG)
Definition: The luminance ratio between foreground and background, from 1:1 (invisible) to 21:1 (black on white).
The WCAG 2.x standards you should know cold:
| Content | AA (the practical legal/industry bar) | AAA (stricter) |
|---|---|---|
| Normal body text | 4.5:1 | 7:1 |
| Large text (β₯24px, or β₯18.66px bold) | 3:1 | 4.5:1 |
| UI components & meaningful graphics (icons, input borders, focus rings) | 3:1 | β |
Why care beyond compliance:
- Roughly 1 in 12 men has some form of color vision deficiency
- Everyone becomes "low vision" in sunlight on a phone screen
- Low-contrast gray-on-gray text (a persistent trend) measurably hurts reading speed and comprehension, which hurts conversion
- Never encode meaning in color alone. Pair color with icons, labels, or patterns (error = red + icon + message)
Tools: WebAIM Contrast Checker, Stark, the contrast inspector built into Chrome DevTools.
6.4 Typography (the 90% of UI that is text)
- Limit to 1β2 typefaces; create variety with size and weight instead
- Body text: ~16px minimum on web; line height ~1.5; line length 45β75 characters
- Establish a type scale (e.g., 1.25 ratio: 16 β 20 β 25 β 31 β 39) and stick to it
- Real hierarchy in text = size + weight + color working together, not size alone
See also: Design Systems, Aesthetics vs Conversion
π§± Node 7 β Design Systems
Definition: A single source of truth that packages design decisions into reusable parts: tokens, components, patterns, and the documentation explaining when to use which.
flowchart TD
A["DESIGN TOKENS<br/>(atoms of decision)<br/>color.primary = #0F62FE<br/>space.md = 16px<br/>radius.sm = 4px"] --> B["COMPONENTS<br/>Button, Input, Card, Modal<br/>(built FROM tokens)"]
B --> C["PATTERNS<br/>Login flow, checkout, empty states,<br/>error handling<br/>(built FROM components)"]
C --> D["PRODUCTS<br/>Actual screens users touch"]
E["PRINCIPLES & DOCS<br/>voice, accessibility rules,<br/>do's and don'ts"] -.governs.-> A
E -.governs.-> B
E -.governs.-> C
Why design systems exist (the actual business case)
- Consistency = learnability. One button style means users build the schema once and reuse it everywhere. (Constructivism again: consistency enables assimilation; inconsistency forces costly accommodation on every screen.)
- Speed. Teams stop redesigning the dropdown for the fifth time
- Quality floor. Accessibility and contrast get solved once, inside the component, instead of re-litigated per page
- Coherent brand at scale, across teams who never meet
What "design system choices" actually means in practice
- Adopt, adapt, or build? Adopt an existing system (Material, Carbon, Polaris, shadcn/ui) when speed matters; build your own when differentiation and scale justify the cost
- Token architecture β semantic tokens (
color.text.danger) over raw values (red-500) so themes and dark mode don't require rewrites - Component API design β which variants exist (
primary/secondary/ghost), which are forbidden - Governance β who can add a component? Without governance, a design system becomes a junk drawer in about six months
Famous public systems worth studying: Material Design (Google), Human Interface Guidelines (Apple), Carbon (IBM), Polaris (Shopify), Atlassian Design System.
See also: Typography, Nielsen heuristic #4: Consistency
π° Node 8 β Aesthetics vs Conversion: The Paradox
This is the contradiction you noticed, and it's real. Beautiful designs sometimes convert worse. Ugly designs sometimes convert and retain brilliantly. Craigslist, Hacker News, Wikipedia, and Berkshire Hathaway's website are all famously plain and famously sticky. Plenty of award-winning redesigns have tanked revenue.
The paradox dissolves once you separate what aesthetics actually does from what conversion actually requires.
Why a beautiful design can fail to convert
| Failure mode | What's happening |
|---|---|
| Beauty without clarity | The visitor can't answer "what is this and why should I care?" in ~5 seconds. Gorgeous hero image, vague headline, dead funnel |
| Misdirected hierarchy | The most visually dominant element is decorative, so attention never reaches the CTA. Failed squint test |
| Aesthetic-Usability Effect masking flaws | In testing, users rate pretty designs as usable while still failing tasks. Your test scores lied to you |
| Performance cost | Heavy animation, video backgrounds, custom fonts β slow load. Every second of delay costs conversions. Doherty Threshold violated |
| Schema violation | The "creative" navigation breaks Jakob's Law. Users must accommodate, and they won't |
| Form over friction | Minimalist aesthetics hid the trust signals, prices, or shipping info people needed to feel safe buying |
| Wrong audience | Designers design for designers. Dribbble taste β what a 52-year-old procurement manager finds credible |
Why a "non-aesthetic" design can convert and retain
- Speed β plain HTML loads instantly
- Information density matches intent β Craigslist users want listings, not whitespace. Amazon's cluttered UI is dense on purpose: density = scent of information for comparison shoppers
- Familiarity β years of unchanged UI means users' schemata fit perfectly. Zero relearning cost, ever. That's retention
- Function as trust β for utility products, "no marketing polish" itself signals honesty
- Nothing competes with the task β accidental perfect hierarchy: the content IS the page
The resolution
Aesthetics is a multiplier on a working system, not a substitute for one. Refer back to the UX Hierarchy of Needs: pleasurable sits on top of functional, reliable, usable, and convenient. And per the Honeycomb, desirable is one cell of seven.
Conversion specifically depends on, in rough order of leverage:
- Clarity β value proposition understood in seconds
- Relevance β message matches what the visitor came for (ad β landing page match)
- Friction β fewer fields, fewer steps, fewer decisions (Hick's Law)
- Anxiety β trust signals, security cues, reviews, transparent pricing
- Urgency/Motivation β honest scarcity, clear benefit
- Distraction β one page, one job; remove competing links
- Then aesthetics, which amplifies credibility and perceived quality of everything above
Diagnostic flowchart: "my design doesn't convert"
flowchart TD
A[Low conversion / retention] --> B{Can users state what the<br/>product does in 5 seconds?}
B -->|No| B1[CLARITY problem<br/>Rewrite the headline & hero.<br/>Aesthetics can't fix this]
B -->|Yes| C{Does the page load fast?<br/>under ~3s, ideally under 1s}
C -->|No| C1[PERFORMANCE problem<br/>Cut weight before adding beauty]
C -->|Yes| D{Squint test: is the CTA<br/>the most prominent element?}
D -->|No| D1[HIERARCHY problem<br/>Demote decoration, promote action]
D -->|Yes| E{Can users complete the<br/>core task in usability tests?}
E -->|No| E1[USABILITY problem<br/>Watch 5 users. Fix what they trip on]
E -->|Yes| F{Do they trust you?<br/>reviews, pricing, security, brand}
F -->|No| F1[CREDIBILITY problem<br/>Add proof, not polish]
F -->|Yes| G{Does the offer match<br/>what they actually want?}
G -->|No| G1[PRODUCT/MESSAGE FIT problem<br/>No design fixes a wrong offer]
G -->|Yes| H[NOW invest in aesthetics.<br/>It will multiply a working system]
Shortened here. Read the whole file on GitHub.
Signals
- GitHub stars
- 395
- Forks
- 61
- Last commit
- Jun 2026
Advanced
- Catalog kind
- skill
- Gateway key
super-ui-ux-design- Source
- github.com/syahiidkamil/software-engineer-ai-agent-atlas