@ericrisco/rsc 3.3.1 → 3.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/manifest.json +43 -22
- package/package.json +1 -1
- package/scripts/lib/default-skill-floor.js +5 -1
- package/scripts/lib/domains.js +2 -2
- package/scripts/lib/retired-skills.js +4 -0
- package/skills/design/SKILL.md +4 -3
- package/skills/design/evals/cases.yaml +2 -2
- package/skills/react/SKILL.md +2 -1
- package/skills/ux/SKILL.md +149 -0
- package/skills/ux/THIRD_PARTY.md +32 -0
- package/skills/ux/evals/cases.yaml +40 -0
- package/skills/ux/references/flows.md +124 -0
- package/skills/ux/upstream/UPSTREAM.json +59 -0
- package/skills/ux/upstream/ux-designer/GUIDE.md +180 -0
- package/skills/ux/upstream/ux-designer/LICENSE +21 -0
- package/skills/ux/upstream/ux-designer/references/01-core-principles.md +251 -0
- package/skills/ux/upstream/ux-designer/references/02-laws-of-ux.md +330 -0
- package/skills/ux/upstream/ux-designer/references/03-accessibility.md +411 -0
- package/skills/ux/upstream/ux-designer/references/04-visual-design.md +433 -0
- package/skills/ux/upstream/ux-designer/references/05-information-architecture.md +432 -0
- package/skills/ux/upstream/ux-designer/references/06-interaction-design.md +495 -0
- package/skills/ux/upstream/ux-designer/references/07-forms-and-inputs.md +491 -0
- package/skills/ux/upstream/ux-designer/references/08-mobile-ux.md +539 -0
- package/skills/ux/upstream/ux-designer/references/09-ux-writing.md +493 -0
- package/skills/ux/upstream/ux-designer/references/10-user-research.md +533 -0
- package/skills/ux/upstream/ux-designer/references/11-design-systems.md +618 -0
- package/skills/ux/upstream/ux-designer/references/12a-presence-awareness.md +395 -0
- package/skills/ux/upstream/ux-designer/references/12b-conflict-resolution-sync.md +420 -0
- package/skills/ux/upstream/ux-designer/references/13a-canvas-navigation.md +388 -0
- package/skills/ux/upstream/ux-designer/references/13b-canvas-objects-performance.md +559 -0
- package/skills/ux/upstream/ux-designer/references/14-ai-ux-patterns.md +511 -0
- package/skills/ux/upstream/ux-designer/references/15-ethical-design.md +419 -0
- package/skills/ux/upstream/ux-designer/references/16-onboarding.md +430 -0
- package/skills/ux/upstream/ux-designer/references/17-notifications.md +461 -0
- package/skills/ux/upstream/ux-designer/references/18-data-visualization.md +453 -0
- package/skills/ux/upstream/ux-designer/references/19-search-ux.md +479 -0
- package/skills/ux/upstream/ux-designer/references/20-emotional-design.md +382 -0
- package/skills/ux/upstream/ux-designer/references/21-data-tables.md +629 -0
- package/skills/ux/upstream/ux-designer/references/22-performance-ux.md +626 -0
- package/skills/ux/upstream/ux-designer/references/23-internationalization.md +347 -0
- package/skills/ux/upstream/ux-designer/references/24-voice-and-multimodal.md +308 -0
- package/skills/ux/upstream/ux-designer/references/25a-barcode-camera-scanning.md +342 -0
- package/skills/ux/upstream/ux-designer/references/25b-barcode-scanner-workflows.md +412 -0
- package/skills/ux/upstream/ux-designer/references/25c-barcode-display.md +277 -0
- package/skills/ux/upstream/ux-usability-foundations/GUIDE.md +285 -0
- package/skills/ux/upstream/ux-usability-foundations/LICENSE +21 -0
- package/skills/ux/upstream/ux-usability-foundations/references/anti-patterns.md +267 -0
- package/skills/ux/upstream/ux-usability-foundations/references/checklists.md +130 -0
- package/skills/ux/upstream/ux-usability-foundations/references/decision-prompts.md +340 -0
- package/skills/ux/upstream/ux-usability-foundations/references/principle-cards.md +449 -0
- package/targets/clone-bootstrap.mjs +1 -1
- package/skills/ui-engineering/SKILL.md +0 -113
- package/skills/ui-engineering/evals/cases.yaml +0 -38
|
@@ -0,0 +1,432 @@
|
|
|
1
|
+
# Information Architecture
|
|
2
|
+
|
|
3
|
+
Information Architecture (IA) is the structural design of shared information environments—how content is organized, labeled, and navigated.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Contents
|
|
8
|
+
|
|
9
|
+
- IA Fundamentals
|
|
10
|
+
- Organization Structures
|
|
11
|
+
- Navigation Patterns
|
|
12
|
+
- Labeling Best Practices
|
|
13
|
+
- Search Design
|
|
14
|
+
- IA Research Methods
|
|
15
|
+
- 2026 Trends
|
|
16
|
+
- IA Documentation
|
|
17
|
+
- Common IA Mistakes
|
|
18
|
+
- Sources
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## IA Fundamentals
|
|
23
|
+
|
|
24
|
+
### What is Information Architecture?
|
|
25
|
+
|
|
26
|
+
IA is the blueprint of a digital product, defining:
|
|
27
|
+
- How content is organized and categorized
|
|
28
|
+
- How users navigate between sections
|
|
29
|
+
- How information is labeled and described
|
|
30
|
+
- How users find what they're looking for
|
|
31
|
+
|
|
32
|
+
### Core Components
|
|
33
|
+
|
|
34
|
+
1. **Organization Systems** - How content is grouped
|
|
35
|
+
2. **Labeling Systems** - How content is named
|
|
36
|
+
3. **Navigation Systems** - How users move through content
|
|
37
|
+
4. **Search Systems** - How users find specific content
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Organization Structures
|
|
42
|
+
|
|
43
|
+
### Hierarchical (Tree)
|
|
44
|
+
Most common structure. Content flows from broad to specific.
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
Home
|
|
48
|
+
├── Products
|
|
49
|
+
│ ├── Category A
|
|
50
|
+
│ │ ├── Product 1
|
|
51
|
+
│ │ └── Product 2
|
|
52
|
+
│ └── Category B
|
|
53
|
+
├── About
|
|
54
|
+
└── Contact
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
**Best for:** E-commerce, documentation, corporate sites
|
|
58
|
+
|
|
59
|
+
### Sequential (Linear)
|
|
60
|
+
Content follows a specific order.
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
Step 1 → Step 2 → Step 3 → Step 4 → Done
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
**Best for:** Onboarding flows, tutorials, checkout processes
|
|
67
|
+
|
|
68
|
+
### Matrix
|
|
69
|
+
Multiple navigation paths to the same content.
|
|
70
|
+
|
|
71
|
+
```
|
|
72
|
+
Products can be accessed by:
|
|
73
|
+
- Category
|
|
74
|
+
- Brand
|
|
75
|
+
- Price range
|
|
76
|
+
- New arrivals
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
**Best for:** E-commerce, catalogs, databases
|
|
80
|
+
|
|
81
|
+
### Network (Web)
|
|
82
|
+
No fixed hierarchy; content interconnects freely.
|
|
83
|
+
|
|
84
|
+
```
|
|
85
|
+
Page A ←→ Page B
|
|
86
|
+
↕ ↕
|
|
87
|
+
Page C ←→ Page D
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
**Best for:** Wikis, knowledge bases, blogs
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Navigation Patterns
|
|
95
|
+
|
|
96
|
+
### Global Navigation
|
|
97
|
+
|
|
98
|
+
Consistent navigation across all pages.
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
Horizontal Navigation Bar:
|
|
102
|
+
┌────────────────────────────────────────┐
|
|
103
|
+
│ Logo Home Products About Contact│
|
|
104
|
+
└────────────────────────────────────────┘
|
|
105
|
+
|
|
106
|
+
Best for:
|
|
107
|
+
- Sites with 5-7 top-level sections
|
|
108
|
+
- Desktop-first designs
|
|
109
|
+
- Corporate/marketing sites
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Local Navigation
|
|
113
|
+
|
|
114
|
+
Section-specific navigation.
|
|
115
|
+
|
|
116
|
+
```
|
|
117
|
+
Sidebar Navigation:
|
|
118
|
+
┌──────────┬─────────────────┐
|
|
119
|
+
│ Section │ │
|
|
120
|
+
│ ├─ Page 1│ Content │
|
|
121
|
+
│ ├─ Page 2│ │
|
|
122
|
+
│ └─ Page 3│ │
|
|
123
|
+
└──────────┴─────────────────┘
|
|
124
|
+
|
|
125
|
+
Best for:
|
|
126
|
+
- Documentation sites
|
|
127
|
+
- Admin dashboards
|
|
128
|
+
- Settings panels
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Contextual Navigation
|
|
132
|
+
|
|
133
|
+
Related content links within the page.
|
|
134
|
+
|
|
135
|
+
```
|
|
136
|
+
"Related Articles"
|
|
137
|
+
"Customers Also Bought"
|
|
138
|
+
"See Also"
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### Utility Navigation
|
|
142
|
+
|
|
143
|
+
Functional links (login, cart, search, settings).
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
┌─────────────────────────────────────────┐
|
|
147
|
+
│ Search 🔍 Cart 🛒 👤│
|
|
148
|
+
└─────────────────────────────────────────┘
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### Hamburger Menu
|
|
152
|
+
|
|
153
|
+
Hidden navigation behind an icon (☰).
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
Pros:
|
|
157
|
+
- Saves space
|
|
158
|
+
- Clean interface
|
|
159
|
+
- Mobile-friendly
|
|
160
|
+
|
|
161
|
+
Cons:
|
|
162
|
+
- Reduces discoverability
|
|
163
|
+
- Adds interaction step
|
|
164
|
+
- Less suitable for desktop
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
### Bottom Navigation (Mobile)
|
|
168
|
+
|
|
169
|
+
Tab bar at bottom of screen.
|
|
170
|
+
|
|
171
|
+
```
|
|
172
|
+
┌─────────────────────────────────────┐
|
|
173
|
+
│ │
|
|
174
|
+
│ Content │
|
|
175
|
+
│ │
|
|
176
|
+
├─────────────────────────────────────┤
|
|
177
|
+
│ 🏠 🔍 ➕ ❤️ 👤 │
|
|
178
|
+
│ Home Search Add Saved Profile │
|
|
179
|
+
└─────────────────────────────────────┘
|
|
180
|
+
|
|
181
|
+
Best for:
|
|
182
|
+
- Mobile apps
|
|
183
|
+
- 3-5 primary destinations
|
|
184
|
+
- Frequent navigation actions
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
### Breadcrumbs
|
|
188
|
+
|
|
189
|
+
Show the user's location in the hierarchy.
|
|
190
|
+
|
|
191
|
+
```
|
|
192
|
+
Home > Products > Electronics > Phones > iPhone
|
|
193
|
+
|
|
194
|
+
Best for:
|
|
195
|
+
- Deep hierarchies
|
|
196
|
+
- E-commerce
|
|
197
|
+
- When users may enter via search
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
---
|
|
201
|
+
|
|
202
|
+
## Labeling Best Practices
|
|
203
|
+
|
|
204
|
+
### Clarity Over Cleverness
|
|
205
|
+
```
|
|
206
|
+
Good: "Pricing"
|
|
207
|
+
Bad: "Investment Levels"
|
|
208
|
+
|
|
209
|
+
Good: "Contact Us"
|
|
210
|
+
Bad: "Let's Chat"
|
|
211
|
+
|
|
212
|
+
Good: "Settings"
|
|
213
|
+
Bad: "Command Center"
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
### Consistency
|
|
217
|
+
```
|
|
218
|
+
Consistent verb forms:
|
|
219
|
+
- Create Project
|
|
220
|
+
- Edit Project
|
|
221
|
+
- Delete Project
|
|
222
|
+
|
|
223
|
+
Not:
|
|
224
|
+
- New Project
|
|
225
|
+
- Edit Project
|
|
226
|
+
- Remove
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
### User Language
|
|
230
|
+
- Use terms users understand
|
|
231
|
+
- Test labels with real users
|
|
232
|
+
- Avoid internal jargon
|
|
233
|
+
- Research common search terms
|
|
234
|
+
|
|
235
|
+
### Scannability
|
|
236
|
+
- Front-load important words
|
|
237
|
+
- Keep labels short (1-3 words)
|
|
238
|
+
- Use parallel structure
|
|
239
|
+
- Differentiate clearly
|
|
240
|
+
|
|
241
|
+
---
|
|
242
|
+
|
|
243
|
+
## Search Design
|
|
244
|
+
|
|
245
|
+
### Search Box Best Practices
|
|
246
|
+
|
|
247
|
+
```html
|
|
248
|
+
<!-- Prominent, always visible -->
|
|
249
|
+
<form role="search">
|
|
250
|
+
<label for="search" class="sr-only">Search</label>
|
|
251
|
+
<input
|
|
252
|
+
type="search"
|
|
253
|
+
id="search"
|
|
254
|
+
placeholder="Search products..."
|
|
255
|
+
aria-label="Search products"
|
|
256
|
+
/>
|
|
257
|
+
<button type="submit">
|
|
258
|
+
<span class="sr-only">Search</span>
|
|
259
|
+
🔍
|
|
260
|
+
</button>
|
|
261
|
+
</form>
|
|
262
|
+
```
|
|
263
|
+
|
|
264
|
+
**Guidelines:**
|
|
265
|
+
- Place in expected location (header, top-right)
|
|
266
|
+
- Make it large enough to see query
|
|
267
|
+
- Use placeholder text to indicate scope
|
|
268
|
+
- Support autocomplete/suggestions
|
|
269
|
+
- Show recent searches
|
|
270
|
+
|
|
271
|
+
### Search Results
|
|
272
|
+
|
|
273
|
+
```
|
|
274
|
+
Essential elements:
|
|
275
|
+
- Number of results
|
|
276
|
+
- Sorting options
|
|
277
|
+
- Filters/facets
|
|
278
|
+
- Clear result snippets
|
|
279
|
+
- Query highlighting
|
|
280
|
+
- Pagination or infinite scroll
|
|
281
|
+
- "No results" helpful message
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
### Zero Results Page
|
|
285
|
+
```
|
|
286
|
+
"No results for 'xyz'"
|
|
287
|
+
- Check spelling
|
|
288
|
+
- Try different keywords
|
|
289
|
+
- Browse categories
|
|
290
|
+
- Contact support
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
---
|
|
294
|
+
|
|
295
|
+
## IA Research Methods
|
|
296
|
+
|
|
297
|
+
### Card Sorting
|
|
298
|
+
|
|
299
|
+
Users organize content into groups that make sense to them.
|
|
300
|
+
|
|
301
|
+
**Open Card Sort:**
|
|
302
|
+
- Users create their own category names
|
|
303
|
+
- Reveals mental models
|
|
304
|
+
- Good for new products
|
|
305
|
+
|
|
306
|
+
**Closed Card Sort:**
|
|
307
|
+
- Users sort into predefined categories
|
|
308
|
+
- Tests existing structure
|
|
309
|
+
- Good for validation
|
|
310
|
+
|
|
311
|
+
**Tools:** OptimalSort, Maze, physical cards
|
|
312
|
+
|
|
313
|
+
### Tree Testing
|
|
314
|
+
|
|
315
|
+
Test if users can find items in your proposed structure.
|
|
316
|
+
|
|
317
|
+
```
|
|
318
|
+
Task: "Find the return policy"
|
|
319
|
+
|
|
320
|
+
Structure:
|
|
321
|
+
- Home
|
|
322
|
+
- Shop
|
|
323
|
+
- Account
|
|
324
|
+
- Help Center ← Target
|
|
325
|
+
- Shipping
|
|
326
|
+
- Returns ← Success
|
|
327
|
+
- Contact
|
|
328
|
+
```
|
|
329
|
+
|
|
330
|
+
**Metrics:**
|
|
331
|
+
- Success rate
|
|
332
|
+
- Directness (first click correct)
|
|
333
|
+
- Time to complete
|
|
334
|
+
|
|
335
|
+
**Tools:** Treejack, UserZoom
|
|
336
|
+
|
|
337
|
+
### First-Click Testing
|
|
338
|
+
|
|
339
|
+
Measure where users first click to complete a task.
|
|
340
|
+
|
|
341
|
+
**Insight:** If the first click is wrong, only 46% eventually succeed.
|
|
342
|
+
|
|
343
|
+
---
|
|
344
|
+
|
|
345
|
+
## 2026 Trends
|
|
346
|
+
|
|
347
|
+
### AI-Powered IA
|
|
348
|
+
- Dynamic categorization based on user behavior
|
|
349
|
+
- Personalized navigation paths
|
|
350
|
+
- Predictive search and recommendations
|
|
351
|
+
- Auto-tagging and organization
|
|
352
|
+
|
|
353
|
+
### Voice and Conversational IA
|
|
354
|
+
- Structure content for voice interfaces
|
|
355
|
+
- Natural language navigation
|
|
356
|
+
- Question-based organization
|
|
357
|
+
- Conversational menus
|
|
358
|
+
|
|
359
|
+
### Zero UI
|
|
360
|
+
- Interfaces that anticipate needs
|
|
361
|
+
- Reduce navigation through prediction
|
|
362
|
+
- Ambient computing integration
|
|
363
|
+
- Context-aware content delivery
|
|
364
|
+
|
|
365
|
+
---
|
|
366
|
+
|
|
367
|
+
## IA Documentation
|
|
368
|
+
|
|
369
|
+
### Sitemap
|
|
370
|
+
|
|
371
|
+
Visual representation of page hierarchy.
|
|
372
|
+
|
|
373
|
+
```
|
|
374
|
+
Homepage
|
|
375
|
+
├── Products
|
|
376
|
+
│ ├── Category A
|
|
377
|
+
│ ├── Category B
|
|
378
|
+
│ └── All Products
|
|
379
|
+
├── About
|
|
380
|
+
│ ├── Our Story
|
|
381
|
+
│ ├── Team
|
|
382
|
+
│ └── Careers
|
|
383
|
+
├── Blog
|
|
384
|
+
│ ├── Article List
|
|
385
|
+
│ └── Single Article
|
|
386
|
+
└── Contact
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
**Tools:** Figma, XMind, Lucidchart, Slickplan
|
|
390
|
+
|
|
391
|
+
### Content Inventory
|
|
392
|
+
|
|
393
|
+
Spreadsheet of all existing content.
|
|
394
|
+
|
|
395
|
+
| URL | Title | Type | Owner | Last Updated | Action |
|
|
396
|
+
|-----|-------|------|-------|--------------|--------|
|
|
397
|
+
| /about | About Us | Page | Marketing | 2024-06 | Keep |
|
|
398
|
+
| /old-promo | Summer Sale | Landing | Marketing | 2023-08 | Delete |
|
|
399
|
+
|
|
400
|
+
### User Flow Diagrams
|
|
401
|
+
|
|
402
|
+
Map the paths users take through your product.
|
|
403
|
+
|
|
404
|
+
```
|
|
405
|
+
Entry → Landing Page → Product List → Product Detail
|
|
406
|
+
↓ ↓
|
|
407
|
+
Search → Add to Cart → Checkout → Success
|
|
408
|
+
↓
|
|
409
|
+
Continue Shopping
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
## Common IA Mistakes
|
|
415
|
+
|
|
416
|
+
1. **Organizing by org structure** - Users don't know your departments
|
|
417
|
+
2. **Too deep** - More than 3-4 levels becomes unwieldy
|
|
418
|
+
3. **Too wide** - Too many top-level options overwhelms
|
|
419
|
+
4. **Duplicate content** - Same info in multiple places
|
|
420
|
+
5. **Vague labels** - "Resources," "Solutions," "Services"
|
|
421
|
+
6. **No search** - Users often prefer search
|
|
422
|
+
7. **Breaking conventions** - Cart not in top-right
|
|
423
|
+
8. **Mobile afterthought** - IA must work for all devices
|
|
424
|
+
|
|
425
|
+
---
|
|
426
|
+
|
|
427
|
+
## Sources
|
|
428
|
+
|
|
429
|
+
- Rosenfeld, L., Morville, P., & Arango, J. (2015). "Information Architecture: For the Web and Beyond"
|
|
430
|
+
- [Nielsen Norman Group - IA](https://www.nngroup.com/topic/information-architecture/)
|
|
431
|
+
- [Interaction Design Foundation - IA](https://www.interaction-design.org/literature/topics/information-architecture)
|
|
432
|
+
- [A List Apart - IA](https://alistapart.com/)
|