cbrowser 16.7.0 → 16.7.2

package/docs/PERSONA-QUESTIONNAIRE.md

@@ -0,0 +1,322 @@
+# Persona Questionnaire System
+
+**Introduced in v16.6.0**
+
+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.
+
+## The Problem
+
+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.
+
+## The Solution
+
+The questionnaire system:
+1. Maps behavioral answers to trait values (0-1 scale)
+2. Uses 5 distinct behavioral levels per trait (0, 0.25, 0.5, 0.75, 1.0)
+3. Applies research-backed correlations between traits
+4. Provides behavioral descriptions based on academic research
+
+## Quick Start
+
+### CLI Usage
+
+```bash
+# Interactive 8-question questionnaire
+npx cbrowser persona-questionnaire start
+
+# Comprehensive 25-trait questionnaire
+npx cbrowser persona-questionnaire start --comprehensive --name "my-persona"
+
+# Look up trait behavior at specific value
+npx cbrowser persona-questionnaire lookup --trait patience --value 0.25
+
+# List all available traits
+npx cbrowser persona-questionnaire list-traits
+```
+
+### Programmatic Usage
+
+```typescript
+import {
+  generatePersonaQuestionnaire,
+  buildTraitsFromAnswers,
+  getTraitBehaviors,
+  getTraitLabel,
+} from 'cbrowser';
+
+// Generate questionnaire
+const questionnaire = generatePersonaQuestionnaire({ comprehensive: false });
+
+// Build traits from answers
+const traits = buildTraitsFromAnswers({
+  patience: 0.25,
+  riskTolerance: 0.75,
+  curiosity: 1.0,
+});
+
+// Look up specific trait behavior
+const behaviors = getTraitBehaviors('patience', 0.25);
+console.log(behaviors.label);       // "Low"
+console.log(behaviors.behaviors);   // ["Gets frustrated quickly", ...]
+```
+
+### MCP Tools
+
+Three MCP tools are available:
+
+| Tool | Description |
+|------|-------------|
+| `persona_questionnaire_get` | Generate questionnaire questions |
+| `persona_questionnaire_build` | Build trait profile from answers |
+| `persona_trait_lookup` | Look up behaviors for trait value |
+
+## The 25 Cognitive Traits
+
+| Trait | Research Basis | What It Models |
+|-------|---------------|----------------|
+| **patience** | UX research | Time before abandoning on friction |
+| **riskTolerance** | Prospect theory | Willingness to try unfamiliar actions |
+| **comprehension** | Cognitive load theory | UI pattern understanding |
+| **persistence** | Motivation research | Retry behavior after failures |
+| **curiosity** | Exploration theory | Feature discovery tendency |
+| **workingMemory** | Cognitive psychology | Multi-step task handling |
+| **readingTendency** | Eye-tracking studies | Text consumption behavior |
+| **resilience** | Positive psychology | Bounce-back from errors |
+| **selfEfficacy** | Bandura (1977) | Belief in problem-solving ability |
+| **satisficing** | Simon (1956) | Accept "good enough" vs optimize |
+| **trustCalibration** | Fogg (2003) | Trust in unfamiliar interfaces |
+| **interruptRecovery** | Mark et al. (2005) | Resume after distractions |
+| **decisionFatigue** | Baumeister | Decision quality over time |
+| **internalAttribution** | Attribution theory | Self-blame for failures |
+| **externalAttribution** | Attribution theory | System-blame for failures |
+| **techSavviness** | Digital literacy | Familiarity with UI patterns |
+| **attentionSpan** | Attention research | Focus duration |
+| **impulsivity** | Behavioral psychology | Quick vs deliberate actions |
+| **errorRecovery** | Human factors | Speed of correcting mistakes |
+| **visualProcessing** | Cognitive science | Image vs text preference |
+| **spatialMemory** | Navigation research | UI layout recall |
+| **patternRecognition** | Expertise research | UI element identification |
+| **riskPerception** | Risk psychology | Danger assessment |
+| **socialProof** | Cialdini (1984) | Influence of others' actions |
+| **authorityTrust** | Trust research | Trust in official sources |
+
+## Trait Reference Matrix
+
+Each trait has 5 behavioral levels with specific descriptions:
+
+### Example: Patience Trait
+
+| Value | Label | Behaviors |
+|-------|-------|-----------|
+| 0 | Very Low | Abandons at first sign of friction, expects instant results |
+| 0.25 | Low | Gets frustrated quickly, skips slow-loading content |
+| 0.5 | Moderate | Waits reasonable time, tolerates some friction |
+| 0.75 | High | Patient with delays, reads loading messages |
+| 1.0 | Very High | Extremely patient, waits through any delay |
+
+### Example: Self-Efficacy Trait
+
+| Value | Label | Behaviors |
+|-------|-------|-----------|
+| 0 | Very Low | "I can't do this", gives up immediately on challenge |
+| 0.25 | Low | Doubts ability, abandons 40% faster than average |
+| 0.5 | Moderate | Normal confidence, persists through minor challenges |
+| 0.75 | High | Confident problem-solver, sees obstacles as puzzles |
+| 1.0 | Very High | "I'll figure this out", never attributes failure to self |
+
+## Trait Correlations
+
+The system automatically applies research-backed correlations:
+
+| Primary Trait | Correlated Trait | Relationship |
+|---------------|------------------|--------------|
+| Low selfEfficacy | High internalAttribution | Self-blame for failures |
+| Low selfEfficacy | Low resilience | Slower bounce-back |
+| Low patience | Low resilience | Less tolerance for errors |
+| High curiosity | Higher exploration | More feature discovery |
+| Low trustCalibration | Longer evaluation time | Scrutinizes CTAs |
+
+## Questionnaire Formats
+
+### Quick Questionnaire (8 traits)
+
+Core traits for basic persona differentiation:
+- patience, riskTolerance, comprehension, persistence
+- curiosity, workingMemory, readingTendency, resilience
+
+### Comprehensive Questionnaire (25 traits)
+
+All cognitive traits for detailed behavioral modeling.
+
+### Custom Selection
+
+Request specific traits:
+
+```typescript
+const questionnaire = generatePersonaQuestionnaire({
+  traits: ['patience', 'selfEfficacy', 'trustCalibration'],
+});
+```
+
+## AskUserQuestion Integration
+
+For Claude sessions, use the `formatForAskUserQuestion` function:
+
+```typescript
+import { formatForAskUserQuestion, generatePersonaQuestionnaire } from 'cbrowser';
+
+const questionnaire = generatePersonaQuestionnaire({ comprehensive: false });
+const askUserFormat = formatForAskUserQuestion(questionnaire.questions);
+
+// Returns format compatible with Claude's AskUserQuestion tool:
+// {
+//   questions: [
+//     {
+//       question: "How does this user handle waiting?",
+//       header: "patience",
+//       options: [
+//         { label: "Very impatient", description: "Abandons at first delay" },
+//         ...
+//       ],
+//       multiSelect: false
+//     },
+//     ...
+//   ]
+// }
+```
+
+## CLI Interactive Mode
+
+The CLI provides an interactive questionnaire experience:
+
+```bash
+$ npx cbrowser persona-questionnaire start --name "anxious-newbie"
+
+=== CBrowser Persona Questionnaire ===
+Creating persona: anxious-newbie (8 core traits)
+
+[1/8] Patience
+How does this user handle waiting for pages or actions?
+  1. Very impatient - abandons at first delay
+  2. Somewhat impatient - frustrated by normal load times
+  3. Average - tolerates reasonable waits
+  4. Patient - waits through delays calmly
+  5. Very patient - unlimited patience
+> 2
+
+[2/8] Risk Tolerance
+How willing is this user to try unfamiliar features?
+...
+
+=== Persona Created ===
+Saved to: ~/.cbrowser/personas/anxious-newbie.json
+```
+
+## Using Custom Personas
+
+After creating a persona via questionnaire:
+
+```typescript
+import { runCognitiveJourney } from 'cbrowser';
+
+const result = await runCognitiveJourney({
+  persona: 'anxious-newbie',  // Uses saved persona
+  startUrl: 'https://example.com',
+  goal: 'complete signup',
+});
+```
+
+Or with inline traits:
+
+```typescript
+const customTraits = buildTraitsFromAnswers({
+  patience: 0.25,
+  selfEfficacy: 0.25,
+  trustCalibration: 0.25,
+});
+
+const result = await runCognitiveJourney({
+  persona: 'custom',
+  customTraits,
+  startUrl: 'https://example.com',
+  goal: 'complete signup',
+});
+```
+
+## Research Citations
+
+The trait system is grounded in academic research:
+
+- **Bandura, A. (1977)** - Self-Efficacy: Toward a Unifying Theory of Behavioral Change
+- **Kahneman, D. & Tversky, A.** - Prospect Theory and Decision Making
+- **Simon, H. (1956)** - Satisficing and Administrative Behavior
+- **Fogg, B.J. (2003)** - Persuasive Technology and Trust
+- **Mark, G. et al. (2005)** - No Task Left Behind: Interrupt Recovery
+- **Baumeister, R.** - Ego Depletion and Decision Fatigue
+- **Nielsen, J.** - Usability Engineering and User Behavior
+- **Cialdini, R. (1984)** - Influence: The Psychology of Persuasion
+
+## API Reference
+
+### generatePersonaQuestionnaire(options)
+
+Generate questionnaire questions.
+
+```typescript
+interface QuestionnaireOptions {
+  comprehensive?: boolean;     // All 25 traits (default: false = 8 traits)
+  traits?: string[];           // Specific traits to include
+  includeResearch?: boolean;   // Include research citations
+}
+
+const questionnaire = generatePersonaQuestionnaire(options);
+// Returns: { questions: Question[], estimatedMinutes: number }
+```
+
+### buildTraitsFromAnswers(answers)
+
+Build complete trait profile from questionnaire answers.
+
+```typescript
+const traits = buildTraitsFromAnswers({
+  patience: 0.25,
+  curiosity: 0.75,
+});
+// Returns: CognitiveTraits with correlations applied
+```
+
+### getTraitBehaviors(trait, value)
+
+Get behavioral description for a trait value.
+
+```typescript
+const behaviors = getTraitBehaviors('patience', 0.25);
+// Returns: { label: string, description: string, behaviors: string[] }
+```
+
+### getTraitLabel(trait, value)
+
+Get short label for trait value.
+
+```typescript
+const label = getTraitLabel('patience', 0.25);
+// Returns: "Low"
+```
+
+### getTraitReference(trait)
+
+Get full research reference for a trait.
+
+```typescript
+const ref = getTraitReference('selfEfficacy');
+// Returns: { researchBasis: string, citations: string[], levels: Level[] }
+```
+
+### formatForAskUserQuestion(questions)
+
+Format questions for Claude's AskUserQuestion tool.
+
+```typescript
+const formatted = formatForAskUserQuestion(questions);
+// Returns: { questions: AskUserQuestion[] }
+```

