cbrowser 16.7.1 → 16.7.2

package/docs/personas/Persona-Index.md

@@ -0,0 +1,170 @@
+# Persona Index
+
+> **Copyright**: (c) 2026 WF Media (Alexandria Eden). All rights reserved.
+>
+> **License**: [Business Source License 1.1](https://github.com/alexandriashai/cbrowser/blob/main/LICENSE) - Converts to Apache 2.0 on February 5, 2030.
+>
+> **Contact**: alexandria.shai.eden@gmail.com
+
+CBrowser includes 9 pre-configured user personas, each with research-backed cognitive trait profiles. Personas represent common user archetypes for testing how different users experience web interfaces.
+
+## Available Personas
+
+| Persona | Description | Key Characteristics |
+|---------|-------------|---------------------|
+| [Power User](Persona-PowerUser) | Tech-savvy expert | High comprehension, low patience, rapid scanning |
+| [First Timer](Persona-FirstTimer) | New to the interface | Low comprehension, high curiosity, methodical |
+| [Elderly User](Persona-ElderlyUser) | Older adult (65+) | Low working memory, high reading tendency |
+| [Mobile User](Persona-MobileUser) | Smartphone-first | Low patience, high satisficing, touch-focused |
+| [Impatient User](Persona-ImpatientUser) | Quick to abandon | Very low patience, high FOMO |
+| [Screen Reader User](Persona-ScreenReaderUser) | Assistive technology | High persistence, sequential navigation |
+| [Motor Tremor](Persona-MotorTremor) | Motor impairment | Low risk tolerance, high patience |
+| [Low Vision](Persona-LowVision) | Vision impairment | High reading tendency, low change blindness |
+| [ADHD](Persona-ADHD) | Attention differences | Low working memory, high curiosity, low patience |
+
+---
+
+## Persona Trait Profiles
+
+### Quick Reference Table
+
+All values on 0.0-1.0 scale. Higher = more of the trait.
+
+| Trait | Power | First | Elderly | Mobile | Impatient | Screen | Motor | Low Vision | ADHD |
+|-------|-------|-------|---------|--------|-----------|--------|-------|------------|------|
+| patience | 0.3 | 0.7 | 0.8 | 0.3 | 0.1 | 0.9 | 0.9 | 0.7 | 0.2 |
+| riskTolerance | 0.8 | 0.3 | 0.2 | 0.5 | 0.6 | 0.2 | 0.2 | 0.3 | 0.7 |
+| comprehension | 0.9 | 0.3 | 0.5 | 0.6 | 0.6 | 0.8 | 0.7 | 0.6 | 0.5 |
+| persistence | 0.7 | 0.5 | 0.6 | 0.4 | 0.2 | 0.9 | 0.8 | 0.8 | 0.3 |
+| curiosity | 0.8 | 0.9 | 0.4 | 0.5 | 0.3 | 0.5 | 0.4 | 0.5 | 0.9 |
+| workingMemory | 0.9 | 0.5 | 0.4 | 0.5 | 0.6 | 0.7 | 0.7 | 0.6 | 0.3 |
+| readingTendency | 0.2 | 0.6 | 0.8 | 0.2 | 0.1 | 0.9 | 0.7 | 0.9 | 0.2 |
+
+---
+
+## Persona Categories
+
+### General Users
+
+- **[Power User](Persona-PowerUser)** - Experienced users who know shortcuts, scan quickly, and expect responsive interfaces
+- **[First Timer](Persona-FirstTimer)** - New users learning the interface, more exploratory and methodical
+- **[Mobile User](Persona-MobileUser)** - Users on smartphones with touch interaction and attention constraints
+- **[Impatient User](Persona-ImpatientUser)** - Users with very low tolerance for friction, quick to abandon
+
+### Accessibility Personas
+
+- **[Elderly User](Persona-ElderlyUser)** - Older adults with age-related cognitive changes
+- **[Screen Reader User](Persona-ScreenReaderUser)** - Users navigating via screen reader technology
+- **[Motor Tremor](Persona-MotorTremor)** - Users with motor impairments affecting precision
+- **[Low Vision](Persona-LowVision)** - Users with significant vision impairment
+- **[ADHD](Persona-ADHD)** - Users with attention differences
+
+---
+
+## Using Personas
+
+### Via MCP Tool
+
+```typescript
+await cognitive_journey_init({
+  persona: "elderly-user",
+  goal: "complete checkout",
+  startUrl: "https://example.com/shop"
+});
+```
+
+### Via CLI
+
+```bash
+npx cbrowser cognitive-journey \
+  --persona elderly-user \
+  --start https://example.com/shop \
+  --goal "complete checkout"
+```
+
+### Custom Traits
+
+Override any trait for a built-in persona:
+
+```typescript
+await cognitive_journey_init({
+  persona: "power-user",
+  goal: "find settings",
+  startUrl: "https://example.com",
+  customTraits: {
+    patience: 0.1  // Even more impatient power user
+  }
+});
+```
+
+---
+
+## Research Basis
+
+Persona trait values are derived from peer-reviewed research:
+
+| Persona | Primary Research Sources |
+|---------|-------------------------|
+| Power User | Nielsen (2006) expert user studies |
+| First Timer | Card et al. (1983) novice-expert differences |
+| Elderly User | Czaja & Lee (2007) aging and technology |
+| Mobile User | Adipat et al. (2011) mobile usability |
+| Screen Reader | Lazar et al. (2007) assistive technology |
+| Motor Tremor | Trewin & Pain (1999) motor impairment HCI |
+| Low Vision | Jacko et al. (2000) low vision computing |
+| ADHD | Goodman et al. (2007) ADHD and web use |
+
+---
+
+## Trait Interactions
+
+When personas encounter challenges, their trait combinations produce characteristic behaviors:
+
+| Persona | Typical Response to Friction |
+|---------|------------------------------|
+| Power User | Tries keyboard shortcuts, abandons quickly if blocked |
+| First Timer | Reads help text, tries multiple options systematically |
+| Elderly User | Re-reads content, may call for help, patient retries |
+| Mobile User | Taps repeatedly, tries swiping, abandons if >2 taps needed |
+| Impatient User | Immediate abandonment, high frustration expression |
+| Screen Reader | Navigates to next element, uses landmarks, persists |
+| Motor Tremor | Careful targeting, uses larger targets, avoids hover |
+| Low Vision | Zooms in, traces text carefully, uses high contrast |
+| ADHD | Distracted by other elements, forgets original goal |
+
+---
+
+## Creating Custom Personas
+
+Use the questionnaire or define traits directly:
+
+```typescript
+// Via questionnaire (generates trait profile)
+await runPersonaQuestionnaire();
+
+// Direct definition
+const customPersona = {
+  patience: 0.4,
+  riskTolerance: 0.6,
+  comprehension: 0.7,
+  persistence: 0.5,
+  curiosity: 0.8,
+  workingMemory: 0.6,
+  readingTendency: 0.3
+};
+```
+
+---
+
+## See Also
+
+- [Trait Index](../traits/Trait-Index) - All 25 cognitive traits explained
+- [Cognitive User Simulation](../Cognitive-User-Simulation) - Main documentation
+- [Persona Questionnaire](../Persona-Questionnaire) - Generate custom personas
+- [Multi-Persona Comparison](../Multi-Persona-Comparison) - Compare across personas
+
+---
+
+## Bibliography
+
+See [Complete Bibliography](../research/Bibliography) for all academic sources used in persona development.

package/docs/personas/Persona-LowVision.md

@@ -0,0 +1,133 @@
+# Low Vision User
+
+**Category**: Accessibility Personas
+**Description**: Users with partial visual impairment who rely on magnification, high contrast, or other visual adaptations to use interfaces
+
+## Overview
+
+Low vision users have significant visual impairment that cannot be fully corrected with glasses or contact lenses, but retain some functional vision. This includes conditions like macular degeneration, glaucoma, diabetic retinopathy, and cataracts. Unlike screen reader users who have no functional vision, low vision users navigate visually but under significantly constrained conditions.
+
+Low vision users employ various strategies to access digital content: screen magnification (often 200-800%), high contrast modes, color inversion, custom CSS overrides, and physical proximity to screens. These adaptations create a unique interaction paradigm where only a small portion of the interface is visible at any time, requiring extensive panning to understand page layout.
+
+The low vision experience reveals the importance of clear visual hierarchy, sufficient color contrast, text scalability, and reduced reliance on spatial relationships. Changes happening outside the magnified viewport may be completely missed, making change management particularly important for this persona.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.7 | Developed through adaptation; understand interactions take longer |
+| riskTolerance | 0.3 | Cautious; may miss visual cues that sighted users rely on |
+| comprehension | 0.7 | Cognitive abilities intact; visual access to information may be limited |
+| persistence | 0.8 | High; committed to completing tasks despite visual barriers |
+| curiosity | 0.5 | Moderate; exploration costly due to magnification requirements |
+| workingMemory | 0.6 | Normal capacity; some used for spatial memory of page layout |
+| readingTendency | 0.9 | Read thoroughly due to high cost of re-finding information |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.7 | Adapted to challenges; developed coping strategies |
+| selfEfficacy | 0.6 | Confident with adapted strategies; aware of vision limitations |
+| trustCalibration | 0.5 | May miss visual trust cues; rely on text-based indicators |
+| interruptRecovery | 0.5 | Losing place in magnified view is costly |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.4 | Prefer thorough understanding; re-finding options is costly |
+| informationForaging | 0.5 | Systematic due to limited viewport; can't visually scan |
+| anchoringBias | 0.5 | Moderate; first option in magnified view may have advantage |
+| timeHorizon | 0.6 | Invest time to learn page layout for future efficiency |
+| attributionStyle | 0.5 | Understand interaction of vision limitations and design choices |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.7 | Strategic about navigation; minimize panning |
+| proceduralFluency | 0.6 | Develop routines for common sites and patterns |
+| transferLearning | 0.6 | Apply patterns but each site requires new spatial mapping |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.2 | Low blindness - very attentive to visible changes; high blindness to changes outside viewport |
+| mentalModelRigidity | 0.5 | Rely on learned spatial layouts |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.5 | Moderate; evaluate based on accessibility |
+| emotionalContagion | 0.5 | Normal emotional sensitivity; may miss visual cues |
+| fomo | 0.4 | Focused on accessible content |
+| socialProofSensitivity | 0.5 | Value reviews from other low vision users |
+
+## Behavioral Patterns
+
+### Navigation
+Low vision users navigate by panning across magnified views, often using keyboard navigation to move between elements. They build mental maps of page layouts through exploration. Consistent layouts across pages are essential. They may use a combination of magnification and screen reader for different content types.
+
+### Decision Making
+Decisions require extensive exploration to understand all options. Users may not see all choices simultaneously. Clear labeling and consistent positioning help. Summary information at the beginning of sections reduces exploration requirements.
+
+### Error Recovery
+Error messages must be high contrast and appear in predictable locations. Focus management should move errors into the viewport. Errors appearing far from the triggering element may be missed entirely.
+
+### Abandonment Triggers
+- Low contrast text or interactive elements
+- Small text that doesn't scale properly
+- Information conveyed only through color
+- Important content appearing only on hover
+- Unpredictable layout changes
+- Fixed-size elements that can't be magnified
+- Interfaces that break at high zoom levels
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Limited viewport | Predictable layouts; essential info in consistent locations |
+| Contrast needs | WCAG AAA contrast ratios (7:1 for text, 4.5:1 for large text) |
+| Magnification | Responsive layouts that work at 200-400% zoom |
+| Color dependence | Never use color alone to convey information |
+| Spatial relationships | Programmatic associations (labels, headings); not just proximity |
+| Out-of-viewport changes | ARIA live regions; focus management for important updates |
+| Reading difficulty | Resizable text; sufficient line height and letter spacing |
+
+## Research Basis
+
+- Szpiro, S. et al. (2016). How people with low vision access computing devices - Behavior studies
+- Legge, G.E. (2007). Psychophysics of Reading in Normal and Low Vision
+- WCAG 2.2 Guidelines - Contrast and resizing requirements
+- Accessibility guidelines from AFB (American Foundation for the Blind)
+- Shneiderman, B. (2003). Designing for people with visual impairments
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "low-vision",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona low-vision --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Reading Tendency](../traits/Trait-ReadingTendency.md)
+- [Persistence](../traits/Trait-Persistence.md)
+- [Change Blindness](../traits/Trait-ChangeBlindness.md)

