Overview
Reasoning rules are the intelligence layer that sits on top of the BM25 search engine. They encode domain expertise about which design patterns, styles, and colors work best for specific industries and product types. Instead of just returning search results, the reasoning engine applies industry-specific rules to filter, prioritize, and combine results into a cohesive design system.The 100 Reasoning Rules
UI/UX Pro Max includes 100 reasoning rules covering major product categories across 7 industries:| Category | Examples | Rule Count |
|---|---|---|
| Tech & SaaS | SaaS, Micro SaaS, B2B Enterprise, Developer Tools, AI/Chatbot Platform | ~20 |
| Finance | Fintech, Banking, Crypto, Insurance, Trading Dashboard | ~12 |
| Healthcare | Medical Clinic, Pharmacy, Dental, Veterinary, Mental Health | ~10 |
| E-commerce | General, Luxury, Marketplace, Subscription Box | ~15 |
| Services | Beauty/Spa, Restaurant, Hotel, Legal, Consulting | ~18 |
| Creative | Portfolio, Agency, Photography, Gaming, Music Streaming | ~15 |
| Emerging Tech | Web3/NFT, Spatial Computing, Quantum Computing, Autonomous Systems | ~10 |
Rule Structure
Each reasoning rule is stored inui-reasoning.csv and contains these fields:
1. UI_Category
The product type or industry category this rule applies to. Examples:SaaS - GeneralE-Commerce - LuxuryHealthcare - Medical ClinicBeauty/SpaFintech - Banking
2. Recommended_Pattern
The landing page structure that works best for this industry. Examples:Hero-Centric + Social Proof(Beauty/Spa)Feature-Rich Showcase(SaaS)Trust & Authority(Banking)Conversion-Optimized(E-commerce)
design_system.py:src/ui-ux-pro-max/scripts/design_system.py:112:
3. Style_Priority
A ranked list of UI styles that work best for this industry, separated by+.
Examples:
Soft UI Evolution + Minimalism(Beauty/Spa)Glassmorphism + Dark Mode(Fintech)Brutalism + Retro-Futurism(Gaming)Minimalism + Swiss Style(SaaS)
4. Color_Mood
Describes the color palette characteristics appropriate for this industry. Examples:Calming, soft pastels(Beauty/Spa)Professional, trustworthy blues(Banking)Bold, vibrant, high contrast(Gaming)Neutral with premium accents(Luxury E-commerce)
5. Typography_Mood
Describes the font personality that matches the brand. Examples:Elegant, calming, sophisticated(Beauty/Spa)Clean, modern, trustworthy(Banking)Bold, expressive, futuristic(Gaming)Professional, readable(SaaS)
6. Key_Effects
Recommended animations and interactions. Examples:Soft shadows + Smooth transitions (200-300ms) + Gentle hover states(Beauty/Spa)Minimal motion + Subtle hover states(Banking)Dynamic animations + Particle effects + Bold transitions(Gaming)
7. Anti_Patterns
Critical mistakes to avoid for this industry, separated by+.
Examples:
Bright neon colors + Harsh animations + Dark mode(Beauty/Spa)AI purple/pink gradients + Playful animations(Banking)Slow animations + Muted colors(Gaming)
Anti-patterns are just as important as recommendations. They prevent common mistakes that reduce trust or user engagement.
8. Decision_Rules (JSON)
Optional conditional logic for complex decision-making. Example:design_system.py:src/ui-ux-pro-max/scripts/design_system.py:105:
9. Severity
How critical it is to follow this rule.- CRITICAL: Must follow (e.g., accessibility rules, banking trust patterns)
- HIGH: Strongly recommended (e.g., e-commerce conversion optimization)
- MEDIUM: Best practice (e.g., style preferences)
- LOW: Nice to have (e.g., animation polish)
How Reasoning Rules Work
The reasoning engine applies rules in a multi-step process:Step 1: Match Product Category
Fromdesign_system.py:src/ui-ux-pro-max/scripts/design_system.py:64:
- Exact match: “Beauty/Spa” matches “Beauty/Spa” rule
- Partial match: “Beauty service” matches “Beauty/Spa” rule
- Keyword match: “spa wellness” matches “Beauty/Spa” rule
Step 2: Extract Style Priority
Fromdesign_system.py:src/ui-ux-pro-max/scripts/design_system.py:173:
["Soft UI Evolution", "Minimalism"]) is used to boost matching styles during search.
Step 3: Multi-Domain Search with Priority
Fromdesign_system.py:src/ui-ux-pro-max/scripts/design_system.py:51:
style domain, the query is augmented with the top 2 style priority keywords.
Example:
- Original query:
"beauty spa wellness" - Style priority:
["Soft UI Evolution", "Minimalism"] - Augmented query:
"beauty spa wellness Soft UI Evolution Minimalism"
Step 4: Select Best Match
Fromdesign_system.py:src/ui-ux-pro-max/scripts/design_system.py:122:
- Exact style name match (score: return immediately)
- Style name contains keyword (score: +10)
- Keywords field contains keyword (score: +3)
- Any field contains keyword (score: +1)
Example Reasoning Flow
Let’s walk through a complete example:Input
Step 1: Product Search
Searchproducts.csv for “beauty spa wellness service”
Result: Beauty/Spa category
Step 2: Load Reasoning Rule
Find rule forBeauty/Spa in ui-reasoning.csv
Rule:
- Recommended Pattern: Hero-Centric + Social Proof
- Style Priority: Soft UI Evolution + Minimalism
- Color Mood: Calming, soft pastels
- Typography Mood: Elegant, calming, sophisticated
- Key Effects: Soft shadows + Smooth transitions (200-300ms) + Gentle hover states
- Anti-Patterns: Bright neon colors + Harsh animations + Dark mode
Step 3: Augmented Style Search
Original query:"beauty spa wellness service"
Augmented query: "beauty spa wellness service Soft UI Evolution Minimalism"
Search styles.csv with augmented query
Top 3 Results:
- Soft UI Evolution (score: 8.2) ✅ Priority match
- Minimalism (score: 7.8) ✅ Priority match
- Glassmorphism (score: 5.1)
Step 4: Select Best Match
Apply priority scoring:- “Soft UI Evolution” has exact match with priority[0] → Selected
Step 5: Other Domain Searches
Run searches for color, typography, landing:- Color: Search for “beauty spa” in
colors.csv→ Soft Pink + Sage Green palette - Typography: Search for “elegant calming” in
typography.csv→ Cormorant Garamond / Montserrat - Landing: Search for “hero social proof” in
landing.csv→ Hero-Centric pattern
Step 6: Combine into Design System
The final output combines all domains + reasoning:Fallback Strategy
If no reasoning rule matches the product category, the engine uses a safe default: Fromdesign_system.py:src/ui-ux-pro-max/scripts/design_system.py:91:
Industry Examples
Banking/Fintech
Rule:- Pattern: Trust & Authority
- Style Priority: Minimalism + Swiss Style + Glassmorphism
- Color Mood: Professional blues, trustworthy
- Typography Mood: Clean, modern, readable
- Key Effects: Minimal motion, subtle hover states
- Anti-Patterns: AI purple/pink gradients + Playful animations + Emojis
Gaming/Esports
Rule:- Pattern: Interactive Product Demo
- Style Priority: Cyberpunk UI + Retro-Futurism + Vibrant Block-based
- Color Mood: Bold, vibrant, high contrast, neon accents
- Typography Mood: Bold, expressive, futuristic
- Key Effects: Dynamic animations + Particle effects + Bold transitions
- Anti-Patterns: Slow animations + Muted colors + Minimal UI
Healthcare
Rule:- Pattern: Trust & Authority + Accessible Design
- Style Priority: Accessible & Ethical + Minimalism + Soft UI
- Color Mood: Calming, professional, accessible
- Typography Mood: Readable, trustworthy, clear
- Key Effects: Minimal animations, smooth transitions
- Anti-Patterns: Low contrast + Complex animations + Dense layouts
Luxury E-commerce
Rule:- Pattern: Hero-Centric + Storytelling
- Style Priority: Exaggerated Minimalism + Swiss Modernism 2.0 + Liquid Glass
- Color Mood: Neutral with premium accents (gold, silver)
- Typography Mood: Elegant, sophisticated, editorial
- Key Effects: Smooth parallax + Cinematic transitions + Subtle reveals
- Anti-Patterns: Bright colors + Playful elements + Dense layouts
Rule Severity Levels
From the README:| Severity | Meaning | Example |
|---|---|---|
| CRITICAL | Must follow or risk user harm/legal issues | Accessibility rules, banking security patterns |
| HIGH | Strongly recommended for user success | E-commerce conversion optimization, trust patterns |
| MEDIUM | Best practice for quality | Style preferences, animation polish |
| LOW | Nice to have | Advanced micro-interactions |
The severity field is returned in the design system output but not currently used for filtering. It’s available for future enhancements (e.g., “show only CRITICAL rules”).
Adding Custom Rules
To add your own reasoning rules:- Open
src/ui-ux-pro-max/data/ui-reasoning.csv - Add a new row with all required fields
- Test with:
See Also
- Design System Generation - How reasoning rules fit into the overall generation process
- Search Engine - The BM25 algorithm that powers search
- Skill vs Workflow - When reasoning rules are automatically applied