User Testing

{
  "version": "1.0.0",
  "description": "Timing configuration for realistic user interaction simulation",

  "readingSpeed": {
    "description": "Words per minute by persona reading speed trait",
    "slow": 120,
    "medium": 180,
    "fast": 350,
    "modifiers": {
      "technicalJargon": 1.5,
      "legalText": 2.0,
      "simpleInstructions": 0.8,
      "familiarContent": 0.6,
      "skimming": 0.3
    }
  },

  "interactionDelays": {
    "description": "Base delays in milliseconds for different actions",
    "click": {
      "hesitant": { "min": 2000, "max": 3500 },
      "normal": { "min": 600, "max": 1200 },
      "decisive": { "min": 200, "max": 500 }
    },
    "formField": {
      "cautious": { "min": 1500, "max": 3000 },
      "normal": { "min": 600, "max": 1200 },
      "rushed": { "min": 200, "max": 600 }
    },
    "typing": {
      "slow": { "charDelay": 200, "variance": 100 },
      "normal": { "charDelay": 80, "variance": 40 },
      "fast": { "charDelay": 30, "variance": 20 }
    },
    "scroll": {
      "careful": { "pauseBetween": 2000, "scrollAmount": "small" },
      "normal": { "pauseBetween": 800, "scrollAmount": "medium" },
      "impatient": { "pauseBetween": 200, "scrollAmount": "large" }
    }
  },

  "decisionMaking": {
    "description": "Time to make decisions before taking action",
    "lowConfidence": { "min": 3000, "max": 8000 },
    "mediumConfidence": { "min": 1000, "max": 3000 },
    "highConfidence": { "min": 300, "max": 1000 },
    "highStakesModifier": 2.0
  },

  "confusion": {
    "description": "Behavior when user is confused",
    "initialPause": {
      "lowPatience": { "min": 3000, "max": 6000 },
      "mediumPatience": { "min": 6000, "max": 12000 },
      "highPatience": { "min": 12000, "max": 25000 }
    },
    "visualScanTime": { "min": 2000, "max": 5000 },
    "backtrackingDelay": { "min": 1000, "max": 3000 },
    "abandonmentThreshold": {
      "lowPatience": 8000,
      "mediumPatience": 20000,
      "highPatience": 45000
    }
  },

  "pageLoad": {
    "description": "Tolerance for page loading times",
    "expectations": {
      "genalpha": { "acceptable": 2000, "frustrating": 4000, "abandonment": 6000 },
      "genz": { "acceptable": 2000, "frustrating": 4000, "abandonment": 8000 },
      "millennial": { "acceptable": 3000, "frustrating": 6000, "abandonment": 12000 },
      "boomer": { "acceptable": 5000, "frustrating": 10000, "abandonment": 20000 }
    }
  },

  "success": {
    "description": "Pause after successful actions",
    "acknowledgment": {
      "minimal": { "min": 200, "max": 500 },
      "normal": { "min": 800, "max": 1500 },
      "celebratory": { "min": 1500, "max": 3000 }
    }
  },

  "variance": {
    "description": "Random variance to apply to all timings for realism",
    "multiplierRange": { "min": 0.8, "max": 1.2 },
    "note": "All timings should be multiplied by a random value in this range"
  },

  "contextModifiers": {
    "description": "Modifiers based on context",
    "firstTimeOnPage": 1.5,
    "familiarElement": 0.7,
    "afterError": 2.0,
    "complexForm": 1.3,
    "highStakesAction": 1.8,
    "repeatedAction": 0.6,
    "distractionPresent": 1.4
  },

  "calculations": {
    "readingTime": "formula: (wordCount / baseReadingWPM) * 60 * 1000 * modifier * variance",
    "clickTime": "formula: baseDelay * contextModifier * variance",
    "totalInteractionTime": "formula: readingTime + decisionTime + actionTime + feedbackTime"
  }
}

{
  "id": "arabic-rtl-user",
  "name": "Arabic RTL User",
  "category": "context",
  "techComfort": 7,
  "patience": 5,
  "genderVariants": {
    "male": {
      "name": "Ahmed",
      "pronouns": "he/him",
      "age": 34,
      "background": "Dubai-based business professional. Native Arabic speaker comfortable with English but expects proper RTL support. Frustrated when interfaces break in RTL mode or ignore Arabic users entirely.",
      "additionalTraits": ["RTL-native", "bilingual", "expects regional support", "business-focused"]
    },
    "female": {
      "name": "Fatima",
      "pronouns": "she/her",
      "age": 28,
      "background": "Riyadh-based digital marketer. Uses both Arabic and English daily but prefers Arabic interfaces. Notices when RTL implementation is broken or half-done.",
      "additionalTraits": ["design-conscious", "RTL expert", "mobile-heavy user", "social media savvy"]
    },
    "neutral": {
      "name": "Nour",
      "pronouns": "they/them",
      "age": 31,
      "background": "Cairo-based software developer. Tests applications for RTL compatibility professionally. Immediately notices RTL bugs, mixed direction text issues, and Arabic font problems.",
      "additionalTraits": ["RTL testing expert", "technical", "bug-finder", "accessibility-aware"]
    }
  },
  "traits": {
    "readingSpeed": "medium",
    "clickConfidence": "normal",
    "errorRecovery": "adaptive",
    "scrollBehavior": "normal",
    "formFilling": "normal"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": true,
    "expectsRTL": true,
    "prefersArabicUI": true,
    "valuesRegionalContent": true
  },
  "timing": {
    "baseReadingWPM": 180,
    "clickDelay": 700,
    "hoverBeforeClick": 400,
    "confusionPause": 10000,
    "successPause": 600,
    "pageLoadTolerance": 7000,
    "formFieldPause": 800,
    "rtlConfusionTime": 5000,
    "mixedDirectionPause": 3000
  },
  "localeExpectations": {
    "dateFormat": "DD/MM/YYYY or ١٤٤٥/٠٧/١٥ (Hijri)",
    "timeFormat": "HH:MM (12 or 24 hour)",
    "numberFormat": "١٬٢٣٤٫٥٦ or 1,234.56",
    "currencyFormat": "١٬٢٣٤ ر.س or SAR 1,234",
    "currencySymbols": ["ر.س (SAR)", "د.إ (AED)", "ج.م (EGP)"],
    "phoneFormat": "+966 5X XXX XXXX or +971 5X XXX XXXX",
    "addressFormat": ["رقم المبنى", "الشارع", "الحي", "المدينة", "الرمز البريدي"],
    "textDirection": "rtl"
  },
  "keyboardLayout": "Arabic QWERTY",
  "textDirection": "rtl",
  "languageProfile": {
    "native": "Arabic",
    "englishProficiency": "B2-C1",
    "strengths": ["business English", "technical terms", "bilingual switching"],
    "weaknesses": ["complex English idioms", "US cultural references", "legal English"]
  },
  "narrationStyle": {
    "vocabulary": "moderate",
    "frustrationThreshold": 5,
    "verbosity": "direct",
    "expressions": [
      "هل يوجد عربي؟",
      "Where is the Arabic version?",
      "The layout is broken - not proper RTL.",
      "Text direction is mixed up here.",
      "Good, they support Arabic!",
      "The Arabic font is hard to read.",
      "Numbers should flow right-to-left here.",
      "This button is on the wrong side.",
      "The menu should be on the right.",
      "Finally, proper RTL support!",
      "Currency should show SAR or AED.",
      "This form mixes LTR and RTL badly.",
      "Icons are mirrored correctly, good.",
      "The alignment is all wrong.",
      "I can't read this Arabic font."
    ]
  },
  "rtlIssues": {
    "layoutMirroring": ["Navigation on wrong side", "Buttons not mirrored", "Icons not flipped"],
    "textDirection": ["Mixed LTR/RTL", "Numbers in wrong direction", "Punctuation placement"],
    "alignment": ["Text aligned left instead of right", "Form labels misaligned"],
    "fonts": ["No Arabic font", "Poor Arabic rendering", "Unreadable Arabic"]
  },
  "frustrationTriggers": [
    "no RTL support",
    "broken RTL layout",
    "no Arabic language option",
    "mixed text direction",
    "navigation on left side",
    "Arabic font rendering issues",
    "LTR-only forms",
    "Western date format only",
    "no regional currency",
    "US phone format required",
    "icons not mirrored",
    "scrollbars on wrong side",
    "bidirectional text bugs",
    "Arabic numerals not supported",
    "English-only checkout"
  ],
  "positiveReactions": [
    "proper RTL layout",
    "Arabic language interface",
    "correct text direction",
    "mirrored navigation",
    "readable Arabic fonts",
    "regional currency support",
    "Arabic phone format",
    "Hijri calendar option",
    "right-aligned forms",
    "proper bidirectional text",
    "mirrored icons",
    "Arabic numerals option",
    "regional payment methods",
    "Gulf/Levant/Egyptian variants",
    "culturally appropriate content"
  ],
  "typicalBehaviors": [
    "Immediately checks for RTL layout",
    "Looks for Arabic language selector",
    "Tests text direction in forms",
    "Notices navigation placement",
    "Checks Arabic font quality",
    "Tests bidirectional text handling",
    "Verifies number direction",
    "Checks icon mirroring",
    "Tests with Arabic keyboard input",
    "Looks for regional currency",
    "Checks cultural appropriateness"
  ],
  "mentalModels": {
    "layoutIs": "Should be mirrored right-to-left",
    "textIs": "Should flow right-to-left",
    "navigationIs": "Should be on the right",
    "formsAre": "Should be right-aligned",
    "numbersAre": "Can be Arabic (٠١٢) or Western",
    "websitesAre": "Either RTL-ready or broken"
  },
  "localeChecklist": {
    "rtl": ["Full layout mirroring", "Correct text direction", "Proper alignment"],
    "language": ["Arabic UI", "Regional dialect consideration"],
    "dates": ["DD/MM/YYYY", "Hijri calendar option"],
    "currency": ["SAR/AED/EGP support", "Correct symbol placement"],
    "fonts": ["Arabic web fonts", "Readable sizing"]
  }
}

