Add Persona Walkthrough Specialist#507
Open
hedonnn wants to merge 1 commit into
Open
Conversation
|
Closing — this is my personal fork (bensl84/agency-agents). The canonical project lives at https://github.com/msitarzewski/agency-agents — please re-open your PR there. Thanks! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do?
Adds a new Persona Walkthrough Specialist agent to
design/— a UX research agent that simulates cognitive walkthroughs of web pages from the psychological perspective of defined user personas.Instead of running generic usability checklists, this agent becomes a specific user: it adopts their fears, cultural expectations, search intent, and decision style, then experiences the page scroll by scroll through concurrent think-aloud monologues paired with structured framework analysis.
The approach is grounded in established UX research methodology (cognitive walkthroughs, think-aloud protocols, five-second testing) and validated by recent academic work — notably [UXAgent](https://arxiv.org/html/2504.09407v2) (Amazon Science, 2025), which demonstrated that LLM agents conditioned on personas can produce meaningful usability insights on real websites.
Agent Information
What makes this agent different
Most UX evaluation agents run against heuristic checklists. This one produces two distinct voices per page fold:
The Persona — a raw, first-person inner monologue that sounds like a real person scanning a page ("I have no idea who these people are. Is this an agency? A marketplace?"), not a consultant reporting ("The value proposition lacks clarity").
The Analyst — a structured assessment mapping the persona's reaction to conversion frameworks: which LIFT factor is affected, which Cialdini principle is active or missing, where the persona sits on the Fogg Motivation/Ability/Prompt axes.
The agent includes:
Motivation
Landing page evaluation is one of the most common tasks where AI agents can add real value — but generic "review this page" prompts produce generic output. The gap is empathy: understanding what a specific person with specific fears and expectations actually experiences when they land on a page.
This agent fills that gap by combining persona psychology with conversion science, producing insights that analytics dashboards and heuristic checklists miss — the human friction that kills conversions.
Testing
Tested on real estate, SaaS, and local service landing pages with multiple persona profiles (varying urgency levels, attachment styles, and cultural backgrounds). The dual-voice format (persona monologue + analyst assessment) consistently produces more actionable insights than single-voice approaches.
Checklist
name,description,color,emoji,vibe