cbrowser 18.63.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.
- package/package.json +1 -1
- package/docs/ASSESSMENT.md +0 -132
- package/docs/AUTH0-SETUP.md +0 -207
- package/docs/COGNITIVE-OPTIMAL-TRANSPORT-RESEARCH.md +0 -238
- package/docs/DEMO-DEPLOYMENT.md +0 -177
- package/docs/ENTERPRISE-INTEGRATION.md +0 -250
- package/docs/GETTING-STARTED.md +0 -232
- package/docs/INSTALL.md +0 -274
- package/docs/MCP-INTEGRATION.md +0 -301
- package/docs/METHODOLOGY.md +0 -276
- package/docs/PERSONA-QUESTIONNAIRE.md +0 -328
- package/docs/README.md +0 -45
- package/docs/REMOTE-MCP-SERVER.md +0 -569
- package/docs/SECURITY_WHITEPAPER.md +0 -475
- package/docs/STRESS-TEST-v16.14.4.md +0 -241
- package/docs/Tool-Cognitive-Journey-Autonomous.md +0 -270
- package/docs/Tool-Competitive-Benchmark.md +0 -293
- package/docs/Tool-Empathy-Audit.md +0 -331
- package/docs/Tool-Hunt-Bugs.md +0 -305
- package/docs/Tool-Marketing-Campaign.md +0 -298
- package/docs/Tool-Persona-Create.md +0 -274
- package/docs/Tools-Accessibility.md +0 -208
- package/docs/Tools-Browser-Automation.md +0 -311
- package/docs/Tools-Cognitive-Journeys.md +0 -233
- package/docs/Tools-Marketing-Intelligence.md +0 -271
- package/docs/Tools-Overview.md +0 -162
- package/docs/Tools-Persona-System.md +0 -300
- package/docs/Tools-Session-State.md +0 -278
- package/docs/Tools-Testing-Quality.md +0 -257
- package/docs/Tools-Utilities.md +0 -182
- package/docs/Tools-Visual-Performance.md +0 -278
- package/docs/hunt-bugs-coverage.md +0 -103
- package/docs/personas/Persona-ADHD.md +0 -141
- package/docs/personas/Persona-ElderlyUser.md +0 -137
- package/docs/personas/Persona-FirstTimer.md +0 -137
- package/docs/personas/Persona-ImpatientUser.md +0 -138
- package/docs/personas/Persona-Index.md +0 -302
- package/docs/personas/Persona-LowVision.md +0 -139
- package/docs/personas/Persona-MobileUser.md +0 -139
- package/docs/personas/Persona-MotorTremor.md +0 -139
- package/docs/personas/Persona-PowerUser.md +0 -135
- package/docs/personas/Persona-ScreenReaderUser.md +0 -139
- package/docs/research/Bibliography.md +0 -275
- package/docs/research/Research-Methodology.md +0 -244
- package/docs/research/Values-Research.md +0 -432
- package/docs/traits/Trait-AnchoringBias.md +0 -227
- package/docs/traits/Trait-AttributionStyle.md +0 -280
- package/docs/traits/Trait-AuthoritySensitivity.md +0 -141
- package/docs/traits/Trait-ChangeBlindness.md +0 -171
- package/docs/traits/Trait-Comprehension.md +0 -180
- package/docs/traits/Trait-Curiosity.md +0 -189
- package/docs/traits/Trait-EmotionalContagion.md +0 -144
- package/docs/traits/Trait-FOMO.md +0 -150
- package/docs/traits/Trait-Index.md +0 -166
- package/docs/traits/Trait-InformationForaging.md +0 -217
- package/docs/traits/Trait-InterruptRecovery.md +0 -249
- package/docs/traits/Trait-MentalModelRigidity.md +0 -228
- package/docs/traits/Trait-MetacognitivePlanning.md +0 -164
- package/docs/traits/Trait-Patience.md +0 -137
- package/docs/traits/Trait-Persistence.md +0 -165
- package/docs/traits/Trait-ProceduralFluency.md +0 -205
- package/docs/traits/Trait-ReadingTendency.md +0 -216
- package/docs/traits/Trait-Resilience.md +0 -162
- package/docs/traits/Trait-RiskTolerance.md +0 -162
- package/docs/traits/Trait-Satisficing.md +0 -181
- package/docs/traits/Trait-SelfEfficacy.md +0 -199
- package/docs/traits/Trait-SocialProofSensitivity.md +0 -155
- package/docs/traits/Trait-TimeHorizon.md +0 -267
- package/docs/traits/Trait-TransferLearning.md +0 -249
- package/docs/traits/Trait-TrustCalibration.md +0 -227
- package/docs/traits/Trait-WorkingMemory.md +0 -192
package/docs/METHODOLOGY.md
DELETED
|
@@ -1,276 +0,0 @@
|
|
|
1
|
-
> **This documentation is no longer maintained here.**
|
|
2
|
-
>
|
|
3
|
-
> For the latest version, please visit: **[CBrowser Scoring Methodology & Research Sources](https://cbrowser.ai/docs/METHODOLOGY)**
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# CBrowser Scoring Methodology & Research Sources
|
|
8
|
-
|
|
9
|
-
CBrowser's analysis features use **heuristic estimates** calibrated against published UX and accessibility research. This document explains our methodology, sources, and limitations.
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## Important Disclaimers
|
|
14
|
-
|
|
15
|
-
> **Letter grades, not percentages.** We use letter grades (A-F) instead of percentage scores to avoid implying false precision. These are directional indicators, not measurements.
|
|
16
|
-
|
|
17
|
-
> **Heuristic estimates, not predictions.** Scores indicate relative comparison value, not actual user behavior predictions.
|
|
18
|
-
|
|
19
|
-
> **Not a substitute for real testing.** For accessibility, combine with automated WCAG checkers and user testing with people who have disabilities.
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## Research Sources & Bibliography
|
|
24
|
-
|
|
25
|
-
### Page Load & Abandonment
|
|
26
|
-
|
|
27
|
-
| Metric | Threshold | Source |
|
|
28
|
-
|--------|-----------|--------|
|
|
29
|
-
| Mobile abandonment at 3s load | 53% | Google/SOASTA "The State of Online Retail Performance" (2017)¹ |
|
|
30
|
-
| Abandonment increase per second | +7% | Akamai "State of Online Retail Performance" (2017)² |
|
|
31
|
-
|
|
32
|
-
¹ *Google/SOASTA. "The State of Online Retail Performance." 2017. https://www.thinkwithgoogle.com/marketing-resources/data-measurement/mobile-page-speed-new-industry-benchmarks/*
|
|
33
|
-
|
|
34
|
-
² *Akamai. "Akamai Online Retail Performance Report: Milliseconds Are Critical." 2017.*
|
|
35
|
-
|
|
36
|
-
### Form Complexity & Cognitive Load
|
|
37
|
-
|
|
38
|
-
| Metric | Threshold | Source |
|
|
39
|
-
|--------|-----------|--------|
|
|
40
|
-
| Optimal form field count | 7-8 fields | Baymard Institute "Checkout Usability" (2024)³ |
|
|
41
|
-
| Average e-commerce checkout fields | 23 fields | Baymard Institute (2024)³ |
|
|
42
|
-
| Abandonment with too many steps | 67% | Baymard Institute Cart Abandonment Research⁴ |
|
|
43
|
-
|
|
44
|
-
³ *Baymard Institute. "The Current State of Checkout UX." 2024. https://baymard.com/checkout-usability*
|
|
45
|
-
|
|
46
|
-
⁴ *Baymard Institute. "49 Cart Abandonment Rate Statistics." https://baymard.com/lists/cart-abandonment-rate*
|
|
47
|
-
|
|
48
|
-
### Frustration Detection
|
|
49
|
-
|
|
50
|
-
| Metric | Definition | Source |
|
|
51
|
-
|--------|------------|--------|
|
|
52
|
-
| Rage click | 3+ clicks in 1-2 seconds | FullStory Rage Click definition⁵ |
|
|
53
|
-
| Average rage gesture rate | 6.5% of sessions | FullStory research (2023)⁵ |
|
|
54
|
-
| Dead click rate average | 8.1% of sessions | FullStory Digital Experience Benchmark (2023)⁵ |
|
|
55
|
-
|
|
56
|
-
⁵ *FullStory. "The Complete Guide to Rage Clicks." 2023. https://www.fullstory.com/blog/rage-clicks/*
|
|
57
|
-
|
|
58
|
-
### Usability Severity Scale
|
|
59
|
-
|
|
60
|
-
We calibrate severity levels to Nielsen's usability severity scale:
|
|
61
|
-
|
|
62
|
-
| Level | Nielsen Definition | CBrowser Mapping |
|
|
63
|
-
|-------|-------------------|------------------|
|
|
64
|
-
| 0 | Not a usability problem | (not flagged) |
|
|
65
|
-
| 1 | Cosmetic problem | Low severity |
|
|
66
|
-
| 2 | Minor usability problem | Medium severity |
|
|
67
|
-
| 3 | Major usability problem | High severity |
|
|
68
|
-
| 4 | Usability catastrophe | Critical severity |
|
|
69
|
-
|
|
70
|
-
⁶ *Nielsen, Jakob. "Severity Ratings for Usability Problems." Nielsen Norman Group. https://www.nngroup.com/articles/how-to-rate-the-severity-of-usability-problems/*
|
|
71
|
-
|
|
72
|
-
### Accessibility (WCAG)
|
|
73
|
-
|
|
74
|
-
| Metric | Threshold | Source |
|
|
75
|
-
|--------|-----------|--------|
|
|
76
|
-
| Sites with WCAG failures | 94.8% | WebAIM Million (2024)⁷ |
|
|
77
|
-
| Screen reader task completion | 55.6% | WebAIM Screen Reader User Survey (2024)⁸ |
|
|
78
|
-
| Touch target minimum | 44x44px | WCAG 2.5.5 (AAA) / 2.5.8 (AA)⁹ |
|
|
79
|
-
| Contrast ratio (normal text) | 4.5:1 | WCAG 1.4.3 (AA)⁹ |
|
|
80
|
-
| Contrast ratio (large text) | 3:1 | WCAG 1.4.3 (AA)⁹ |
|
|
81
|
-
|
|
82
|
-
⁷ *WebAIM. "The WebAIM Million." 2024. https://webaim.org/projects/million/*
|
|
83
|
-
|
|
84
|
-
⁸ *WebAIM. "Screen Reader User Survey #10." 2024. https://webaim.org/projects/screenreadersurvey10/*
|
|
85
|
-
|
|
86
|
-
⁹ *W3C. "Web Content Accessibility Guidelines (WCAG) 2.1." https://www.w3.org/TR/WCAG21/*
|
|
87
|
-
|
|
88
|
-
### Focus Hierarchies & Attention Patterns (v9.0.0)
|
|
89
|
-
|
|
90
|
-
| Pattern | Description | Source |
|
|
91
|
-
|---------|-------------|--------|
|
|
92
|
-
| F-pattern scanning | Users scan top horizontally, then left side vertically | Nielsen Norman Group¹⁰ |
|
|
93
|
-
| Banner blindness | Users ignore banner-like elements (~90% ignore rate) | Nielsen Norman Group¹¹ |
|
|
94
|
-
| Search usage | ~30% of users prefer search as first action | Nielsen Norman Group¹² |
|
|
95
|
-
| Miller's Law | Users can hold 7±2 items in working memory | Miller (1956)¹³ |
|
|
96
|
-
|
|
97
|
-
**Distraction Ignore Rates (Heuristic Estimates)**
|
|
98
|
-
|
|
99
|
-
| Element Type | Ignore Rate | Rationale |
|
|
100
|
-
|--------------|-------------|-----------|
|
|
101
|
-
| Cookie banners | 85% | Cookie consent fatigue |
|
|
102
|
-
| Newsletter popups | 90% | Subscription blindness |
|
|
103
|
-
| Chat widgets | 80% | Help widget blindness (unless stuck) |
|
|
104
|
-
| Social share buttons | 80% | Social widget blindness |
|
|
105
|
-
| Promotional banners | 85% | Ad blindness generalization |
|
|
106
|
-
|
|
107
|
-
*These ignore rates are heuristic estimates based on banner blindness research patterns, not precise measurements.*
|
|
108
|
-
|
|
109
|
-
**Focus Area Priorities (by Task Type)**
|
|
110
|
-
|
|
111
|
-
| Task Type | Primary Focus Areas | Secondary Focus Areas |
|
|
112
|
-
|-----------|---------------------|----------------------|
|
|
113
|
-
| find_information | Headings (95%), Navigation (85%), Search (75%) | Content (70%), CTAs (50%) |
|
|
114
|
-
| complete_action | CTAs (95%), Forms (90%), Navigation (80%) | Headings (60%), Content (50%) |
|
|
115
|
-
| explore | Hero (85%), Headings (80%), Navigation (75%) | Content (70%), Images (60%) |
|
|
116
|
-
| compare | Content (90%), Headings (85%), Navigation (70%) | CTAs (60%), Images (50%) |
|
|
117
|
-
| troubleshoot | Search (90%), Navigation (85%), Content (80%) | Headings (75%), Forms (60%) |
|
|
118
|
-
|
|
119
|
-
*Priority percentages are heuristic weights for simulation, derived from eye-tracking research patterns.*
|
|
120
|
-
|
|
121
|
-
¹⁰ *Nielsen, Jakob. "F-Shaped Pattern For Reading Web Content." Nielsen Norman Group. 2006. https://www.nngroup.com/articles/f-shaped-pattern-reading-web-content/*
|
|
122
|
-
|
|
123
|
-
¹¹ *Nielsen, Jakob. "Banner Blindness: Old and New Findings." Nielsen Norman Group. 2007. https://www.nngroup.com/articles/banner-blindness-old-and-new-findings/*
|
|
124
|
-
|
|
125
|
-
¹² *Nielsen, Jakob. "Search: Visible and Simple." Nielsen Norman Group. 2001. https://www.nngroup.com/articles/search-visible-and-simple/*
|
|
126
|
-
|
|
127
|
-
¹³ *Miller, George A. "The Magical Number Seven, Plus or Minus Two." Psychological Review. 1956.*
|
|
128
|
-
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
## Scoring Algorithms
|
|
132
|
-
|
|
133
|
-
### Competitive UX Benchmark
|
|
134
|
-
|
|
135
|
-
**Abandonment Risk Grade**
|
|
136
|
-
|
|
137
|
-
Grades based on accumulated friction, mapped to research thresholds:
|
|
138
|
-
|
|
139
|
-
| Grade | Risk Level | Interpretation |
|
|
140
|
-
|-------|------------|----------------|
|
|
141
|
-
| A | ≤15% | Very low abandonment risk |
|
|
142
|
-
| B | ≤30% | Low risk |
|
|
143
|
-
| C | ≤50% | Moderate risk (typical) |
|
|
144
|
-
| D | ≤70% | High risk |
|
|
145
|
-
| F | >70% | Very high risk |
|
|
146
|
-
|
|
147
|
-
*Formula:*
|
|
148
|
-
```
|
|
149
|
-
Risk = (100 - patience) × 0.4 + frustration × 0.3 + confusion × 0.3
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
Weights are heuristic, not derived from specific studies. The formula is designed to weight patience depletion most heavily, as research shows patience exhaustion correlates strongly with abandonment.
|
|
153
|
-
|
|
154
|
-
### Agent-Ready Audit
|
|
155
|
-
|
|
156
|
-
**Severity Penalties**
|
|
157
|
-
|
|
158
|
-
| Severity | Points Deducted | Rationale |
|
|
159
|
-
|----------|-----------------|-----------|
|
|
160
|
-
| Critical | 25 | ~Nielsen Level 4: blocks task completion |
|
|
161
|
-
| High | 15 | ~Nielsen Level 3: major obstacle |
|
|
162
|
-
| Medium | 8 | ~Nielsen Level 2: minor problem |
|
|
163
|
-
| Low | 3 | ~Nielsen Level 1: cosmetic issue |
|
|
164
|
-
|
|
165
|
-
**Category Weights**
|
|
166
|
-
|
|
167
|
-
| Category | Weight | Rationale |
|
|
168
|
-
|----------|--------|-----------|
|
|
169
|
-
| Findability | 35% | Most critical for AI agents |
|
|
170
|
-
| Stability | 30% | Selector reliability |
|
|
171
|
-
| Accessibility | 20% | ARIA provides semantic context |
|
|
172
|
-
| Semantics | 15% | HTML structure aids parsing |
|
|
173
|
-
|
|
174
|
-
*These weights are heuristic estimates based on typical AI agent interaction patterns, not derived from specific studies.*
|
|
175
|
-
|
|
176
|
-
### Accessibility Empathy Audit
|
|
177
|
-
|
|
178
|
-
**Barrier Severity Deductions**
|
|
179
|
-
|
|
180
|
-
| Severity | Points | Rationale |
|
|
181
|
-
|----------|--------|-----------|
|
|
182
|
-
| Critical | 20 | Blocks task for affected users |
|
|
183
|
-
| Major | 10 | Significant difficulty |
|
|
184
|
-
| Minor | 3 | Noticeable but manageable |
|
|
185
|
-
|
|
186
|
-
**Empathy Grade Thresholds**
|
|
187
|
-
|
|
188
|
-
| Grade | Score Range |
|
|
189
|
-
|-------|-------------|
|
|
190
|
-
| A | ≥80 |
|
|
191
|
-
| B | ≥65 |
|
|
192
|
-
| C | ≥50 |
|
|
193
|
-
| D | ≥35 |
|
|
194
|
-
| F | <35 |
|
|
195
|
-
|
|
196
|
-
---
|
|
197
|
-
|
|
198
|
-
## Limitations
|
|
199
|
-
|
|
200
|
-
### What These Scores Are
|
|
201
|
-
|
|
202
|
-
- **Directional indicators** for comparing options
|
|
203
|
-
- **Heuristic flags** for potential issues
|
|
204
|
-
- **Starting points** for investigation
|
|
205
|
-
|
|
206
|
-
### What These Scores Are NOT
|
|
207
|
-
|
|
208
|
-
- **Predictions** of actual user behavior
|
|
209
|
-
- **Guarantees** of accessibility compliance
|
|
210
|
-
- **Substitutes** for real user testing
|
|
211
|
-
- **Precise measurements** (hence letter grades)
|
|
212
|
-
|
|
213
|
-
### Recommended Complementary Testing
|
|
214
|
-
|
|
215
|
-
For comprehensive validation, combine CBrowser analysis with:
|
|
216
|
-
|
|
217
|
-
1. **Automated WCAG testing:** axe-core, WAVE, Lighthouse
|
|
218
|
-
2. **Manual accessibility review:** Keyboard navigation, screen reader testing
|
|
219
|
-
3. **User testing:** With actual users who have disabilities
|
|
220
|
-
4. **Analytics:** Real user monitoring, session replay analysis
|
|
221
|
-
5. **A/B testing:** For conversion-critical flows
|
|
222
|
-
|
|
223
|
-
---
|
|
224
|
-
|
|
225
|
-
## Cognitive Trait Research (v11.5.0)
|
|
226
|
-
|
|
227
|
-
Four research-backed cognitive traits for realistic user simulation:
|
|
228
|
-
|
|
229
|
-
| Trait | Research Basis | Key Finding |
|
|
230
|
-
|-------|---------------|-------------|
|
|
231
|
-
| **selfEfficacy** | Bandura (1977) | Low efficacy users abandon 40% faster on first error |
|
|
232
|
-
| **satisficing** | Simon (1956) | Satisficers decide 50% faster with similar outcomes |
|
|
233
|
-
| **trustCalibration** | Fogg (2003) | Trust affects CTA click-through by up to 40% |
|
|
234
|
-
| **interruptRecovery** | Mark et al. (2005) | Average recovery time is 23 minutes |
|
|
235
|
-
|
|
236
|
-
### Research Citations
|
|
237
|
-
|
|
238
|
-
¹⁴ *Bandura, A. "Self-efficacy: Toward a unifying theory of behavioral change." Psychological Review, 84(2), 191-215. 1977.*
|
|
239
|
-
|
|
240
|
-
¹⁵ *Simon, H. A. "Rational Choice and the Structure of the Environment." Psychological Review, 63(2), 129-138. 1956.*
|
|
241
|
-
|
|
242
|
-
¹⁶ *Fogg, B. J. "Persuasive Technology: Using Computers to Change What We Think and Do." Morgan Kaufmann Publishers. 2003.*
|
|
243
|
-
|
|
244
|
-
¹⁷ *Mark, G., Gonzalez, V. M., & Harris, J. "No Task Left Behind? Examining the Nature of Fragmented Work." CHI 2005.*
|
|
245
|
-
|
|
246
|
-
---
|
|
247
|
-
|
|
248
|
-
## Changelog
|
|
249
|
-
|
|
250
|
-
| Version | Date | Changes |
|
|
251
|
-
|---------|------|---------|
|
|
252
|
-
| 11.5.0 | 2026-02-07 | Added 4 cognitive trait research citations |
|
|
253
|
-
| | | Added selfEfficacy, satisficing, trustCalibration, interruptRecovery |
|
|
254
|
-
| 9.0.0 | 2026-02-06 | Added Focus Hierarchies research section |
|
|
255
|
-
| | | Added distraction ignore rate heuristics |
|
|
256
|
-
| | | Added focus area priorities by task type |
|
|
257
|
-
| | | Added Miller's Law and attention pattern citations |
|
|
258
|
-
| 8.0.0 | 2026-02-06 | Initial methodology documentation |
|
|
259
|
-
| | | Added letter grades to avoid false precision |
|
|
260
|
-
| | | Added research bibliography with citations |
|
|
261
|
-
| | | Added disclaimers to all report outputs |
|
|
262
|
-
|
|
263
|
-
---
|
|
264
|
-
|
|
265
|
-
## Contributing
|
|
266
|
-
|
|
267
|
-
If you find additional research that could improve our calibration, please open an issue or PR with:
|
|
268
|
-
|
|
269
|
-
1. The metric being updated
|
|
270
|
-
2. The new threshold/value
|
|
271
|
-
3. Citation to peer-reviewed or industry-recognized research
|
|
272
|
-
4. Explanation of methodology
|
|
273
|
-
|
|
274
|
-
---
|
|
275
|
-
|
|
276
|
-
*Generated by CBrowser v9.0.0*
|
|
@@ -1,328 +0,0 @@
|
|
|
1
|
-
> **This documentation is no longer maintained here.**
|
|
2
|
-
>
|
|
3
|
-
> For the latest version, please visit: **[Persona Questionnaire System](https://cbrowser.ai/docs/PERSONA-QUESTIONNAIRE)**
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Persona Questionnaire System
|
|
8
|
-
|
|
9
|
-
**Introduced in v16.6.0**
|
|
10
|
-
|
|
11
|
-
The Persona Questionnaire system provides research-backed trait mapping for creating custom cognitive personas. Instead of defaulting traits to 0.5 (neutral baseline), this system uses behavioral questions to derive differentiated trait profiles.
|
|
12
|
-
|
|
13
|
-
## The Problem
|
|
14
|
-
|
|
15
|
-
When creating custom personas, AI-generated profiles often defaulted many traits to 0.5. This creates "average" personas that don't accurately represent real user diversity.
|
|
16
|
-
|
|
17
|
-
## The Solution
|
|
18
|
-
|
|
19
|
-
The questionnaire system:
|
|
20
|
-
1. Maps behavioral answers to trait values (0-1 scale)
|
|
21
|
-
2. Uses 5 distinct behavioral levels per trait (0, 0.25, 0.5, 0.75, 1.0)
|
|
22
|
-
3. Applies research-backed correlations between traits
|
|
23
|
-
4. Provides behavioral descriptions based on academic research
|
|
24
|
-
|
|
25
|
-
## Quick Start
|
|
26
|
-
|
|
27
|
-
### CLI Usage
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
# Interactive 8-question questionnaire
|
|
31
|
-
npx cbrowser persona-questionnaire start
|
|
32
|
-
|
|
33
|
-
# Comprehensive 25-trait questionnaire
|
|
34
|
-
npx cbrowser persona-questionnaire start --comprehensive --name "my-persona"
|
|
35
|
-
|
|
36
|
-
# Look up trait behavior at specific value
|
|
37
|
-
npx cbrowser persona-questionnaire lookup --trait patience --value 0.25
|
|
38
|
-
|
|
39
|
-
# List all available traits
|
|
40
|
-
npx cbrowser persona-questionnaire list-traits
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### Programmatic Usage
|
|
44
|
-
|
|
45
|
-
```typescript
|
|
46
|
-
import {
|
|
47
|
-
generatePersonaQuestionnaire,
|
|
48
|
-
buildTraitsFromAnswers,
|
|
49
|
-
getTraitBehaviors,
|
|
50
|
-
getTraitLabel,
|
|
51
|
-
} from 'cbrowser';
|
|
52
|
-
|
|
53
|
-
// Generate questionnaire
|
|
54
|
-
const questionnaire = generatePersonaQuestionnaire({ comprehensive: false });
|
|
55
|
-
|
|
56
|
-
// Build traits from answers
|
|
57
|
-
const traits = buildTraitsFromAnswers({
|
|
58
|
-
patience: 0.25,
|
|
59
|
-
riskTolerance: 0.75,
|
|
60
|
-
curiosity: 1.0,
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
// Look up specific trait behavior
|
|
64
|
-
const behaviors = getTraitBehaviors('patience', 0.25);
|
|
65
|
-
console.log(behaviors.label); // "Low"
|
|
66
|
-
console.log(behaviors.behaviors); // ["Gets frustrated quickly", ...]
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### MCP Tools
|
|
70
|
-
|
|
71
|
-
Three MCP tools are available:
|
|
72
|
-
|
|
73
|
-
| Tool | Description |
|
|
74
|
-
|------|-------------|
|
|
75
|
-
| `persona_questionnaire_get` | Generate questionnaire questions |
|
|
76
|
-
| `persona_questionnaire_build` | Build trait profile from answers |
|
|
77
|
-
| `persona_trait_lookup` | Look up behaviors for trait value |
|
|
78
|
-
|
|
79
|
-
## The 25 Cognitive Traits
|
|
80
|
-
|
|
81
|
-
| Trait | Research Basis | What It Models |
|
|
82
|
-
|-------|---------------|----------------|
|
|
83
|
-
| **patience** | UX research | Time before abandoning on friction |
|
|
84
|
-
| **riskTolerance** | Prospect theory | Willingness to try unfamiliar actions |
|
|
85
|
-
| **comprehension** | Cognitive load theory | UI pattern understanding |
|
|
86
|
-
| **persistence** | Motivation research | Retry behavior after failures |
|
|
87
|
-
| **curiosity** | Exploration theory | Feature discovery tendency |
|
|
88
|
-
| **workingMemory** | Cognitive psychology | Multi-step task handling |
|
|
89
|
-
| **readingTendency** | Eye-tracking studies | Text consumption behavior |
|
|
90
|
-
| **resilience** | Positive psychology | Bounce-back from errors |
|
|
91
|
-
| **selfEfficacy** | Bandura (1977) | Belief in problem-solving ability |
|
|
92
|
-
| **satisficing** | Simon (1956) | Accept "good enough" vs optimize |
|
|
93
|
-
| **trustCalibration** | Fogg (2003) | Trust in unfamiliar interfaces |
|
|
94
|
-
| **interruptRecovery** | Mark et al. (2005) | Resume after distractions |
|
|
95
|
-
| **decisionFatigue** | Baumeister | Decision quality over time |
|
|
96
|
-
| **internalAttribution** | Attribution theory | Self-blame for failures |
|
|
97
|
-
| **externalAttribution** | Attribution theory | System-blame for failures |
|
|
98
|
-
| **techSavviness** | Digital literacy | Familiarity with UI patterns |
|
|
99
|
-
| **attentionSpan** | Attention research | Focus duration |
|
|
100
|
-
| **impulsivity** | Behavioral psychology | Quick vs deliberate actions |
|
|
101
|
-
| **errorRecovery** | Human factors | Speed of correcting mistakes |
|
|
102
|
-
| **visualProcessing** | Cognitive science | Image vs text preference |
|
|
103
|
-
| **spatialMemory** | Navigation research | UI layout recall |
|
|
104
|
-
| **patternRecognition** | Expertise research | UI element identification |
|
|
105
|
-
| **riskPerception** | Risk psychology | Danger assessment |
|
|
106
|
-
| **socialProof** | Cialdini (1984) | Influence of others' actions |
|
|
107
|
-
| **authorityTrust** | Trust research | Trust in official sources |
|
|
108
|
-
|
|
109
|
-
## Trait Reference Matrix
|
|
110
|
-
|
|
111
|
-
Each trait has 5 behavioral levels with specific descriptions:
|
|
112
|
-
|
|
113
|
-
### Example: Patience Trait
|
|
114
|
-
|
|
115
|
-
| Value | Label | Behaviors |
|
|
116
|
-
|-------|-------|-----------|
|
|
117
|
-
| 0 | Very Low | Abandons at first sign of friction, expects instant results |
|
|
118
|
-
| 0.25 | Low | Gets frustrated quickly, skips slow-loading content |
|
|
119
|
-
| 0.5 | Moderate | Waits reasonable time, tolerates some friction |
|
|
120
|
-
| 0.75 | High | Patient with delays, reads loading messages |
|
|
121
|
-
| 1.0 | Very High | Extremely patient, waits through any delay |
|
|
122
|
-
|
|
123
|
-
### Example: Self-Efficacy Trait
|
|
124
|
-
|
|
125
|
-
| Value | Label | Behaviors |
|
|
126
|
-
|-------|-------|-----------|
|
|
127
|
-
| 0 | Very Low | "I can't do this", gives up immediately on challenge |
|
|
128
|
-
| 0.25 | Low | Doubts ability, abandons 40% faster than average |
|
|
129
|
-
| 0.5 | Moderate | Normal confidence, persists through minor challenges |
|
|
130
|
-
| 0.75 | High | Confident problem-solver, sees obstacles as puzzles |
|
|
131
|
-
| 1.0 | Very High | "I'll figure this out", never attributes failure to self |
|
|
132
|
-
|
|
133
|
-
## Trait Correlations
|
|
134
|
-
|
|
135
|
-
The system automatically applies research-backed correlations:
|
|
136
|
-
|
|
137
|
-
| Primary Trait | Correlated Trait | Relationship |
|
|
138
|
-
|---------------|------------------|--------------|
|
|
139
|
-
| Low selfEfficacy | High internalAttribution | Self-blame for failures |
|
|
140
|
-
| Low selfEfficacy | Low resilience | Slower bounce-back |
|
|
141
|
-
| Low patience | Low resilience | Less tolerance for errors |
|
|
142
|
-
| High curiosity | Higher exploration | More feature discovery |
|
|
143
|
-
| Low trustCalibration | Longer evaluation time | Scrutinizes CTAs |
|
|
144
|
-
|
|
145
|
-
## Questionnaire Formats
|
|
146
|
-
|
|
147
|
-
### Quick Questionnaire (8 traits)
|
|
148
|
-
|
|
149
|
-
Core traits for basic persona differentiation:
|
|
150
|
-
- patience, riskTolerance, comprehension, persistence
|
|
151
|
-
- curiosity, workingMemory, readingTendency, resilience
|
|
152
|
-
|
|
153
|
-
### Comprehensive Questionnaire (25 traits)
|
|
154
|
-
|
|
155
|
-
All cognitive traits for detailed behavioral modeling.
|
|
156
|
-
|
|
157
|
-
### Custom Selection
|
|
158
|
-
|
|
159
|
-
Request specific traits:
|
|
160
|
-
|
|
161
|
-
```typescript
|
|
162
|
-
const questionnaire = generatePersonaQuestionnaire({
|
|
163
|
-
traits: ['patience', 'selfEfficacy', 'trustCalibration'],
|
|
164
|
-
});
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
## AskUserQuestion Integration
|
|
168
|
-
|
|
169
|
-
For Claude sessions, use the `formatForAskUserQuestion` function:
|
|
170
|
-
|
|
171
|
-
```typescript
|
|
172
|
-
import { formatForAskUserQuestion, generatePersonaQuestionnaire } from 'cbrowser';
|
|
173
|
-
|
|
174
|
-
const questionnaire = generatePersonaQuestionnaire({ comprehensive: false });
|
|
175
|
-
const askUserFormat = formatForAskUserQuestion(questionnaire.questions);
|
|
176
|
-
|
|
177
|
-
// Returns format compatible with Claude's AskUserQuestion tool:
|
|
178
|
-
// {
|
|
179
|
-
// questions: [
|
|
180
|
-
// {
|
|
181
|
-
// question: "How does this user handle waiting?",
|
|
182
|
-
// header: "patience",
|
|
183
|
-
// options: [
|
|
184
|
-
// { label: "Very impatient", description: "Abandons at first delay" },
|
|
185
|
-
// ...
|
|
186
|
-
// ],
|
|
187
|
-
// multiSelect: false
|
|
188
|
-
// },
|
|
189
|
-
// ...
|
|
190
|
-
// ]
|
|
191
|
-
// }
|
|
192
|
-
```
|
|
193
|
-
|
|
194
|
-
## CLI Interactive Mode
|
|
195
|
-
|
|
196
|
-
The CLI provides an interactive questionnaire experience:
|
|
197
|
-
|
|
198
|
-
```bash
|
|
199
|
-
$ npx cbrowser persona-questionnaire start --name "anxious-newbie"
|
|
200
|
-
|
|
201
|
-
=== CBrowser Persona Questionnaire ===
|
|
202
|
-
Creating persona: anxious-newbie (8 core traits)
|
|
203
|
-
|
|
204
|
-
[1/8] Patience
|
|
205
|
-
How does this user handle waiting for pages or actions?
|
|
206
|
-
1. Very impatient - abandons at first delay
|
|
207
|
-
2. Somewhat impatient - frustrated by normal load times
|
|
208
|
-
3. Average - tolerates reasonable waits
|
|
209
|
-
4. Patient - waits through delays calmly
|
|
210
|
-
5. Very patient - unlimited patience
|
|
211
|
-
> 2
|
|
212
|
-
|
|
213
|
-
[2/8] Risk Tolerance
|
|
214
|
-
How willing is this user to try unfamiliar features?
|
|
215
|
-
...
|
|
216
|
-
|
|
217
|
-
=== Persona Created ===
|
|
218
|
-
Saved to: ~/.cbrowser/personas/anxious-newbie.json
|
|
219
|
-
```
|
|
220
|
-
|
|
221
|
-
## Using Custom Personas
|
|
222
|
-
|
|
223
|
-
After creating a persona via questionnaire:
|
|
224
|
-
|
|
225
|
-
```typescript
|
|
226
|
-
import { runCognitiveJourney } from 'cbrowser';
|
|
227
|
-
|
|
228
|
-
const result = await runCognitiveJourney({
|
|
229
|
-
persona: 'anxious-newbie', // Uses saved persona
|
|
230
|
-
startUrl: 'https://example.com',
|
|
231
|
-
goal: 'complete signup',
|
|
232
|
-
});
|
|
233
|
-
```
|
|
234
|
-
|
|
235
|
-
Or with inline traits:
|
|
236
|
-
|
|
237
|
-
```typescript
|
|
238
|
-
const customTraits = buildTraitsFromAnswers({
|
|
239
|
-
patience: 0.25,
|
|
240
|
-
selfEfficacy: 0.25,
|
|
241
|
-
trustCalibration: 0.25,
|
|
242
|
-
});
|
|
243
|
-
|
|
244
|
-
const result = await runCognitiveJourney({
|
|
245
|
-
persona: 'custom',
|
|
246
|
-
customTraits,
|
|
247
|
-
startUrl: 'https://example.com',
|
|
248
|
-
goal: 'complete signup',
|
|
249
|
-
});
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
## Research Citations
|
|
253
|
-
|
|
254
|
-
The trait system is grounded in academic research:
|
|
255
|
-
|
|
256
|
-
- **Bandura, A. (1977)** - Self-Efficacy: Toward a Unifying Theory of Behavioral Change
|
|
257
|
-
- **Kahneman, D. & Tversky, A.** - Prospect Theory and Decision Making
|
|
258
|
-
- **Simon, H. (1956)** - Satisficing and Administrative Behavior
|
|
259
|
-
- **Fogg, B.J. (2003)** - Persuasive Technology and Trust
|
|
260
|
-
- **Mark, G. et al. (2005)** - No Task Left Behind: Interrupt Recovery
|
|
261
|
-
- **Baumeister, R.** - Ego Depletion and Decision Fatigue
|
|
262
|
-
- **Nielsen, J.** - Usability Engineering and User Behavior
|
|
263
|
-
- **Cialdini, R. (1984)** - Influence: The Psychology of Persuasion
|
|
264
|
-
|
|
265
|
-
## API Reference
|
|
266
|
-
|
|
267
|
-
### generatePersonaQuestionnaire(options)
|
|
268
|
-
|
|
269
|
-
Generate questionnaire questions.
|
|
270
|
-
|
|
271
|
-
```typescript
|
|
272
|
-
interface QuestionnaireOptions {
|
|
273
|
-
comprehensive?: boolean; // All 25 traits (default: false = 8 traits)
|
|
274
|
-
traits?: string[]; // Specific traits to include
|
|
275
|
-
includeResearch?: boolean; // Include research citations
|
|
276
|
-
}
|
|
277
|
-
|
|
278
|
-
const questionnaire = generatePersonaQuestionnaire(options);
|
|
279
|
-
// Returns: { questions: Question[], estimatedMinutes: number }
|
|
280
|
-
```
|
|
281
|
-
|
|
282
|
-
### buildTraitsFromAnswers(answers)
|
|
283
|
-
|
|
284
|
-
Build complete trait profile from questionnaire answers.
|
|
285
|
-
|
|
286
|
-
```typescript
|
|
287
|
-
const traits = buildTraitsFromAnswers({
|
|
288
|
-
patience: 0.25,
|
|
289
|
-
curiosity: 0.75,
|
|
290
|
-
});
|
|
291
|
-
// Returns: CognitiveTraits with correlations applied
|
|
292
|
-
```
|
|
293
|
-
|
|
294
|
-
### getTraitBehaviors(trait, value)
|
|
295
|
-
|
|
296
|
-
Get behavioral description for a trait value.
|
|
297
|
-
|
|
298
|
-
```typescript
|
|
299
|
-
const behaviors = getTraitBehaviors('patience', 0.25);
|
|
300
|
-
// Returns: { label: string, description: string, behaviors: string[] }
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
### getTraitLabel(trait, value)
|
|
304
|
-
|
|
305
|
-
Get short label for trait value.
|
|
306
|
-
|
|
307
|
-
```typescript
|
|
308
|
-
const label = getTraitLabel('patience', 0.25);
|
|
309
|
-
// Returns: "Low"
|
|
310
|
-
```
|
|
311
|
-
|
|
312
|
-
### getTraitReference(trait)
|
|
313
|
-
|
|
314
|
-
Get full research reference for a trait.
|
|
315
|
-
|
|
316
|
-
```typescript
|
|
317
|
-
const ref = getTraitReference('selfEfficacy');
|
|
318
|
-
// Returns: { researchBasis: string, citations: string[], levels: Level[] }
|
|
319
|
-
```
|
|
320
|
-
|
|
321
|
-
### formatForAskUserQuestion(questions)
|
|
322
|
-
|
|
323
|
-
Format questions for Claude's AskUserQuestion tool.
|
|
324
|
-
|
|
325
|
-
```typescript
|
|
326
|
-
const formatted = formatForAskUserQuestion(questions);
|
|
327
|
-
// Returns: { questions: AskUserQuestion[] }
|
|
328
|
-
```
|
package/docs/README.md
DELETED
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
> **This documentation is no longer maintained here.**
|
|
2
|
-
>
|
|
3
|
-
> For the latest version, please visit: **[CBrowser Documentation](https://cbrowser.ai/docs/README)**
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# CBrowser Documentation
|
|
8
|
-
|
|
9
|
-
**Full documentation has moved to: [https://cbrowser.ai/docs](https://cbrowser.ai/docs)**
|
|
10
|
-
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
## Quick Links
|
|
14
|
-
|
|
15
|
-
| Resource | URL |
|
|
16
|
-
|----------|-----|
|
|
17
|
-
| **Documentation Home** | [cbrowser.ai/docs](https://cbrowser.ai/docs) |
|
|
18
|
-
| **Getting Started** | [cbrowser.ai/docs/Getting-Started](https://cbrowser.ai/docs/Getting-Started) |
|
|
19
|
-
| **CLI Reference** | [cbrowser.ai/docs/CLI-Reference](https://cbrowser.ai/docs/CLI-Reference) |
|
|
20
|
-
| **API Reference** | [cbrowser.ai/docs/API-Reference](https://cbrowser.ai/docs/API-Reference) |
|
|
21
|
-
| **MCP Server Setup** | [cbrowser.ai/docs/MCP-Server](https://cbrowser.ai/docs/MCP-Server) |
|
|
22
|
-
| **Persona Index** | [cbrowser.ai/docs/Persona-Index](https://cbrowser.ai/docs/Persona-Index) |
|
|
23
|
-
| **Trait Index** | [cbrowser.ai/docs/Trait-Index](https://cbrowser.ai/docs/Trait-Index) |
|
|
24
|
-
|
|
25
|
-
## Why the Move?
|
|
26
|
-
|
|
27
|
-
The documentation is now hosted on [cbrowser.ai](https://cbrowser.ai) for:
|
|
28
|
-
|
|
29
|
-
- **Better search** — Full-text search across all docs
|
|
30
|
-
- **Always current** — Auto-updated with each release
|
|
31
|
-
- **Better navigation** — Sidebar, breadcrumbs, related pages
|
|
32
|
-
- **Mobile-friendly** — Responsive design for reading on any device
|
|
33
|
-
|
|
34
|
-
## Local Files
|
|
35
|
-
|
|
36
|
-
This directory contains a few files for reference:
|
|
37
|
-
|
|
38
|
-
- `STRESS-TEST-v16.14.4.md` — Grade A+ stress test results
|
|
39
|
-
- `AUTH0-SETUP.md` — Auth0 OAuth configuration for remote MCP
|
|
40
|
-
|
|
41
|
-
For all other documentation, please visit **[cbrowser.ai/docs](https://cbrowser.ai/docs)**.
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
45
|
-
© 2026 Alexandria Eden | [cbrowser.ai](https://cbrowser.ai)
|