package/docs/README.md

@@ -0,0 +1,74 @@
+# CBrowser Documentation
+
+Welcome to the CBrowser documentation. This directory contains comprehensive guides for all CBrowser features.
+
+## Quick Links
+
+| Guide | Description |
+|-------|-------------|
+| [Getting Started](./GETTING-STARTED.md) | Installation, first commands, basic usage |
+| [Cognitive Simulation](./COGNITIVE-SIMULATION.md) | User simulation, personas, trait system |
+| [Persona Questionnaire](./PERSONA-QUESTIONNAIRE.md) | Research-backed custom persona creation |
+| [Visual Testing](./VISUAL-TESTING.md) | AI visual regression, cross-browser, responsive |
+| [MCP Integration](./MCP-INTEGRATION.md) | Claude Desktop and remote MCP server setup |
+| [Natural Language Tests](./NATURAL-LANGUAGE-TESTS.md) | Writing tests in plain English |
+| [Constitutional Safety](./CONSTITUTIONAL-SAFETY.md) | Risk classification and safety zones |
+| [CLI Reference](./CLI-REFERENCE.md) | Complete command-line reference |
+| [API Reference](./API-REFERENCE.md) | TypeScript API documentation |
+
+## Feature Guides
+
+### Core Features
+- [Self-Healing Selectors](./SELF-HEALING-SELECTORS.md) - ARIA-first selector strategy
+- [Agent-Ready Audit](./AGENT-READY-AUDIT.md) - AI-agent friendliness analysis
+- [Competitive Benchmark](./COMPETITIVE-BENCHMARK.md) - UX comparison across sites
+- [Empathy Audit](./EMPATHY-AUDIT.md) - Disability simulation testing
+
+### Testing Features
+- [Test Suites](./TEST-SUITES.md) - Natural language test execution
+- [Test Repair](./TEST-REPAIR.md) - AI-powered test fixing
+- [Flaky Detection](./FLAKY-DETECTION.md) - Identify unreliable tests
+- [Coverage Mapping](./COVERAGE-MAPPING.md) - Find untested pages
+
+### Visual Features
+- [Visual Baselines](./VISUAL-BASELINES.md) - Capture and compare screenshots
+- [Cross-Browser Testing](./CROSS-BROWSER-TESTING.md) - Chrome, Firefox, Safari comparison
+- [Responsive Testing](./RESPONSIVE-TESTING.md) - Mobile, tablet, desktop viewports
+- [A/B Comparison](./AB-COMPARISON.md) - Compare two URLs visually
+
+### Advanced Features
+- [Chaos Testing](./CHAOS-TESTING.md) - Inject failures, test resilience
+- [Bug Hunting](./BUG-HUNTING.md) - Autonomous issue discovery
+- [Performance Testing](./PERFORMANCE-TESTING.md) - Regression detection
+- [Session Management](./SESSION-MANAGEMENT.md) - Save and restore browser state
+
+## MCP Tools Reference
+
+CBrowser provides 48 MCP tools organized by category:
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| **Navigation** | 5 | Navigate, screenshot, extract, cloudflare detection |
+| **Interaction** | 4 | Click, smart click, fill, scroll |
+| **Testing** | 3 | Test suites, repair, flaky detection |
+| **Visual** | 6 | Baselines, regression, cross-browser, responsive, A/B |
+| **Cognitive** | 3 | Journey init, state update, persona comparison |
+| **Persona** | 3 | Questionnaire, build, trait lookup |
+| **Analysis** | 5 | Bug hunt, chaos, agent audit, benchmark, empathy |
+| **Stealth** | 5 | Enable, disable, status, check, diagnose |
+
+See [MCP Integration](./MCP-INTEGRATION.md) for complete tool documentation.
+
+## Version History
+
+See [CHANGELOG.md](../CHANGELOG.md) for detailed release notes.
+
+### Current Version: 16.7.0
+
+Key features:
+- 48 MCP tools for Claude integration
+- Research-backed persona questionnaire system
+- 25 cognitive traits with behavioral mappings
+- Accessibility empathy testing
+- Competitive UX benchmarking
+- Agent-ready site auditing

package/docs/personas/Persona-ADHD.md

@@ -0,0 +1,135 @@
+# Cognitive ADHD User
+
+**Category**: Accessibility Personas
+**Description**: Users with Attention Deficit Hyperactivity Disorder experiencing challenges with sustained attention, working memory, and impulse control
+
+## Overview
+
+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.
+
+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.
+
+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.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.2 | Difficulty sustaining attention during delays; fidgeting and frustration with waiting |
+| riskTolerance | 0.7 | Impulsivity leads to action before full consideration of consequences |
+| comprehension | 0.6 | Capable when engaged; inconsistent when attention wanders |
+| persistence | 0.3 | Low for unengaging tasks; can hyperfocus on interesting challenges |
+| curiosity | 0.9 | High novelty-seeking; drawn to new and interesting content |
+| workingMemory | 0.3 | Significant challenge; difficulty holding multiple items in mind |
+| readingTendency | 0.2 | Skim or skip text; prefer visual and interactive content |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.4 | Emotional dysregulation common; frustration and discouragement |
+| selfEfficacy | 0.4 | May have experienced repeated failures; internalized self-doubt |
+| trustCalibration | 0.5 | Moderate; may act impulsively before evaluating trustworthiness |
+| interruptRecovery | 0.3 | Extremely difficult to resume after distraction; may abandon |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.7 | Accept good-enough options to reduce decision fatigue |
+| informationForaging | 0.4 | Distractible; may go down tangential paths |
+| anchoringBias | 0.6 | First option favored due to decision fatigue avoidance |
+| timeHorizon | 0.3 | Strong preference for immediate rewards; difficulty with delayed gratification |
+| attributionStyle | 0.3 | May blame self; history of perceived failures |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.3 | Difficulty with planning and organization; reactive approach |
+| proceduralFluency | 0.4 | Inconsistent; routines help but are difficult to establish |
+| transferLearning | 0.5 | Variable; depends on engagement level |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.6 | May miss changes when attention elsewhere; hyperfocus can cause tunnel vision |
+| mentalModelRigidity | 0.4 | Flexible thinking; sometimes too flexible (difficulty maintaining mental model) |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.4 | May question or ignore authority recommendations impulsively |
+| emotionalContagion | 0.6 | Heightened emotional sensitivity |
+| fomo | 0.7 | Fear of missing out drives engagement with notifications, new features |
+| socialProofSensitivity | 0.5 | Moderate influence; depends on current focus |
+
+## Behavioral Patterns
+
+### Navigation
+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.
+
+### Decision Making
+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.
+
+### Error Recovery
+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.
+
+### Abandonment Triggers
+- Lengthy forms without progress saving
+- Walls of text
+- Visual clutter and competing attention demands
+- Slow loading without engaging feedback
+- Multi-step processes requiring memory of previous steps
+- Punitive error handling
+- Boring or unstimulating interfaces
+- Too many choices
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Low working memory | Progress indicators; save state frequently; reduce memory requirements |
+| Distractibility | Minimize visual clutter; clear focal points; hide non-essential elements |
+| Impulsivity | Gentle confirmation for important actions; easy undo; forgiving design |
+| Low persistence | Quick wins early; gamification elements; break tasks into small steps |
+| Reading difficulty | Scannable content; bullet points; visual communication |
+| Time blindness | Clear time estimates; progress indicators; gentle reminders |
+| Decision fatigue | Reduce choices; smart defaults; recommended options |
+
+## Research Basis
+
+- Barkley, R.A. (2015). Attention-Deficit Hyperactivity Disorder: A Handbook - Executive function deficits
+- Hallowell, E.M. & Ratey, J.J. (2011). Driven to Distraction - ADHD experience and coping
+- Ramsay, J.R. (2017). Cognitive Behavioral Therapy for Adult ADHD - Working memory and attention
+- Understood.org research on ADHD and technology use
+- Brown, T.E. (2013). A New Understanding of ADHD - Executive function model
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "cognitive-adhd",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona cognitive-adhd --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Working Memory](../traits/Trait-WorkingMemory.md)
+- [Patience](../traits/Trait-Patience.md)
+- [Curiosity](../traits/Trait-Curiosity.md)
+- [FOMO](../traits/Trait-FOMO.md)

