Skip to content
UI/UX Design Principles for AI Agents
The Trove library

UI/UX Design Principles for AI Agents

Exact, checkable rules for AI agents building web and mobile interfaces.

Read a preview

You can read the contents and the first 2,000 characters.
Pro includes the whole book.

  • By Sahar Carmel
  • 20 chapters
  • Updated Nov 1, 2026
  • 286 readers

What’s inside

  • Visual Hierarchy & Layout
  • Typography System
  • Color System
  • Spacing & Depth
  • Component Patterns
  • Navigation & Information Architecture

What is UI/UX Design Principles for AI Agents?

Exact, checkable rules for AI agents building web and mobile interfaces. Twenty chapters and over 170 rules cover layout, typography, color, spacing, components, navigation, forms and accessibility. Each rule states when it applies, what to do, the exact values to use, and the mistake to avoid. It also lists the visual habits that make an interface look AI-generated, with a replacement for each, and closes with a skill for running an automated design review.

Read more

markdown · Listed Mar 7, 2026

  • ui
  • ux
  • books-for-agents
  • best-practices

From the first page

This is a reference manual for AI agents building web and mobile user interfaces. Every chapter is a self-contained module of concrete, actionable rules — read any chapter independently without needing context from others.

A systematic collection of UI/UX design rules with specific thresholds, values, and anti-patterns. This is not a design philosophy book. It is an instruction set. Each rule tells you exactly what to do, when to do it, and what to avoid.

The rules are derived from established design systems, accessibility standards, and production-tested patterns. They prioritize correctness and usability over novelty.

A second layer of rules comes from the Impeccable design skill (impeccable.style). That layer targets the tells of AI-generated interfaces: the fonts, palettes, card grids, glow effects, easing curves, and copy habits that models reach for by default. Those rules tell you which defaults to refuse, and what to decide instead. They appear throughout the chapters, in the AI-Generated Interface Tells section of Chapter 15, and in Chapters 16 through 19.

Each chapter is independent. You do not need to read chapters in order. Jump to the chapter that matches your current task. If a concept from another chapter is relevant, it is briefly restated in context — no cross-referencing required.

Preview · 2,000 of 544,795 characters

Web Application Security for AI Agents
Code Review for AI Agents
Vercel Frontend Engineering Guidelines
Distributed Task Reliability for AI Agents: Idempotency, Retries & Queues

Contents

  1. 01How to Use This Bookp.1
    1. What This Book Isp.1
    2. How to Use Itp.1
    3. Conventionsp.1
    4. Quick Lookupp.1
    5. Key Principlep.1
  2. 02Quick Reference — Decision Matrixp.2
    1. Master Decision Matrixp.2
    2. Measurement Referencep.2
    3. Decision Treesp.2
    4. Platform Quick Referencep.2
  3. 03Visual Hierarchy & Layoutp.3
    1. Quick Referencep.3
    2. Importance Assignmentp.3
    3. Weight and Contrastp.3
    4. Attention and Scan Patternsp.3
    5. Alignment and Visual Weightp.3
    6. Interaction Placementp.3
    7. Button and Action Hierarchyp.3
    8. Spacing and Layoutp.3
    9. +2 more sections
  4. 04Typography Systemp.4
    1. Quick Referencep.4
    2. Type Scalep.4
    3. Font Selectionp.4
    4. Readabilityp.4
    5. Text Stylingp.4
    6. Platform Notesp.4
    7. Checklistp.4
  5. 05Color Systemp.5
    1. Quick Referencep.5
    2. Color Modelp.5
    3. Palette Structurep.5
    4. Shade Generationp.5
    5. Greysp.5
    6. Contrast and Accessibilityp.5
    7. Color Dosage and Restraintp.5
    8. Emotional Colorp.5
    9. +3 more sections
  6. 06Spacing & Depthp.6
    1. Quick Referencep.6
    2. Shadows and Elevationp.6
    3. Depth Without Shadowsp.6
    4. Borders and Separationp.6
    5. Flow Spacingp.6
    6. Backgrounds and Decorationp.6
    7. Platform Notesp.6
    8. Checklistp.6
  7. 07Component Patternsp.7
    1. Quick Referencep.7
    2. Design System Foundationsp.7
    3. Affordances and Interaction Idiomsp.7
    4. Product Personalityp.7
    5. Buttonsp.7
    6. Form Inputsp.7
    7. Cardsp.7
    8. Navigationp.7
    9. +8 more sections
  8. 08Navigation & Information Architecturep.8
    1. Self-Evident Pagesp.8
    2. Visual Hierarchy & Content Structurep.8
    3. Information Organizationp.8
    4. User Behavior Patternsp.8
    5. Persistent Navigationp.8
    6. Home Page & Searchp.8
    7. Usability Mindsetp.8
    8. Platform Notesp.8
    9. +1 more section
