Skip to content

ericrisco/rsc-harness / skills/ux

Use when an app or SaaS must be easy to use: designing complete user flows, screens and every state, navigation, forms, onboarding, tables, dashboards, search or AI features, or auditing usability and accessibility. Anyone finishes the job without a manual; experts go fast. NOT the visual direction (design), NOT the words (landing-copy).

FileKindSize
SKILL.mdskill md9.3 KB
THIRD_PARTY.mdmarkdown1.6 KB
evals/cases.yamlconfig2.5 KB
references/flows.mdmarkdown7.3 KB
upstream/UPSTREAM.jsonconfig4.7 KB
upstream/ux-designer/GUIDE.mdmarkdown15.2 KB
upstream/ux-designer/LICENSEother1.0 KB
upstream/ux-designer/references/01-core-principles.mdmarkdown7.9 KB
upstream/ux-designer/references/02-laws-of-ux.mdmarkdown8.3 KB
upstream/ux-designer/references/03-accessibility.mdmarkdown10.7 KB
upstream/ux-designer/references/04-visual-design.mdmarkdown8.9 KB
upstream/ux-designer/references/05-information-architecture.mdmarkdown9.1 KB
upstream/ux-designer/references/06-interaction-design.mdmarkdown11.2 KB
upstream/ux-designer/references/07-forms-and-inputs.mdmarkdown11.4 KB
upstream/ux-designer/references/08-mobile-ux.mdmarkdown10.9 KB
upstream/ux-designer/references/09-ux-writing.mdmarkdown9.0 KB
upstream/ux-designer/references/10-user-research.mdmarkdown10.6 KB
upstream/ux-designer/references/11-design-systems.mdmarkdown13.2 KB
upstream/ux-designer/references/12a-presence-awareness.mdmarkdown10.2 KB
upstream/ux-designer/references/12b-conflict-resolution-sync.mdmarkdown15.8 KB
upstream/ux-designer/references/13a-canvas-navigation.mdmarkdown9.5 KB
upstream/ux-designer/references/13b-canvas-objects-performance.mdmarkdown14.2 KB
upstream/ux-designer/references/14-ai-ux-patterns.mdmarkdown20.9 KB
upstream/ux-designer/references/15-ethical-design.mdmarkdown13.9 KB
upstream/ux-designer/references/16-onboarding.mdmarkdown16.5 KB
upstream/ux-designer/references/17-notifications.mdmarkdown17.7 KB
upstream/ux-designer/references/18-data-visualization.mdmarkdown18.8 KB
upstream/ux-designer/references/19-search-ux.mdmarkdown19.0 KB
upstream/ux-designer/references/20-emotional-design.mdmarkdown14.5 KB
upstream/ux-designer/references/21-data-tables.mdmarkdown20.5 KB
upstream/ux-designer/references/22-performance-ux.mdmarkdown17.5 KB
upstream/ux-designer/references/23-internationalization.mdmarkdown15.4 KB
upstream/ux-designer/references/24-voice-and-multimodal.mdmarkdown15.9 KB
upstream/ux-designer/references/25a-barcode-camera-scanning.mdmarkdown21.3 KB
upstream/ux-designer/references/25b-barcode-scanner-workflows.mdmarkdown25.3 KB
upstream/ux-designer/references/25c-barcode-display.mdmarkdown17.3 KB
upstream/ux-usability-foundations/GUIDE.mdmarkdown16.0 KB
upstream/ux-usability-foundations/LICENSEother1.0 KB
upstream/ux-usability-foundations/references/anti-patterns.mdmarkdown8.3 KB
upstream/ux-usability-foundations/references/checklists.mdmarkdown6.2 KB
upstream/ux-usability-foundations/references/decision-prompts.mdmarkdown10.0 KB
upstream/ux-usability-foundations/references/principle-cards.mdmarkdown15.4 KB

upstream/ux-designer/references/05-information-architecture.md

View on GitHub
# Information Architecture

Information Architecture (IA) is the structural design of shared information environments—how content is organized, labeled, and navigated.

---

