cbrowser 16.7.1 → 16.8.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 (73) hide show
  1. package/README.md +2 -0
  2. package/dist/browser.d.ts.map +1 -1
  3. package/dist/browser.js +52 -7
  4. package/dist/browser.js.map +1 -1
  5. package/dist/cognitive/index.d.ts.map +1 -1
  6. package/dist/cognitive/index.js +22 -0
  7. package/dist/cognitive/index.js.map +1 -1
  8. package/dist/index.d.ts +1 -0
  9. package/dist/index.d.ts.map +1 -1
  10. package/dist/index.js +3 -0
  11. package/dist/index.js.map +1 -1
  12. package/dist/personas.d.ts.map +1 -1
  13. package/dist/personas.js +17 -2
  14. package/dist/personas.js.map +1 -1
  15. package/dist/testing/nl-test-suite.d.ts +2 -0
  16. package/dist/testing/nl-test-suite.d.ts.map +1 -1
  17. package/dist/testing/nl-test-suite.js +38 -1
  18. package/dist/testing/nl-test-suite.js.map +1 -1
  19. package/dist/values/index.d.ts +14 -0
  20. package/dist/values/index.d.ts.map +1 -0
  21. package/dist/values/index.js +17 -0
  22. package/dist/values/index.js.map +1 -0
  23. package/dist/values/persona-values.d.ts +36 -0
  24. package/dist/values/persona-values.d.ts.map +1 -0
  25. package/dist/values/persona-values.js +343 -0
  26. package/dist/values/persona-values.js.map +1 -0
  27. package/dist/values/schwartz-values.d.ts +207 -0
  28. package/dist/values/schwartz-values.d.ts.map +1 -0
  29. package/dist/values/schwartz-values.js +130 -0
  30. package/dist/values/schwartz-values.js.map +1 -0
  31. package/dist/values/value-mappings.d.ts +97 -0
  32. package/dist/values/value-mappings.d.ts.map +1 -0
  33. package/dist/values/value-mappings.js +520 -0
  34. package/dist/values/value-mappings.js.map +1 -0
  35. package/docs/personas/Persona-ADHD.md +135 -0
  36. package/docs/personas/Persona-ElderlyUser.md +131 -0
  37. package/docs/personas/Persona-FirstTimer.md +131 -0
  38. package/docs/personas/Persona-ImpatientUser.md +132 -0
  39. package/docs/personas/Persona-Index.md +170 -0
  40. package/docs/personas/Persona-LowVision.md +133 -0
  41. package/docs/personas/Persona-MobileUser.md +133 -0
  42. package/docs/personas/Persona-MotorTremor.md +133 -0
  43. package/docs/personas/Persona-PowerUser.md +129 -0
  44. package/docs/personas/Persona-ScreenReaderUser.md +133 -0
  45. package/docs/research/Bibliography.md +269 -0
  46. package/docs/research/Research-Methodology.md +224 -0
  47. package/docs/traits/Trait-AnchoringBias.md +219 -0
  48. package/docs/traits/Trait-AttributionStyle.md +272 -0
  49. package/docs/traits/Trait-AuthoritySensitivity.md +133 -0
  50. package/docs/traits/Trait-ChangeBlindness.md +163 -0
  51. package/docs/traits/Trait-Comprehension.md +172 -0
  52. package/docs/traits/Trait-Curiosity.md +181 -0
  53. package/docs/traits/Trait-EmotionalContagion.md +136 -0
  54. package/docs/traits/Trait-FOMO.md +142 -0
  55. package/docs/traits/Trait-Index.md +158 -0
  56. package/docs/traits/Trait-InformationForaging.md +209 -0
  57. package/docs/traits/Trait-InterruptRecovery.md +241 -0
  58. package/docs/traits/Trait-MentalModelRigidity.md +220 -0
  59. package/docs/traits/Trait-MetacognitivePlanning.md +156 -0
  60. package/docs/traits/Trait-Patience.md +129 -0
  61. package/docs/traits/Trait-Persistence.md +157 -0
  62. package/docs/traits/Trait-ProceduralFluency.md +197 -0
  63. package/docs/traits/Trait-ReadingTendency.md +208 -0
  64. package/docs/traits/Trait-Resilience.md +154 -0
  65. package/docs/traits/Trait-RiskTolerance.md +154 -0
  66. package/docs/traits/Trait-Satisficing.md +173 -0
  67. package/docs/traits/Trait-SelfEfficacy.md +191 -0
  68. package/docs/traits/Trait-SocialProofSensitivity.md +147 -0
  69. package/docs/traits/Trait-TimeHorizon.md +259 -0
  70. package/docs/traits/Trait-TransferLearning.md +241 -0
  71. package/docs/traits/Trait-TrustCalibration.md +219 -0
  72. package/docs/traits/Trait-WorkingMemory.md +184 -0
  73. package/package.json +2 -2