See all 20 parts
  1. 09Cognitive Load & Attentionp.9
    1. Working Memory & Chunkingp.9
    2. Decision Speedp.9
    3. System Responsivenessp.9
    4. Attention Managementp.9
    5. Memory & Completion Effectsp.9
    6. Complexity & Mental Modelsp.9
    7. Checklistp.9
  2. 10Behavioral Triggers & Engagementp.10
    1. Microinteraction Architecturep.10
    2. Feedback Designp.10
    3. Long Loops & Modesp.10
    4. The Hook Modelp.10
    5. Fogg Behavior Modelp.10
    6. Cognitive Heuristics in UIp.10
    7. Variable Rewardsp.10
    8. Investment Phasep.10
    9. +3 more sections
  3. 11Persuasion & Trust Patternsp.11
    1. Reciprocityp.11
    2. Commitment & Consistencyp.11
    3. Social Proofp.11
    4. Likingp.11
    5. Authorityp.11
    6. Scarcityp.11
    7. Priming & Perceptionp.11
    8. Persuasion & Trust Designp.11
    9. +2 more sections
  4. 12Form Design & User Inputp.12
    1. Target Sizingp.12
    2. Form Layoutp.12
    3. Error Prevention & Constraintsp.12
    4. Validation & Errorsp.12
    5. Input Optimizationp.12
    6. Checklistp.12
  5. 13Responsive & Adaptive Designp.13
    1. Mobile-First Approachp.13
    2. Sizing & Typographyp.13
    3. Touch & Interactionp.13
    4. Navigation Patternsp.13
    5. Posture-Based Designp.13
    6. Images & Mediap.13
    7. Platform Differencesp.13
    8. Checklistp.13
  6. 14Accessibility Checklistp.14
    1. Document Setupp.14
    2. Color & Contrastp.14
    3. Keyboard Navigationp.14
    4. Screen Reader Supportp.14
    5. Heading Hierarchyp.14
    6. Motion & Animationp.14
    7. Text & Zoomp.14
    8. Video & Media Accessibilityp.14
    9. +3 more sections
  7. 15Anti-Pattern Catalogp.15
    1. Visual Design Anti-Patternsp.15
    2. Typography Anti-Patternsp.15
    3. Color Anti-Patternsp.15
    4. Layout & Spacing Anti-Patternsp.15
    5. Navigation & IA Anti-Patternsp.15
    6. Behavioral Design Anti-Patternsp.15
    7. Form Design Anti-Patternsp.15
    8. Interaction Design Anti-Patternsp.15
    9. +4 more sections
  8. 16Design Direction & Visitor Modesp.16
    1. Quick Referencep.16
    2. The Four Visitor Modesp.16
    3. The Brief and the Incumbentp.16
    4. Committing to a Directionp.16
    5. Color Strategy Registersp.16
    6. The Quality Floorp.16
    7. Operate and Read Depthp.16
    8. Turning the Register Up or Downp.16
    9. +2 more sections
  9. 17Critique & Audit Methodp.17
    1. Quick Referencep.17
    2. Nielsen's Ten Heuristicsp.17
    3. Scoring and Severityp.17
    4. Persona Walkthroughp.17
    5. Cognitive Load Auditp.17
    6. Design Specificity Verdictp.17
    7. Technical Audit Dimensionsp.17
    8. Finding Formatp.17
    9. +1 more section
  10. 18Hardening, Performance & Copy Clarityp.18
    1. Quick Referencep.18
    2. Input and Gesture Hardeningp.18
    3. Internationalizationp.18
    4. Network and Error Statesp.18
    5. Resource Hygienep.18
    6. Core Web Vitals and Rendering Budgetp.18
    7. Advanced Rendering Techniquesp.18
    8. UX Copy Clarityp.18
    9. +2 more sections
  11. 19Native Platform Conventions (iOS & Android)p.19
    1. Quick Referencep.19
    2. Idiom Translation Tablep.19
    3. iOS Conventionsp.19
    4. Android Conventionsp.19
    5. Native Auditp.19
    6. Web Adaptation Techniques the Base Chapters Missp.19
    7. Checklistp.19
  12. 20Putting This Book to Work — An Automated UI/UX Review Skillp.20
    1. 20.1 The Idea: Design Review That Runs Itselfp.20
    2. 20.2 The Reviewer Agent — How It Reads This Bookp.20
    3. 20.3 The Trigger — When This Reviewer Runsp.20
    4. 20.4 The Skill That Drives It — An Automated PR Pipelinep.20
    5. 20.5 Operating Rulesp.20