cbrowser 18.62.0 → 18.63.1

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 (90) hide show
  1. package/README.md +32 -7
  2. package/dist/analysis/accessibility-empathy.d.ts.map +1 -1
  3. package/dist/analysis/accessibility-empathy.js +85 -22
  4. package/dist/analysis/accessibility-empathy.js.map +1 -1
  5. package/dist/mcp-server-remote.d.ts.map +1 -1
  6. package/dist/mcp-server-remote.js +89 -1
  7. package/dist/mcp-server-remote.js.map +1 -1
  8. package/dist/mcp-tools/base/audit-tools.d.ts.map +1 -1
  9. package/dist/mcp-tools/base/audit-tools.js +40 -2
  10. package/dist/mcp-tools/base/audit-tools.js.map +1 -1
  11. package/dist/mcp-tools/base/persona-comparison-tools.d.ts.map +1 -1
  12. package/dist/mcp-tools/base/persona-comparison-tools.js +33 -4
  13. package/dist/mcp-tools/base/persona-comparison-tools.js.map +1 -1
  14. package/dist/mcp-tools/base/site-knowledge-tools.js +1 -1
  15. package/dist/mcp-tools/base/site-knowledge-tools.js.map +1 -1
  16. package/dist/mcp-tools/index.d.ts +1 -1
  17. package/dist/mcp-tools/index.d.ts.map +1 -1
  18. package/dist/mcp-tools/index.js +1 -1
  19. package/dist/mcp-tools/index.js.map +1 -1
  20. package/package.json +1 -1
  21. package/docs/ASSESSMENT.md +0 -132
  22. package/docs/AUTH0-SETUP.md +0 -207
  23. package/docs/COGNITIVE-OPTIMAL-TRANSPORT-RESEARCH.md +0 -238
  24. package/docs/DEMO-DEPLOYMENT.md +0 -177
  25. package/docs/ENTERPRISE-INTEGRATION.md +0 -250
  26. package/docs/GETTING-STARTED.md +0 -232
  27. package/docs/INSTALL.md +0 -274
  28. package/docs/MCP-INTEGRATION.md +0 -301
  29. package/docs/METHODOLOGY.md +0 -276
  30. package/docs/PERSONA-QUESTIONNAIRE.md +0 -328
  31. package/docs/README.md +0 -45
  32. package/docs/REMOTE-MCP-SERVER.md +0 -569
  33. package/docs/SECURITY_WHITEPAPER.md +0 -475
  34. package/docs/STRESS-TEST-v16.14.4.md +0 -241
  35. package/docs/Tool-Cognitive-Journey-Autonomous.md +0 -270
  36. package/docs/Tool-Competitive-Benchmark.md +0 -293
  37. package/docs/Tool-Empathy-Audit.md +0 -331
  38. package/docs/Tool-Hunt-Bugs.md +0 -305
  39. package/docs/Tool-Marketing-Campaign.md +0 -298
  40. package/docs/Tool-Persona-Create.md +0 -274
  41. package/docs/Tools-Accessibility.md +0 -208
  42. package/docs/Tools-Browser-Automation.md +0 -311
  43. package/docs/Tools-Cognitive-Journeys.md +0 -233
  44. package/docs/Tools-Marketing-Intelligence.md +0 -271
  45. package/docs/Tools-Overview.md +0 -162
  46. package/docs/Tools-Persona-System.md +0 -300
  47. package/docs/Tools-Session-State.md +0 -278
  48. package/docs/Tools-Testing-Quality.md +0 -257
  49. package/docs/Tools-Utilities.md +0 -182
  50. package/docs/Tools-Visual-Performance.md +0 -278
  51. package/docs/hunt-bugs-coverage.md +0 -103
  52. package/docs/personas/Persona-ADHD.md +0 -141
  53. package/docs/personas/Persona-ElderlyUser.md +0 -137
  54. package/docs/personas/Persona-FirstTimer.md +0 -137
  55. package/docs/personas/Persona-ImpatientUser.md +0 -138
  56. package/docs/personas/Persona-Index.md +0 -302
  57. package/docs/personas/Persona-LowVision.md +0 -139
  58. package/docs/personas/Persona-MobileUser.md +0 -139
  59. package/docs/personas/Persona-MotorTremor.md +0 -139
  60. package/docs/personas/Persona-PowerUser.md +0 -135
  61. package/docs/personas/Persona-ScreenReaderUser.md +0 -139
  62. package/docs/research/Bibliography.md +0 -275
  63. package/docs/research/Research-Methodology.md +0 -244
  64. package/docs/research/Values-Research.md +0 -432
  65. package/docs/traits/Trait-AnchoringBias.md +0 -227
  66. package/docs/traits/Trait-AttributionStyle.md +0 -280
  67. package/docs/traits/Trait-AuthoritySensitivity.md +0 -141
  68. package/docs/traits/Trait-ChangeBlindness.md +0 -171
  69. package/docs/traits/Trait-Comprehension.md +0 -180
  70. package/docs/traits/Trait-Curiosity.md +0 -189
  71. package/docs/traits/Trait-EmotionalContagion.md +0 -144
  72. package/docs/traits/Trait-FOMO.md +0 -150
  73. package/docs/traits/Trait-Index.md +0 -166
  74. package/docs/traits/Trait-InformationForaging.md +0 -217
  75. package/docs/traits/Trait-InterruptRecovery.md +0 -249
  76. package/docs/traits/Trait-MentalModelRigidity.md +0 -228
  77. package/docs/traits/Trait-MetacognitivePlanning.md +0 -164
  78. package/docs/traits/Trait-Patience.md +0 -137
  79. package/docs/traits/Trait-Persistence.md +0 -165
  80. package/docs/traits/Trait-ProceduralFluency.md +0 -205
  81. package/docs/traits/Trait-ReadingTendency.md +0 -216
  82. package/docs/traits/Trait-Resilience.md +0 -162
  83. package/docs/traits/Trait-RiskTolerance.md +0 -162
  84. package/docs/traits/Trait-Satisficing.md +0 -181
  85. package/docs/traits/Trait-SelfEfficacy.md +0 -199
  86. package/docs/traits/Trait-SocialProofSensitivity.md +0 -155
  87. package/docs/traits/Trait-TimeHorizon.md +0 -267
  88. package/docs/traits/Trait-TransferLearning.md +0 -249
  89. package/docs/traits/Trait-TrustCalibration.md +0 -227
  90. package/docs/traits/Trait-WorkingMemory.md +0 -192