package/docs/personas/Persona-MobileUser.md

@@ -0,0 +1,133 @@
+# Mobile User
+
+**Category**: General Users
+**Description**: Users primarily accessing interfaces through mobile devices, often in contexts with divided attention and time pressure
+
+## Overview
+
+Mobile users interact with digital interfaces in fundamentally different ways than desktop users. They typically operate in contexts characterized by divided attention, physical movement, variable connectivity, and time pressure. The mobile context transforms user behavior regardless of the user's underlying cognitive abilities.
+
+The mobile experience is defined by constraints and interruptions. Screen real estate is limited, requiring prioritization of the most essential content and actions. Touch input replaces precision mouse interactions. Users often engage in "snacking" behavior - brief, interrupted sessions between other activities. This context creates unique patterns of satisficing, impatience, and goal-focused behavior.
+
+Mobile users are not less capable than desktop users; rather, they operate under situational constraints that affect their interaction patterns. A user who carefully reads documentation on desktop may skim on mobile. Understanding this context is essential for designing effective mobile experiences.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.3 | Mobile context creates time pressure; users expect immediate responses |
+| riskTolerance | 0.5 | Moderate; willing to act quickly but cautious about security on mobile |
+| comprehension | 0.6 | Capability unchanged but limited attention reduces effective comprehension |
+| persistence | 0.4 | Low commitment to any single session; will abandon and return later |
+| curiosity | 0.4 | Goal-focused rather than exploratory; minimize time spent in app |
+| workingMemory | 0.5 | Capacity unchanged but divided attention reduces available resources |
+| readingTendency | 0.2 | Skim headlines; rely on visual hierarchy; rarely read body text |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.5 | Brief frustration but quick to try alternatives rather than persist |
+| selfEfficacy | 0.6 | Generally confident with mobile interfaces |
+| trustCalibration | 0.5 | Balanced; aware of mobile security concerns |
+| interruptRecovery | 0.5 | Expect interruptions; design mental models around resumption |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.8 | Accept first reasonable option; minimize decision time |
+| informationForaging | 0.5 | Quick scans for obvious information; abandon if not found |
+| anchoringBias | 0.5 | First-seen options have advantage but less commitment overall |
+| timeHorizon | 0.3 | Focus on immediate task; minimize time investment |
+| attributionStyle | 0.5 | Balanced attribution; expect mobile to be different |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.4 | Less planning; reactive to immediate needs |
+| proceduralFluency | 0.6 | Familiar with mobile conventions (swipe, tap, etc.) |
+| transferLearning | 0.6 | Apply mobile patterns across apps |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.6 | May miss changes while attention divided; rely on clear notifications |
+| mentalModelRigidity | 0.5 | Expect mobile conventions; frustrated by non-standard patterns |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.5 | Moderate; skeptical of mobile ads and promotions |
+| emotionalContagion | 0.5 | Moderate influence from visual design |
+| fomo | 0.6 | Mobile creates urgency; notifications drive engagement |
+| socialProofSensitivity | 0.6 | App store ratings and reviews influence choices |
+
+## Behavioral Patterns
+
+### Navigation
+Mobile users rely on familiar patterns: bottom navigation, hamburger menus, swipe gestures. They expect single-hand operation for most tasks. Deep hierarchies are problematic; prefer flat architecture with clear entry points. Search is often preferred over navigation for finding specific items.
+
+### Decision Making
+Decisions are rapid and often based on minimal information. The top option or featured choice has significant advantage. Users rarely scroll below the fold for options. Price and key differentiators must be immediately visible.
+
+### Error Recovery
+Low tolerance for errors that interrupt flow. Errors should be recoverable without losing progress. Form validation should be inline and immediate. Connectivity errors should allow offline operation or easy retry.
+
+### Abandonment Triggers
+- Slow load times (over 3 seconds)
+- Forced desktop-style interactions
+- Lengthy forms without progress saving
+- Pop-ups and interstitials
+- Unclear touch targets
+- Required account creation for simple tasks
+- Poor cellular connectivity handling
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Time pressure | Minimize steps; allow task completion in under 2 minutes |
+| Divided attention | Clear visual hierarchy; essential info "above the fold" |
+| Limited screen space | Progressive disclosure; prioritize ruthlessly |
+| Touch input | Generous touch targets (minimum 44x44 pixels); forgiving hit areas |
+| Interrupted sessions | Save state automatically; enable easy resumption |
+| Variable connectivity | Offline capability; graceful degradation; queue actions |
+| Low reading tendency | Visual communication; icons with text; clear CTAs |
+
+## Research Basis
+
+- Chittaro, L. (2011). Mobile HCI research methods - Context-specific user behavior
+- Hoober, S. & Berkman, E. (2012). Designing Mobile Interfaces - Touch interaction patterns
+- Nielsen, J. (2012). Mobile Usability - Mobile vs desktop behavior differences
+- Google/SOASTA (2017). Mobile page speed benchmarks - Load time impact on conversion
+- Budiu, R. (2015). Mobile User Experience - Attention and task completion research
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "mobile-user",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona mobile-user --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Patience](../traits/Trait-Patience.md)
+- [Satisficing](../traits/Trait-Satisficing.md)
+- [Reading Tendency](../traits/Trait-ReadingTendency.md)

