cbrowser 16.7.0 → 16.7.2

package/docs/personas/Persona-FirstTimer.md

@@ -0,0 +1,131 @@
+# First-Timer
+
+**Category**: General Users
+**Description**: Users encountering an application or interface type for the first time, characterized by high curiosity but limited domain knowledge
+
+## Overview
+
+First-timers represent users who have no prior experience with a specific application, service, or interface paradigm. They approach new experiences with fresh eyes and open minds, but lack the contextual knowledge that experienced users take for granted. This persona is crucial for testing onboarding flows and initial user experiences.
+
+First-timers typically exhibit high curiosity and motivation to learn, combined with uncertainty about conventions and expectations. They read more carefully than experienced users, seeking to understand the rules of the new environment. Their mental models are still forming, making them particularly sensitive to confusing information architecture or inconsistent design patterns.
+
+The first-timer experience is decisive for long-term retention. Research shows that frustration during initial interactions is a primary driver of early abandonment. However, first-timers who successfully navigate onboarding often become loyal users. Designing for this persona requires balancing guidance with respect for user intelligence.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.7 | Willing to invest time learning new systems; expect some initial friction |
+| riskTolerance | 0.3 | Hesitant to click unfamiliar buttons or commit to actions with unclear consequences |
+| comprehension | 0.3 | Limited domain knowledge means slower processing of jargon and conventions |
+| persistence | 0.5 | Will try multiple times but have lower frustration threshold than experienced users |
+| curiosity | 0.9 | High intrinsic motivation to explore and understand the new environment |
+| workingMemory | 0.5 | Average capacity, but heavily taxed by unfamiliar terminology and concepts |
+| readingTendency | 0.6 | Read more carefully than average; actively seek understanding |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.4 | Vulnerable to discouragement; initial failures feel more significant |
+| selfEfficacy | 0.4 | Uncertainty about ability to succeed in unfamiliar environment |
+| trustCalibration | 0.5 | Neither overly trusting nor skeptical; forming initial impressions |
+| interruptRecovery | 0.4 | Struggle to recover context after interruptions; mental models still forming |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.6 | Accept reasonable options rather than optimizing; unsure what "best" means here |
+| informationForaging | 0.4 | Inefficient information seeking; don't know where to look |
+| anchoringBias | 0.7 | First impressions heavily influence subsequent expectations and interpretations |
+| timeHorizon | 0.4 | Focus on immediate task completion; not yet thinking about long-term usage |
+| attributionStyle | 0.4 | Tend to blame self for difficulties rather than recognizing system issues |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.3 | Limited ability to strategize in unfamiliar domain; reactive approach |
+| proceduralFluency | 0.2 | No automated procedures; every action requires conscious effort |
+| transferLearning | 0.5 | Can apply general web conventions but may miss domain-specific patterns |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.6 | May miss important updates; still learning where to look |
+| mentalModelRigidity | 0.3 | Mental models are flexible because they're still forming |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.7 | Look to interface guidance and authority signals for direction |
+| emotionalContagion | 0.6 | Influenced by perceived emotional tone of interface and help content |
+| fomo | 0.5 | Moderate concern about missing features; still discovering what's possible |
+| socialProofSensitivity | 0.7 | Look for evidence that others use and value the service |
+
+## Behavioral Patterns
+
+### Navigation
+First-timers rely heavily on obvious navigation elements and follow the happy path. They avoid shortcuts and advanced features, preferring clearly labeled buttons. Back button usage is common as they explore and backtrack. They appreciate breadcrumbs and clear indication of current location.
+
+### Decision Making
+Decisions are cautious and deliberate. First-timers seek confirmation before committing to actions and carefully read button labels and warnings. They prefer explicit choices over implicit defaults and appreciate explanations of why options matter.
+
+### Error Recovery
+Errors are distressing and may prompt abandonment. First-timers need clear, non-blaming error messages with specific remediation steps. They often need help distinguishing between recoverable and serious errors.
+
+### Abandonment Triggers
+- Jargon-heavy content without explanations
+- Required account creation before value is demonstrated
+- Unclear next steps or missing call-to-action
+- Errors without clear recovery path
+- Overwhelming options without guidance
+- Feeling judged or embarrassed
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Limited domain knowledge | Provide contextual help and tooltips; explain jargon on first use |
+| Hesitation about commitments | Clear undo capabilities; preview of action consequences |
+| Forming initial impressions | Invest heavily in first-time UX; quick wins build confidence |
+| Self-blame for failures | Non-judgmental error messages; emphasize system responsibility |
+| Seeking validation | Show social proof; testimonials; user counts; success stories |
+| Navigation uncertainty | Strong wayfinding; breadcrumbs; clear current-location indicators |
+
+## Research Basis
+
+- Carroll, J.M. & Rosson, M.B. (1987). Paradox of the Active User - Why users don't read
+- Krug, S. (2014). Don't Make Me Think - First-time user navigation patterns
+- Kim, J. et al. (2016). First-time user retention research at Dropbox
+- Saffer, D. (2010). Designing for Interaction - Onboarding principles
+- Garrett, J.J. (2011). Elements of User Experience - User learning curves
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "first-timer",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona first-timer --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Curiosity](../traits/Trait-Curiosity.md)
+- [Comprehension](../traits/Trait-Comprehension.md)
+- [Risk Tolerance](../traits/Trait-RiskTolerance.md)