@@ -1,103 +0,0 @@
1
- # Hunt Bugs Detection Coverage
2
-
3
- CBrowser's `hunt_bugs` tool detects accessibility and usability issues across web pages. This document describes the detection categories, their WCAG mappings, and expected results.
4
-
5
- ## Detection Categories
6
-
7
- ### Core Accessibility Issues (6 original)
8
-
9
- | Issue Type | Description | WCAG Criterion | Severity |
10
- |------------|-------------|----------------|----------|
11
- | **broken-image** | Images with failed `src` or missing source | N/A | medium |
12
- | **missing-alt** | Images lacking `alt` attribute | 1.1.1 Non-text Content | high |
13
- | **empty-link** | Links with no text content or `aria-label` | 2.4.4 Link Purpose | medium |
14
- | **no-button-text** | Buttons without accessible text | 4.1.2 Name, Role, Value | high |
15
- | **missing-label** | Form inputs without associated `<label>` | 1.3.1 Info and Relationships | high |
16
- | **no-keyboard-access** | Elements with `onclick` but not keyboard-accessible | 2.1.1 Keyboard | high |
17
-
18
- ### Expanded Detection Categories (8 new in v18.14.0)
19
-
20
- | Issue Type | Description | WCAG Criterion | Severity |
21
- |------------|-------------|----------------|----------|
22
- | **contrast-violation** | Text with insufficient color contrast | 1.4.3 Contrast (Minimum) | high |
23
- | **missing-aria** | Elements with ARIA role missing required attributes | 4.1.2 Name, Role, Value | medium |
24
- | **duplicate-id** | Multiple elements sharing the same `id` attribute | 4.1.1 Parsing | medium |
25
- | **missing-page-title** | Document with empty or missing `<title>` | 2.4.2 Page Titled | low |
26
- | **missing-lang** | HTML element without `lang` attribute | 3.1.1 Language of Page | low |
27
- | **keyboard-trap** | Elements that trap keyboard focus | 2.1.2 No Keyboard Trap | critical |
28
- | **autoplay-media** | Video/audio elements with `autoplay` | 1.4.2 Audio Control | medium |
29
- | **missing-skip-link** | Pages without skip-to-content navigation | 2.4.1 Bypass Blocks | low |
30
-
31
- ## Severity Mapping
32
-
33
- | Severity | Impact | Action Required |
34
- |----------|--------|-----------------|
35
- | **critical** | Blocks users entirely | Fix immediately |
36
- | **high** | Significantly impairs accessibility | Fix before release |
37
- | **medium** | Creates friction for assistive tech users | Fix in next sprint |
38
- | **low** | Minor issue or best practice | Fix when convenient |
39
-
40
- ## Example Output
41
-
42
- ```json
43
- {
44
- "url": "https://example.com",
45
- "pagesScanned": 5,
46
- "issuesFound": 23,
47
- "categories": {
48
- "missing-alt": 8,
49
- "missing-label": 6,
50
- "contrast-violation": 4,
51
- "empty-link": 3,
52
- "missing-skip-link": 2
53
- },
54
- "bySeverity": {
55
- "high": 14,
56
- "medium": 7,
57
- "low": 2
58
- },
59
- "recommendations": [
60
- "Add alt text to all 8 images",
61
- "Associate labels with all form inputs",
62
- "Improve contrast ratio on 4 text elements",
63
- "Add skip-to-content link"
64
- ]
65
- }
66
- ```
67
-
68
- ## Usage
69
-
70
- ```bash
71
- # Scan homepage only
72
- npx cbrowser hunt-bugs https://example.com
73
-
74
- # Scan multiple pages
75
- npx cbrowser hunt-bugs https://example.com --max-pages 10
76
-
77
- # Output as JSON
78
- npx cbrowser hunt-bugs https://example.com --output report.json
79
-
80
- # Output as HTML
81
- npx cbrowser hunt-bugs https://example.com --html
82
- ```
83
-
84
- ## Known Test Sites
85
-
86
- For validating detection coverage, these sites have intentional accessibility issues:
87
-
88
- | Site | Purpose | Expected Issues |
89
- |------|---------|-----------------|
90
- | [a11y-challenges.com](https://a11y-challenges.com) | Intentionally broken for testing | Multiple categories |
91
- | [dequeuniversity.com/demo/mars](https://dequeuniversity.com/demo/mars) | Accessible example | Few/no issues |
92
- | [webaim.org/standards/wcag/checklist](https://webaim.org/standards/wcag/checklist) | WCAG reference | Minimal issues |
93
-
94
- ## Comparison to Other Tools
95
-
96
- | Tool | Categories | Cognitive Persona Testing | Self-Healing |
97
- |------|------------|---------------------------|--------------|
98
- | **CBrowser hunt_bugs** | 14 | ✅ (via empathy_audit) | ✅ |
99
- | axe-core | 100+ | ❌ | ❌ |
100
- | Lighthouse A11y | ~40 | ❌ | ❌ |
101
- | WAVE | ~50 | ❌ | ❌ |
102
-
103
- CBrowser focuses on the most impactful issues while providing unique persona-based testing through `empathy_audit`. For comprehensive WCAG compliance, combine with axe-core.
@@ -1,141 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Cognitive ADHD User](https://cbrowser.ai/docs/Persona-ADHD)**
4
-
5
- ---
6
-
7
- # Cognitive ADHD User
8
-
9
- **Category**: Accessibility Personas
10
- **Description**: Users with Attention Deficit Hyperactivity Disorder experiencing challenges with sustained attention, working memory, and impulse control
11
-
12
- ## Overview
13
-
14
- ADHD (Attention Deficit Hyperactivity Disorder) is a neurodevelopmental condition affecting executive function, attention regulation, and impulse control. Users with ADHD experience the digital world differently - they may hyperfocus on engaging content while struggling to complete routine tasks, get distracted by notifications and visual clutter, and have difficulty with multi-step processes that tax working memory.
15
-
16
- ADHD users often possess significant strengths alongside their challenges. High curiosity and creativity can lead to innovative problem-solving. The ability to hyperfocus on interesting tasks can result in deep engagement. However, interfaces that don't account for ADHD patterns can create significant barriers through distraction, cognitive overload, and friction in task completion.
17
-
18
- Designing for ADHD benefits many users by reducing cognitive load, minimizing distractions, and creating clearer paths to task completion. The strategies that help ADHD users - clear structure, reduced clutter, engaging feedback, and forgiveness for errors - improve the experience for everyone.
19
-
20
- ## Trait Profile
21
-
22
- All values on 0.0-1.0 scale.
23
-
24
- ### Core Traits (Tier 1)
25
-
26
- | Trait | Value | Rationale |
27
- |-------|-------|-----------|
28
- | patience | 0.2 | Difficulty sustaining attention during delays; fidgeting and frustration with waiting |
29
- | riskTolerance | 0.7 | Impulsivity leads to action before full consideration of consequences |
30
- | comprehension | 0.6 | Capable when engaged; inconsistent when attention wanders |
31
- | persistence | 0.3 | Low for unengaging tasks; can hyperfocus on interesting challenges |
32
- | curiosity | 0.9 | High novelty-seeking; drawn to new and interesting content |
33
- | workingMemory | 0.3 | Significant challenge; difficulty holding multiple items in mind |
34
- | readingTendency | 0.2 | Skim or skip text; prefer visual and interactive content |
35
-
36
- ### Emotional Traits (Tier 2)
37
-
38
- | Trait | Value | Rationale |
39
- |-------|-------|-----------|
40
- | resilience | 0.4 | Emotional dysregulation common; frustration and discouragement |
41
- | selfEfficacy | 0.4 | May have experienced repeated failures; internalized self-doubt |
42
- | trustCalibration | 0.5 | Moderate; may act impulsively before evaluating trustworthiness |
43
- | interruptRecovery | 0.3 | Extremely difficult to resume after distraction; may abandon |
44
-
45
- ### Decision-Making Traits (Tier 3)
46
-
47
- | Trait | Value | Rationale |
48
- |-------|-------|-----------|
49
- | satisficing | 0.7 | Accept good-enough options to reduce decision fatigue |
50
- | informationForaging | 0.4 | Distractible; may go down tangential paths |
51
- | anchoringBias | 0.6 | First option favored due to decision fatigue avoidance |
52
- | timeHorizon | 0.3 | Strong preference for immediate rewards; difficulty with delayed gratification |
53
- | attributionStyle | 0.3 | May blame self; history of perceived failures |
54
-
55
- ### Planning Traits (Tier 4)
56
-
57
- | Trait | Value | Rationale |
58
- |-------|-------|-----------|
59
- | metacognitivePlanning | 0.3 | Difficulty with planning and organization; reactive approach |
60
- | proceduralFluency | 0.4 | Inconsistent; routines help but are difficult to establish |
61
- | transferLearning | 0.5 | Variable; depends on engagement level |
62
-
63
- ### Perception Traits (Tier 5)
64
-
65
- | Trait | Value | Rationale |
66
- |-------|-------|-----------|
67
- | changeBlindness | 0.6 | May miss changes when attention elsewhere; hyperfocus can cause tunnel vision |
68
- | mentalModelRigidity | 0.4 | Flexible thinking; sometimes too flexible (difficulty maintaining mental model) |
69
-
70
- ### Social Traits (Tier 6)
71
-
72
- | Trait | Value | Rationale |
73
- |-------|-------|-----------|
74
- | authoritySensitivity | 0.4 | May question or ignore authority recommendations impulsively |
75
- | emotionalContagion | 0.6 | Heightened emotional sensitivity |
76
- | fomo | 0.7 | Fear of missing out drives engagement with notifications, new features |
77
- | socialProofSensitivity | 0.5 | Moderate influence; depends on current focus |
78
-
79
- ## Behavioral Patterns
80
-
81
- ### Navigation
82
- ADHD users navigate impulsively, clicking interesting links before completing current tasks. They benefit from clear visual hierarchy that guides attention. They may open multiple tabs and lose track of original goal. Progress indicators and clear next steps help maintain task focus.
83
-
84
- ### Decision Making
85
- Decisions are often quick and impulsive. Choice overload causes decision paralysis or random selection. Reducing options and highlighting recommended choices helps. Immediate feedback on decisions maintains engagement.
86
-
87
- ### Error Recovery
88
- Errors are particularly frustrating and may cause abandonment. Clear, non-judgmental error messages are essential. Easy undo capabilities reduce consequences of impulsive actions. Autosave prevents loss of work during distraction.
89
-
90
- ### Abandonment Triggers
91
- - Lengthy forms without progress saving
92
- - Walls of text
93
- - Visual clutter and competing attention demands
94
- - Slow loading without engaging feedback
95
- - Multi-step processes requiring memory of previous steps
96
- - Punitive error handling
97
- - Boring or unstimulating interfaces
98
- - Too many choices
99
-
100
- ## UX Recommendations
101
-
102
- | Challenge | Recommendation |
103
- |-----------|----------------|
104
- | Low working memory | Progress indicators; save state frequently; reduce memory requirements |
105
- | Distractibility | Minimize visual clutter; clear focal points; hide non-essential elements |
106
- | Impulsivity | Gentle confirmation for important actions; easy undo; forgiving design |
107
- | Low persistence | Quick wins early; gamification elements; break tasks into small steps |
108
- | Reading difficulty | Scannable content; bullet points; visual communication |
109
- | Time blindness | Clear time estimates; progress indicators; gentle reminders |
110
- | Decision fatigue | Reduce choices; smart defaults; recommended options |
111
-
112
- ## Research Basis
113
-
114
- - Barkley, R.A. (2015). Attention-Deficit Hyperactivity Disorder: A Handbook - Executive function deficits
115
- - Hallowell, E.M. & Ratey, J.J. (2011). Driven to Distraction - ADHD experience and coping
116
- - Ramsay, J.R. (2017). Cognitive Behavioral Therapy for Adult ADHD - Working memory and attention
117
- - Understood.org research on ADHD and technology use
118
- - Brown, T.E. (2013). A New Understanding of ADHD - Executive function model
119
-
120
- ## Usage
121
-
122
- ```typescript
123
- await cognitive_journey_init({
124
- persona: "cognitive-adhd",
125
- goal: "complete checkout",
126
- startUrl: "https://example.com"
127
- });
128
- ```
129
-
130
- ```bash
131
- npx cbrowser cognitive-journey --persona cognitive-adhd --start https://example.com --goal "complete checkout"
132
- ```
133
-
134
- ## See Also
135
-
136
- - [Persona Index](./Persona-Index.md)
137
- - [Trait Index](../traits/Trait-Index.md)
138
- - [Working Memory](../traits/Trait-WorkingMemory.md)
139
- - [Patience](../traits/Trait-Patience.md)
140
- - [Curiosity](../traits/Trait-Curiosity.md)
141
- - [FOMO](../traits/Trait-FOMO.md)
@@ -1,137 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Elderly User](https://cbrowser.ai/docs/Persona-ElderlyUser)**
4
-
5
- ---
6
-
7
- # Elderly User
8
-
9
- **Category**: General Users
10
- **Description**: Users aged 65+ who may have age-related cognitive and perceptual changes affecting their digital interactions
11
-
12
- ## Overview
13
-
14
- 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.
15
-
16
- 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.
17
-
18
- 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.
19
-
20
- ## Trait Profile
21
-
22
- All values on 0.0-1.0 scale.
23
-
24
- ### Core Traits (Tier 1)
25
-
26
- | Trait | Value | Rationale |
27
- |-------|-------|-----------|
28
- | patience | 0.8 | Research shows older adults allocate more time to tasks and are less frustrated by reasonable delays |
29
- | riskTolerance | 0.2 | Strong preference for caution; fear of making irreversible mistakes or being scammed |
30
- | comprehension | 0.5 | Crystallized intelligence intact; processing of novel interfaces may be slower |
31
- | persistence | 0.6 | Will continue trying but may seek help earlier than younger users |
32
- | curiosity | 0.4 | More goal-focused than exploration-oriented; prefer familiar patterns |
33
- | workingMemory | 0.4 | Age-related decline in working memory capacity is well-documented |
34
- | readingTendency | 0.8 | Read thoroughly; prefer complete understanding before acting |
35
-
36
- ### Emotional Traits (Tier 2)
37
-
38
- | Trait | Value | Rationale |
39
- |-------|-------|-----------|
40
- | resilience | 0.5 | May become discouraged by repeated failures but have life experience with overcoming challenges |
41
- | selfEfficacy | 0.4 | Often underestimate their abilities with technology due to stereotype threat |
42
- | trustCalibration | 0.5 | Mix of appropriate caution and sometimes excessive trust in official-looking content |
43
- | interruptRecovery | 0.4 | Reduced working memory makes context recovery after interruptions more difficult |
44
-
45
- ### Decision-Making Traits (Tier 3)
46
-
47
- | Trait | Value | Rationale |
48
- |-------|-------|-----------|
49
- | satisficing | 0.6 | Accept good-enough solutions; not driven to find optimal choices |
50
- | informationForaging | 0.5 | Thorough but may be slower to recognize information scent |
51
- | anchoringBias | 0.7 | Preferences shaped by earlier technology experiences; may expect older patterns |
52
- | timeHorizon | 0.5 | Balanced perspective; neither overly focused on immediate nor distant outcomes |
53
- | attributionStyle | 0.5 | Balanced attribution; experience provides perspective on system vs user responsibility |
54
-
55
- ### Planning Traits (Tier 4)
56
-
57
- | Trait | Value | Rationale |
58
- |-------|-------|-----------|
59
- | metacognitivePlanning | 0.5 | Good planning abilities but may not apply them to unfamiliar technology contexts |
60
- | proceduralFluency | 0.4 | Slower development of procedural skills with new interfaces |
61
- | transferLearning | 0.5 | Can transfer knowledge but may be slower to recognize applicable patterns |
62
-
63
- ### Perception Traits (Tier 5)
64
-
65
- | Trait | Value | Rationale |
66
- |-------|-------|-----------|
67
- | changeBlindness | 0.6 | May miss subtle interface changes; attention resources more limited |
68
- | mentalModelRigidity | 0.7 | Expect interfaces to work like familiar systems; resistant to paradigm shifts |
69
-
70
- ### Social Traits (Tier 6)
71
-
72
- | Trait | Value | Rationale |
73
- |-------|-------|-----------|
74
- | authoritySensitivity | 0.7 | Respect institutional authority; may trust official-looking interfaces too readily |
75
- | emotionalContagion | 0.5 | Moderate influence from emotional tone of content |
76
- | fomo | 0.3 | Less driven by fear of missing out; focused on personal needs |
77
- | socialProofSensitivity | 0.5 | Influenced by trusted sources but less by general popularity |
78
-
79
- ## Behavioral Patterns
80
-
81
- ### Navigation
82
- 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.
83
-
84
- ### Decision Making
85
- 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.
86
-
87
- ### Error Recovery
88
- 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.
89
-
90
- ### Abandonment Triggers
91
- - Small text or low contrast
92
- - Time-limited interactions
93
- - Unclear or jargon-heavy instructions
94
- - Fear of making irreversible mistakes
95
- - No obvious way to get help
96
- - Security warnings that seem threatening
97
-
98
- ## UX Recommendations
99
-
100
- | Challenge | Recommendation |
101
- |-----------|----------------|
102
- | Reduced working memory | Minimize steps; show progress; provide external memory aids |
103
- | Processing speed | Allow ample time; avoid timeouts; show loading states |
104
- | Cautious behavior | Explicit undo; preview actions; confirmation without being patronizing |
105
- | Vision changes | Large text options; high contrast; avoid reliance on color alone |
106
- | Motor control changes | Large click targets; forgive imprecise clicks; avoid hover-dependent interactions |
107
- | Technology self-efficacy | Encouraging feedback; celebrate successes; normalize difficulty |
108
-
109
- ## Research Basis
110
-
111
- - Czaja, S.J. & Lee, C.C. (2007). Information Technology and Older Adults - Comprehensive review of age-related changes
112
- - Hawthorn, D. (2000). Possible implications of aging for interface designers - Specific design recommendations
113
- - Pak, R. & McLaughlin, A. (2010). Designing Displays for Older Adults - Evidence-based guidelines
114
- - Fisk, A.D. et al. (2009). Designing for Older Adults: Principles and Creative Human Factors Approaches
115
- - AARP/MIT AgeLab research on digital experiences for older adults
116
-
117
- ## Usage
118
-
119
- ```typescript
120
- await cognitive_journey_init({
121
- persona: "elderly-user",
122
- goal: "complete checkout",
123
- startUrl: "https://example.com"
124
- });
125
- ```
126
-
127
- ```bash
128
- npx cbrowser cognitive-journey --persona elderly-user --start https://example.com --goal "complete checkout"
129
- ```
130
-
131
- ## See Also
132
-
133
- - [Persona Index](./Persona-Index.md)
134
- - [Trait Index](../traits/Trait-Index.md)
135
- - [Patience](../traits/Trait-Patience.md)
136
- - [Working Memory](../traits/Trait-WorkingMemory.md)
137
- - [Reading Tendency](../traits/Trait-ReadingTendency.md)
@@ -1,137 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[First-Timer](https://cbrowser.ai/docs/Persona-FirstTimer)**
4
-
5
- ---
6
-
7
- # First-Timer
8
-
9
- **Category**: General Users
10
- **Description**: Users encountering an application or interface type for the first time, characterized by high curiosity but limited domain knowledge
11
-
12
- ## Overview
13
-
14
- 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.
15
-
16
- 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.
17
-
18
- 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.
19
-
20
- ## Trait Profile
21
-
22
- All values on 0.0-1.0 scale.
23
-
24
- ### Core Traits (Tier 1)
25
-
26
- | Trait | Value | Rationale |
27
- |-------|-------|-----------|
28
- | patience | 0.7 | Willing to invest time learning new systems; expect some initial friction |
29
- | riskTolerance | 0.3 | Hesitant to click unfamiliar buttons or commit to actions with unclear consequences |
30
- | comprehension | 0.3 | Limited domain knowledge means slower processing of jargon and conventions |
31
- | persistence | 0.5 | Will try multiple times but have lower frustration threshold than experienced users |
32
- | curiosity | 0.9 | High intrinsic motivation to explore and understand the new environment |
33
- | workingMemory | 0.5 | Average capacity, but heavily taxed by unfamiliar terminology and concepts |
34
- | readingTendency | 0.6 | Read more carefully than average; actively seek understanding |
35
-
36
- ### Emotional Traits (Tier 2)
37
-
38
- | Trait | Value | Rationale |
39
- |-------|-------|-----------|
40
- | resilience | 0.4 | Vulnerable to discouragement; initial failures feel more significant |
41
- | selfEfficacy | 0.4 | Uncertainty about ability to succeed in unfamiliar environment |
42
- | trustCalibration | 0.5 | Neither overly trusting nor skeptical; forming initial impressions |
43
- | interruptRecovery | 0.4 | Struggle to recover context after interruptions; mental models still forming |
44
-
45
- ### Decision-Making Traits (Tier 3)
46
-
47
- | Trait | Value | Rationale |
48
- |-------|-------|-----------|
49
- | satisficing | 0.6 | Accept reasonable options rather than optimizing; unsure what "best" means here |
50
- | informationForaging | 0.4 | Inefficient information seeking; don't know where to look |
51
- | anchoringBias | 0.7 | First impressions heavily influence subsequent expectations and interpretations |
52
- | timeHorizon | 0.4 | Focus on immediate task completion; not yet thinking about long-term usage |
53
- | attributionStyle | 0.4 | Tend to blame self for difficulties rather than recognizing system issues |
54
-
55
- ### Planning Traits (Tier 4)
56
-
57
- | Trait | Value | Rationale |
58
- |-------|-------|-----------|
59
- | metacognitivePlanning | 0.3 | Limited ability to strategize in unfamiliar domain; reactive approach |
60
- | proceduralFluency | 0.2 | No automated procedures; every action requires conscious effort |
61
- | transferLearning | 0.5 | Can apply general web conventions but may miss domain-specific patterns |
62
-
63
- ### Perception Traits (Tier 5)
64
-
65
- | Trait | Value | Rationale |
66
- |-------|-------|-----------|
67
- | changeBlindness | 0.6 | May miss important updates; still learning where to look |
68
- | mentalModelRigidity | 0.3 | Mental models are flexible because they're still forming |
69
-
70
- ### Social Traits (Tier 6)
71
-
72
- | Trait | Value | Rationale |
73
- |-------|-------|-----------|
74
- | authoritySensitivity | 0.7 | Look to interface guidance and authority signals for direction |
75
- | emotionalContagion | 0.6 | Influenced by perceived emotional tone of interface and help content |
76
- | fomo | 0.5 | Moderate concern about missing features; still discovering what's possible |
77
- | socialProofSensitivity | 0.7 | Look for evidence that others use and value the service |
78
-
79
- ## Behavioral Patterns
80
-
81
- ### Navigation
82
- 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.
83
-
84
- ### Decision Making
85
- 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.
86
-
87
- ### Error Recovery
88
- 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.
89
-
90
- ### Abandonment Triggers
91
- - Jargon-heavy content without explanations
92
- - Required account creation before value is demonstrated
93
- - Unclear next steps or missing call-to-action
94
- - Errors without clear recovery path
95
- - Overwhelming options without guidance
96
- - Feeling judged or embarrassed
97
-
98
- ## UX Recommendations
99
-
100
- | Challenge | Recommendation |
101
- |-----------|----------------|
102
- | Limited domain knowledge | Provide contextual help and tooltips; explain jargon on first use |
103
- | Hesitation about commitments | Clear undo capabilities; preview of action consequences |
104
- | Forming initial impressions | Invest heavily in first-time UX; quick wins build confidence |
105
- | Self-blame for failures | Non-judgmental error messages; emphasize system responsibility |
106
- | Seeking validation | Show social proof; testimonials; user counts; success stories |
107
- | Navigation uncertainty | Strong wayfinding; breadcrumbs; clear current-location indicators |
108
-
109
- ## Research Basis
110
-
111
- - Carroll, J.M. & Rosson, M.B. (1987). Paradox of the Active User - Why users don't read
112
- - Krug, S. (2014). Don't Make Me Think - First-time user navigation patterns
113
- - Kim, J. et al. (2016). First-time user retention research at Dropbox
114
- - Saffer, D. (2010). Designing for Interaction - Onboarding principles
115
- - Garrett, J.J. (2011). Elements of User Experience - User learning curves
116
-
117
- ## Usage
118
-
119
- ```typescript
120
- await cognitive_journey_init({
121
- persona: "first-timer",
122
- goal: "complete checkout",
123
- startUrl: "https://example.com"
124
- });
125
- ```
126
-
127
- ```bash
128
- npx cbrowser cognitive-journey --persona first-timer --start https://example.com --goal "complete checkout"
129
- ```
130
-
131
- ## See Also
132
-
133
- - [Persona Index](./Persona-Index.md)
134
- - [Trait Index](../traits/Trait-Index.md)
135
- - [Curiosity](../traits/Trait-Curiosity.md)
136
- - [Comprehension](../traits/Trait-Comprehension.md)
137
- - [Risk Tolerance](../traits/Trait-RiskTolerance.md)
@@ -1,138 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Impatient User](https://cbrowser.ai/docs/Persona-ImpatientUser)**
4
-
5
- ---
6
-
7
- # Impatient User
8
-
9
- **Category**: General Users
10
- **Description**: Users characterized by extremely low tolerance for delays, friction, or obstacles in completing their goals
11
-
12
- ## Overview
13
-
14
- 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.
15
-
16
- 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.
17
-
18
- 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.
19
-
20
- ## Trait Profile
21
-
22
- All values on 0.0-1.0 scale.
23
-
24
- ### Core Traits (Tier 1)
25
-
26
- | Trait | Value | Rationale |
27
- |-------|-------|-----------|
28
- | patience | 0.1 | Defining characteristic; extremely low tolerance for any perceived delay |
29
- | riskTolerance | 0.6 | Willing to take shortcuts and skip safety measures to save time |
30
- | comprehension | 0.6 | Capable of understanding but unwilling to invest time in reading |
31
- | persistence | 0.2 | Extremely quick to abandon; try alternatives rather than persist |
32
- | curiosity | 0.3 | No interest in exploration; purely goal-focused |
33
- | workingMemory | 0.6 | Adequate capacity but impatience prevents full utilization |
34
- | readingTendency | 0.1 | Minimal reading; scan for actionable elements only |
35
-
36
- ### Emotional Traits (Tier 2)
37
-
38
- | Trait | Value | Rationale |
39
- |-------|-------|-----------|
40
- | resilience | 0.3 | Low tolerance for setbacks; frustration escalates quickly |
41
- | selfEfficacy | 0.6 | Confident but attributes delays to system rather than self |
42
- | trustCalibration | 0.4 | May proceed despite warnings to save time |
43
- | interruptRecovery | 0.5 | Moderate; interruptions are frustrating but may welcome escape from slow process |
44
-
45
- ### Decision-Making Traits (Tier 3)
46
-
47
- | Trait | Value | Rationale |
48
- |-------|-------|-----------|
49
- | satisficing | 0.9 | Accept first available option; no comparison shopping |
50
- | informationForaging | 0.4 | Brief scans; abandon quickly if information not obvious |
51
- | anchoringBias | 0.6 | First option heavily favored due to reluctance to explore |
52
- | timeHorizon | 0.2 | Extreme focus on immediate completion; future consequences ignored |
53
- | attributionStyle | 0.3 | Blame system for any delays; low self-attribution |
54
-
55
- ### Planning Traits (Tier 4)
56
-
57
- | Trait | Value | Rationale |
58
- |-------|-------|-----------|
59
- | metacognitivePlanning | 0.3 | Action-oriented; minimal planning |
60
- | proceduralFluency | 0.6 | Expect common patterns; frustrated by novel interactions |
61
- | transferLearning | 0.5 | Apply familiar patterns but won't invest in learning new ones |
62
-
63
- ### Perception Traits (Tier 5)
64
-
65
- | Trait | Value | Rationale |
66
- |-------|-------|-----------|
67
- | changeBlindness | 0.7 | Miss changes while focused on finding CTAs |
68
- | mentalModelRigidity | 0.6 | Expect things to work in familiar ways |
69
-
70
- ### Social Traits (Tier 6)
71
-
72
- | Trait | Value | Rationale |
73
- |-------|-------|-----------|
74
- | authoritySensitivity | 0.4 | Ignore recommendations that slow progress |
75
- | emotionalContagion | 0.4 | Moderate; frustration internally driven |
76
- | fomo | 0.8 | High urgency; feel they're wasting time on current task |
77
- | socialProofSensitivity | 0.4 | Ignore reviews if they require reading |
78
-
79
- ## Behavioral Patterns
80
-
81
- ### Navigation
82
- 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.
83
-
84
- ### Decision Making
85
- First visible option is selected unless obviously wrong. No comparison of alternatives. Defaults are accepted without consideration. Any friction at decision point causes abandonment.
86
-
87
- ### Error Recovery
88
- Errors cause immediate frustration and often abandonment. Retry only if instant; otherwise seek alternatives (competitors, phone support, abandon entirely). Error messages are barely read.
89
-
90
- ### Abandonment Triggers
91
- - Any delay over 2 seconds
92
- - Required reading of more than 2 sentences
93
- - Multi-step processes without clear progress
94
- - Required account creation
95
- - Captchas or verification steps
96
- - Unclear next action
97
- - Any modal or interstitial
98
-
99
- ## UX Recommendations
100
-
101
- | Challenge | Recommendation |
102
- |-----------|----------------|
103
- | Extreme impatience | Sub-second interactions; skeleton loading; optimistic updates |
104
- | No reading | Single-word CTAs; icon-based communication; visual hierarchy |
105
- | Quick abandonment | One-click paths; guest checkout; express options |
106
- | Shortcut-seeking | Provide the shortcuts; don't force thoroughness |
107
- | Error intolerance | Prevent errors through smart defaults; instant inline validation |
108
- | First-option bias | Ensure first option is genuinely good; don't bury best options |
109
-
110
- ## Research Basis
111
-
112
- - Nielsen, J. (1993). Response Times: 3 Important Limits - Sub-second expectations
113
- - Galletta, D. et al. (2006). Impact of delay on web user interaction and abandonment
114
- - Akamai (2017). Page load time impact on conversion rates
115
- - Perfetti, C. & Landesman, L. (2001). Eight principles of user frustration - UIE research
116
- - Kohavi, R. et al. (2014). Online experimentation at Microsoft - Latency impact studies
117
-
118
- ## Usage
119
-
120
- ```typescript
121
- await cognitive_journey_init({
122
- persona: "impatient-user",
123
- goal: "complete checkout",
124
- startUrl: "https://example.com"
125
- });
126
- ```
127
-
128
- ```bash
129
- npx cbrowser cognitive-journey --persona impatient-user --start https://example.com --goal "complete checkout"
130
- ```
131
-
132
- ## See Also
133
-
134
- - [Persona Index](./Persona-Index.md)
135
- - [Trait Index](../traits/Trait-Index.md)
136
- - [Patience](../traits/Trait-Patience.md)
137
- - [FOMO](../traits/Trait-FOMO.md)
138
- - [Persistence](../traits/Trait-Persistence.md)