cbrowser 17.6.1 → 18.1.0

package/docs/Tools-Marketing-Intelligence.md

@@ -0,0 +1,265 @@
+# Marketing Intelligence Tools
+
+**Stop guessing which messages work. Start measuring influence.**
+
+These 11 tools let you test which psychological influence patterns work on which audience segments. Run A/B campaigns with cognitive personas, analyze conversion funnels, and benchmark against competitors — all with scientific rigor.
+
+---
+
+## When to Use These Tools
+
+- **You're optimizing conversion** and want to know which messaging resonates with each audience
+- **You have A/B test fatigue** from inconclusive results because you're testing at the population level, not segment level
+- **You want competitive intelligence** on why competitor sites convert better
+- **You need to prove ROI** on UX investments with actual persona-by-persona data
+
+---
+
+## Tools
+
+### `marketing_personas_list`
+
+**What it does**: List available marketing-specific personas with their influence susceptibilities.
+
+**Why you'd use it**: See which audience segments you can test against and what motivates each one.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `category` | string | No | Filter: `b2b`, `consumer`, `all`. Default: `all` |
+
+**Returns**: Personas with descriptions, effective influence patterns, and ineffective patterns.
+
+### Marketing Personas
+
+| Persona | Category | Effective Patterns | Ineffective Patterns |
+|---------|----------|-------------------|---------------------|
+| `enterprise-buyer` | B2B | Authority, Social Proof, Default Bias | Scarcity, Reciprocity |
+| `startup-founder` | B2B | Scarcity, Commitment, Reciprocity | Authority, Default Bias |
+| `procurement-manager` | B2B | Authority, Social Proof, Default Bias | Scarcity, Reciprocity |
+| `technical-evaluator` | B2B | Commitment, Reciprocity | Social Proof, Scarcity |
+| `impulse-shopper` | Consumer | Scarcity, Anchoring, Social Proof | Authority, Commitment |
+| `price-researcher` | Consumer | Anchoring, Scarcity, Social Proof | Authority, Unity |
+| `loyal-customer` | Consumer | Unity, Reciprocity, Default Bias | Scarcity, Novelty |
+| `skeptical-first-timer` | Consumer | Social Proof, Authority, Default Bias | Scarcity, Commitment |
+
+---
+
+### `marketing_campaign_create`
+
+**What it does**: Create a multi-variant campaign that tests different page versions across multiple personas.
+
+**Why you'd use it**: Set up structured testing to understand which variations work for which audiences.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | string | Yes | Campaign name |
+| `variants` | array | Yes | URLs or descriptions of variants to test |
+| `personas` | array | Yes | Persona IDs to test with |
+| `goal` | string | Yes | What success looks like |
+| `metrics` | array | No | Custom metrics to track |
+
+**Example**:
+```json
+{
+  "name": "Pricing Page Optimization",
+  "variants": [
+    { "name": "Control", "url": "https://example.com/pricing" },
+    { "name": "Social Proof", "url": "https://example.com/pricing-v2" },
+    { "name": "Scarcity", "url": "https://example.com/pricing-v3" }
+  ],
+  "personas": ["enterprise-buyer", "startup-founder", "impulse-shopper"],
+  "goal": "Click 'Start Free Trial' button"
+}
+```
+
+**Returns**: Campaign ID, test matrix (variants × personas), ready for execution.
+
+---
+
+### `marketing_campaign_report_result`
+
+**What it does**: Report the result of a journey back to a campaign for aggregation.
+
+**Why you'd use it**: After running a cognitive journey for a campaign, log whether it succeeded and what friction was encountered.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | Yes | Campaign ID |
+| `variantIndex` | number | Yes | Which variant was tested |
+| `persona` | string | Yes | Persona that ran the journey |
+| `success` | boolean | Yes | Did the persona achieve the goal? |
+| `friction` | array | No | Friction points encountered |
+| `timeToGoal` | number | No | Seconds to achieve goal (if successful) |
+| `abandonmentReason` | string | No | Why they gave up (if unsuccessful) |
+
+---
+
+### `marketing_campaign_run` 🔒 Enterprise
+
+**What it does**: Execute a full campaign automatically — runs cognitive journeys for every variant × persona combination.
+
+**Why you'd use it**: Hands-off campaign execution that produces complete results without manual orchestration.
+
+> **Enterprise Feature** — Requires CBrowser Enterprise.
+> Executes multiple autonomous journeys, consuming significant compute and API resources.
+> [Learn about Enterprise →](/docs/Marketing-Suite/)
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | Yes | Campaign to run |
+| `variantIndex` | number | No | Run only specific variant |
+| `personaFilter` | array | No | Run only specific personas |
+
+---
+
+### `marketing_influence_matrix` 🔒 Enterprise
+
+**What it does**: Generate a matrix showing which influence patterns work for which personas based on campaign results.
+
+**Why you'd use it**: Visualize pattern effectiveness at a glance. Know exactly what works for enterprise buyers vs impulse shoppers.
+
+> **Enterprise Feature** — Requires CBrowser Enterprise.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | Yes | Campaign to analyze |
+
+**Returns**: Matrix with personas on one axis, influence patterns on the other, with effectiveness scores.
+
+---
+
+### `marketing_lever_analysis` 🔒 Enterprise
+
+**What it does**: Deep analysis of which psychological levers (scarcity, authority, social proof, etc.) drove behavior for each persona.
+
+**Why you'd use it**: Understand *why* certain variants worked, not just *that* they worked.
+
+> **Enterprise Feature** — Requires CBrowser Enterprise.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | Yes | Campaign to analyze |
+
+**Returns**: Lever-by-lever breakdown with evidence from journey traces.
+
+---
+
+### `marketing_funnel_analyze` 🔒 Enterprise
+
+**What it does**: Compare conversion funnels across variants — where do people drop off, what's different between successful and failed journeys?
+
+**Why you'd use it**: Find the specific step where each persona type struggles.
+
+> **Enterprise Feature** — Requires CBrowser Enterprise.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `campaignId` | string | Yes | Campaign to analyze |
+
+**Returns**: Funnel visualization per variant, drop-off points, comparison between personas.
+
+---
+
+### `marketing_compete` 🔒 Enterprise
+
+**What it does**: Run the same personas through your site and a competitor's site, then compare conversion effectiveness.
+
+**Why you'd use it**: Understand why competitors might be converting better for specific audience segments.
+
+> **Enterprise Feature** — Requires CBrowser Enterprise.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `yourUrl` | string | Yes | Your site URL |
+| `competitorUrl` | string | Yes | Competitor site URL |
+| `goal` | string | Yes | Goal to compare (e.g., "Sign up for trial") |
+| `personas` | array | No | Which personas to use |
+
+---
+
+### `marketing_audience_discover` 🔒 Enterprise
+
+**What it does**: Discover who your site is optimized for by running randomized personas and seeing which ones convert best.
+
+**Why you'd use it**: Find out if your site accidentally favors one audience over another.
+
+> **Enterprise Feature** — Requires CBrowser Enterprise.
+> Runs many autonomous journeys to build statistical significance.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `url` | string | Yes | URL to analyze |
+| `goal` | string | Yes | Conversion goal |
+| `samples` | number | No | Number of randomized personas. Default: 50 |
+| `maxConcurrency` | number | No | Parallel journey limit. Default: 5 |
+
+**Returns**: Job ID for async polling.
+
+---
+
+### `marketing_discover_status` 🔒 Enterprise
+
+**What it does**: Check status of an audience discovery job.
+
+**Why you'd use it**: Poll for completion of long-running audience discovery.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `jobId` | string | Yes | Job ID from `marketing_audience_discover` |
+
+---
+
+### `competitive_benchmark`
+
+**What it does**: Compare UX metrics across competitor sites — form friction, cognitive load, navigation clarity, trust signals.
+
+**Why you'd use it**: Understand how your UX stacks up against competitors without running full campaigns.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `urls` | array | Yes | URLs to benchmark (your site + competitors) |
+| `metrics` | array | No | Specific metrics to compare |
+
+**Example**:
+```json
+{
+  "urls": [
+    "https://example.com/signup",
+    "https://competitor1.com/signup",
+    "https://competitor2.com/signup"
+  ]
+}
+```
+
+**Returns**: Ranking, metric scores, specific recommendations.
+
+---
+
+## Demo vs Enterprise for Marketing
+
+| Capability | Demo | Enterprise |
+|------------|------|------------|
+| List marketing personas | ✅ | ✅ |
+| Create campaigns | ✅ | ✅ |
+| Report journey results | ✅ | ✅ |
+| Run campaigns automatically | ❌ | ✅ |
+| Influence matrix analysis | ❌ | ✅ |
+| Lever analysis | ❌ | ✅ |
+| Funnel analysis | ❌ | ✅ |
+| Competitive analysis | ❌ | ✅ |
+| Audience discovery | ❌ | ✅ |
+
+**Demo gives you the framework** — create campaigns, run journeys manually with Claude, report results.
+**Enterprise gives you the insights** — automated execution and deep analysis.
+
+---
+
+## Related Documentation
+
+- [Marketing Suite](/docs/Marketing-Suite/) — Full marketing capabilities overview
+- [Values Framework](/docs/Values-Framework/) — Schwartz values and motivation
+- [Persona System](/docs/Tools-Persona-System/) — Creating custom personas
+
+---
+
+*Last updated: v17.6.0*