@@ -0,0 +1,131 @@
1
+ # Elderly User
2
+
3
+ **Category**: General Users
4
+ **Description**: Users aged 65+ who may have age-related cognitive and perceptual changes affecting their digital interactions
5
+
6
+ ## Overview
7
+
8
+ Elderly users represent a growing and often underserved segment of the digital population. As digital literacy spreads across generations, more seniors are engaging with technology for essential tasks like healthcare management, financial services, and social connection. This persona captures the common challenges and strengths of older users.
9
+
10
+ Age-related changes can affect multiple cognitive domains relevant to interface use. Working memory capacity typically decreases, making complex multi-step procedures more challenging. Processing speed slows, requiring more time for decision-making. However, crystallized intelligence and accumulated wisdom often compensate, allowing older users to make thoughtful decisions and persist through challenges that would frustrate younger users.
11
+
12
+ Elderly users often bring patience and careful attention that younger users lack. They read content more thoroughly, consider options more carefully, and are less likely to make impulsive errors. Designing for this persona benefits all users through clearer interfaces, better error handling, and reduced cognitive load.
13
+
14
+ ## Trait Profile
15
+
16
+ All values on 0.0-1.0 scale.
17
+
18
+ ### Core Traits (Tier 1)
19
+
20
+ | Trait | Value | Rationale |
21
+ |-------|-------|-----------|
22
+ | patience | 0.8 | Research shows older adults allocate more time to tasks and are less frustrated by reasonable delays |
23
+ | riskTolerance | 0.2 | Strong preference for caution; fear of making irreversible mistakes or being scammed |
24
+ | comprehension | 0.5 | Crystallized intelligence intact; processing of novel interfaces may be slower |
25
+ | persistence | 0.6 | Will continue trying but may seek help earlier than younger users |
26
+ | curiosity | 0.4 | More goal-focused than exploration-oriented; prefer familiar patterns |
27
+ | workingMemory | 0.4 | Age-related decline in working memory capacity is well-documented |
28
+ | readingTendency | 0.8 | Read thoroughly; prefer complete understanding before acting |
29
+
30
+ ### Emotional Traits (Tier 2)
31
+
32
+ | Trait | Value | Rationale |
33
+ |-------|-------|-----------|
34
+ | resilience | 0.5 | May become discouraged by repeated failures but have life experience with overcoming challenges |
35
+ | selfEfficacy | 0.4 | Often underestimate their abilities with technology due to stereotype threat |
36
+ | trustCalibration | 0.5 | Mix of appropriate caution and sometimes excessive trust in official-looking content |
37
+ | interruptRecovery | 0.4 | Reduced working memory makes context recovery after interruptions more difficult |
38
+
39
+ ### Decision-Making Traits (Tier 3)
40
+
41
+ | Trait | Value | Rationale |
42
+ |-------|-------|-----------|
43
+ | satisficing | 0.6 | Accept good-enough solutions; not driven to find optimal choices |
44
+ | informationForaging | 0.5 | Thorough but may be slower to recognize information scent |
45
+ | anchoringBias | 0.7 | Preferences shaped by earlier technology experiences; may expect older patterns |
46
+ | timeHorizon | 0.5 | Balanced perspective; neither overly focused on immediate nor distant outcomes |
47
+ | attributionStyle | 0.5 | Balanced attribution; experience provides perspective on system vs user responsibility |
48
+
49
+ ### Planning Traits (Tier 4)
50
+
51
+ | Trait | Value | Rationale |
52
+ |-------|-------|-----------|
53
+ | metacognitivePlanning | 0.5 | Good planning abilities but may not apply them to unfamiliar technology contexts |
54
+ | proceduralFluency | 0.4 | Slower development of procedural skills with new interfaces |
55
+ | transferLearning | 0.5 | Can transfer knowledge but may be slower to recognize applicable patterns |
56
+
57
+ ### Perception Traits (Tier 5)
58
+
59
+ | Trait | Value | Rationale |
60
+ |-------|-------|-----------|
61
+ | changeBlindness | 0.6 | May miss subtle interface changes; attention resources more limited |
62
+ | mentalModelRigidity | 0.7 | Expect interfaces to work like familiar systems; resistant to paradigm shifts |
63
+
64
+ ### Social Traits (Tier 6)
65
+
66
+ | Trait | Value | Rationale |
67
+ |-------|-------|-----------|
68
+ | authoritySensitivity | 0.7 | Respect institutional authority; may trust official-looking interfaces too readily |
69
+ | emotionalContagion | 0.5 | Moderate influence from emotional tone of content |
70
+ | fomo | 0.3 | Less driven by fear of missing out; focused on personal needs |
71
+ | socialProofSensitivity | 0.5 | Influenced by trusted sources but less by general popularity |
72
+
73
+ ## Behavioral Patterns
74
+
75
+ ### Navigation
76
+ Elderly users prefer clear, consistent navigation with obvious labels. They favor linear flows over complex hierarchies. Scrolling may be preferred over clicking through multiple pages. Font size and contrast significantly impact navigation success. Hover states should persist longer and touch targets should be generous.
77
+
78
+ ### Decision Making
79
+ Decisions are careful and deliberate. Elderly users read all options before choosing and prefer fewer, clearer choices over extensive options. They value explanations of consequences and appreciate time to consider without pressure.
80
+
81
+ ### Error Recovery
82
+ Errors can be particularly distressing, especially if they fear making the situation worse. Clear, calm error messages are essential. Explicit recovery steps with no assumptions about user knowledge work best. Phone support or chat may be preferred for complex issues.
83
+
84
+ ### Abandonment Triggers
85
+ - Small text or low contrast
86
+ - Time-limited interactions
87
+ - Unclear or jargon-heavy instructions
88
+ - Fear of making irreversible mistakes
89
+ - No obvious way to get help
90
+ - Security warnings that seem threatening
91
+
92
+ ## UX Recommendations
93
+
94
+ | Challenge | Recommendation |
95
+ |-----------|----------------|
96
+ | Reduced working memory | Minimize steps; show progress; provide external memory aids |
97
+ | Processing speed | Allow ample time; avoid timeouts; show loading states |
98
+ | Cautious behavior | Explicit undo; preview actions; confirmation without being patronizing |
99
+ | Vision changes | Large text options; high contrast; avoid reliance on color alone |
100
+ | Motor control changes | Large click targets; forgive imprecise clicks; avoid hover-dependent interactions |
101
+ | Technology self-efficacy | Encouraging feedback; celebrate successes; normalize difficulty |
102
+
103
+ ## Research Basis
104
+
105
+ - Czaja, S.J. & Lee, C.C. (2007). Information Technology and Older Adults - Comprehensive review of age-related changes
106
+ - Hawthorn, D. (2000). Possible implications of aging for interface designers - Specific design recommendations
107
+ - Pak, R. & McLaughlin, A. (2010). Designing Displays for Older Adults - Evidence-based guidelines
108
+ - Fisk, A.D. et al. (2009). Designing for Older Adults: Principles and Creative Human Factors Approaches
109
+ - AARP/MIT AgeLab research on digital experiences for older adults
110
+
111
+ ## Usage
112
+
113
+ ```typescript
114
+ await cognitive_journey_init({
115
+ persona: "elderly-user",
116
+ goal: "complete checkout",
117
+ startUrl: "https://example.com"
118
+ });
119
+ ```
120
+
121
+ ```bash
122
+ npx cbrowser cognitive-journey --persona elderly-user --start https://example.com --goal "complete checkout"
123
+ ```
124
+
125
+ ## See Also
126
+
127
+ - [Persona Index](Persona-Index)
128
+ - [Trait Index](../traits/Trait-Index)
129
+ - [Patience](../traits/Trait-Patience.md)
130
+ - [Working Memory](../traits/Trait-WorkingMemory.md)
131
+ - [Reading Tendency](../traits/Trait-ReadingTendency.md)
@@ -0,0 +1,131 @@
1
+ # First-Timer
2
+
3
+ **Category**: General Users
4
+ **Description**: Users encountering an application or interface type for the first time, characterized by high curiosity but limited domain knowledge
5
+
6
+ ## Overview
7
+
8
+ 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.
9
+
10
+ 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.
11
+
12
+ 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.
13
+
14
+ ## Trait Profile
15
+
16
+ All values on 0.0-1.0 scale.
17
+
18
+ ### Core Traits (Tier 1)
19
+
20
+ | Trait | Value | Rationale |
21
+ |-------|-------|-----------|
22
+ | patience | 0.7 | Willing to invest time learning new systems; expect some initial friction |
23
+ | riskTolerance | 0.3 | Hesitant to click unfamiliar buttons or commit to actions with unclear consequences |
24
+ | comprehension | 0.3 | Limited domain knowledge means slower processing of jargon and conventions |
25
+ | persistence | 0.5 | Will try multiple times but have lower frustration threshold than experienced users |
26
+ | curiosity | 0.9 | High intrinsic motivation to explore and understand the new environment |
27
+ | workingMemory | 0.5 | Average capacity, but heavily taxed by unfamiliar terminology and concepts |
28
+ | readingTendency | 0.6 | Read more carefully than average; actively seek understanding |
29
+
30
+ ### Emotional Traits (Tier 2)
31
+
32
+ | Trait | Value | Rationale |
33
+ |-------|-------|-----------|
34
+ | resilience | 0.4 | Vulnerable to discouragement; initial failures feel more significant |
35
+ | selfEfficacy | 0.4 | Uncertainty about ability to succeed in unfamiliar environment |
36
+ | trustCalibration | 0.5 | Neither overly trusting nor skeptical; forming initial impressions |
37
+ | interruptRecovery | 0.4 | Struggle to recover context after interruptions; mental models still forming |
38
+
39
+ ### Decision-Making Traits (Tier 3)
40
+
41
+ | Trait | Value | Rationale |
42
+ |-------|-------|-----------|
43
+ | satisficing | 0.6 | Accept reasonable options rather than optimizing; unsure what "best" means here |
44
+ | informationForaging | 0.4 | Inefficient information seeking; don't know where to look |
45
+ | anchoringBias | 0.7 | First impressions heavily influence subsequent expectations and interpretations |
46
+ | timeHorizon | 0.4 | Focus on immediate task completion; not yet thinking about long-term usage |
47
+ | attributionStyle | 0.4 | Tend to blame self for difficulties rather than recognizing system issues |
48
+
49
+ ### Planning Traits (Tier 4)
50
+
51
+ | Trait | Value | Rationale |
52
+ |-------|-------|-----------|
53
+ | metacognitivePlanning | 0.3 | Limited ability to strategize in unfamiliar domain; reactive approach |
54
+ | proceduralFluency | 0.2 | No automated procedures; every action requires conscious effort |
55
+ | transferLearning | 0.5 | Can apply general web conventions but may miss domain-specific patterns |
56
+
57
+ ### Perception Traits (Tier 5)
58
+
59
+ | Trait | Value | Rationale |
60
+ |-------|-------|-----------|
61
+ | changeBlindness | 0.6 | May miss important updates; still learning where to look |
62
+ | mentalModelRigidity | 0.3 | Mental models are flexible because they're still forming |
63
+
64
+ ### Social Traits (Tier 6)
65
+
66
+ | Trait | Value | Rationale |
67
+ |-------|-------|-----------|
68
+ | authoritySensitivity | 0.7 | Look to interface guidance and authority signals for direction |
69
+ | emotionalContagion | 0.6 | Influenced by perceived emotional tone of interface and help content |
70
+ | fomo | 0.5 | Moderate concern about missing features; still discovering what's possible |
71
+ | socialProofSensitivity | 0.7 | Look for evidence that others use and value the service |
72
+
73
+ ## Behavioral Patterns
74
+
75
+ ### Navigation
76
+ 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.
77
+
78
+ ### Decision Making
79
+ 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.
80
+
81
+ ### Error Recovery
82
+ 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.
83
+
84
+ ### Abandonment Triggers
85
+ - Jargon-heavy content without explanations
86
+ - Required account creation before value is demonstrated
87
+ - Unclear next steps or missing call-to-action
88
+ - Errors without clear recovery path
89
+ - Overwhelming options without guidance
90
+ - Feeling judged or embarrassed
91
+
92
+ ## UX Recommendations
93
+
94
+ | Challenge | Recommendation |
95
+ |-----------|----------------|
96
+ | Limited domain knowledge | Provide contextual help and tooltips; explain jargon on first use |
97
+ | Hesitation about commitments | Clear undo capabilities; preview of action consequences |
98
+ | Forming initial impressions | Invest heavily in first-time UX; quick wins build confidence |
99
+ | Self-blame for failures | Non-judgmental error messages; emphasize system responsibility |
100
+ | Seeking validation | Show social proof; testimonials; user counts; success stories |
101
+ | Navigation uncertainty | Strong wayfinding; breadcrumbs; clear current-location indicators |
102
+
103
+ ## Research Basis
104
+
105
+ - Carroll, J.M. & Rosson, M.B. (1987). Paradox of the Active User - Why users don't read
106
+ - Krug, S. (2014). Don't Make Me Think - First-time user navigation patterns
107
+ - Kim, J. et al. (2016). First-time user retention research at Dropbox
108
+ - Saffer, D. (2010). Designing for Interaction - Onboarding principles
109
+ - Garrett, J.J. (2011). Elements of User Experience - User learning curves
110
+
111
+ ## Usage
112
+
113
+ ```typescript
114
+ await cognitive_journey_init({
115
+ persona: "first-timer",
116
+ goal: "complete checkout",
117
+ startUrl: "https://example.com"
118
+ });
119
+ ```
120
+
121
+ ```bash
122
+ npx cbrowser cognitive-journey --persona first-timer --start https://example.com --goal "complete checkout"
123
+ ```
124
+
125
+ ## See Also
126
+
127
+ - [Persona Index](Persona-Index)
128
+ - [Trait Index](../traits/Trait-Index)
129
+ - [Curiosity](../traits/Trait-Curiosity.md)
130
+ - [Comprehension](../traits/Trait-Comprehension.md)
131
+ - [Risk Tolerance](../traits/Trait-RiskTolerance.md)
@@ -0,0 +1,132 @@
1
+ # Impatient User
2
+
3
+ **Category**: General Users
4
+ **Description**: Users characterized by extremely low tolerance for delays, friction, or obstacles in completing their goals
5
+
6
+ ## Overview
7
+
8
+ 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.
9
+
10
+ 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.
11
+
12
+ 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.
13
+
14
+ ## Trait Profile
15
+
16
+ All values on 0.0-1.0 scale.
17
+
18
+ ### Core Traits (Tier 1)
19
+
20
+ | Trait | Value | Rationale |
21
+ |-------|-------|-----------|
22
+ | patience | 0.1 | Defining characteristic; extremely low tolerance for any perceived delay |
23
+ | riskTolerance | 0.6 | Willing to take shortcuts and skip safety measures to save time |
24
+ | comprehension | 0.6 | Capable of understanding but unwilling to invest time in reading |
25
+ | persistence | 0.2 | Extremely quick to abandon; try alternatives rather than persist |
26
+ | curiosity | 0.3 | No interest in exploration; purely goal-focused |
27
+ | workingMemory | 0.6 | Adequate capacity but impatience prevents full utilization |
28
+ | readingTendency | 0.1 | Minimal reading; scan for actionable elements only |
29
+
30
+ ### Emotional Traits (Tier 2)
31
+
32
+ | Trait | Value | Rationale |
33
+ |-------|-------|-----------|
34
+ | resilience | 0.3 | Low tolerance for setbacks; frustration escalates quickly |
35
+ | selfEfficacy | 0.6 | Confident but attributes delays to system rather than self |
36
+ | trustCalibration | 0.4 | May proceed despite warnings to save time |
37
+ | interruptRecovery | 0.5 | Moderate; interruptions are frustrating but may welcome escape from slow process |
38
+
39
+ ### Decision-Making Traits (Tier 3)
40
+
41
+ | Trait | Value | Rationale |
42
+ |-------|-------|-----------|
43
+ | satisficing | 0.9 | Accept first available option; no comparison shopping |
44
+ | informationForaging | 0.4 | Brief scans; abandon quickly if information not obvious |
45
+ | anchoringBias | 0.6 | First option heavily favored due to reluctance to explore |
46
+ | timeHorizon | 0.2 | Extreme focus on immediate completion; future consequences ignored |
47
+ | attributionStyle | 0.3 | Blame system for any delays; low self-attribution |
48
+
49
+ ### Planning Traits (Tier 4)
50
+
51
+ | Trait | Value | Rationale |
52
+ |-------|-------|-----------|
53
+ | metacognitivePlanning | 0.3 | Action-oriented; minimal planning |
54
+ | proceduralFluency | 0.6 | Expect common patterns; frustrated by novel interactions |
55
+ | transferLearning | 0.5 | Apply familiar patterns but won't invest in learning new ones |
56
+
57
+ ### Perception Traits (Tier 5)
58
+
59
+ | Trait | Value | Rationale |
60
+ |-------|-------|-----------|
61
+ | changeBlindness | 0.7 | Miss changes while focused on finding CTAs |
62
+ | mentalModelRigidity | 0.6 | Expect things to work in familiar ways |
63
+
64
+ ### Social Traits (Tier 6)
65
+
66
+ | Trait | Value | Rationale |
67
+ |-------|-------|-----------|
68
+ | authoritySensitivity | 0.4 | Ignore recommendations that slow progress |
69
+ | emotionalContagion | 0.4 | Moderate; frustration internally driven |
70
+ | fomo | 0.8 | High urgency; feel they're wasting time on current task |
71
+ | socialProofSensitivity | 0.4 | Ignore reviews if they require reading |
72
+
73
+ ## Behavioral Patterns
74
+
75
+ ### Navigation
76
+ 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.
77
+
78
+ ### Decision Making
79
+ First visible option is selected unless obviously wrong. No comparison of alternatives. Defaults are accepted without consideration. Any friction at decision point causes abandonment.
80
+
81
+ ### Error Recovery
82
+ Errors cause immediate frustration and often abandonment. Retry only if instant; otherwise seek alternatives (competitors, phone support, abandon entirely). Error messages are barely read.
83
+
84
+ ### Abandonment Triggers
85
+ - Any delay over 2 seconds
86
+ - Required reading of more than 2 sentences
87
+ - Multi-step processes without clear progress
88
+ - Required account creation
89
+ - Captchas or verification steps
90
+ - Unclear next action
91
+ - Any modal or interstitial
92
+
93
+ ## UX Recommendations
94
+
95
+ | Challenge | Recommendation |
96
+ |-----------|----------------|
97
+ | Extreme impatience | Sub-second interactions; skeleton loading; optimistic updates |
98
+ | No reading | Single-word CTAs; icon-based communication; visual hierarchy |
99
+ | Quick abandonment | One-click paths; guest checkout; express options |
100
+ | Shortcut-seeking | Provide the shortcuts; don't force thoroughness |
101
+ | Error intolerance | Prevent errors through smart defaults; instant inline validation |
102
+ | First-option bias | Ensure first option is genuinely good; don't bury best options |
103
+
104
+ ## Research Basis
105
+
106
+ - Nielsen, J. (1993). Response Times: 3 Important Limits - Sub-second expectations
107
+ - Galletta, D. et al. (2006). Impact of delay on web user interaction and abandonment
108
+ - Akamai (2017). Page load time impact on conversion rates
109
+ - Perfetti, C. & Landesman, L. (2001). Eight principles of user frustration - UIE research
110
+ - Kohavi, R. et al. (2014). Online experimentation at Microsoft - Latency impact studies
111
+
112
+ ## Usage
113
+
114
+ ```typescript
115
+ await cognitive_journey_init({
116
+ persona: "impatient-user",
117
+ goal: "complete checkout",
118
+ startUrl: "https://example.com"
119
+ });
120
+ ```
121
+
122
+ ```bash
123
+ npx cbrowser cognitive-journey --persona impatient-user --start https://example.com --goal "complete checkout"
124
+ ```
125
+
126
+ ## See Also
127
+
128
+ - [Persona Index](Persona-Index)
129
+ - [Trait Index](../traits/Trait-Index)
130
+ - [Patience](../traits/Trait-Patience.md)
131
+ - [FOMO](../traits/Trait-FOMO.md)
132
+ - [Persistence](../traits/Trait-Persistence.md)
@@ -0,0 +1,170 @@
1
+ # Persona Index
2
+
3
+ > **Copyright**: (c) 2026 WF Media (Alexandria Eden). All rights reserved.
4
+ >
5
+ > **License**: [Business Source License 1.1](https://github.com/alexandriashai/cbrowser/blob/main/LICENSE) - Converts to Apache 2.0 on February 5, 2030.
6
+ >
7
+ > **Contact**: alexandria.shai.eden@gmail.com
8
+
9
+ 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.
10
+
11
+ ## Available Personas
12
+
13
+ | Persona | Description | Key Characteristics |
14
+ |---------|-------------|---------------------|
15
+ | [Power User](Persona-PowerUser) | Tech-savvy expert | High comprehension, low patience, rapid scanning |
16
+ | [First Timer](Persona-FirstTimer) | New to the interface | Low comprehension, high curiosity, methodical |
17
+ | [Elderly User](Persona-ElderlyUser) | Older adult (65+) | Low working memory, high reading tendency |
18
+ | [Mobile User](Persona-MobileUser) | Smartphone-first | Low patience, high satisficing, touch-focused |
19
+ | [Impatient User](Persona-ImpatientUser) | Quick to abandon | Very low patience, high FOMO |
20
+ | [Screen Reader User](Persona-ScreenReaderUser) | Assistive technology | High persistence, sequential navigation |
21
+ | [Motor Tremor](Persona-MotorTremor) | Motor impairment | Low risk tolerance, high patience |
22
+ | [Low Vision](Persona-LowVision) | Vision impairment | High reading tendency, low change blindness |
23
+ | [ADHD](Persona-ADHD) | Attention differences | Low working memory, high curiosity, low patience |
24
+
25
+ ---
26
+
27
+ ## Persona Trait Profiles
28
+
29
+ ### Quick Reference Table
30
+
31
+ All values on 0.0-1.0 scale. Higher = more of the trait.
32
+
33
+ | Trait | Power | First | Elderly | Mobile | Impatient | Screen | Motor | Low Vision | ADHD |
34
+ |-------|-------|-------|---------|--------|-----------|--------|-------|------------|------|
35
+ | patience | 0.3 | 0.7 | 0.8 | 0.3 | 0.1 | 0.9 | 0.9 | 0.7 | 0.2 |
36
+ | riskTolerance | 0.8 | 0.3 | 0.2 | 0.5 | 0.6 | 0.2 | 0.2 | 0.3 | 0.7 |
37
+ | comprehension | 0.9 | 0.3 | 0.5 | 0.6 | 0.6 | 0.8 | 0.7 | 0.6 | 0.5 |
38
+ | persistence | 0.7 | 0.5 | 0.6 | 0.4 | 0.2 | 0.9 | 0.8 | 0.8 | 0.3 |
39
+ | curiosity | 0.8 | 0.9 | 0.4 | 0.5 | 0.3 | 0.5 | 0.4 | 0.5 | 0.9 |
40
+ | workingMemory | 0.9 | 0.5 | 0.4 | 0.5 | 0.6 | 0.7 | 0.7 | 0.6 | 0.3 |
41
+ | readingTendency | 0.2 | 0.6 | 0.8 | 0.2 | 0.1 | 0.9 | 0.7 | 0.9 | 0.2 |
42
+
43
+ ---
44
+
45
+ ## Persona Categories
46
+
47
+ ### General Users
48
+
49
+ - **[Power User](Persona-PowerUser)** - Experienced users who know shortcuts, scan quickly, and expect responsive interfaces
50
+ - **[First Timer](Persona-FirstTimer)** - New users learning the interface, more exploratory and methodical
51
+ - **[Mobile User](Persona-MobileUser)** - Users on smartphones with touch interaction and attention constraints
52
+ - **[Impatient User](Persona-ImpatientUser)** - Users with very low tolerance for friction, quick to abandon
53
+
54
+ ### Accessibility Personas
55
+
56
+ - **[Elderly User](Persona-ElderlyUser)** - Older adults with age-related cognitive changes
57
+ - **[Screen Reader User](Persona-ScreenReaderUser)** - Users navigating via screen reader technology
58
+ - **[Motor Tremor](Persona-MotorTremor)** - Users with motor impairments affecting precision
59
+ - **[Low Vision](Persona-LowVision)** - Users with significant vision impairment
60
+ - **[ADHD](Persona-ADHD)** - Users with attention differences
61
+
62
+ ---
63
+
64
+ ## Using Personas
65
+
66
+ ### Via MCP Tool
67
+
68
+ ```typescript
69
+ await cognitive_journey_init({
70
+ persona: "elderly-user",
71
+ goal: "complete checkout",
72
+ startUrl: "https://example.com/shop"
73
+ });
74
+ ```
75
+
76
+ ### Via CLI
77
+
78
+ ```bash
79
+ npx cbrowser cognitive-journey \
80
+ --persona elderly-user \
81
+ --start https://example.com/shop \
82
+ --goal "complete checkout"
83
+ ```
84
+
85
+ ### Custom Traits
86
+
87
+ Override any trait for a built-in persona:
88
+
89
+ ```typescript
90
+ await cognitive_journey_init({
91
+ persona: "power-user",
92
+ goal: "find settings",
93
+ startUrl: "https://example.com",
94
+ customTraits: {
95
+ patience: 0.1 // Even more impatient power user
96
+ }
97
+ });
98
+ ```
99
+
100
+ ---
101
+
102
+ ## Research Basis
103
+
104
+ Persona trait values are derived from peer-reviewed research:
105
+
106
+ | Persona | Primary Research Sources |
107
+ |---------|-------------------------|
108
+ | Power User | Nielsen (2006) expert user studies |
109
+ | First Timer | Card et al. (1983) novice-expert differences |
110
+ | Elderly User | Czaja & Lee (2007) aging and technology |
111
+ | Mobile User | Adipat et al. (2011) mobile usability |
112
+ | Screen Reader | Lazar et al. (2007) assistive technology |
113
+ | Motor Tremor | Trewin & Pain (1999) motor impairment HCI |
114
+ | Low Vision | Jacko et al. (2000) low vision computing |
115
+ | ADHD | Goodman et al. (2007) ADHD and web use |
116
+
117
+ ---
118
+
119
+ ## Trait Interactions
120
+
121
+ When personas encounter challenges, their trait combinations produce characteristic behaviors:
122
+
123
+ | Persona | Typical Response to Friction |
124
+ |---------|------------------------------|
125
+ | Power User | Tries keyboard shortcuts, abandons quickly if blocked |
126
+ | First Timer | Reads help text, tries multiple options systematically |
127
+ | Elderly User | Re-reads content, may call for help, patient retries |
128
+ | Mobile User | Taps repeatedly, tries swiping, abandons if >2 taps needed |
129
+ | Impatient User | Immediate abandonment, high frustration expression |
130
+ | Screen Reader | Navigates to next element, uses landmarks, persists |
131
+ | Motor Tremor | Careful targeting, uses larger targets, avoids hover |
132
+ | Low Vision | Zooms in, traces text carefully, uses high contrast |
133
+ | ADHD | Distracted by other elements, forgets original goal |
134
+
135
+ ---
136
+
137
+ ## Creating Custom Personas
138
+
139
+ Use the questionnaire or define traits directly:
140
+
141
+ ```typescript
142
+ // Via questionnaire (generates trait profile)
143
+ await runPersonaQuestionnaire();
144
+
145
+ // Direct definition
146
+ const customPersona = {
147
+ patience: 0.4,
148
+ riskTolerance: 0.6,
149
+ comprehension: 0.7,
150
+ persistence: 0.5,
151
+ curiosity: 0.8,
152
+ workingMemory: 0.6,
153
+ readingTendency: 0.3
154
+ };
155
+ ```
156
+
157
+ ---
158
+
159
+ ## See Also
160
+
161
+ - [Trait Index](../traits/Trait-Index) - All 25 cognitive traits explained
162
+ - [Cognitive User Simulation](../Cognitive-User-Simulation) - Main documentation
163
+ - [Persona Questionnaire](../Persona-Questionnaire) - Generate custom personas
164
+ - [Multi-Persona Comparison](../Multi-Persona-Comparison) - Compare across personas
165
+
166
+ ---
167
+
168
+ ## Bibliography
169
+
170
+ See [Complete Bibliography](../research/Bibliography) for all academic sources used in persona development.