@ericrisco/rsc 3.3.0 → 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.
Files changed (56) hide show
  1. package/README.md +6 -3
  2. package/manifest.json +43 -22
  3. package/package.json +1 -1
  4. package/scripts/lib/default-skill-floor.js +5 -1
  5. package/scripts/lib/domains.js +2 -2
  6. package/scripts/lib/retired-skills.js +4 -0
  7. package/skills/design/SKILL.md +4 -3
  8. package/skills/design/evals/cases.yaml +2 -2
  9. package/skills/react/SKILL.md +2 -1
  10. package/skills/suggest/SKILL.md +12 -8
  11. package/skills/suggest/evals/cases.yaml +6 -0
  12. package/skills/ux/SKILL.md +149 -0
  13. package/skills/ux/THIRD_PARTY.md +32 -0
  14. package/skills/ux/evals/cases.yaml +40 -0
  15. package/skills/ux/references/flows.md +124 -0
  16. package/skills/ux/upstream/UPSTREAM.json +59 -0
  17. package/skills/ux/upstream/ux-designer/GUIDE.md +180 -0
  18. package/skills/ux/upstream/ux-designer/LICENSE +21 -0
  19. package/skills/ux/upstream/ux-designer/references/01-core-principles.md +251 -0
  20. package/skills/ux/upstream/ux-designer/references/02-laws-of-ux.md +330 -0
  21. package/skills/ux/upstream/ux-designer/references/03-accessibility.md +411 -0
  22. package/skills/ux/upstream/ux-designer/references/04-visual-design.md +433 -0
  23. package/skills/ux/upstream/ux-designer/references/05-information-architecture.md +432 -0
  24. package/skills/ux/upstream/ux-designer/references/06-interaction-design.md +495 -0
  25. package/skills/ux/upstream/ux-designer/references/07-forms-and-inputs.md +491 -0
  26. package/skills/ux/upstream/ux-designer/references/08-mobile-ux.md +539 -0
  27. package/skills/ux/upstream/ux-designer/references/09-ux-writing.md +493 -0
  28. package/skills/ux/upstream/ux-designer/references/10-user-research.md +533 -0
  29. package/skills/ux/upstream/ux-designer/references/11-design-systems.md +618 -0
  30. package/skills/ux/upstream/ux-designer/references/12a-presence-awareness.md +395 -0
  31. package/skills/ux/upstream/ux-designer/references/12b-conflict-resolution-sync.md +420 -0
  32. package/skills/ux/upstream/ux-designer/references/13a-canvas-navigation.md +388 -0
  33. package/skills/ux/upstream/ux-designer/references/13b-canvas-objects-performance.md +559 -0
  34. package/skills/ux/upstream/ux-designer/references/14-ai-ux-patterns.md +511 -0
  35. package/skills/ux/upstream/ux-designer/references/15-ethical-design.md +419 -0
  36. package/skills/ux/upstream/ux-designer/references/16-onboarding.md +430 -0
  37. package/skills/ux/upstream/ux-designer/references/17-notifications.md +461 -0
  38. package/skills/ux/upstream/ux-designer/references/18-data-visualization.md +453 -0
  39. package/skills/ux/upstream/ux-designer/references/19-search-ux.md +479 -0
  40. package/skills/ux/upstream/ux-designer/references/20-emotional-design.md +382 -0
  41. package/skills/ux/upstream/ux-designer/references/21-data-tables.md +629 -0
  42. package/skills/ux/upstream/ux-designer/references/22-performance-ux.md +626 -0
  43. package/skills/ux/upstream/ux-designer/references/23-internationalization.md +347 -0
  44. package/skills/ux/upstream/ux-designer/references/24-voice-and-multimodal.md +308 -0
  45. package/skills/ux/upstream/ux-designer/references/25a-barcode-camera-scanning.md +342 -0
  46. package/skills/ux/upstream/ux-designer/references/25b-barcode-scanner-workflows.md +412 -0
  47. package/skills/ux/upstream/ux-designer/references/25c-barcode-display.md +277 -0
  48. package/skills/ux/upstream/ux-usability-foundations/GUIDE.md +285 -0
  49. package/skills/ux/upstream/ux-usability-foundations/LICENSE +21 -0
  50. package/skills/ux/upstream/ux-usability-foundations/references/anti-patterns.md +267 -0
  51. package/skills/ux/upstream/ux-usability-foundations/references/checklists.md +130 -0
  52. package/skills/ux/upstream/ux-usability-foundations/references/decision-prompts.md +340 -0
  53. package/skills/ux/upstream/ux-usability-foundations/references/principle-cards.md +449 -0
  54. package/targets/clone-bootstrap.mjs +1 -1
  55. package/skills/ui-engineering/SKILL.md +0 -113
  56. 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/)