package/docs/Tools-Overview.md

@@ -0,0 +1,143 @@
+# Tools Reference
+
+**Stop writing brittle test scripts. Start having conversations with your browser.**
+
+CBrowser provides 82 MCP tools that let Claude automate browsers using natural language. No CSS selectors. No XPath. No "element not found" errors at 3am. Just describe what you want to do, and CBrowser figures out the rest.
+
+---
+
+## The Problem We Solve
+
+Traditional browser automation breaks constantly:
+- **Selectors drift** — A developer changes a CSS class and your entire test suite fails
+- **Timing issues** — Pages load at different speeds, tests randomly fail
+- **Maintenance burden** — You spend more time fixing tests than writing features
+- **No user insight** — Tests tell you if buttons click, not if humans can use your product
+
+CBrowser fixes this with AI-powered automation that:
+- **Self-heals** when the DOM changes
+- **Waits intelligently** for content, not arbitrary timeouts
+- **Simulates real users** with patience, frustration, and abandonment
+- **Works through conversation** — describe intent, not implementation
+
+---
+
+## Tool Tiers
+
+| Tier | Tools | Access | Best For |
+|------|-------|--------|----------|
+| **Demo** | 63 real tools | Free at `demo.cbrowser.ai/mcp` | Evaluation, small projects, learning |
+| **Enterprise** | 82 tools (all Demo + 19 exclusive) | Self-hosted or authenticated | Production use, marketing intelligence, stealth testing |
+
+The Demo tier gives you everything you need to automate browsers, run tests, and simulate users. Enterprise adds autonomous AI execution, marketing campaign analysis, and bot detection bypass for authorized testing.
+
+---
+
+## Tools by Capability
+
+### [Browser Automation](/docs/Tools-Browser-Automation/)
+**12 tools** — Navigate, click, fill forms, extract data. The foundation of everything else.
+
+*"Click the blue login button"* works better than `document.querySelector('.btn-primary.auth-action.mt-4')`.
+
+### [Cognitive Journeys](/docs/Tools-Cognitive-Journeys/)
+**6 tools** — Simulate real users with patience thresholds, frustration tracking, and abandonment detection.
+
+Find out where users give up *before* they actually do. A frustrated-first-timer abandons faster than a patient-power-user.
+
+### [Persona System](/docs/Tools-Persona-System/)
+**15 tools** — Create and customize personas backed by 25 research-validated cognitive traits.
+
+Test as an elderly user with low tech confidence. Or an ADHD user who skims and clicks fast. Or your exact target demographic.
+
+### [Testing & Quality](/docs/Tools-Testing-Quality/)
+**7 tools** — Write tests in plain English, auto-repair broken selectors, detect flaky tests, map coverage.
+
+*"Go to the checkout page, add a product, verify the cart updates"* — that's a test. No code required.
+
+### [Visual & Performance](/docs/Tools-Visual-Performance/)
+**10 tools** — Catch visual regressions, performance degradations, cross-browser issues, and responsive breakage.
+
+Know when your staging deploy breaks the hero image on mobile Safari before your users tell you.
+
+### [Marketing Intelligence](/docs/Tools-Marketing-Intelligence/)
+**11 tools** — Test which psychological influence patterns work on which audience segments.
+
+Does scarcity messaging work on enterprise buyers? (No.) Does social proof work on skeptical first-timers? (Yes.) Now you can measure it.
+
+### [Accessibility](/docs/Tools-Accessibility/)
+**1 flagship tool** — Simulate disabilities (motor tremor, low vision, ADHD, color blindness) with WCAG remediation.
+
+Stop guessing if your site is accessible. Experience it through the eyes of someone who can't use a mouse.
+
+### [Session & State](/docs/Tools-Session-State/)
+**14 tools** — Save sessions, manage browser state, handle Cloudflare challenges (Enterprise), enable stealth mode (Enterprise).
+
+Stay logged in across test runs. Bypass bot detection on sites you're authorized to test.
+
+### [Utilities](/docs/Tools-Utilities/)
+**6 tools** — Diagnostics, health checks, API key management (Enterprise), agent-readiness audits.
+
+Is your site ready for AI agents to navigate it? Get a score and specific recommendations.
+
+---
+
+## Quick Start
+
+**1. Connect to the Demo MCP** (free, rate-limited):
+```
+URL: https://demo.cbrowser.ai/mcp
+```
+
+**2. Or run locally** (no rate limits):
+```bash
+npx cbrowser mcp-server
+```
+
+**3. Start automating**:
+```
+Navigate to https://example.com
+Click the "Get Started" button
+Fill the email field with "test@example.com"
+Take a screenshot
+```
+
+That's it. No setup, no configuration, no selectors.
+
+---
+
+## Enterprise Features
+
+Enterprise adds capabilities that require either:
+- **API credits** (autonomous AI journeys that make decisions)
+- **Security attestation** (stealth/Cloudflare bypass requires domain authorization)
+- **Compute resources** (marketing campaigns that run hundreds of journeys)
+
+| Feature | Why It's Enterprise |
+|---------|---------------------|
+| Autonomous Journeys | AI makes decisions, consumes API credits |
+| Marketing Execution | Runs campaigns with real cognitive journeys |
+| Marketing Analysis | Influence matrices, lever analysis, funnel comparison |
+| Stealth Mode | Constitutional bypass requires signed authorization |
+| Cloudflare Handling | Challenge bypass for authorized domains only |
+
+**Demo users can still:**
+- Set up marketing campaigns and report results manually
+- Run cognitive journeys with Claude orchestrating (no server-side autonomy)
+- Use all 63 core automation, testing, and persona tools
+
+[Contact for Enterprise →](mailto:alexandria.shai.eden@gmail.com)
+
+---
+
+## Related Documentation
+
+- [Getting Started](/docs/Getting-Started/) — Installation and first steps
+- [MCP Server](/docs/MCP-Server/) — Claude Desktop integration
+- [Remote MCP Server](/docs/Remote-MCP-Server/) — claude.ai integration
+- [Examples](/docs/Examples/) — Real-world usage patterns
+- [CLI Reference](/docs/CLI-Reference/) — Command-line usage
+
+---
+
+*Last updated: v17.6.0*

package/docs/Tools-Persona-System.md

@@ -0,0 +1,294 @@
+# Persona System Tools
+
+**Test your site through the eyes of real user types, not imaginary "average users."**
+
+These 15 tools let you create, customize, and inspect cognitive personas backed by 25 research-validated traits and Schwartz's universal values framework. Every persona behaves differently because they *think* differently.
+
+---
+
+## When to Use These Tools
+
+- **You're building for a specific audience** and want to validate they can actually use your product
+- **You need to test accessibility** with realistic disability simulations, not just WCAG checkers
+- **You want consistent test personas** across your team with documented cognitive profiles
+- **You're customizing personas** for your specific user base
+
+---
+
+## Tools
+
+### `list_cognitive_personas`
+
+**What it does**: Returns all available personas with their complete cognitive trait profiles.
+
+**Why you'd use it**: See what personas exist and understand their characteristics before selecting one.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `category` | string | No | Filter by category: `general`, `accessibility`, `marketing`, `all` |
+| `detailed` | boolean | No | Include full trait values. Default: false |
+
+**Example**:
+```json
+{
+  "category": "accessibility",
+  "detailed": true
+}
+```
+
+**Returns**: List of personas with names, descriptions, trait summaries, and (if detailed) all 25 trait values.
+
+---
+
+### `persona_create_start`
+
+**What it does**: Begins the persona creation flow. Choose between questionnaire mode (answer questions to generate traits) or description mode (describe the persona in natural language).
+
+**Why you'd use it**: Start building a custom persona tailored to your specific user base.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `mode` | string | Yes | `questionnaire` or `description` |
+| `name` | string | Yes | Name for the new persona |
+
+**Example**:
+```json
+{
+  "mode": "description",
+  "name": "startup-cto"
+}
+```
+
+---
+
+### `persona_create_from_description`
+
+**What it does**: Generate a persona from a natural language description. Returns a trait reference matrix for review before finalizing.
+
+**Why you'd use it**: Quickly create a persona by describing who they are, rather than answering individual trait questions.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `sessionId` | string | Yes | Session ID from `persona_create_start` |
+| `description` | string | Yes | Natural language description of the persona |
+
+**Example**:
+```json
+{
+  "sessionId": "create_abc123",
+  "description": "A senior developer at a Fortune 500 company. Highly technical, impatient with marketing fluff, wants to see code examples immediately. Uses keyboard shortcuts for everything. Skeptical of new tools until proven."
+}
+```
+
+**Returns**: Inferred trait values with confidence scores and suggested adjustments.
+
+---
+
+### `persona_create_submit_traits`
+
+**What it does**: Finalize a description-based persona by confirming or adjusting the inferred traits.
+
+**Why you'd use it**: Review the AI-generated traits and make corrections before saving.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `sessionId` | string | Yes | Session ID |
+| `traits` | object | Yes | Final trait values (adjusted if needed) |
+| `save` | boolean | No | Save persona for future use. Default: true |
+
+---
+
+### `persona_create_questionnaire_start`
+
+**What it does**: Begin the questionnaire-based persona creation. Returns the first question.
+
+**Why you'd use it**: Build a persona through guided questions when you want precise control over trait values.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `sessionId` | string | Yes | Session ID from `persona_create_start` |
+| `comprehensive` | boolean | No | Use full 25-trait questionnaire vs 8-core. Default: false |
+
+---
+
+### `persona_create_questionnaire_answer`
+
+**What it does**: Submit an answer to the current questionnaire question and receive the next one.
+
+**Why you'd use it**: Progress through the questionnaire one question at a time.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `sessionId` | string | Yes | Session ID |
+| `answer` | string/number | Yes | Answer to the current question |
+
+---
+
+### `persona_create_cancel`
+
+**What it does**: Cancel the current persona creation session.
+
+**Why you'd use it**: Abandon a persona creation that's no longer needed.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `sessionId` | string | Yes | Session ID to cancel |
+
+---
+
+### `persona_questionnaire_get`
+
+**What it does**: Retrieve the full persona questionnaire for external use — the questions, scales, and trait mappings.
+
+**Why you'd use it**: Build your own persona creation UI or review the research-backed questions.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `version` | string | No | `core` (8 questions) or `comprehensive` (25 questions). Default: `core` |
+
+---
+
+### `persona_questionnaire_build`
+
+**What it does**: Build a persona directly from questionnaire answers with category-aware safeguards.
+
+**Why you'd use it**: Create a persona from pre-collected answers (e.g., from a user survey).
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | string | Yes | Persona name |
+| `answers` | object | Yes | Map of trait names to values (0.0-1.0) |
+| `category` | string | No | Persona category for value derivation rules |
+
+---
+
+### `persona_traits_list`
+
+**What it does**: List all 25 cognitive traits with descriptions, research basis, and behavioral implications.
+
+**Why you'd use it**: Understand what each trait measures before assigning values.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `tier` | number | No | Filter by tier (1-6) |
+
+**Example**:
+```json
+{
+  "tier": 1
+}
+```
+
+Returns Tier 1 core traits: Patience, Risk Tolerance, Comprehension, Persistence, Curiosity, Working Memory, Reading Tendency.
+
+---
+
+### `persona_trait_lookup`
+
+**What it does**: Get detailed behavioral descriptions for specific trait values.
+
+**Why you'd use it**: Understand what a patience value of 0.3 actually means in practice.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `trait` | string | Yes | Trait name (e.g., `patience`, `riskTolerance`) |
+| `value` | number | Yes | Value to look up (0.0-1.0) |
+
+**Example**:
+```json
+{
+  "trait": "patience",
+  "value": 0.3
+}
+```
+
+**Returns**: Behavioral description, abandonment thresholds, typical actions at this level.
+
+---
+
+### `persona_values_lookup`
+
+**What it does**: Retrieve the values profile for a persona — Schwartz universal values, SDT psychological needs, and Maslow hierarchy level.
+
+**Why you'd use it**: Understand what motivates a persona and which influence patterns will resonate with them.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `persona` | string | Yes | Persona ID |
+
+**Example**:
+```json
+{
+  "persona": "enterprise-buyer"
+}
+```
+
+**Returns**: Schwartz value rankings (security, achievement, benevolence, etc.), primary psychological needs, Maslow level.
+
+---
+
+### `persona_category_guidance`
+
+**What it does**: Get guidance for handling value derivation in disability-specific personas.
+
+**Why you'd use it**: When creating accessibility personas, understand how to assign values appropriately without stereotyping.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `category` | string | Yes | Category: `cognitive`, `physical`, `sensory`, `emotional` |
+
+**Returns**: Value derivation strategy, research basis, warnings about common mistakes.
+
+---
+
+### `list_influence_patterns`
+
+**What it does**: List all research-backed influence and persuasion patterns with their effectiveness by persona type.
+
+**Why you'd use it**: Understand which psychological triggers work on which audiences.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `persona` | string | No | Filter to patterns effective for this persona |
+
+**Returns**: Patterns like `scarcity`, `social_proof`, `authority`, `reciprocity` with effectiveness ratings and example implementations.
+
+---
+
+## The 25 Cognitive Traits
+
+Personas are built from 25 research-validated traits organized in 6 tiers:
+
+| Tier | Traits | What They Govern |
+|------|--------|------------------|
+| **1: Core** | Patience, Risk Tolerance, Comprehension, Persistence, Curiosity, Working Memory, Reading Tendency | Basic interaction patterns |
+| **2: Emotional** | Resilience, Self-Efficacy, Trust Calibration, Interrupt Recovery | Response to friction and failure |
+| **3: Decision** | Satisficing, Information Foraging, Anchoring Bias, Time Horizon, Attribution Style | How choices are made |
+| **4: Planning** | Metacognitive Planning, Procedural Fluency, Transfer Learning | Approach to complex tasks |
+| **5: Perception** | Change Blindness, Mental Model Rigidity | How UI changes are noticed/understood |
+| **6: Social** | Authority Sensitivity, Emotional Contagion, FOMO, Social Proof Sensitivity | Response to social cues |
+
+See [Trait Index](/docs/Trait-Index/) for detailed documentation of each trait.
+
+---
+
+## Built-in Personas
+
+| Category | Personas |
+|----------|----------|
+| **General** | power-user, first-timer, mobile-user, impatient-user |
+| **Accessibility** | elderly-user, screen-reader-user, motor-tremor, low-vision, cognitive-adhd |
+| **Marketing** | enterprise-buyer, startup-founder, procurement-manager, technical-evaluator, impulse-shopper, price-researcher, loyal-customer, skeptical-first-timer |
+
+---
+
+## Related Documentation
+
+- [Persona Index](/docs/Persona-Index/) — Complete persona profiles
+- [Persona Questionnaire](/docs/Persona-Questionnaire/) — Creating custom personas
+- [Trait Index](/docs/Trait-Index/) — Deep dives on each trait
+- [Values Framework](/docs/Values-Framework/) — Schwartz values and motivation
+
+---
+
+*Last updated: v17.6.0*