package/docs/personas/Persona-ImpatientUser.md

@@ -0,0 +1,132 @@
+# Impatient User
+
+**Category**: General Users
+**Description**: Users characterized by extremely low tolerance for delays, friction, or obstacles in completing their goals
+
+## Overview
+
+Impatient users represent an extreme end of the user behavior spectrum where time sensitivity dominates all other considerations. While all users value their time, impatient users have an outsized reaction to perceived delays or obstacles. This persona is valuable for identifying friction points that may cause abandonment across your entire user base.
+
+Impatient users may be experiencing situational time pressure (rushing to complete a task) or may have personality traits that predispose them to low frustration tolerance. Regardless of cause, their behavior is characterized by rapid scanning, minimal reading, quick abandonment of unclear paths, and strong preference for the most direct route to goal completion.
+
+This persona serves as a "canary in the coal mine" for UX issues. Problems that cause impatient users to abandon will also create friction for other users, even if they persist. Optimizing for this persona often improves conversion and satisfaction across the board.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.1 | Defining characteristic; extremely low tolerance for any perceived delay |
+| riskTolerance | 0.6 | Willing to take shortcuts and skip safety measures to save time |
+| comprehension | 0.6 | Capable of understanding but unwilling to invest time in reading |
+| persistence | 0.2 | Extremely quick to abandon; try alternatives rather than persist |
+| curiosity | 0.3 | No interest in exploration; purely goal-focused |
+| workingMemory | 0.6 | Adequate capacity but impatience prevents full utilization |
+| readingTendency | 0.1 | Minimal reading; scan for actionable elements only |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.3 | Low tolerance for setbacks; frustration escalates quickly |
+| selfEfficacy | 0.6 | Confident but attributes delays to system rather than self |
+| trustCalibration | 0.4 | May proceed despite warnings to save time |
+| interruptRecovery | 0.5 | Moderate; interruptions are frustrating but may welcome escape from slow process |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.9 | Accept first available option; no comparison shopping |
+| informationForaging | 0.4 | Brief scans; abandon quickly if information not obvious |
+| anchoringBias | 0.6 | First option heavily favored due to reluctance to explore |
+| timeHorizon | 0.2 | Extreme focus on immediate completion; future consequences ignored |
+| attributionStyle | 0.3 | Blame system for any delays; low self-attribution |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.3 | Action-oriented; minimal planning |
+| proceduralFluency | 0.6 | Expect common patterns; frustrated by novel interactions |
+| transferLearning | 0.5 | Apply familiar patterns but won't invest in learning new ones |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.7 | Miss changes while focused on finding CTAs |
+| mentalModelRigidity | 0.6 | Expect things to work in familiar ways |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.4 | Ignore recommendations that slow progress |
+| emotionalContagion | 0.4 | Moderate; frustration internally driven |
+| fomo | 0.8 | High urgency; feel they're wasting time on current task |
+| socialProofSensitivity | 0.4 | Ignore reviews if they require reading |
+
+## Behavioral Patterns
+
+### Navigation
+Impatient users click rapidly, often before pages fully load. They favor search over navigation when available. Multi-step processes are abandoned if not clearly necessary. They use browser back button aggressively and may open multiple tabs to hedge bets.
+
+### Decision Making
+First visible option is selected unless obviously wrong. No comparison of alternatives. Defaults are accepted without consideration. Any friction at decision point causes abandonment.
+
+### Error Recovery
+Errors cause immediate frustration and often abandonment. Retry only if instant; otherwise seek alternatives (competitors, phone support, abandon entirely). Error messages are barely read.
+
+### Abandonment Triggers
+- Any delay over 2 seconds
+- Required reading of more than 2 sentences
+- Multi-step processes without clear progress
+- Required account creation
+- Captchas or verification steps
+- Unclear next action
+- Any modal or interstitial
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Extreme impatience | Sub-second interactions; skeleton loading; optimistic updates |
+| No reading | Single-word CTAs; icon-based communication; visual hierarchy |
+| Quick abandonment | One-click paths; guest checkout; express options |
+| Shortcut-seeking | Provide the shortcuts; don't force thoroughness |
+| Error intolerance | Prevent errors through smart defaults; instant inline validation |
+| First-option bias | Ensure first option is genuinely good; don't bury best options |
+
+## Research Basis
+
+- Nielsen, J. (1993). Response Times: 3 Important Limits - Sub-second expectations
+- Galletta, D. et al. (2006). Impact of delay on web user interaction and abandonment
+- Akamai (2017). Page load time impact on conversion rates
+- Perfetti, C. & Landesman, L. (2001). Eight principles of user frustration - UIE research
+- Kohavi, R. et al. (2014). Online experimentation at Microsoft - Latency impact studies
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "impatient-user",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona impatient-user --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Patience](../traits/Trait-Patience.md)
+- [FOMO](../traits/Trait-FOMO.md)
+- [Persistence](../traits/Trait-Persistence.md)

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)