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,165 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Persistence](https://cbrowser.ai/docs/Trait-Persistence)**
4
-
5
- ---
6
-
7
- # Persistence
8
-
9
- **Category**: Tier 1 - Core Traits
10
- **Scale**: 0.0 (gives up easily) to 1.0 (persists through difficulty)
11
-
12
- ## Definition
13
-
14
- Persistence represents a user's tendency to continue working toward a goal despite obstacles, errors, and frustration. In web contexts, this trait determines how many attempts a user will make before abandoning a task, how they respond to repeated failures, and their willingness to try alternative approaches. Users with low persistence quickly abandon tasks at the first sign of difficulty, while highly persistent users will exhaust multiple strategies before giving up.
15
-
16
- ## Research Foundation
17
-
18
- ### Primary Citation
19
-
20
- > "Grit is perseverance and passion for long-term goals. Grit entails working strenuously toward challenges, maintaining effort and interest over years despite failure, adversity, and plateaus in progress."
21
- > - Duckworth, Peterson, Matthews, & Kelly, 2007, p. 1088
22
-
23
- **Full Citation (APA 7):**
24
- Duckworth, A. L., Peterson, C., Matthews, M. D., & Kelly, D. R. (2007). Grit: Perseverance and passion for long-term goals. *Journal of Personality and Social Psychology*, 92(6), 1087-1101. https://doi.org/10.1037/0022-3514.92.6.1087
25
-
26
- **DOI**: https://doi.org/10.1037/0022-3514.92.6.1087
27
-
28
- ### Supporting Research
29
-
30
- > "The grit scale predicted retention and graduation over and above traditionally used measures of aptitude... Grit had incremental predictive validity above and beyond IQ for accomplishment in challenging domains."
31
- > - Duckworth et al., 2007, p. 1093
32
-
33
- ### Key Numerical Values
34
-
35
- | Metric | Value | Source |
36
- |--------|-------|--------|
37
- | Grit-success correlation | r = 0.42 | Duckworth et al. (2007) |
38
- | Grit-conscientiousness correlation | r = 0.77 | Duckworth et al. (2007) |
39
- | Task completion improvement with grit | 34% | Duckworth & Quinn (2009) |
40
- | Average retry attempts (web forms) | 2.1 | Formisimo (2018) |
41
- | Abandonment after 3 errors | 67% | Baymard Institute (2020) |
42
- | Users who give up after 1 error | 18% | Nielsen Norman Group (2015) |
43
-
44
- ## Behavioral Levels
45
-
46
- | Value | Label | Behaviors |
47
- |-------|-------|-----------|
48
- | 0.0-0.2 | Very Low Persistence | Abandons after first error or obstacle. Gives up on slow-loading pages. Leaves form immediately if validation fails. Won't retry a failed search. Exits checkout at any friction point. No error recovery attempts. Maximum one try for any action. |
49
- | 0.2-0.4 | Low Persistence | Makes 1-2 attempts before giving up. Quick to assume "it's broken." Easily discouraged by error messages. May try one alternative approach. Abandons complex forms midway. Low tolerance for learning curves. Prefers immediate alternatives over problem-solving. |
50
- | 0.4-0.6 | Moderate Persistence | Makes 2-3 attempts for important tasks. Reads error messages and adjusts. Willing to try suggested solutions. May search for help if frustrated. Completes multi-step processes if progress is visible. Baseline persistence per Baymard data. |
51
- | 0.6-0.8 | High Persistence | Makes 4-5 attempts, tries multiple approaches. Searches for help documentation. Contacts support for important tasks. Willing to clear cache, try different browser. Persists through lengthy processes. Returns to abandoned tasks later. |
52
- | 0.8-1.0 | Very High Persistence | Exhausts all options before abandoning. Troubleshoots systematically. Consults forums, documentation, support. Very rarely gives up entirely. Treats obstacles as problems to solve, not reasons to quit. Will complete task across multiple sessions if needed. |
53
-
54
- ## Grit Components
55
-
56
- Duckworth's Grit Scale measures two factors relevant to web behavior:
57
-
58
- ### Consistency of Interest
59
- - Staying focused on goals over time
60
- - Not being distracted by new opportunities
61
- - **Web impact**: Completes tasks despite distractions, returns to abandoned processes
62
-
63
- ### Perseverance of Effort
64
- - Working hard despite setbacks
65
- - Finishing what is started
66
- - **Web impact**: Retries failed actions, seeks help, tries alternative approaches
67
-
68
- ## Estimated Trait Correlations
69
-
70
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
71
-
72
- | Related Trait | Correlation | Mechanism |
73
- |---------------|-------------|-----------|
74
- | [Patience](./Trait-Patience.md) | r = 0.45 | Both load on conscientiousness |
75
- | [Resilience](../traits/Trait-Resilience) | r = 0.52 | Emotional recovery enables persistence |
76
- | [Self-Efficacy](../traits/Trait-SelfEfficacy) | r = 0.48 | Confidence fuels continued effort |
77
- | [Metacognitive Planning](../traits/Trait-MetacognitivePlanning) | r = 0.41 | Planning enables strategic persistence |
78
- | [Attribution Style](../traits/Trait-AttributionStyle) | r = 0.39 | Internal locus promotes persistence |
79
-
80
- ## Impact on Web Behavior
81
-
82
- ### Error Recovery Pattern
83
-
84
- ```
85
- Very Low: Give up immediately (1 attempt)
86
- Low: Try once more, then leave (2 attempts)
87
- Moderate: Make 2-3 attempts, may seek help (3 attempts)
88
- High: Try multiple approaches (4-5 attempts)
89
- Very High: Exhaust all options (5+ attempts)
90
- ```
91
-
92
- ### Form Completion
93
-
94
- | Persistence Level | Behavior on Validation Error |
95
- |-------------------|------------------------------|
96
- | Very Low | Abandons form entirely |
97
- | Low | Fixes obvious error, gives up if second error occurs |
98
- | Moderate | Works through 2-3 validation cycles |
99
- | High | Completes form despite multiple error cycles |
100
- | Very High | Seeks help if form appears broken |
101
-
102
- ### Search Behavior
103
-
104
- - **Low persistence**: One search query, accepts first results or leaves
105
- - **High persistence**: Reformulates queries, drills into results, tries alternative search engines
106
-
107
- ### Technical Issues
108
-
109
- | Issue Type | Low Persistence Response | High Persistence Response |
110
- |------------|--------------------------|---------------------------|
111
- | Page won't load | Leaves immediately | Refreshes, tries different browser, clears cache |
112
- | Button doesn't work | Gives up | Tries different method, checks for JS errors |
113
- | Form won't submit | Abandons | Reviews fields, tries again, seeks help |
114
- | Login fails | Gives up | Password reset, checks caps lock, contacts support |
115
-
116
- ## Persona Values
117
-
118
- | Persona | Persistence Value | Rationale |
119
- |---------|-------------------|-----------|
120
- | [Rushed Professional](../personas/Persona-RushedProfessional) | 0.3 | Values time over persistence |
121
- | [Distracted Parent](../personas/Persona-DistractedParent) | 0.35 | Interruptions prevent sustained effort |
122
- | [Anxious First-Timer](../personas/Persona-AnxiousFirstTimer) | 0.4 | Anxiety undermines persistence |
123
- | [Impulsive Shopper](../personas/Persona-ImpulsiveShopper) | 0.25 | Low frustration tolerance |
124
- | [Methodical Senior](../personas/Persona-MethodicalSenior) | 0.75 | Patient and thorough |
125
- | [Tech-Savvy Explorer](../personas/Persona-TechSavvyExplorer) | 0.8 | Challenges are interesting problems |
126
-
127
- ## UX Design Implications
128
-
129
- ### For Low-Persistence Users
130
-
131
- - Minimize errors through input constraints
132
- - Provide inline validation with clear solutions
133
- - Use autofill and smart defaults
134
- - Keep processes short (3 steps or fewer)
135
- - Show immediate feedback on every action
136
- - Offer "save progress" for complex flows
137
- - Make retry/undo obvious and easy
138
-
139
- ### For High-Persistence Users
140
-
141
- - Provide detailed error information
142
- - Include advanced troubleshooting options
143
- - Offer help documentation and FAQs
144
- - Allow multiple recovery paths
145
- - Don't oversimplify at expense of capability
146
-
147
- ## See Also
148
-
149
- - [Trait Index](./Trait-Index.md) - All cognitive traits
150
- - [Patience](./Trait-Patience.md) - Related time tolerance trait
151
- - [Resilience](../traits/Trait-Resilience) - Emotional recovery from setbacks
152
- - [Self-Efficacy](../traits/Trait-SelfEfficacy) - Confidence in ability to succeed
153
- - [Persona Index](../personas/Persona-Index.md) - Pre-configured personas
154
-
155
- ## Bibliography
156
-
157
- Baymard Institute. (2020). Form field usability: The relationship between input fields and form conversion. https://baymard.com/blog/form-field-usability
158
-
159
- Duckworth, A. L., Peterson, C., Matthews, M. D., & Kelly, D. R. (2007). Grit: Perseverance and passion for long-term goals. *Journal of Personality and Social Psychology*, 92(6), 1087-1101. https://doi.org/10.1037/0022-3514.92.6.1087
160
-
161
- Duckworth, A. L., & Quinn, P. D. (2009). Development and validation of the Short Grit Scale (Grit-S). *Journal of Personality Assessment*, 91(2), 166-174. https://doi.org/10.1080/00223890802634290
162
-
163
- Formisimo. (2018). Form analytics: How users interact with web forms. https://www.formisimo.com/research
164
-
165
- Nielsen Norman Group. (2015). Error message guidelines. https://www.nngroup.com/articles/error-message-guidelines/
@@ -1,205 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Procedural Fluency](https://cbrowser.ai/docs/Trait-ProceduralFluency)**
4
-
5
- ---
6
-
7
- # Procedural Fluency
8
-
9
- **Category**: Tier 4 - Planning Traits
10
- **Scale**: 0.0 (low) to 1.0 (high)
11
-
12
- ## Definition
13
-
14
- Procedural Fluency measures a user's ability to execute learned procedures efficiently and automatically, with minimal cognitive load. Users with high procedural fluency have internalized common UI interaction patterns (logging in, form submission, navigation, checkout flows) to the point where these actions require little conscious thought, freeing working memory for higher-level goals. Low procedural fluency indicates that even routine web interactions require conscious step-by-step attention, creating cognitive overhead that slows task completion and increases error rates. This trait is closely related to Cognitive Load Theory and the transition from controlled to automatic processing.
15
-
16
- ## Research Foundation
17
-
18
- ### Primary Citation
19
-
20
- > "Cognitive load theory suggests that effective instructional methods work by directing cognitive resources toward activities that are relevant to learning... Worked examples are effective because they allow learners to dedicate more of their limited working memory to learning and less to problem solving."
21
- > -- Sweller, 1988, p. 257
22
-
23
- **Full Citation (APA 7):**
24
- Sweller, J. (1988). Cognitive load during problem solving: Effects on learning. *Cognitive Science*, 12(2), 257-285.
25
-
26
- **DOI**: https://doi.org/10.1016/0364-0213(88)90023-7
27
-
28
- ### Supporting Research
29
-
30
- > "The worked example effect demonstrates that studying worked examples leads to better learning outcomes than solving equivalent problems, because worked examples reduce extraneous cognitive load."
31
- > -- Sweller & Cooper, 1985
32
-
33
- **Full Citation (APA 7):**
34
- Sweller, J., & Cooper, G. A. (1985). The use of worked examples as a substitute for problem solving in learning algebra. *Cognition and Instruction*, 2(1), 59-89. https://doi.org/10.1207/s1532690xci0201_3
35
-
36
- ### Key Numerical Values
37
-
38
- | Metric | Value | Source |
39
- |--------|-------|--------|
40
- | Working memory capacity | 7 +/- 2 elements | Miller (1956) |
41
- | Automaticity threshold | 50-200 practice trials | Anderson (1982) |
42
- | Cognitive load limit | 4-9 novel elements | Sweller (1988) |
43
- | Worked example effect size | d = 0.57-1.02 | Sweller & Cooper (1985) |
44
- | Expertise reversal threshold | 40-60 practice sessions | Kalyuga et al. (2003) |
45
- | Procedural to automatic transition | 20-100 hours | Ericsson et al. (1993) |
46
- | Split-attention penalty | 30-50% performance decrease | Sweller et al. (1998) |
47
-
48
- ## Behavioral Levels
49
-
50
- | Value | Label | Behaviors |
51
- |-------|-------|-----------|
52
- | 0.0-0.2 | Very Low | Every click requires conscious thought; overwhelmed by multi-step forms; frequently forgets steps in familiar procedures; cannot handle interruptions; loses place easily; requires visual guides for even simple tasks; significant hesitation before each action |
53
- | 0.2-0.4 | Low | Basic procedures (login, navigation) require attention; multi-step tasks cause cognitive strain; errors common in routine tasks; needs to re-read instructions; slow, deliberate interaction; easily confused by variations in familiar patterns |
54
- | 0.4-0.6 | Moderate | Common procedures becoming automatic; can handle standard patterns without reference; occasional hesitation on less familiar tasks; recovers from minor variations; moderate speed on routine tasks; can multitask during simple procedures |
55
- | 0.6-0.8 | High | Most web patterns automatic; handles variations smoothly; efficient multi-step completion; can recover from interruptions; recognizes and adapts to pattern variations; fast completion of routine tasks; cognitive resources available for complex decisions |
56
- | 0.8-1.0 | Very High | Expert-level automaticity; all common patterns fully automatic; handles novel variations by pattern matching; extremely fast routine completion; effortless multitasking during procedures; immediately recognizes broken or unusual patterns; can teach procedures to others |
57
-
58
- ## Web/UI Behavioral Patterns
59
-
60
- ### Login and Authentication
61
-
62
- | Level | Observed Behavior |
63
- |-------|-------------------|
64
- | Very Low | Hunts for login button; types credentials slowly with frequent errors; confused by 2FA; may forget password mid-entry |
65
- | Low | Finds login but hesitates; enters credentials deliberately; 2FA causes significant pause; uses password manager with uncertainty |
66
- | Moderate | Smooth login flow; handles 2FA automatically; uses keyboard shortcuts sometimes; adapts to different login layouts |
67
- | High | Instant login recognition; keyboard-driven entry; anticipates 2FA; seamless password manager use; unfazed by layout changes |
68
- | Very High | Fully automatic login across all sites; immediate pattern recognition; uses advanced auth methods effortlessly; notices security anomalies |
69
-
70
- ### Form Completion
71
-
72
- | Level | Observed Behavior |
73
- |-------|-------------------|
74
- | Very Low | Fills one field at a time with pauses; re-reads labels; misses required fields; submits incomplete forms; overwhelmed by long forms |
75
- | Low | Sequential field completion; occasional re-reading; catches some required fields before submit; slow on multi-page forms |
76
- | Moderate | Groups related fields mentally; efficient tab navigation; previews before submit; handles multi-page with minimal confusion |
77
- | High | Rapid field completion; autofill leveraged expertly; anticipates validation; efficient across form types; handles conditional fields |
78
- | Very High | Near-instant form completion; identifies optimal field order; bypasses unnecessary fields; handles complex conditional logic; can complete forms while multitasking |
79
-
80
- ### E-commerce Checkout
81
-
82
- | Level | Observed Behavior |
83
- |-------|-------------------|
84
- | Very Low | Overwhelmed by checkout steps; re-enters information; confused by shipping vs billing; abandons at payment; cannot parse order summary |
85
- | Low | Completes checkout with effort; payment information requires focus; may miss promotional codes; needs to review each step |
86
- | Moderate | Familiar checkout flows smooth; handles address forms; uses saved payment; understands order summary; completes in reasonable time |
87
- | High | Rapid checkout; guest vs account decision instant; leverages autofill; applies promotions; handles variations across sites |
88
- | Very High | Sub-minute checkout; predicts next steps; identifies suspicious checkout flows; parallel tab for price comparison; optimal payment selection |
89
-
90
- ### Cognitive Load Indicators
91
-
92
- | Level | Cognitive Load Signs |
93
- |-------|---------------------|
94
- | Very Low | Visible frustration; verbal expressions of confusion; long pauses; physical signs of strain; abandonment |
95
- | Low | Frequent pauses; re-reading behavior; slow mouse movement; occasional sighs |
96
- | Moderate | Some pauses on complex steps; smooth on familiar patterns; brief hesitations |
97
- | High | Minimal observable load; confident movements; quick decisions |
98
- | Very High | No observable load; parallel processing; possibly bored with simple interfaces |
99
-
100
- ## Estimated Trait Correlations
101
-
102
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
103
-
104
- | Related Trait | Correlation | Research Basis |
105
- |---------------|-------------|----------------|
106
- | [Working Memory](./Trait-WorkingMemory.md) | r = 0.48 | Procedural fluency frees working memory capacity (Sweller, 1988) |
107
- | [Comprehension](./Trait-Comprehension.md) | r = 0.55 | Understanding enables procedure learning (Anderson, 1982) |
108
- | [MetacognitivePlanning](./Trait-MetacognitivePlanning.md) | r = 0.41 | Metacognition monitors procedural execution (Veenman et al., 2006) |
109
- | [Transfer Learning](./Trait-TransferLearning.md) | r = 0.62 | Fluent procedures transfer more readily to similar contexts (Thorndike & Woodworth, 1901) |
110
- | [Patience](./Trait-Patience.md) | r = 0.38 | Low fluency requires more patience to complete tasks (Nah, 2004) |
111
- | [Interrupt Recovery](./Trait-InterruptRecovery.md) | r = 0.45 | Automatic procedures easier to resume after interruption (Mark et al., 2005) |
112
-
113
- ## Persona Values
114
-
115
- | Persona | Value | Rationale |
116
- |---------|-------|-----------|
117
- | power-user | 0.90 | Extensive practice has automated most procedures |
118
- | first-timer | 0.20 | No prior exposure to web patterns; everything requires learning |
119
- | elderly-user | 0.35 | May have some experience but less practice with modern patterns |
120
- | impatient-user | 0.50 | Average fluency; impatience separate from skill level |
121
- | screen-reader-user | 0.70 | Specialized procedures highly practiced for accessibility |
122
- | mobile-user | 0.55 | Touch patterns automated; may be less fluent with complex desktop patterns |
123
- | anxious-user | 0.40 | Anxiety can interfere with procedural automaticity |
124
-
125
- ## Implementation in CBrowser
126
-
127
- ### State Tracking
128
-
129
- ```typescript
130
- interface ProceduralFluencyState {
131
- recognizedPatterns: Set<PatternType>;
132
- currentProcedure: string | null;
133
- procedureStep: number;
134
- stepHesitationMs: number[];
135
- errorRate: number;
136
- cognitiveLoadEstimate: number; // 0-1
137
- automaticityLevel: number; // 0-1, increases with practice
138
- interruptionVulnerability: number; // 0-1
139
- }
140
-
141
- type PatternType =
142
- | 'login'
143
- | 'registration'
144
- | 'checkout'
145
- | 'search'
146
- | 'navigation'
147
- | 'form_submission'
148
- | 'file_upload'
149
- | 'pagination'
150
- | 'filtering'
151
- | 'modal_interaction';
152
- ```
153
-
154
- ### Behavioral Modifiers
155
-
156
- - **Action timing**: Base action time modified by fluency level (very low: 2-3x slower, very high: 0.5x faster)
157
- - **Error rate**: Inversely correlated with fluency (very low: 20% error rate, very high: 1%)
158
- - **Cognitive load accumulation**: Low fluency accumulates load faster, triggering fatigue earlier
159
- - **Pattern recognition**: High fluency immediately identifies common UI patterns and applies learned procedures
160
- - **Interruption tolerance**: High fluency maintains procedure state through brief interruptions
161
-
162
- ### Cognitive Load Simulation
163
-
164
- ```typescript
165
- function calculateCognitiveLoad(
166
- novelElements: number,
167
- fluency: number
168
- ): number {
169
- // Sweller's cognitive load theory
170
- const baseLoad = novelElements / 7; // Miller's magic number
171
- const fluencyReduction = fluency * 0.6; // Fluency reduces load by up to 60%
172
- return Math.min(1.0, baseLoad * (1 - fluencyReduction));
173
- }
174
- ```
175
-
176
- ## See Also
177
-
178
- - [Trait-WorkingMemory](./Trait-WorkingMemory.md) - Capacity freed by procedural automaticity
179
- - [Trait-MetacognitivePlanning](./Trait-MetacognitivePlanning.md) - Strategic monitoring of procedures
180
- - [Trait-TransferLearning](./Trait-TransferLearning.md) - Applying procedures across contexts
181
- - [Trait-Comprehension](./Trait-Comprehension.md) - Understanding that enables procedure learning
182
- - [Cognitive-User-Simulation](../COGNITIVE-SIMULATION.md) - Main simulation documentation
183
- - [Persona-Index](../personas/Persona-Index.md) - Pre-configured trait combinations
184
-
185
- ## Bibliography
186
-
187
- Anderson, J. R. (1982). Acquisition of cognitive skill. *Psychological Review*, 89(4), 369-406. https://doi.org/10.1037/0033-295X.89.4.369
188
-
189
- Ericsson, K. A., Krampe, R. T., & Tesch-Romer, C. (1993). The role of deliberate practice in the acquisition of expert performance. *Psychological Review*, 100(3), 363-406. https://doi.org/10.1037/0033-295X.100.3.363
190
-
191
- Kalyuga, S., Ayres, P., Chandler, P., & Sweller, J. (2003). The expertise reversal effect. *Educational Psychologist*, 38(1), 23-31. https://doi.org/10.1207/S15326985EP3801_4
192
-
193
- Mark, G., Gonzalez, V. M., & Harris, J. (2005). No task left behind? Examining the nature of fragmented work. In *Proceedings of the SIGCHI Conference on Human Factors in Computing Systems* (pp. 321-330). ACM. https://doi.org/10.1145/1054972.1055017
194
-
195
- Miller, G. A. (1956). The magical number seven, plus or minus two: Some limits on our capacity for processing information. *Psychological Review*, 63(2), 81-97. https://doi.org/10.1037/h0043158
196
-
197
- Nah, F. F.-H. (2004). A study on tolerable waiting time: How long are web users willing to wait? *Behaviour & Information Technology*, 23(3), 153-163. https://doi.org/10.1080/01449290410001669914
198
-
199
- Sweller, J. (1988). Cognitive load during problem solving: Effects on learning. *Cognitive Science*, 12(2), 257-285. https://doi.org/10.1016/0364-0213(88)90023-7
200
-
201
- Sweller, J., & Cooper, G. A. (1985). The use of worked examples as a substitute for problem solving in learning algebra. *Cognition and Instruction*, 2(1), 59-89. https://doi.org/10.1207/s1532690xci0201_3
202
-
203
- Sweller, J., van Merrienboer, J. J. G., & Paas, F. G. W. C. (1998). Cognitive architecture and instructional design. *Educational Psychology Review*, 10(3), 251-296. https://doi.org/10.1023/A:1022193728205
204
-
205
- Veenman, M. V. J., Van Hout-Wolters, B. H. A. M., & Afflerbach, P. (2006). Metacognition and learning: Conceptual and methodological considerations. *Metacognition and Learning*, 1(1), 3-14. https://doi.org/10.1007/s11409-006-6893-0
@@ -1,216 +0,0 @@
1
- > **This documentation is no longer maintained here.**
2
- >
3
- > For the latest version, please visit: **[Reading Tendency](https://cbrowser.ai/docs/Trait-ReadingTendency)**
4
-
5
- ---
6
-
7
- # Reading Tendency
8
-
9
- **Category**: Tier 1 - Core Traits
10
- **Scale**: 0.0 (scans only) to 1.0 (reads thoroughly)
11
-
12
- ## Definition
13
-
14
- Reading tendency represents the degree to which users actually read content versus scanning for visual patterns and keywords. This trait determines whether users will notice important text, read instructions before acting, and absorb content beyond headlines. Users with low reading tendency skip most text and rely on visual cues, while high reading tendency users methodically read content and are more likely to notice details.
15
-
16
- ## Research Foundation
17
-
18
- ### Primary Citation
19
-
20
- > "On the average web page, users have time to read at most 28% of the words during an average visit; 20% is more likely... Users scan in an F-shaped pattern, focusing on the top and left side of the page."
21
- > - Nielsen, 2006, p. 2
22
-
23
- **Full Citation (APA 7):**
24
- Nielsen, J. (2006). F-shaped pattern for reading web content. *Nielsen Norman Group*. https://doi.org/10.1145/1167867.1167876
25
-
26
- **DOI**: https://doi.org/10.1145/1167867.1167876
27
-
28
- ### Supporting Research
29
-
30
- > "79% of our test users always scanned any new page they came across; only 16% read word-by-word... Web users are ruthless in their prioritization and will not read more than is absolutely necessary."
31
- > - Nielsen, 1997
32
-
33
- **Full Citation (APA 7):**
34
- Nielsen, J. (1997). How users read on the web. *Nielsen Norman Group*. https://www.nngroup.com/articles/how-users-read-on-the-web/
35
-
36
- ### Key Numerical Values
37
-
38
- | Metric | Value | Source |
39
- |--------|-------|--------|
40
- | Users who scan vs. read | 79% scan | Nielsen (1997) |
41
- | Maximum words read per page visit | 28% | Nielsen (2006) |
42
- | Realistic words read | 20% | Nielsen (2006) |
43
- | F-pattern compliance | 69% of pages | Nielsen (2006) |
44
- | Above-fold attention | 80% of viewing time | Pernice (2017) |
45
- | Headline reading rate | 100% of visitors | Chartbeat (2014) |
46
- | Full article completion | 33% of starters | Chartbeat (2014) |
47
-
48
- ## The F-Pattern
49
-
50
- Nielsen's eyetracking research identified the F-shaped reading pattern:
51
-
52
- ### The Three Fixation Phases
53
-
54
- 1. **First Horizontal Movement**: Users read across the top of the content area
55
- 2. **Second Horizontal Movement**: Users move down and read a shorter horizontal area
56
- 3. **Vertical Movement**: Users scan down the left side in a vertical movement
57
-
58
- ### F-Pattern Distribution
59
-
60
- ```
61
- ████████████████████████████ ← Heavy reading (top)
62
- ████████████████ ← Moderate reading
63
- ████████ ← Light reading
64
- ███ ← Scanning only
65
- ██ ← Minimal attention
66
- █ ← Often missed
67
- ```
68
-
69
- ## Behavioral Levels
70
-
71
- | Value | Label | Behaviors |
72
- |-------|-------|-----------|
73
- | 0.0-0.2 | Scanner Only | Reads headlines only, skips body text entirely. Relies exclusively on visual cues (icons, images, buttons). Misses important text warnings. Never reads terms/conditions. Clicks based on position, not content. May miss inline errors. Maximum 10% of text read. |
74
- | 0.2-0.4 | Light Scanner | Reads first 1-2 sentences of blocks. Scans for keywords relevant to task. Notices bold text and bullet points. Skips paragraphs longer than 2-3 lines. Reads 15-20% of text. Often misses important details buried in paragraphs. |
75
- | 0.4-0.6 | Moderate | Follows F-pattern closely per Nielsen's research. Reads headlines, subheads, and first sentences. Scans remainder for relevant keywords. Reads 20-28% of text. Notices formatted elements (lists, callouts). May miss mid-paragraph important info. |
76
- | 0.6-0.8 | Thorough Reader | Reads most of headlines, subheads, and significant portions of body text. Notices text warnings and important messages. Reads 40-60% of text. Follows links within content. Reads captions and labels. More likely to notice inline guidance. |
77
- | 0.8-1.0 | Complete Reader | Reads nearly all text content systematically. Reads terms and conditions. Notices footnotes and fine print. Reads 70%+ of text. Processes instructions before acting. Unlikely to miss text-based warnings. May read comments and supplementary content. |
78
-
79
- ## Estimated Trait Correlations
80
-
81
- > *Correlation estimates are derived from related research findings and theoretical models. Empirical calibration is planned ([GitHub #95](https://github.com/alexandriashai/cbrowser/issues/95)).*
82
-
83
- | Related Trait | Correlation | Mechanism |
84
- |---------------|-------------|-----------|
85
- | [Comprehension](./Trait-Comprehension.md) | r = 0.35 | Reading enables comprehension |
86
- | [Patience](./Trait-Patience.md) | r = 0.42 | Time allows for reading |
87
- | [Curiosity](./Trait-Curiosity.md) | r = 0.38 | Interest drives deeper reading |
88
- | [Working Memory](./Trait-WorkingMemory.md) | r = 0.25 | Capacity to process text |
89
- | [Risk Tolerance](./Trait-RiskTolerance.md) | r = -0.28 | Risk-averse users read warnings |
90
-
91
- ## Impact on Web Behavior
92
-
93
- ### Content Consumption
94
-
95
- | Reading Level | Words Read | Patterns |
96
- |---------------|------------|----------|
97
- | Scanner Only | 10% | Headlines only |
98
- | Light Scanner | 15-20% | First sentences |
99
- | Moderate | 20-28% | F-pattern |
100
- | Thorough | 40-60% | Most content |
101
- | Complete | 70%+ | Nearly everything |
102
-
103
- ### Form Completion
104
-
105
- - **Low reading tendency**: Skips field labels, misses requirements, ignores inline help
106
- - **High reading tendency**: Reads all labels, follows instructions, notices validation messages
107
-
108
- ### Error Recognition
109
-
110
- | Reading Level | Text Error Notice Rate | Recovery |
111
- |---------------|------------------------|----------|
112
- | Very Low | 23% | Poor |
113
- | Low | 41% | Fair |
114
- | Moderate | 58% | Average |
115
- | High | 79% | Good |
116
- | Very High | 94% | Excellent |
117
-
118
- ### Legal/Terms Content
119
-
120
- | Reading Level | Terms Engagement |
121
- |---------------|------------------|
122
- | Scanner Only | Scrolls to checkbox, never reads |
123
- | Light Scanner | Glances at headings |
124
- | Moderate | Reads bold sections |
125
- | Thorough | Skims important sections |
126
- | Complete | Reads in full (rare: ~4% of users) |
127
-
128
- ## Scanning Patterns Beyond F
129
-
130
- ### Layer-Cake Pattern
131
- - Users read subheadings, skip body
132
- - Common for comparison shopping
133
-
134
- ### Spotted Pattern
135
- - Eyes jump to specific keywords
136
- - Task-focused searching
137
-
138
- ### Commitment Pattern
139
- - Engaged readers who read everything
140
- - Only 16% of users per Nielsen
141
-
142
- ### Marking Pattern
143
- - Eyes return to navigation
144
- - Orientation-focused scanning
145
-
146
- ## Persona Values
147
-
148
- | Persona | Reading Tendency Value | Rationale |
149
- |---------|------------------------|-----------|
150
- | [Rushed Professional](../personas/Persona-RushedProfessional) | 0.2 | Time pressure = scanning |
151
- | [Impulsive Shopper](../personas/Persona-ImpulsiveShopper) | 0.25 | Action-oriented, not reading |
152
- | [Distracted Parent](../personas/Persona-DistractedParent) | 0.3 | Interruptions prevent sustained reading |
153
- | [Anxious First-Timer](../personas/Persona-AnxiousFirstTimer) | 0.45 | Reads more due to uncertainty |
154
- | [Tech-Savvy Explorer](../personas/Persona-TechSavvyExplorer) | 0.5 | Selective reading of interesting content |
155
- | [Methodical Senior](../personas/Persona-MethodicalSenior) | 0.8 | Thorough, careful reading |
156
-
157
- ## UX Design Implications
158
-
159
- ### For Low-Reading-Tendency Users
160
-
161
- - Use clear visual hierarchy
162
- - Put key info in headlines and first sentences
163
- - Use icons alongside text labels
164
- - Make buttons and CTAs visually distinct
165
- - Use bullet points, not paragraphs
166
- - Front-load important information (inverted pyramid)
167
- - Never bury critical info in paragraphs
168
- - Use color, bold, and formatting for emphasis
169
-
170
- ### For High-Reading-Tendency Users
171
-
172
- - Can include detailed explanations
173
- - Longer content is acceptable
174
- - Footnotes and fine print will be noticed
175
- - Can use text for important warnings
176
- - Rich content is appreciated
177
-
178
- ## Content Design Guidelines
179
-
180
- ### The Inverted Pyramid
181
-
182
- Structure content for scanners:
183
- 1. **Most important**: First (headline)
184
- 2. **Important**: Early (subheads)
185
- 3. **Details**: Later (body)
186
- 4. **Background**: End (if read at all)
187
-
188
- ### Scannability Improvements
189
-
190
- | Technique | Reading Improvement |
191
- |-----------|---------------------|
192
- | Highlighted keywords | 47% more noticed |
193
- | Bulleted lists | 70% easier to scan |
194
- | Short paragraphs (1-2 sentences) | 58% more read |
195
- | Meaningful subheadings | 47% more navigation |
196
- | One idea per paragraph | 34% better comprehension |
197
-
198
- ## See Also
199
-
200
- - [Trait Index](./Trait-Index.md) - All cognitive traits
201
- - [Comprehension](./Trait-Comprehension.md) - Understanding what is read
202
- - [Patience](./Trait-Patience.md) - Time to read
203
- - [Working Memory](./Trait-WorkingMemory.md) - Capacity to process
204
- - [Persona Index](../personas/Persona-Index.md) - Pre-configured personas
205
-
206
- ## Bibliography
207
-
208
- Chartbeat. (2014). What you think you know about the web is wrong. *Chartbeat Data Science*. https://blog.chartbeat.com/2014/09/what-you-think-you-know-about-the-web-is-wrong/
209
-
210
- Nielsen, J. (1997). How users read on the web. *Nielsen Norman Group*. https://www.nngroup.com/articles/how-users-read-on-the-web/
211
-
212
- Nielsen, J. (2006). F-shaped pattern for reading web content. *Nielsen Norman Group*. https://doi.org/10.1145/1167867.1167876
213
-
214
- Nielsen, J. (2008). How little do users read? *Nielsen Norman Group*. https://www.nngroup.com/articles/how-little-do-users-read/
215
-
216
- Pernice, K. (2017). F-shaped pattern of reading on the web: Misunderstood, but still relevant (even on mobile). *Nielsen Norman Group*. https://www.nngroup.com/articles/f-shaped-pattern-reading-web-content/