package/docs/personas/Persona-MotorTremor.md

@@ -0,0 +1,133 @@
+# Motor Tremor User
+
+**Category**: Accessibility Personas
+**Description**: Users with motor control impairments affecting precise movements, such as essential tremor, Parkinson's disease, or other neuromuscular conditions
+
+## Overview
+
+Motor tremor users experience involuntary shaking or movement that affects their ability to perform precise motor tasks. This includes difficulty with small click targets, drag-and-drop interactions, hover states, and any interface element requiring steady, accurate movement. Conditions causing tremor range from essential tremor (the most common movement disorder) to Parkinson's disease, multiple sclerosis, and age-related motor changes.
+
+Users with motor tremor have developed strategies to compensate for their movement challenges. They often use keyboard navigation when possible, stabilize their arms against surfaces, use assistive technologies like switch access or adapted mice, and approach interaction targets with deliberate care. They have learned to be patient with themselves and with interfaces.
+
+The challenges faced by motor tremor users highlight the importance of generous click targets, keyboard alternatives, and forgiving interaction patterns. Many design improvements for this persona benefit all users, including those using touch screens in moving vehicles or with temporary motor impairments.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.9 | Developed through necessity; understand that interactions will take more time |
+| riskTolerance | 0.2 | Very cautious; misclicks can have unwanted consequences |
+| comprehension | 0.7 | Unaffected by motor impairment; cognitive abilities intact |
+| persistence | 0.8 | High; committed to completing tasks despite physical challenges |
+| curiosity | 0.5 | Moderate; exploration limited by interaction cost |
+| workingMemory | 0.7 | Normal capacity; may be partially occupied by motor planning |
+| readingTendency | 0.6 | Moderate; read carefully to avoid needing re-interaction |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.7 | Developed through adapting to physical challenges |
+| selfEfficacy | 0.6 | Confident in abilities but aware of limitations |
+| trustCalibration | 0.6 | Appropriately cautious about committing to actions |
+| interruptRecovery | 0.6 | Moderate; interruptions less costly than for some personas |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.3 | Low; prefer to choose carefully to avoid need for corrections |
+| informationForaging | 0.6 | Thorough to reduce need for repeated navigation |
+| anchoringBias | 0.5 | Moderate; don't favor first option if requiring corrections |
+| timeHorizon | 0.6 | Willing to invest time upfront to avoid future corrections |
+| attributionStyle | 0.5 | Understand interaction between personal abilities and interface design |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.7 | Plan interactions carefully to minimize motor demands |
+| proceduralFluency | 0.6 | Develop routines but each interaction requires conscious effort |
+| transferLearning | 0.6 | Apply accessibility patterns across contexts |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.5 | Normal visual attention; may miss changes during motor focus |
+| mentalModelRigidity | 0.5 | Moderate; expect accessibility considerations |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.5 | Moderate; evaluate based on accessibility support |
+| emotionalContagion | 0.5 | Normal emotional sensitivity |
+| fomo | 0.4 | Lower; focused on accessible experiences |
+| socialProofSensitivity | 0.5 | Value accessibility reviews from others with motor impairments |
+
+## Behavioral Patterns
+
+### Navigation
+Motor tremor users favor keyboard navigation over mouse/touch when possible. When using a pointer, they approach targets slowly and deliberately, often using arm stabilization. They benefit from large click targets and avoid hover-dependent interactions. Sticky menus that require precise mouse control are particularly challenging.
+
+### Decision Making
+Decisions are careful and deliberate because correction costs are high. Users prefer to understand all implications before committing to an action. Preview functionality is valuable. The ability to undo or correct without extensive re-navigation is essential.
+
+### Error Recovery
+Errors caused by misclicks are frustrating and common. Error recovery should not require precise motor control. Confirmation dialogs should have well-spaced buttons. The ability to undo actions reduces the cost of accidental clicks.
+
+### Abandonment Triggers
+- Small click targets (under 44x44 pixels)
+- Hover-only interactions with no click alternative
+- Drag-and-drop without keyboard alternative
+- Time-limited interactions during data entry
+- Sliding/swiping interactions requiring precise control
+- Double-click requirements
+- Captchas requiring precise interaction
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Small click targets | Minimum 44x44 pixel touch targets; larger for primary actions |
+| Precision requirements | Forgiving click areas; expand clickable region beyond visual boundary |
+| Hover interactions | Provide click/keyboard alternatives; persistent hover states |
+| Drag and drop | Keyboard alternatives; click-to-select + click-to-place pattern |
+| Misclick recovery | Generous undo; confirmation for destructive actions |
+| Time pressure | Disable timeouts for form inputs; extend session limits |
+| Complex gestures | Simple tap/click alternatives to swipes and multi-touch |
+
+## Research Basis
+
+- Trewin, S. & Pain, H. (1999). Keyboard and mouse errors due to motor impairments - Empirical studies
+- Keates, S. et al. (2002). Cursor measures for motion-impaired users - Design recommendations
+- WCAG 2.2 Target Size guidelines (2.5.5, 2.5.8) - Minimum target sizes
+- MacKenzie, I.S. & Jusoh, S. (2001). Evaluation of pointing devices for users with motor impairments
+- Wobbrock, J.O. & Gajos, K.Z. (2008). Ability-based design - Adapting interfaces to abilities
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "motor-tremor",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona motor-tremor --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Patience](../traits/Trait-Patience.md)
+- [Persistence](../traits/Trait-Persistence.md)
+- [Risk Tolerance](../traits/Trait-RiskTolerance.md)