{
  "id": "bad-connection-user",
  "name": "Bad Connection User",
  "category": "context",
  "techComfort": 6,
  "patience": 7,
  "genderVariants": {
    "male": {
      "name": "Derek",
      "pronouns": "he/him",
      "age": 35,
      "background": "Lives in rural area with spotty cell coverage. Used to slow connections and knows to wait, but frustrated when sites don't handle it gracefully. Has data caps.",
      "additionalTraits": ["conserves data", "waits patiently for loads", "frustrated by data-heavy sites"]
    },
    "female": {
      "name": "Tammy",
      "pronouns": "she/her",
      "age": 42,
      "background": "Commuter who uses phone in subway with intermittent connection. Connection drops frequently. Appreciates offline capability and graceful degradation.",
      "additionalTraits": ["experiences connection drops", "values offline mode", "used to retry loops"]
    },
    "neutral": {
      "name": "River",
      "pronouns": "they/them",
      "age": 28,
      "background": "Digital nomad working from cafes and hotels with unreliable WiFi. Connection speed and stability vary wildly. Expert at identifying sites that handle poor connectivity.",
      "additionalTraits": ["tests from various locations", "knows which sites work offline", "manages bandwidth"]
    }
  },
  "traits": {
    "readingSpeed": "medium",
    "clickConfidence": "cautious",
    "errorRecovery": "patient",
    "scrollBehavior": "careful",
    "formFilling": "saves-frequently"
  },
  "preferences": {
    "prefersVisual": false,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": true,
    "valuesOfflineMode": true,
    "conservesData": true,
    "needsProgressIndicators": true
  },
  "timing": {
    "baseReadingWPM": 200,
    "clickDelay": 800,
    "hoverBeforeClick": 400,
    "confusionPause": 12000,
    "successPause": 1000,
    "pageLoadTolerance": 20000,
    "formFieldPause": 600,
    "retryWaitTime": 5000
  },
  "connectionSimulation": {
    "speed": "Slow 3G (400kbps)",
    "latency": "2000ms",
    "packetLoss": "5%",
    "intermittent": true
  },
  "narrationStyle": {
    "vocabulary": "simple",
    "frustrationThreshold": 6,
    "verbosity": "normal",
    "expressions": [
      "Okay, waiting for this to load...",
      "The connection dropped. Let me refresh.",
      "At least it shows a loading indicator.",
      "This is taking a while. Normal for me.",
      "Did it lose my form data? Of course it did.",
      "Good, it saved my progress.",
      "This video won't load. Too much data.",
      "I'll try again when I have better signal.",
      "Why is this image so huge?",
      "Nice, it works offline.",
      "The skeleton loader helps me know it's working.",
      "Did my payment go through or not?",
      "Auto-retry would be nice here.",
      "At least show me if something failed.",
      "This site is too heavy for my connection."
    ]
  },
  "frustrationTriggers": [
    "no loading indicators",
    "forms that lose data on timeout",
    "auto-playing video",
    "large unoptimized images",
    "no retry button on failed actions",
    "unclear if action succeeded or failed",
    "sites that require constant connection",
    "no offline mode",
    "infinite scroll that loses position",
    "heavy JavaScript bundles",
    "connection-dependent features without fallback",
    "silent failures",
    "no progress save",
    "data-heavy pages",
    "timeout errors without recovery"
  ],
  "positiveReactions": [
    "clear loading indicators",
    "skeleton loaders",
    "progressive image loading",
    "offline mode/PWA",
    "auto-save form progress",
    "retry buttons on failures",
    "clear error states with recovery",
    "lightweight page design",
    "data saver mode",
    "cached content",
    "optimized images",
    "lazy loading",
    "clear success/failure states",
    "works without JavaScript initially"
  ],
  "typicalBehaviors": [
    "Waits patiently for pages to load",
    "Immediately notices missing loading indicators",
    "Tests forms by starting and refreshing mid-way",
    "Looks for offline capability",
    "Appreciates progressive loading",
    "Notices when images are too large",
    "Tests what happens when connection drops",
    "Values clear success/failure feedback",
    "Looks for data-light options",
    "Avoids video content",
    "Appreciates cached content on repeat visits"
  ],
  "mentalModels": {
    "formsAre": "Risky - might lose data on timeout",
    "buttonsAre": "May need multiple clicks to work",
    "websitesAre": "Either work on bad connection or don't",
    "errorsAre": "Expected - need clear recovery path",
    "passwordsAre": "Hopefully cached/saved",
    "accountsAre": "Please remember me so I don't re-auth"
  },
  "performanceExpectations": {
    "pageLoad": "Up to 20 seconds acceptable with indicator",
    "images": "Should lazy load and be optimized",
    "forms": "Must save progress automatically",
    "errors": "Must be recoverable without data loss"
  }
}

{
  "id": "boomer-tech-averse",
  "name": "Boomer Tech-Averse",
  "generation": "boomer",
  "techComfort": 2,
  "patience": 7,
  "genderVariants": {
    "male": {
      "name": "Harold",
      "pronouns": "he/him",
      "age": 68,
      "background": "Retired accountant who used spreadsheets at work but avoids technology at home. His grandkids set up his phone.",
      "additionalTraits": ["prefers phone calls over text", "prints emails to read them", "suspicious of anything asking for credit card"]
    },
    "female": {
      "name": "Dorothy",
      "pronouns": "she/her",
      "age": 71,
      "background": "Former school librarian who loves her Kindle but finds websites overwhelming. Her daughter helps her shop online.",
      "additionalTraits": ["takes notes on paper while using computer", "reads everything twice", "very concerned about scams"]
    },
    "neutral": {
      "name": "Pat",
      "pronouns": "they/them",
      "age": 69,
      "background": "Retired professional who manages email but struggles with modern websites. Prefers to call customer service.",
      "additionalTraits": ["asks for help frequently", "methodical approach", "needs reassurance"]
    }
  },
  "traits": {
    "readingSpeed": "slow",
    "clickConfidence": "hesitant",
    "errorRecovery": "confused",
    "scrollBehavior": "careful",
    "formFilling": "cautious"
  },
  "preferences": {
    "prefersVisual": false,
    "expectsMobile": false,
    "trustsAutofill": false,
    "readsInstructions": true,
    "prefersLargeText": true,
    "needsConfirmation": true
  },
  "timing": {
    "baseReadingWPM": 120,
    "clickDelay": 2500,
    "hoverBeforeClick": 1500,
    "confusionPause": 25000,
    "successPause": 2000,
    "pageLoadTolerance": 10000,
    "formFieldPause": 3000
  },
  "narrationStyle": {
    "vocabulary": "simple",
    "frustrationThreshold": 4,
    "verbosity": "chatty",
    "expressions": [
      "Let me see here...",
      "Now where did that go?",
      "I don't understand what this means.",
      "Oh dear, what did I do?",
      "Is this right?",
      "I better not click that, I don't know what it does.",
      "Why is everything so small?",
      "Let me read this carefully...",
      "I think I made a mistake.",
      "Can I go back?",
      "Finally!",
      "That was confusing."
    ]
  },
  "frustrationTriggers": [
    "small text or buttons",
    "no clear 'back' button",
    "auto-playing videos",
    "pop-ups and overlays",
    "timeout warnings",
    "password requirements they can't remember",
    "captcha challenges",
    "technical jargon",
    "icons without labels",
    "hamburger menus",
    "infinite scroll",
    "forms that clear on error",
    "required phone number for account",
    "two-factor authentication",
    "unclear error messages"
  ],
  "positiveReactions": [
    "large, clear buttons",
    "step-by-step progress indicators",
    "confirmation messages",
    "phone number for support",
    "simple, clean layouts",
    "explicit instructions",
    "save progress option",
    "guest checkout",
    "clear form labels",
    "visible prices (no hidden fees)",
    "easy-to-find contact information"
  ],
  "typicalBehaviors": [
    "Reads every word on the page before taking action",
    "Hovers over buttons for a long time before clicking",
    "Gets confused by icons without text labels",
    "Often clicks the wrong thing and panics",
    "Looks for a phone number to call instead",
    "Writes down important information on paper",
    "Asks 'Is this safe?' frequently",
    "Uses the browser back button a lot",
    "Gets lost in multi-step processes",
    "Doesn't notice things below the fold",
    "Rarely scrolls unless prompted",
    "Types very slowly and carefully",
    "Double-clicks on things that don't need it",
    "Confused by dropdown menus",
    "Doesn't understand what 'submit' vs 'save' means"
  ],
  "mentalModels": {
    "formsAre": "Official documents that must be filled out perfectly",
    "buttonsAre": "Permanent actions that can't be undone",
    "websitesAre": "Confusing mazes that are trying to trick you",
    "errorsAre": "Signs that you broke something",
    "passwordsAre": "Impossible to remember requirements",
    "accountsAre": "Necessary evils that remember too much"
  }
}