## Contents

- IA Fundamentals
- Organization Structures
- Navigation Patterns
- Labeling Best Practices
- Search Design
- IA Research Methods
- 2026 Trends
- IA Documentation
- Common IA Mistakes
- Sources

---

## IA Fundamentals

### What is Information Architecture?

IA is the blueprint of a digital product, defining:
- How content is organized and categorized
- How users navigate between sections
- How information is labeled and described
- How users find what they're looking for

### Core Components

1. **Organization Systems** - How content is grouped
2. **Labeling Systems** - How content is named
3. **Navigation Systems** - How users move through content
4. **Search Systems** - How users find specific content

---

## Organization Structures

### Hierarchical (Tree)
Most common structure. Content flows from broad to specific.

```
Home
├── Products
│   ├── Category A
│   │   ├── Product 1
│   │   └── Product 2
│   └── Category B
├── About
└── Contact
```

**Best for:** E-commerce, documentation, corporate sites

### Sequential (Linear)
Content follows a specific order.

```
Step 1 → Step 2 → Step 3 → Step 4 → Done
```

**Best for:** Onboarding flows, tutorials, checkout processes

### Matrix
Multiple navigation paths to the same content.

```
Products can be accessed by:
- Category
- Brand
- Price range
- New arrivals
```

**Best for:** E-commerce, catalogs, databases

### Network (Web)
No fixed hierarchy; content interconnects freely.

```
Page A ←→ Page B
   ↕        ↕
Page C ←→ Page D
```

**Best for:** Wikis, knowledge bases, blogs

---

## Navigation Patterns

### Global Navigation

Consistent navigation across all pages.

```
Horizontal Navigation Bar:
┌────────────────────────────────────────┐
│ Logo   Home   Products   About   Contact│
└────────────────────────────────────────┘

Best for:
- Sites with 5-7 top-level sections
- Desktop-first designs
- Corporate/marketing sites
```

### Local Navigation

Section-specific navigation.

```
Sidebar Navigation:
┌──────────┬─────────────────┐
│ Section  │                 │
│ ├─ Page 1│    Content      │
│ ├─ Page 2│                 │
│ └─ Page 3│                 │
└──────────┴─────────────────┘

Best for:
- Documentation sites
- Admin dashboards
- Settings panels
```

### Contextual Navigation

Related content links within the page.

```
"Related Articles"
"Customers Also Bought"
"See Also"
```

### Utility Navigation

Functional links (login, cart, search, settings).

```
┌─────────────────────────────────────────┐
│                    Search 🔍  Cart 🛒  👤│
└─────────────────────────────────────────┘
```

### Hamburger Menu

Hidden navigation behind an icon (☰).

```
Pros:
- Saves space
- Clean interface
- Mobile-friendly

Cons:
- Reduces discoverability
- Adds interaction step
- Less suitable for desktop
```

### Bottom Navigation (Mobile)

Tab bar at bottom of screen.

```
┌─────────────────────────────────────┐
│                                     │
│              Content                │
│                                     │
├─────────────────────────────────────┤
│  🏠    🔍    ➕    ❤️    👤        │
│ Home  Search Add  Saved  Profile   │
└─────────────────────────────────────┘

Best for:
- Mobile apps
- 3-5 primary destinations
- Frequent navigation actions
```

### Breadcrumbs

Show the user's location in the hierarchy.

```
Home > Products > Electronics > Phones > iPhone

Best for:
- Deep hierarchies
- E-commerce
- When users may enter via search
```

---

## Labeling Best Practices

### Clarity Over Cleverness
```
Good: "Pricing"
Bad: "Investment Levels"

Good: "Contact Us"
Bad: "Let's Chat"

Good: "Settings"
Bad: "Command Center"
```

### Consistency
```
Consistent verb forms:
- Create Project
- Edit Project
- Delete Project

Not:
- New Project
- Edit Project
- Remove
```

### User Language
- Use terms users understand
- Test labels with real users
- Avoid internal jargon
- Research common search terms

### Scannability
- Front-load important words
- Keep labels short (1-3 words)
- Use parallel structure
- Differentiate clearly