package/docs/personas/Persona-ElderlyUser.md

@@ -0,0 +1,131 @@
+# Elderly User
+
+**Category**: General Users
+**Description**: Users aged 65+ who may have age-related cognitive and perceptual changes affecting their digital interactions
+
+## Overview
+
+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.
+
+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.
+
+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.
+
+## Trait Profile
+
+All values on 0.0-1.0 scale.
+
+### Core Traits (Tier 1)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| patience | 0.8 | Research shows older adults allocate more time to tasks and are less frustrated by reasonable delays |
+| riskTolerance | 0.2 | Strong preference for caution; fear of making irreversible mistakes or being scammed |
+| comprehension | 0.5 | Crystallized intelligence intact; processing of novel interfaces may be slower |
+| persistence | 0.6 | Will continue trying but may seek help earlier than younger users |
+| curiosity | 0.4 | More goal-focused than exploration-oriented; prefer familiar patterns |
+| workingMemory | 0.4 | Age-related decline in working memory capacity is well-documented |
+| readingTendency | 0.8 | Read thoroughly; prefer complete understanding before acting |
+
+### Emotional Traits (Tier 2)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| resilience | 0.5 | May become discouraged by repeated failures but have life experience with overcoming challenges |
+| selfEfficacy | 0.4 | Often underestimate their abilities with technology due to stereotype threat |
+| trustCalibration | 0.5 | Mix of appropriate caution and sometimes excessive trust in official-looking content |
+| interruptRecovery | 0.4 | Reduced working memory makes context recovery after interruptions more difficult |
+
+### Decision-Making Traits (Tier 3)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| satisficing | 0.6 | Accept good-enough solutions; not driven to find optimal choices |
+| informationForaging | 0.5 | Thorough but may be slower to recognize information scent |
+| anchoringBias | 0.7 | Preferences shaped by earlier technology experiences; may expect older patterns |
+| timeHorizon | 0.5 | Balanced perspective; neither overly focused on immediate nor distant outcomes |
+| attributionStyle | 0.5 | Balanced attribution; experience provides perspective on system vs user responsibility |
+
+### Planning Traits (Tier 4)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| metacognitivePlanning | 0.5 | Good planning abilities but may not apply them to unfamiliar technology contexts |
+| proceduralFluency | 0.4 | Slower development of procedural skills with new interfaces |
+| transferLearning | 0.5 | Can transfer knowledge but may be slower to recognize applicable patterns |
+
+### Perception Traits (Tier 5)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| changeBlindness | 0.6 | May miss subtle interface changes; attention resources more limited |
+| mentalModelRigidity | 0.7 | Expect interfaces to work like familiar systems; resistant to paradigm shifts |
+
+### Social Traits (Tier 6)
+
+| Trait | Value | Rationale |
+|-------|-------|-----------|
+| authoritySensitivity | 0.7 | Respect institutional authority; may trust official-looking interfaces too readily |
+| emotionalContagion | 0.5 | Moderate influence from emotional tone of content |
+| fomo | 0.3 | Less driven by fear of missing out; focused on personal needs |
+| socialProofSensitivity | 0.5 | Influenced by trusted sources but less by general popularity |
+
+## Behavioral Patterns
+
+### Navigation
+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.
+
+### Decision Making
+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.
+
+### Error Recovery
+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.
+
+### Abandonment Triggers
+- Small text or low contrast
+- Time-limited interactions
+- Unclear or jargon-heavy instructions
+- Fear of making irreversible mistakes
+- No obvious way to get help
+- Security warnings that seem threatening
+
+## UX Recommendations
+
+| Challenge | Recommendation |
+|-----------|----------------|
+| Reduced working memory | Minimize steps; show progress; provide external memory aids |
+| Processing speed | Allow ample time; avoid timeouts; show loading states |
+| Cautious behavior | Explicit undo; preview actions; confirmation without being patronizing |
+| Vision changes | Large text options; high contrast; avoid reliance on color alone |
+| Motor control changes | Large click targets; forgive imprecise clicks; avoid hover-dependent interactions |
+| Technology self-efficacy | Encouraging feedback; celebrate successes; normalize difficulty |
+
+## Research Basis
+
+- Czaja, S.J. & Lee, C.C. (2007). Information Technology and Older Adults - Comprehensive review of age-related changes
+- Hawthorn, D. (2000). Possible implications of aging for interface designers - Specific design recommendations
+- Pak, R. & McLaughlin, A. (2010). Designing Displays for Older Adults - Evidence-based guidelines
+- Fisk, A.D. et al. (2009). Designing for Older Adults: Principles and Creative Human Factors Approaches
+- AARP/MIT AgeLab research on digital experiences for older adults
+
+## Usage
+
+```typescript
+await cognitive_journey_init({
+  persona: "elderly-user",
+  goal: "complete checkout",
+  startUrl: "https://example.com"
+});
+```
+
+```bash
+npx cbrowser cognitive-journey --persona elderly-user --start https://example.com --goal "complete checkout"
+```
+
+## See Also
+
+- [Persona Index](Persona-Index)
+- [Trait Index](../traits/Trait-Index)
+- [Patience](../traits/Trait-Patience.md)
+- [Working Memory](../traits/Trait-WorkingMemory.md)
+- [Reading Tendency](../traits/Trait-ReadingTendency.md)