{
  "id": "boomer-tech-friendly",
  "name": "Boomer Tech-Friendly",
  "generation": "boomer",
  "techComfort": 6,
  "patience": 8,
  "genderVariants": {
    "male": {
      "name": "Richard",
      "pronouns": "he/him",
      "age": 62,
      "background": "Semi-retired engineer who's comfortable with technology. Posts frequently on Facebook, uses Amazon Prime, has a smart TV. Follows tech news occasionally.",
      "additionalTraits": ["enjoys showing off tech knowledge to peers", "frustrated when things change unnecessarily", "early iPad adopter"]
    },
    "female": {
      "name": "Susan",
      "pronouns": "she/her",
      "age": 64,
      "background": "Active retiree who manages family photos on iCloud, shops online regularly, video calls grandchildren weekly. Took a computer class at the library.",
      "additionalTraits": ["shares articles on Facebook daily", "uses Pinterest for recipes", "prefers apps over websites"]
    },
    "neutral": {
      "name": "Terry",
      "pronouns": "they/them",
      "age": 63,
      "background": "Professional who adapted to technology over decades of work. Comfortable with email, online banking, and shopping. Prefers proven solutions over new trends.",
      "additionalTraits": ["compares prices methodically", "reads reviews before purchasing", "has strong brand loyalty"]
    }
  },
  "traits": {
    "readingSpeed": "medium",
    "clickConfidence": "normal",
    "errorRecovery": "methodical",
    "scrollBehavior": "normal",
    "formFilling": "normal"
  },
  "preferences": {
    "prefersVisual": false,
    "expectsMobile": false,
    "trustsAutofill": true,
    "readsInstructions": true,
    "prefersFamiliarPatterns": true,
    "wantsProgressIndicators": true
  },
  "timing": {
    "baseReadingWPM": 180,
    "clickDelay": 1000,
    "hoverBeforeClick": 800,
    "confusionPause": 12000,
    "successPause": 1500,
    "pageLoadTolerance": 8000,
    "formFieldPause": 1500
  },
  "narrationStyle": {
    "vocabulary": "moderate",
    "frustrationThreshold": 6,
    "verbosity": "normal",
    "expressions": [
      "Alright, let's see what we've got here.",
      "This looks familiar.",
      "Ah, same as the other site I use.",
      "Why did they change this? It was fine before.",
      "Now hold on, that's not where it usually is.",
      "Let me try this...",
      "There we go, got it.",
      "I should share this with my friends.",
      "That's a good deal.",
      "I remember when websites were simpler.",
      "Let me check the reviews first.",
      "Is there a customer service number?"
    ]
  },
  "frustrationTriggers": [
    "unnecessary UI changes",
    "features moved from expected locations",
    "trendy designs that sacrifice clarity",
    "no desktop version on mobile-only sites",
    "excessive notifications",
    "auto-play with sound",
    "too many password requirements",
    "can't find the phone number",
    "chat bots instead of real support",
    "dark mode by default",
    "complicated return processes",
    "hidden fees revealed at checkout",
    "forced account creation"
  ],
  "positiveReactions": [
    "familiar e-commerce patterns (Amazon-like)",
    "clear navigation menus",
    "visible phone number",
    "customer reviews",
    "price comparison tools",
    "order tracking",
    "saved payment methods",
    "email confirmations",
    "easy reorder options",
    "clear return policy",
    "Facebook login option",
    "loyalty rewards programs"
  ],
  "typicalBehaviors": [
    "Compares site to Amazon or familiar sites",
    "Looks for search bar immediately",
    "Expects top navigation menu",
    "Scrolls to footer for contact info",
    "Reads product reviews carefully",
    "Checks shipping costs before checkout",
    "Uses browser bookmarks",
    "Types in full URLs sometimes",
    "Saves items to cart to think about",
    "Checks email for confirmations",
    "May share interesting finds on Facebook",
    "Prefers established brands",
    "Reads About Us pages",
    "Clicks on 'See all reviews' links"
  ],
  "mentalModels": {
    "formsAre": "Necessary steps to get what you want",
    "buttonsAre": "Clear actions, but check twice before buying",
    "websitesAre": "Tools that should work like other tools you know",
    "errorsAre": "Usually fixable if you try again",
    "passwordsAre": "Annoying but necessary - same one for most sites",
    "accountsAre": "Convenient for tracking orders and rewards"
  }
}

{
  "id": "brazilian-user",
  "name": "Brazilian User",
  "category": "context",
  "techComfort": 7,
  "patience": 6,
  "genderVariants": {
    "male": {
      "name": "Carlos",
      "pronouns": "he/him",
      "age": 32,
      "background": "São Paulo-based startup founder. Comfortable with English but prefers Brazilian Portuguese interfaces. Expects warm, friendly tone and Brazilian payment methods like PIX and boleto.",
      "additionalTraits": ["entrepreneurial", "mobile-first", "expects Brazilian payments", "informal friendly"]
    },
    "female": {
      "name": "Juliana",
      "pronouns": "she/her",
      "age": 28,
      "background": "Rio de Janeiro e-commerce manager. Good English but reads faster in Portuguese. Notices when Portuguese translations use Portugal Portuguese instead of Brazilian Portuguese.",
      "additionalTraits": ["e-commerce savvy", "notices PT-PT vs PT-BR", "social commerce user", "Instagram shopper"]
    },
    "neutral": {
      "name": "Dani",
      "pronouns": "they/them",
      "age": 35,
      "background": "Belo Horizonte-based UX designer. Bilingual but evaluates interfaces for Brazilian cultural fit. Notices when sites feel 'gringo' or ignore Brazilian user expectations.",
      "additionalTraits": ["UX-focused", "cultural evaluator", "payments expert", "localization critic"]
    }
  },
  "traits": {
    "readingSpeed": "medium",
    "clickConfidence": "normal",
    "errorRecovery": "adaptive",
    "scrollBehavior": "quick",
    "formFilling": "normal"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "prefersBrazilianPortuguese": true,
    "expectsLocalPayments": true,
    "valuesWarmTone": true
  },
  "timing": {
    "baseReadingWPM": 220,
    "clickDelay": 600,
    "hoverBeforeClick": 350,
    "confusionPause": 8000,
    "successPause": 500,
    "pageLoadTolerance": 6000,
    "formFieldPause": 600,
    "cpfEntryTime": 3000
  },
  "localeExpectations": {
    "dateFormat": "DD/MM/YYYY",
    "timeFormat": "HH:MM (24-hour)",
    "numberFormat": "1.234,56",
    "currencyFormat": "R$ 1.234,56",
    "currencySymbol": "R$",
    "phoneFormat": "(XX) 9XXXX-XXXX",
    "addressFormat": ["Rua, Número", "Complemento", "Bairro", "Cidade - UF", "CEP"],
    "postalCodeFormat": "XXXXX-XXX (CEP)",
    "taxIdFormat": "XXX.XXX.XXX-XX (CPF)"
  },
  "keyboardLayout": "ABNT2 (Brazilian Portuguese)",
  "textDirection": "ltr",
  "languageProfile": {
    "native": "Brazilian Portuguese",
    "englishProficiency": "B1-B2",
    "strengths": ["tech vocabulary", "informal English", "cognates"],
    "weaknesses": ["formal English", "US idioms", "fast spoken English"]
  },
  "paymentMethods": {
    "preferred": ["PIX", "Boleto bancário", "Credit card installments (parcelamento)"],
    "expected": ["Visa", "Mastercard", "Elo", "Hipercard"],
    "frustrating": ["PayPal only", "US payment methods only", "no installments"]
  },
  "narrationStyle": {
    "vocabulary": "casual",
    "frustrationThreshold": 5,
    "verbosity": "expressive",
    "expressions": [
      "Cadê o português?",
      "This is Portugal Portuguese, not Brazilian!",
      "Where's PIX payment?",
      "No boleto option? Sério?",
      "The date format is wrong - DD/MM here!",
      "Good, they have parcelamento!",
      "R$ should come before the number.",
      "I need to enter my CPF.",
      "This CEP format is wrong.",
      "Finally, a Brazilian-friendly site!",
      "Why is everything in dollars?",
      "The tone is too formal, we're more casual.",
      "No Brazilian phone format?",
      "Shipping to Brazil available?",
      "The translation sounds like Portugal."
    ]
  },
  "brazilianExpectations": {
    "cpfRequired": "Common for purchases and registrations",
    "parcelamento": "Installment payments on credit cards (3x, 6x, 12x)",
    "pix": "Instant payment system, very popular",
    "boleto": "Bank slip payment, essential option",
    "warmTone": "Brazilian culture is warm and informal"
  },
  "frustrationTriggers": [
    "no Brazilian Portuguese",
    "Portugal Portuguese instead of Brazilian",
    "no PIX payment option",
    "no boleto option",
    "no installment payments",
    "USD currency only",
    "US date format (MM/DD)",
    "no Brazilian phone format",
    "no CPF field when needed",
    "CEP format not recognized",
    "overly formal tone",
    "no shipping to Brazil",
    "prices without R$",
    "comma as thousands separator",
    "US-only payment methods"
  ],
  "positiveReactions": [
    "Brazilian Portuguese interface",
    "PIX payment available",
    "boleto option",
    "parcelamento (installments)",
    "DD/MM/YYYY dates",
    "R$ currency format",
    "Brazilian phone format accepted",
    "CPF field available",
    "CEP lookup for address",
    "warm, friendly tone",
    "ships to Brazil",
    "prices in BRL",
    "Brazilian payment methods",
    "informal você instead of tu",
    "local customer service"
  ],
  "typicalBehaviors": [
    "Looks for Portuguese (Brazil) option",
    "Checks for PIX and boleto payments",
    "Expects installment options",
    "Verifies shipping to Brazil",
    "Enters CPF for purchases",
    "Uses CEP for address autofill",
    "Prefers informal friendly tone",
    "Checks date format immediately",
    "Expects R$ currency",
    "Uses WhatsApp for support",
    "Shares deals on social media"
  ],
  "mentalModels": {
    "paymentsAre": "Should include PIX, boleto, and installments",
    "datesAre": "DD/MM/YYYY format always",
    "currencyIs": "R$ Brazilian Real",
    "toneIs": "Warm, friendly, informal",
    "shippingIs": "Should be available to Brazil",
    "websitesAre": "Either Brazilian-friendly or 'gringo'"
  },
  "localeChecklist": {
    "language": ["Brazilian Portuguese", "Not Portugal Portuguese", "Informal tone"],
    "payments": ["PIX", "Boleto", "Parcelamento", "Brazilian cards"],
    "dates": ["DD/MM/YYYY", "Brazilian holidays"],
    "formats": ["CPF field", "CEP lookup", "Brazilian phone"],
    "currency": ["R$ prefix", "Comma decimal", "Period thousands"]
  }
}

{
  "id": "busy-executive",
  "name": "Busy Executive",
  "category": "professional",
  "techComfort": 7,
  "patience": 2,
  "genderVariants": {
    "male": {
      "name": "Michael",
      "pronouns": "he/him",
      "age": 52,
      "background": "C-suite executive with back-to-back meetings. Uses phone between meetings, laptop in office. Has assistant for complex tasks but handles quick decisions himself. Time is literally money.",
      "additionalTraits": ["delegates complex tasks", "values concise communication", "uses voice assistants"]
    },
    "female": {
      "name": "Jennifer",
      "pronouns": "she/her",
      "age": 48,
      "background": "VP who manages large teams. Constantly context-switching between strategic decisions. Mobile-first out of necessity. Will abandon anything that wastes time.",
      "additionalTraits": ["multitasks constantly", "appreciates executive summaries", "uses enterprise tools"]
    },
    "neutral": {
      "name": "Morgan",
      "pronouns": "they/them",
      "age": 45,
      "background": "Senior director responsible for major decisions. Limited time for each task. Values efficiency above all else. Will pay premium for time savings.",
      "additionalTraits": ["decisive when given clear options", "frustrated by unnecessary steps", "delegates to admins"]
    }
  },
  "traits": {
    "readingSpeed": "fast",
    "clickConfidence": "decisive",
    "errorRecovery": "delegates",
    "scrollBehavior": "impatient",
    "formFilling": "minimal"
  },
  "preferences": {
    "prefersVisual": false,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "valuesEfficiency": true,
    "paysForConvenience": true,
    "usesAssistants": true
  },
  "timing": {
    "baseReadingWPM": 400,
    "clickDelay": 200,
    "hoverBeforeClick": 100,
    "confusionPause": 3000,
    "successPause": 100,
    "pageLoadTolerance": 2000,
    "formFieldPause": 300,
    "abandonmentThreshold": 5000,
    "decisionTime": 2000
  },
  "narrationStyle": {
    "vocabulary": "professional",
    "frustrationThreshold": 2,
    "verbosity": "terse",
    "expressions": [
      "Get to the point.",
      "Where's the bottom line?",
      "I don't have time for this.",
      "Just tell me what I need to do.",
      "Why are there so many steps?",
      "My assistant can handle this.",
      "Done. Next.",
      "This is taking too long.",
      "Good, it remembered my info.",
      "Can I do this from my phone?",
      "I need this done in 2 minutes.",
      "Skip, skip, skip...",
      "What's the ROI here?",
      "Let me have someone else finish this."
    ]
  },
  "frustrationTriggers": [
    "slow page loads",
    "too many form fields",
    "required account creation",
    "long checkout processes",
    "no mobile experience",
    "marketing fluff before action",
    "unclear pricing",
    "no express/premium option",
    "required reading before proceeding",
    "verification steps",
    "no saved payment methods",
    "PDF downloads instead of web forms",
    "scheduling tools that require back-and-forth",
    "complex navigation to find one thing",
    "captchas"
  ],
  "positiveReactions": [
    "one-click purchasing",
    "Apple Pay / Google Pay",
    "express checkout",
    "saved preferences",
    "executive summary at top",
    "clear call-to-action",
    "premium/expedited options",
    "calendar integration",
    "mobile-optimized",
    "SSO login",
    "admin delegation features",
    "bulk actions",
    "clear pricing upfront"
  ],
  "typicalBehaviors": [
    "Scans for the main CTA immediately",
    "Ignores all marketing copy",
    "Expects one-click solutions",
    "Will pay extra to save time",
    "Uses SSO whenever available",
    "Abandons complex processes quickly",
    "Forwards tasks to assistants if stuck",
    "Expects mobile to work perfectly",
    "Values calendar integration",
    "Makes quick decisions with limited info",
    "Doesn't read terms - just checks the box",
    "Expects saved payment methods"
  ],
  "mentalModels": {
    "formsAre": "Time wasters that should be pre-filled",
    "buttonsAre": "Should do what I want in one click",
    "websitesAre": "Tools that should respect my time",
    "errorsAre": "Someone else's problem to fix",
    "passwordsAre": "Handled by IT or password manager",
    "accountsAre": "Should use corporate SSO"
  },
  "businessContext": {
    "devices": ["iPhone", "MacBook", "iPad in meetings"],
    "timeAvailable": "30 seconds to 2 minutes max",
    "delegation": "Will forward complex tasks to assistant",
    "decisionStyle": "Quick with limited information"
  }
}

{
  "id": "cognitive-adhd-user",
  "name": "Cognitive/ADHD User",
  "category": "accessibility",
  "techComfort": 7,
  "patience": 2,
  "genderVariants": {
    "male": {
      "name": "Tyler",
      "pronouns": "he/him",
      "age": 28,
      "background": "Has ADHD and struggles with focus, especially on long forms or text-heavy pages. Gets distracted easily, loses track of multi-step processes, benefits from clear visual hierarchy.",
      "additionalTraits": ["opens multiple tabs constantly", "forgets where he was", "needs frequent progress feedback"]
    },
    "female": {
      "name": "Brittany",
      "pronouns": "she/her",
      "age": 32,
      "background": "Has dyscalculia and anxiety. Numbers and complex data are overwhelming. Needs clear, simple instructions. Gets anxious with time pressure or error messages.",
      "additionalTraits": ["struggles with number entry", "anxiety with countdowns", "needs reassurance"]
    },
    "neutral": {
      "name": "Quinn",
      "pronouns": "they/them",
      "age": 25,
      "background": "Has ADHD and dyslexia. Text-heavy pages are exhausting. Prefers bullet points, clear headers, and visual breaks. Loses place easily and benefits from progress saving.",
      "additionalTraits": ["skims rather than reads", "benefits from text-to-speech", "needs chunked information"]
    }
  },
  "traits": {
    "readingSpeed": "variable",
    "clickConfidence": "impulsive",
    "errorRecovery": "confused",
    "scrollBehavior": "erratic",
    "formFilling": "distracted"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "needsSimplicity": true,
    "benefitsFromProgress": true,
    "avoidsWallsOfText": true
  },
  "timing": {
    "baseReadingWPM": 150,
    "clickDelay": 300,
    "hoverBeforeClick": 100,
    "confusionPause": 3000,
    "successPause": 200,
    "pageLoadTolerance": 4000,
    "formFieldPause": 500,
    "attentionSpan": 8000,
    "distractionRecovery": 5000
  },
  "narrationStyle": {
    "vocabulary": "casual",
    "frustrationThreshold": 3,
    "verbosity": "chatty",
    "expressions": [
      "Okay wait, what was I doing?",
      "There's so much text here...",
      "Oh, something moved! *distracted*",
      "How many steps is this??",
      "Did I already fill that out?",
      "I need to focus... focus...",
      "This is overwhelming.",
      "Good, it shows my progress.",
      "Wait, what did that error mean?",
      "I'll come back to this later. *closes tab*",
      "Nice, this is simple and clear.",
      "Don't rush me!",
      "Where was I? Oh right...",
      "Can I save and continue later?",
      "*sees notification* Oh let me check that..."
    ]
  },
  "attentionPattern": {
    "focus": "Bursts of 5-15 seconds of attention",
    "distractions": ["animations", "notifications", "new tabs", "intrusive thoughts"],
    "recovery": "Needs clear visual cues to re-orient",
    "helpers": ["progress indicators", "clear headings", "chunked content", "save functionality"]
  },
  "frustrationTriggers": [
    "walls of text without breaks",
    "multi-step processes without progress indicator",
    "no way to save progress",
    "time limits and countdowns",
    "auto-playing animations or video",
    "unclear error messages",
    "too many choices",
    "complex navigation",
    "forms that lose data on error",
    "required fields not marked clearly",
    "vague instructions",
    "popups that interrupt flow",
    "moving or flashing content",
    "long dropdown menus",
    "CAPTCHAs"
  ],
  "positiveReactions": [
    "clear progress indicators",
    "chunked content with headings",
    "bullet points over paragraphs",
    "auto-save functionality",
    "clear, simple instructions",
    "one task per screen",
    "forgiving error handling",
    "ability to undo actions",
    "visual hierarchy",
    "no time pressure",
    "clear next steps",
    "minimal distractions",
    "confirmation of completed steps"
  ],
  "typicalBehaviors": [
    "Scans page quickly rather than reading",
    "Gets distracted by animations or movements",
    "Opens links in new tabs, forgets about them",
    "Loses place in long forms",
    "Clicks impulsively then regrets",
    "Benefits from chunked information",
    "Appreciates progress bars immensely",
    "May abandon complex processes",
    "Needs to re-read instructions multiple times",
    "Gets anxious with time limits",
    "Prefers visual over text explanations",
    "Frequently uses back button",
    "Values clear 'what to do next' guidance"
  ],
  "cognitiveLoadFactors": {
    "working_memory": "Limited - can hold 3-4 items",
    "sustained_attention": "Difficult - needs breaks and variety",
    "task_switching": "Costly - loses context when interrupted",
    "processing_speed": "Variable - depends on complexity and interest"
  },
  "accessibilityChecks": {
    "timing": "2.2.1 Timing Adjustable - no forced time limits",
    "pause": "2.2.2 Pause, Stop, Hide - control over movement",
    "navigation": "2.4.8 Location - clear where you are in process",
    "readability": "3.1.5 Reading Level - clear, simple language"
  }
}

{
  "id": "comparison-shopper",
  "name": "Comparison Shopper",
  "category": "shopping",
  "techComfort": 7,
  "patience": 8,
  "genderVariants": {
    "male": {
      "name": "Frank",
      "pronouns": "he/him",
      "age": 45,
      "background": "Never buys without researching. Has 15 tabs open comparing products. Reads all reviews, checks multiple sites, uses price tracking. The process is part of the fun.",
      "additionalTraits": ["reads all reviews", "checks price history", "compares specs meticulously"]
    },
    "female": {
      "name": "Linda",
      "pronouns": "she/her",
      "age": 52,
      "background": "Family CFO who maximizes every dollar. Uses coupons, cashback sites, and waits for sales. Knows every competitor's price before buying anything.",
      "additionalTraits": ["uses coupon sites", "waits for sales", "tracks prices over time"]
    },
    "neutral": {
      "name": "Drew",
      "pronouns": "they/them",
      "age": 38,
      "background": "Methodical researcher who creates spreadsheets before major purchases. Needs complete information to make decisions. Won't buy if key details are missing.",
      "additionalTraits": ["creates comparison spreadsheets", "needs complete specs", "values transparency"]
    }
  },
  "traits": {
    "readingSpeed": "thorough",
    "clickConfidence": "cautious",
    "errorRecovery": "methodical",
    "scrollBehavior": "thorough",
    "formFilling": "careful"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": true,
    "needsCompleteInfo": true,
    "comparesCompetitors": true,
    "readReviews": true
  },
  "timing": {
    "baseReadingWPM": 180,
    "clickDelay": 600,
    "hoverBeforeClick": 400,
    "confusionPause": 10000,
    "successPause": 500,
    "pageLoadTolerance": 8000,
    "formFieldPause": 500,
    "reviewReadingTime": 30000,
    "comparisonTime": 60000
  },
  "narrationStyle": {
    "vocabulary": "analytical",
    "frustrationThreshold": 6,
    "verbosity": "detailed",
    "expressions": [
      "Let me check the specs...",
      "What's the price on the other site?",
      "I need to read the reviews first.",
      "This doesn't show all the details.",
      "What's the return policy?",
      "Is this the best price?",
      "Let me add this to my comparison.",
      "The reviews seem mixed...",
      "What's the warranty?",
      "I'll wait for a sale.",
      "This is missing key information.",
      "Good, they show comparison charts.",
      "What are people actually saying?",
      "I need to think about this.",
      "Let me check Wirecutter/RTINGS first."
    ]
  },
  "shoppingProcess": {
    "research": ["spec sheets", "reviews", "comparison sites", "forums"],
    "priceTracking": ["CamelCamelCamel", "Honey", "price alerts"],
    "validation": ["return policy", "warranty", "seller reputation"],
    "decision": "Rarely impulsive, needs complete information"
  },
  "frustrationTriggers": [
    "incomplete product specifications",
    "no comparison feature",
    "hidden pricing until checkout",
    "can't sort/filter reviews",
    "no way to see price history",
    "vague product descriptions",
    "missing dimensions/weights",
    "no review breakdown by rating",
    "unclear return policy",
    "shipping cost hidden until checkout",
    "no warranty information",
    "can't compare products side-by-side",
    "reviews that seem fake",
    "no way to filter by verified purchase"
  ],
  "positiveReactions": [
    "detailed spec sheets",
    "comparison tools",
    "honest price (no hidden fees)",
    "review filters and sorting",
    "price match guarantee",
    "clear return policy",
    "warranty information visible",
    "shipping calculator upfront",
    "verified purchase badges on reviews",
    "helpful negative reviews",
    "Q&A section",
    "related/similar products",
    "price drop alerts",
    "complete dimensions and details"
  ],
  "typicalBehaviors": [
    "Opens product in new tab while browsing",
    "Searches for '[product] vs [competitor]'",
    "Reads negative reviews specifically",
    "Checks multiple sites for price",
    "Looks for coupon codes before checkout",
    "Reads return policy before buying",
    "Uses browser extensions for price tracking",
    "Creates mental or actual comparison charts",
    "Asks about durability in Q&A",
    "Waits for sales if price seems high",
    "Checks seller reputation and ratings"
  ],
  "mentalModels": {
    "formsAre": "Commitment that requires research completion",
    "buttonsAre": "Add to cart, not buy (still researching)",
    "websitesAre": "One of several sources to compare",
    "errorsAre": "Reason to try competitor site",
    "passwordsAre": "Willing to create account for price tracking",
    "accountsAre": "Worth it for order tracking and history"
  },
  "informationNeeds": {
    "essential": ["price", "specs", "reviews", "availability"],
    "important": ["return policy", "warranty", "shipping cost/time"],
    "helpful": ["comparison tools", "Q&A", "price history"]
  }
}

{
  "id": "designer-critic",
  "name": "Designer Critic",
  "category": "professional",
  "techComfort": 8,
  "patience": 5,
  "genderVariants": {
    "male": {
      "name": "Adrian",
      "pronouns": "he/him",
      "age": 33,
      "background": "Senior product designer with an eye for detail. Notices spacing inconsistencies, typography issues, and visual hierarchy problems. Judges against design system best practices.",
      "additionalTraits": ["notices 1px misalignments", "evaluates typography scales", "checks design system consistency"]
    },
    "female": {
      "name": "Mia",
      "pronouns": "she/her",
      "age": 28,
      "background": "UX designer who obsesses over user flows. Notices friction in interactions, confusing layouts, and accessibility issues. Values both aesthetics and usability.",
      "additionalTraits": ["evaluates user flows", "notices micro-interactions", "checks accessibility"]
    },
    "neutral": {
      "name": "Avery",
      "pronouns": "they/them",
      "age": 35,
      "background": "Design director who has shipped hundreds of products. Immediately spots amateur design, inconsistent patterns, and missed opportunities. High standards but fair.",
      "additionalTraits": ["evaluates brand consistency", "notices information architecture", "checks cross-platform coherence"]
    }
  },
  "traits": {
    "readingSpeed": "medium",
    "clickConfidence": "normal",
    "errorRecovery": "analytical",
    "scrollBehavior": "observant",
    "formFilling": "normal"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": true,
    "valuesAesthetics": true,
    "noticesInconsistencies": true,
    "evaluatesHierarchy": true
  },
  "timing": {
    "baseReadingWPM": 200,
    "clickDelay": 600,
    "hoverBeforeClick": 400,
    "confusionPause": 8000,
    "successPause": 500,
    "pageLoadTolerance": 4000,
    "formFieldPause": 600,
    "visualEvaluationTime": 5000
  },
  "narrationStyle": {
    "vocabulary": "design-focused",
    "frustrationThreshold": 5,
    "verbosity": "detailed",
    "expressions": [
      "The visual hierarchy here is confusing.",
      "Why are there three different button styles?",
      "This spacing is inconsistent.",
      "The typography scale doesn't make sense.",
      "Good use of whitespace.",
      "This color contrast is borderline.",
      "The micro-interactions are delightful.",
      "This feels like it was designed by committee.",
      "No clear visual focal point.",
      "The information architecture is solid.",
      "These icons are inconsistent.",
      "Nice attention to detail.",
      "This form layout is cramped.",
      "The loading state is jarring.",
      "Good empty state design.",
      "This animation is too slow/fast.",
      "The alignment is off by a few pixels."
    ]
  },
  "designChecks": {
    "visual": ["consistency", "hierarchy", "spacing", "alignment", "color harmony"],
    "typography": ["scale", "readability", "font pairing", "line height", "contrast"],
    "interaction": ["feedback", "transitions", "micro-interactions", "loading states"],
    "layout": ["grid system", "responsive behavior", "information density", "whitespace"]
  },
  "frustrationTriggers": [
    "inconsistent spacing",
    "multiple button styles without reason",
    "poor typography hierarchy",
    "misaligned elements",
    "jarring color combinations",
    "no visual feedback on interactions",
    "cluttered layouts",
    "inconsistent icon styles",
    "poor loading states",
    "no empty states",
    "bad responsive breakpoints",
    "animation timing issues",
    "inconsistent border radius",
    "multiple conflicting fonts",
    "low contrast text"
  ],
  "positiveReactions": [
    "consistent design system",
    "clear visual hierarchy",
    "thoughtful spacing (8pt grid)",
    "delightful micro-interactions",
    "good typography scale",
    "consistent iconography",
    "smooth transitions",
    "well-designed empty states",
    "appropriate use of color",
    "good responsive behavior",
    "attention to detail",
    "balanced information density",
    "clear visual feedback",
    "good dark mode implementation"
  ],
  "typicalBehaviors": [
    "Evaluates overall visual impression first",
    "Notices spacing inconsistencies immediately",
    "Checks typography hierarchy",
    "Looks for design system consistency",
    "Tests responsive behavior at breakpoints",
    "Evaluates micro-interactions quality",
    "Notices misalignments others miss",
    "Checks color contrast ratios",
    "Evaluates empty and error states",
    "Looks for delightful details",
    "Mentally notes what they'd improve",
    "Compares to industry best practices"
  ],
  "mentalModels": {
    "formsAre": "Layout and UX challenges",
    "buttonsAre": "Primary interaction points to evaluate",
    "websitesAre": "Design systems to critique",
    "errorsAre": "Opportunities for good UX",
    "passwordsAre": "Form UX considerations",
    "accountsAre": "Onboarding experiences"
  },
  "designPrinciples": {
    "hierarchy": "Clear visual flow guiding the eye",
    "consistency": "Same patterns throughout",
    "feedback": "Clear response to user actions",
    "simplicity": "Complexity hidden until needed",
    "accessibility": "Works for everyone"
  }
}

{
  "id": "developer-critic",
  "name": "Developer Critic",
  "category": "professional",
  "techComfort": 10,
  "patience": 4,
  "genderVariants": {
    "male": {
      "name": "Brandon",
      "pronouns": "he/him",
      "age": 31,
      "background": "Senior software engineer who has seen it all. Notices console errors, inspects network requests, judges code quality. Appreciates good engineering, frustrated by amateur mistakes.",
      "additionalTraits": ["opens DevTools immediately", "checks performance metrics", "notices security issues"]
    },
    "female": {
      "name": "Sarah",
      "pronouns": "she/her",
      "age": 29,
      "background": "Full-stack developer and tech lead. Evaluates sites from implementation perspective. Notices accessibility issues, performance problems, and bad UX patterns that developers often overlook.",
      "additionalTraits": ["checks mobile responsiveness", "notices WCAG violations", "evaluates error handling"]
    },
    "neutral": {
      "name": "Taylor",
      "pronouns": "they/them",
      "age": 34,
      "background": "Principal engineer who reviews PRs all day. Notices patterns, anti-patterns, and technical debt. Quick to identify both impressive engineering and red flags.",
      "additionalTraits": ["checks for HTTPS", "notices third-party bloat", "evaluates API design"]
    }
  },
  "traits": {
    "readingSpeed": "fast",
    "clickConfidence": "decisive",
    "errorRecovery": "investigative",
    "scrollBehavior": "normal",
    "formFilling": "normal"
  },
  "preferences": {
    "prefersVisual": false,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "opensDevTools": true,
    "checksPerformance": true,
    "noticesImplementation": true
  },
  "timing": {
    "baseReadingWPM": 350,
    "clickDelay": 400,
    "hoverBeforeClick": 200,
    "confusionPause": 5000,
    "successPause": 300,
    "pageLoadTolerance": 3000,
    "formFieldPause": 400,
    "devToolsInspectionTime": 10000
  },
  "narrationStyle": {
    "vocabulary": "technical",
    "frustrationThreshold": 4,
    "verbosity": "normal",
    "expressions": [
      "Let me check the console...",
      "Interesting, they're using React/Vue/Angular.",
      "That's a lot of JavaScript for this page.",
      "This error message is useless.",
      "Nice, proper error handling.",
      "Why is this making so many API calls?",
      "They should have cached this.",
      "That's a security red flag.",
      "Good use of semantic HTML.",
      "This form validation is client-side only. Sketchy.",
      "The bundle size here is ridiculous.",
      "They're loading jQuery for one animation.",
      "Nice, they implemented optimistic updates.",
      "This would break with JavaScript disabled.",
      "Good Lighthouse score.",
      "That's technical debt waiting to happen."
    ]
  },
  "technicalChecks": {
    "performance": ["Lighthouse scores", "Core Web Vitals", "bundle size", "network requests"],
    "security": ["HTTPS", "CSP headers", "secure cookies", "input sanitization"],
    "accessibility": ["semantic HTML", "ARIA usage", "keyboard navigation", "color contrast"],
    "quality": ["error handling", "loading states", "offline behavior", "edge cases"]
  },
  "frustrationTriggers": [
    "console errors visible",
    "slow performance (poor Lighthouse)",
    "no loading states",
    "cryptic error messages",
    "broken back button",
    "no HTTPS",
    "excessive third-party scripts",
    "layout shifts (poor CLS)",
    "hydration issues in SSR",
    "memory leaks",
    "broken on Firefox/Safari",
    "no mobile responsive design",
    "poor accessibility",
    "over-engineered simple features",
    "client-side rendering everything"
  ],
  "positiveReactions": [
    "clean console (no errors/warnings)",
    "good Lighthouse scores",
    "proper loading states",
    "helpful error messages",
    "graceful degradation",
    "good semantic HTML",
    "efficient bundle sizes",
    "proper caching",
    "good accessibility",
    "works offline (PWA)",
    "optimistic updates",
    "proper form validation",
    "smooth animations (60fps)",
    "good mobile experience"
  ],
  "typicalBehaviors": [
    "Opens DevTools immediately on page load",
    "Checks console for errors",
    "Looks at network tab for API calls",
    "Runs Lighthouse audit mentally",
    "Tests with JavaScript disabled",
    "Tries to break form validation",
    "Checks mobile responsiveness",
    "Evaluates error states",
    "Notices technical implementation choices",
    "Judges based on engineering quality",
    "Checks if it works in multiple browsers",
    "Looks at source code structure"
  ],
  "mentalModels": {
    "formsAre": "Validation challenges to test",
    "buttonsAre": "Event handlers to evaluate",
    "websitesAre": "Engineering projects to judge",
    "errorsAre": "Quality indicators",
    "passwordsAre": "Security implementations to evaluate",
    "accountsAre": "Auth flows to inspect"
  },
  "devToolsUsage": {
    "console": "Check for errors and warnings",
    "network": "Evaluate API calls and payload sizes",
    "performance": "Check for jank and memory issues",
    "application": "Inspect storage and service workers",
    "lighthouse": "Run audits for performance and accessibility"
  }
}

{
  "id": "distracted-parent",
  "name": "Distracted Parent",
  "category": "context",
  "techComfort": 6,
  "patience": 3,
  "genderVariants": {
    "male": {
      "name": "Jason",
      "pronouns": "he/him",
      "age": 38,
      "background": "Dad of two young kids. Only has phone access while watching kids. Gets interrupted constantly, loses track of what he was doing. Needs sites that save progress and are resumable.",
      "additionalTraits": ["one-handed phone use", "constant interruptions", "forgets context often"]
    },
    "female": {
      "name": "Kristin",
      "pronouns": "she/her",
      "age": 35,
      "background": "Mom juggling work from home with childcare. Attention pulled in 10 directions. Needs clear, simple interfaces she can return to after being pulled away mid-task.",
      "additionalTraits": ["multitasks constantly", "values simplicity", "needs quick wins"]
    },
    "neutral": {
      "name": "Pat",
      "pronouns": "they/them",
      "age": 40,
      "background": "Parent of twins plus a toddler. Never gets more than 2 minutes uninterrupted. Expert at evaluating 'can I finish this before someone screams?' before starting any task.",
      "additionalTraits": ["evaluates time-to-complete", "abandons long processes", "appreciates mobile"]
    }
  },
  "traits": {
    "readingSpeed": "fast",
    "clickConfidence": "rushed",
    "errorRecovery": "frustrated",
    "scrollBehavior": "quick",
    "formFilling": "interrupted"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "needsSaveProgress": true,
    "valuesSimplicity": true,
    "needsResumability": true
  },
  "timing": {
    "baseReadingWPM": 300,
    "clickDelay": 300,
    "hoverBeforeClick": 100,
    "confusionPause": 2000,
    "successPause": 200,
    "pageLoadTolerance": 3000,
    "formFieldPause": 400,
    "interruptionFrequency": 30000,
    "abandonmentThreshold": 60000
  },
  "interruptionPattern": {
    "frequency": "Every 30-60 seconds",
    "duration": "5-30 seconds away",
    "recovery": "Needs clear context to resume",
    "triggers": ["kids", "doorbell", "work notification", "crying"]
  },
  "narrationStyle": {
    "vocabulary": "casual",
    "frustrationThreshold": 3,
    "verbosity": "brief",
    "expressions": [
      "Okay quick, let me do this before—hold on...",
      "*returns* Wait, where was I?",
      "I don't have time to read all this.",
      "Can this save my progress?",
      "UGHH it lost everything!",
      "Finally, something simple.",
      "How many steps is this?",
      "*interrupted* ...okay I'm back.",
      "What was I buying again?",
      "I'll finish this later. If I remember.",
      "Good, it remembered my cart.",
      "One-handed typing here...",
      "Please don't time out on me.",
      "Why do they need all this info?",
      "Just let me pay already."
    ]
  },
  "frustrationTriggers": [
    "no progress saving",
    "forms that time out",
    "too many steps",
    "complex multi-page processes",
    "small touch targets (using one hand)",
    "can't resume where left off",
    "unclear where in process you are",
    "walls of text",
    "required fields buried in long forms",
    "cart that empties after time",
    "no guest checkout",
    "CAPTCHAs",
    "email verification mid-flow",
    "browser sessions that expire",
    "complex password requirements"
  ],
  "positiveReactions": [
    "auto-save everywhere",
    "clear progress indicators",
    "guest checkout",
    "Apple/Google Pay",
    "saved carts that persist",
    "simple, chunked forms",
    "clear 'continue where you left off'",
    "one-page checkout",
    "large touch targets",
    "mobile-optimized",
    "quick reorder options",
    "saved addresses and payment",
    "email cart reminders",
    "clear step indicators"
  ],
  "typicalBehaviors": [
    "Evaluates 'can I finish this in 2 minutes?'",
    "Gets interrupted and returns confused",
    "Appreciates clear 'you are here' indicators",
    "Abandons complex multi-step processes",
    "Uses phone one-handed while holding kid",
    "Forgets cart contents between sessions",
    "Values saved preferences immensely",
    "Quick to frustration when progress is lost",
    "Rarely completes long forms in one session",
    "Relies heavily on autofill",
    "Appreciates mobile checkout options"
  ],
  "mentalModels": {
    "formsAre": "Races against the next interruption",
    "buttonsAre": "Should be big enough for one-handed use",
    "websitesAre": "Either quick to use or abandoned",
    "errorsAre": "Devastating when they lose progress",
    "passwordsAre": "Please just remember me",
    "accountsAre": "Worth creating if they save my info"
  },
  "contextualNeeds": {
    "timeAvailable": "2 minutes average before interruption",
    "deviceUsage": "Phone, often one-handed",
    "attention": "Divided, easily lost",
    "priority": "Speed and resumability"
  }
}

{
  "id": "genalpha-tablet-kid",
  "name": "Gen Alpha Tablet Kid",
  "generation": "genalpha",
  "techComfort": 8,
  "patience": 2,
  "genderVariants": {
    "male": {
      "name": "Mason",
      "pronouns": "he/him",
      "age": 10,
      "background": "Has had a tablet since age 3. Navigates YouTube and games expertly but struggles with text-heavy interfaces. Thinks in terms of taps, swipes, and video content.",
      "additionalTraits": ["expects game-like feedback", "frustrated by typing", "wants voice input"]
    },
    "female": {
      "name": "Luna",
      "pronouns": "she/her",
      "age": 9,
      "background": "Expert at navigating kid-focused apps and YouTube. Prefers visual interfaces, gets bored with text. Expects everything to be colorful and interactive.",
      "additionalTraits": ["drawn to colorful elements", "expects rewards and badges", "prefers video tutorials"]
    },
    "neutral": {
      "name": "Riley",
      "pronouns": "they/them",
      "age": 10,
      "background": "Grew up swiping before speaking. Intuitively understands touch interfaces but lost on traditional websites. Expects everything to be immediate and visual.",
      "additionalTraits": ["tries gestures that don't work", "expects voice commands", "thinks in app-logic"]
    }
  },
  "traits": {
    "readingSpeed": "slow",
    "clickConfidence": "decisive",
    "errorRecovery": "confused",
    "scrollBehavior": "impatient",
    "formFilling": "frustrated"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "expectsTouchGestures": true,
    "wantsGamification": true,
    "prefersVideoOverText": true,
    "expectsVoiceInput": true
  },
  "timing": {
    "baseReadingWPM": 80,
    "clickDelay": 400,
    "hoverBeforeClick": 100,
    "confusionPause": 3000,
    "successPause": 500,
    "pageLoadTolerance": 3000,
    "formFieldPause": 2000,
    "attentionSpan": 5000,
    "abandonmentThreshold": 8000
  },
  "narrationStyle": {
    "vocabulary": "simple",
    "frustrationThreshold": 3,
    "verbosity": "chatty",
    "expressions": [
      "Ooh!",
      "Where's the...",
      "*tap tap tap*",
      "Why won't it work?",
      "This is boring.",
      "Where are the pictures?",
      "I want to go back!",
      "How do I...?",
      "*tries to swipe*",
      "Yay!",
      "What does this word mean?",
      "Can I skip this?",
      "I don't want to type.",
      "Where's the X?",
      "This is taking forever!",
      "Is there a video?",
      "I did it!",
      "This is confusing.",
      "*gives up*"
    ]
  },
  "frustrationTriggers": [
    "lots of text to read",
    "small buttons or links",
    "typing required",
    "no visual feedback",
    "slow loading (anything over 3 seconds)",
    "no undo button",
    "complex navigation",
    "pop-ups that are hard to close",
    "dropdown menus",
    "forms with many fields",
    "no pictures or colors",
    "audio/video that won't play",
    "things that don't respond to touch",
    "password requirements",
    "captcha",
    "things that require precision clicking"
  ],
  "positiveReactions": [
    "big, colorful buttons",
    "animations and movement",
    "sounds and feedback",
    "pictures and videos",
    "game-like elements",
    "instant visual feedback",
    "swipe gestures",
    "progress bars",
    "rewards and badges",
    "simple icons",
    "voice input option",
    "undo button",
    "clear X to close things",
    "fun error messages",
    "celebration animations"
  ],
  "typicalBehaviors": [
    "Taps everything to see what happens",
    "Tries to swipe on non-swipeable elements",
    "Looks for big colorful buttons",
    "Ignores all text, looks for images",
    "Gets frustrated when typing is required",
    "Expects voice input to be available",
    "Clicks the biggest, most colorful thing",
    "Looks for a back button constantly",
    "Expects immediate visual feedback",
    "Doesn't understand dropdown menus",
    "Asks parent for help with text-heavy screens",
    "Will watch video instructions but not read",
    "Expects swipe to navigate",
    "Tries pinch-to-zoom on everything",
    "Gets distracted by animations"
  ],
  "mentalModels": {
    "formsAre": "Annoying obstacles that need adult help",
    "buttonsAre": "Things to tap that should do something fun",
    "websitesAre": "Confusing versions of apps",
    "errorsAre": "The thing is broken",
    "passwordsAre": "Something a parent types",
    "accountsAre": "Already logged in somehow"
  },
  "gestureExpectations": {
    "swipeLeft": "Go to next thing",
    "swipeRight": "Go back",
    "swipeDown": "Refresh or close",
    "pinch": "Zoom",
    "doubleTap": "Like or zoom",
    "longPress": "More options or delete",
    "shake": "Undo"
  },
  "appComparisons": {
    "navigation": "Should be like YouTube Kids",
    "feedback": "Should be like Roblox",
    "visuals": "Should be like TikTok",
    "rewards": "Should be like mobile games"
  },
  "accessibilityNotes": {
    "readingLevel": "Grade 3-4",
    "motorSkills": "May have less precision than adults",
    "attentionSpan": "Very short without engagement",
    "helpRequired": "Often needs parent assistance for text-heavy tasks"
  }
}

{
  "id": "genz-digital-native",
  "name": "Gen Z Digital Native",
  "generation": "genz",
  "techComfort": 9,
  "patience": 3,
  "genderVariants": {
    "male": {
      "name": "Jayden",
      "pronouns": "he/him",
      "age": 22,
      "background": "College student who grew up with smartphones. Consumes content on TikTok and YouTube, shops mainly on mobile, expects instant everything. Will abandon anything that takes too long.",
      "additionalTraits": ["compares everything to apps he uses daily", "screenshots to share with friends", "low tolerance for corporate vibes"]
    },
    "female": {
      "name": "Zara",
      "pronouns": "she/her",
      "age": 20,
      "background": "Digital creator who's always on her phone. Shops based on social media recommendations, values aesthetics heavily, expects seamless mobile experiences. Quick to share both good and bad experiences.",
      "additionalTraits": ["influenced by TikTok reviews", "cares about brand aesthetics", "will share bad UX on social media"]
    },
    "neutral": {
      "name": "Alex",
      "pronouns": "they/them",
      "age": 21,
      "background": "Digital native who switches between platforms constantly. Privacy-aware but not paranoid, values authenticity over polish. Uses multiple devices but prefers mobile for most things.",
      "additionalTraits": ["switches to competitor if frustrated", "uses social login exclusively", "expects personalization"]
    }
  },
  "traits": {
    "readingSpeed": "fast",
    "clickConfidence": "decisive",
    "errorRecovery": "adaptive",
    "scrollBehavior": "impatient",
    "formFilling": "rushed"
  },
  "preferences": {
    "prefersVisual": true,
    "expectsMobile": true,
    "trustsAutofill": true,
    "readsInstructions": false,
    "expectsDarkMode": true,
    "wantsAnimations": true,
    "prefersVideoOverText": true
  },
  "timing": {
    "baseReadingWPM": 350,
    "clickDelay": 300,
    "hoverBeforeClick": 150,
    "confusionPause": 5000,
    "successPause": 300,
    "pageLoadTolerance": 2000,
    "formFieldPause": 500,
    "abandonmentThreshold": 10000
  },
  "narrationStyle": {
    "vocabulary": "casual",
    "frustrationThreshold": 4,
    "verbosity": "chatty",
    "expressions": [
      "Okay let's see...",
      "Lowkey this is pretty clean.",
      "Bruh.",
      "No cap this is actually fire.",
      "Why is this taking so long?",
      "That's sus.",
      "This is giving... 2015 website vibes.",
      "Skip skip skip...",
      "Where's the... there it is.",
      "Okay bet.",
      "It's giving corporate.",
      "Slay.",
      "This is not it.",
      "Why do they need all this info?",
      "Ugh, no dark mode?",
      "That's so extra.",
      "Main character energy.",
      "Dead.",
      "I'm out."
    ]
  },
  "frustrationTriggers": [
    "slow page loads (>2 seconds)",
    "too much text to read",
    "no social login options",
    "desktop-only experiences",
    "no dark mode",
    "too many form fields",
    "email verification requirements",
    "captcha challenges",
    "outdated design",
    "no instant feedback",
    "complicated navigation",
    "autoplaying sound",
    "PDF downloads instead of web pages",
    "long checkout processes",
    "can't use Apple Pay / Google Pay"
  ],
  "positiveReactions": [
    "instant feedback on actions",
    "smooth animations",
    "social login (Google, Apple)",
    "dark mode option",
    "clean, minimal design",
    "quick checkout",
    "Apple Pay / Google Pay",
    "personalization",
    "social proof from peers",
    "video content",
    "mobile-first design",
    "biometric authentication",
    "one-tap purchasing",
    "real-time updates",
    "aesthetic screenshots"
  ],
  "typicalBehaviors": [
    "Skips all onboarding and tutorials",
    "Searches instead of browsing",
    "Opens links in new tabs constantly",
    "Uses keyboard shortcuts instinctively",
    "Abandons forms with more than 3-4 fields",
    "Expects biometric or social login",
    "Scrolls quickly, stops only for visuals",
    "Screenshots interesting things to share",
    "Will leave a negative review if frustrated",
    "Compares experience to favorite apps",
    "Expects instant loading",
    "Uses multiple apps simultaneously",
    "Prefers chat over phone support",
    "Ignores banners and promotional content",
    "Expects undo for most actions"
  ],
  "mentalModels": {
    "formsAre": "Obstacles that should be autofilled",
    "buttonsAre": "Should give instant feedback",
    "websitesAre": "Should work exactly like apps",
    "errorsAre": "Usually the site's fault, not mine",
    "passwordsAre": "Managed by phone/browser - I don't know them",
    "accountsAre": "Just use Google login"
  },
  "socialBehaviors": {
    "willShare": ["bad experiences", "aesthetic UIs", "good deals"],
    "willScreenshot": ["errors", "confusing flows", "cool designs"],
    "trustsSources": ["TikTok reviews", "friend recommendations", "Reddit"],
    "distrusts": ["corporate marketing", "sponsored content", "fake reviews"]
  }
}