---

## Search Design

### Search Box Best Practices

```html
<!-- Prominent, always visible -->
<form role="search">
  <label for="search" class="sr-only">Search</label>
  <input
    type="search"
    id="search"
    placeholder="Search products..."
    aria-label="Search products"
  />
  <button type="submit">
    <span class="sr-only">Search</span>
    🔍
  </button>
</form>
```

**Guidelines:**
- Place in expected location (header, top-right)
- Make it large enough to see query
- Use placeholder text to indicate scope
- Support autocomplete/suggestions
- Show recent searches

### Search Results

```
Essential elements:
- Number of results
- Sorting options
- Filters/facets
- Clear result snippets
- Query highlighting
- Pagination or infinite scroll
- "No results" helpful message
```

### Zero Results Page
```
"No results for 'xyz'"
- Check spelling
- Try different keywords
- Browse categories
- Contact support
```

---

## IA Research Methods

### Card Sorting

Users organize content into groups that make sense to them.

**Open Card Sort:**
- Users create their own category names
- Reveals mental models
- Good for new products

**Closed Card Sort:**
- Users sort into predefined categories
- Tests existing structure
- Good for validation

**Tools:** OptimalSort, Maze, physical cards

### Tree Testing

Test if users can find items in your proposed structure.

```
Task: "Find the return policy"

Structure:
- Home
  - Shop
  - Account
  - Help Center ← Target
    - Shipping
    - Returns ← Success
    - Contact
```

**Metrics:**
- Success rate
- Directness (first click correct)
- Time to complete

**Tools:** Treejack, UserZoom

### First-Click Testing

Measure where users first click to complete a task.

**Insight:** If the first click is wrong, only 46% eventually succeed.

---

## 2026 Trends

### AI-Powered IA
- Dynamic categorization based on user behavior
- Personalized navigation paths
- Predictive search and recommendations
- Auto-tagging and organization

### Voice and Conversational IA
- Structure content for voice interfaces
- Natural language navigation
- Question-based organization
- Conversational menus

### Zero UI
- Interfaces that anticipate needs
- Reduce navigation through prediction
- Ambient computing integration
- Context-aware content delivery

---

## IA Documentation

### Sitemap

Visual representation of page hierarchy.

```
Homepage
├── Products
│   ├── Category A
│   ├── Category B
│   └── All Products
├── About
│   ├── Our Story
│   ├── Team
│   └── Careers
├── Blog
│   ├── Article List
│   └── Single Article
└── Contact
```

**Tools:** Figma, XMind, Lucidchart, Slickplan

### Content Inventory

Spreadsheet of all existing content.

| URL | Title | Type | Owner | Last Updated | Action |
|-----|-------|------|-------|--------------|--------|
| /about | About Us | Page | Marketing | 2024-06 | Keep |
| /old-promo | Summer Sale | Landing | Marketing | 2023-08 | Delete |

### User Flow Diagrams

Map the paths users take through your product.

```
Entry → Landing Page → Product List → Product Detail
                ↓                         ↓
            Search          →      Add to Cart → Checkout → Success
                                       ↓
                                   Continue Shopping
```

---

## Common IA Mistakes

1. **Organizing by org structure** - Users don't know your departments
2. **Too deep** - More than 3-4 levels becomes unwieldy
3. **Too wide** - Too many top-level options overwhelms
4. **Duplicate content** - Same info in multiple places
5. **Vague labels** - "Resources," "Solutions," "Services"
6. **No search** - Users often prefer search
7. **Breaking conventions** - Cart not in top-right
8. **Mobile afterthought** - IA must work for all devices

---

## Sources

- Rosenfeld, L., Morville, P., & Arango, J. (2015). "Information Architecture: For the Web and Beyond"
- [Nielsen Norman Group - IA](https://www.nngroup.com/topic/information-architecture/)
- [Interaction Design Foundation - IA](https://www.interaction-design.org/literature/topics/information-architecture)
- [A List Apart - IA](https://alistapart.com/)
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall