UX Researcher & Designer
Generate user personas from research data, create journey maps, plan usability tests, and synthesize research findings into actionable design recommendations.
Table of Contents
Trigger Terms
Use this skill when you need to:
- "create user persona"
- "generate persona from data"
- "build customer journey map"
- "map user journey"
- "plan usability test"
- "design usability study"
- "analyze user research"
- "synthesize interview findings"
- "identify user pain points"
- "define user archetypes"
- "calculate research sample size"
- "create empathy map"
- "identify user needs"
Clarify First
Before generating the research artifact, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Workflows
Workflow 1: Generate User Persona
Situation: You have user data (analytics, surveys, interviews) and need to create a research-backed persona.
Steps:
Prepare user data
Required format (JSON):
[
{
"user_id": "user_1",
"age": 32,
"usage_frequency": "daily",
"features_used": ["dashboard", "reports", "export"],
"primary_device": "desktop",
"usage_context": "work",
"tech_proficiency": 7,
"pain_points": ["slow loading", "confusing UI"]
}
]
Run persona generator
# Human-readable output
python scripts/persona_generator.py
# JSON output for integration
python scripts/persona_generator.py json
Review generated components
| Component |
What to Check |
| Archetype |
Does it match the data patterns? |
| Demographics |
Are they derived from actual data? |
| Goals |
Are they specific and actionable? |
| Frustrations |
Do they include frequency counts? |
| Design implications |
Can designers act on these? |
Validate persona
- Show to 3-5 real users: "Does this sound like you?"
- Cross-check with support tickets
- Verify against analytics data
Reference: See references/persona-methodology.md for validity criteria
Proto-Persona Canvas (Lightweight Alternative)
When you lack research data but need a hypothesis-driven persona to align the team, use a proto-persona canvas. Proto-personas are assumption tools -- not validated truth -- meant to be tested and refined.
Use when: Starting a new initiative with no research budget, aligning a cross-functional team quickly, or creating a testable hypothesis about your user.
Proto-Persona Canvas Template:
### [Alliterative Name] (e.g., "Careful Carlos")
**Bio & Demographics:**
- Age, geography, social status, career stage
- Online presence, leisure activities, partner status
**Quotes** (what they say, feel, think):
- "[Direct quote capturing their perspective]"
- "[Quote revealing frustration or aspiration]"
**Pains:**
- [Pain related to the problem space]
- [Pain related to current workarounds]
**What They're Trying to Accomplish:**
- [Observable behavior 1]
- [Observable behavior 2]
**Goals** (wants, needs, dreams):
- [Short-term goal]
- [Long-term aspiration]
**Attitudes & Influences:**
- Decision Making Authority: [Can they buy/adopt your solution?]
- Decision Influencers: [Who influences their decisions?]
- Beliefs & Attitudes: [What beliefs impact their choices?]
**Assumptions to Validate:**
- [Top assumption that must be true for this persona to be viable]
- [Second assumption]
- [Third assumption]
Next steps after proto-persona:
- Generate interview questions to validate assumptions (Recommended)
- Generate an anti-persona to define scope boundaries
- Convert into a one-page stakeholder brief
Workflow 2: Create Journey Map
Situation: You need to visualize the end-to-end user experience for a specific goal.
Steps:
Define scope
| Element |
Description |
| Persona |
Which user type |
| Goal |
What they're trying to achieve |
| Start |
Trigger that begins journey |
| End |
Success criteria |
| Timeframe |
Hours/days/weeks |
Gather journey data
Sources:
- User interviews (ask "walk me through...")
- Session recordings
- Analytics (funnel, drop-offs)
- Support tickets
Map the stages
Typical B2B SaaS stages:
Awareness → Evaluation → Onboarding → Adoption → Advocacy
Fill in layers for each stage
Stage: [Name]
├── Actions: What does user do?
├── Touchpoints: Where do they interact?
├── Emotions: How do they feel? (1-5)
├── Pain Points: What frustrates them?
└── Opportunities: Where can we improve?
Map three experience paths (not just the happy path)
| Stage |
Happy Path |
Fail Path |
Difficult Path |
| Awareness |
Finds product via search |
Never discovers product |
Finds competitor first |
| Consideration |
Clear value proposition |
Confused by pricing |
Needs manager approval |
| Decision |
Easy signup flow |
Form errors, abandons |
Legal review delays |
| Delivery & Use |
Smooth onboarding |
Can't import data |
Workaround needed |
| Loyalty |
Becomes advocate |
Churns silently |
Stays but complains |
- Happy Path: Everything works as designed.
- Fail Path: User cannot complete their goal and drops off.
- Difficult Path: User completes the goal but with friction, workarounds, or frustration.
Add KPIs and ownership per stage
| Stage |
Leading KPI |
Lagging KPI |
Team Owner |
| Awareness |
Site visits, ad impressions |
Brand recall |
Marketing |
| Consideration |
Demo requests, pricing page views |
MQL conversion |
Marketing/Sales |
| Decision |
Trial starts, contract sent |
Close rate |
Sales |
| Use |
Feature adoption, DAU |
Retention rate |
Product |
| Loyalty |
NPS, referral count |
LTV, expansion revenue |
Customer Success |
Identify top friction points and interventions
For each friction point, document:
| Friction Point |
Why It Matters |
Intervention |
Expected Impact |
Effort |
Confidence |
| [Description] |
[User/business impact] |
[Proposed fix] |
High/Med/Low |
S/M/L |
High/Med/Low |
Priority Score = Frequency x Severity x Solvability
Reference: See references/journey-mapping-guide.md for templates
Workflow 3: Plan Usability Test
Situation: You need to validate a design with real users.
Steps:
Define research questions
Transform vague goals into testable questions:
| Vague |
Testable |
| "Is it easy to use?" |
"Can users complete checkout in <3 min?" |
| "Do users like it?" |
"Will users choose Design A or B?" |
| "Does it make sense?" |
"Can users find settings without hints?" |
Select method
| Method |
Participants |
Duration |
Best For |
| Moderated remote |
5-8 |
45-60 min |
Deep insights |
| Unmoderated remote |
10-20 |
15-20 min |
Quick validation |
| Guerrilla |
3-5 |
5-10 min |
Rapid feedback |
Design tasks
Good task format:
SCENARIO: "Imagine you're planning a trip to Paris..."
GOAL: "Book a hotel for 3 nights in your budget."
SUCCESS: "You see the confirmation page."
Task progression: Warm-up → Core → Secondary → Edge case → Free exploration
Define success metrics
| Metric |
Target |
| Completion rate |
>80% |
| Time on task |
<2× expected |
| Error rate |
<15% |
| Satisfaction |
>4/5 |
Prepare moderator guide
- Think-aloud instructions
- Non-leading prompts
- Post-task questions
Reference: See references/usability-testing-frameworks.md for full guide
Workflow 4: Synthesize Research
Situation: You have raw research data (interviews, surveys, observations) and need actionable insights.
Steps:
Code the data
Tag each data point:
[GOAL] - What they want to achieve
[PAIN] - What frustrates them
[BEHAVIOR] - What they actually do
[CONTEXT] - When/where they use product
[QUOTE] - Direct user words
Cluster similar patterns
User A: Uses daily, advanced features, shortcuts
User B: Uses daily, complex workflows, automation
User C: Uses weekly, basic needs, occasional
Cluster 1: A, B (Power Users)
Cluster 2: C (Casual User)
Calculate segment sizes
| Cluster |
Users |
% |
Viability |
| Power Users |
18 |
36% |
Primary persona |
| Business Users |
15 |
30% |
Primary persona |
| Casual Users |
12 |
24% |
Secondary persona |
Extract key findings
For each theme:
- Finding statement
- Supporting evidence (quotes, data)
- Frequency (X/Y participants)
- Business impact
- Recommendation
Prioritize opportunities
| Factor |
Score 1-5 |
| Frequency |
How often does this occur? |
| Severity |
How much does it hurt? |
| Breadth |
How many users affected? |
| Solvability |
Can we fix this? |
Reference: See references/persona-methodology.md for analysis framework
Tool Reference
persona_generator.py
Generates data-driven personas from user research data.
| Argument |
Values |
Default |
Description |
| format |
(none), json |
(none) |
Output format |
Sample Output:
============================================================
PERSONA: Alex the Power User
============================================================
📝 A daily user who primarily uses the product for work purposes
Archetype: Power User
Quote: "I need tools that can keep up with my workflow"
👤 Demographics:
• Age Range: 25-34
• Location Type: Urban
• Tech Proficiency: Advanced
🎯 Goals & Needs:
• Complete tasks efficiently
• Automate workflows
• Access advanced features
😤 Frustrations:
• Slow loading times (14/20 users)
• No keyboard shortcuts
• Limited API access
💡 Design Implications:
→ Optimize for speed and efficiency
→ Provide keyboard shortcuts and power features
→ Expose API and automation capabilities
📈 Data: Based on 45 users
Confidence: High
Archetypes Generated:
| Archetype |
Signals |
Design Focus |
| power_user |
Daily use, 10+ features |
Efficiency, customization |
| casual_user |
Weekly use, 3-5 features |
Simplicity, guidance |
| business_user |
Work context, team use |
Collaboration, reporting |
| mobile_first |
Mobile primary |
Touch, offline, speed |
Output Components:
| Component |
Description |
| demographics |
Age range, location, occupation, tech level |
| psychographics |
Motivations, values, attitudes, lifestyle |
| behaviors |
Usage patterns, feature preferences |
| needs_and_goals |
Primary, secondary, functional, emotional |
| frustrations |
Pain points with evidence |
| scenarios |
Contextual usage stories |
| design_implications |
Actionable recommendations |
| data_points |
Sample size, confidence level |
Quick Reference Tables
Research Method Selection
| Question Type |
Best Method |
Sample Size |
| "What do users do?" |
Analytics, observation |
100+ events |
| "Why do they do it?" |
Interviews |
8-15 users |
| "How well can they do it?" |
Usability test |
5-8 users |
| "What do they prefer?" |
Survey, A/B test |
50+ users |
| "What do they feel?" |
Diary study, interviews |
10-15 users |
Persona Confidence Levels
| Sample Size |
Confidence |
Use Case |
| 5-10 users |
Low |
Exploratory |
| 11-30 users |
Medium |
Directional |
| 31+ users |
High |
Production |
Usability Issue Severity
| Severity |
Definition |
Action |
| 4 - Critical |
Prevents task completion |
Fix immediately |
| 3 - Major |
Significant difficulty |
Fix before release |
| 2 - Minor |
Causes hesitation |
Fix when possible |
| 1 - Cosmetic |
Noticed but not problematic |
Low priority |
Interview Question Types
| Type |
Example |
Use For |
| Context |
"Walk me through your typical day" |
Understanding environment |
| Behavior |
"Show me how you do X" |
Observing actual actions |
| Goals |
"What are you trying to achieve?" |
Uncovering motivations |
| Pain |
"What's the hardest part?" |
Identifying frustrations |
| Reflection |
"What would you change?" |
Generating ideas |
Knowledge Base
Detailed reference guides in references/:
| File |
Content |
persona-methodology.md |
Validity criteria, data collection, analysis framework |
journey-mapping-guide.md |
Mapping process, templates, opportunity identification |
example-personas.md |
3 complete persona examples with data |
usability-testing-frameworks.md |
Test planning, task design, analysis |
Validation Checklist
Persona Quality
Journey Map Quality
Usability Test Quality
Research Synthesis Quality
Tool Reference
persona_generator.py
Generates data-driven personas from user research data, classifying users into archetypes with demographics, psychographics, behaviors, goals, frustrations, and design implications.
| Argument |
Type |
Default |
Description |
format |
positional |
(none) |
Add json for JSON output; omit for human-readable |
Archetypes supported: power_user, casual_user, business_user, mobile_first
Output components: name, archetype, tagline, quote, demographics, psychographics, behaviors, needs_and_goals, frustrations, scenarios, data_points, design_implications
python scripts/persona_generator.py # Human-readable formatted output
python scripts/persona_generator.py json # JSON for programmatic use
Data input format (customize in script):
[{
"user_id": "user_1",
"age": 32,
"usage_frequency": "daily",
"features_used": ["dashboard", "reports", "export"],
"primary_device": "desktop",
"usage_context": "work",
"tech_proficiency": 7,
"pain_points": ["slow loading", "confusing UI"]
}]
Troubleshooting
| Problem |
Cause |
Solution |
| Persona confidence level is "Low" |
Fewer than 20 users in sample data |
Collect more data points; combine quantitative analytics with qualitative interviews |
| All users classified as same archetype |
Insufficient variation in input data |
Ensure data includes diverse usage frequencies, devices, and contexts |
| Frustrations are generic (fallback defaults) |
Not enough pain_points in user data |
Enrich user data with pain_points from interviews and support tickets |
| Design implications too vague |
Patterns don't strongly differentiate |
Add more behavioral signals (features_used, session duration, task completion) |
| Journey map has flat emotion curve |
All stages scored similarly |
Re-evaluate with actual user data; conduct contextual interviews per stage |
| Usability test sample too small |
Fewer than 5 participants |
5 participants find ~85% of usability issues; recruit to minimum 5 |
| Research synthesis has no clear patterns |
Data not coded consistently |
Use consistent tagging scheme (GOAL, PAIN, BEHAVIOR, CONTEXT, QUOTE) |
Success Criteria
| Criterion |
Target |
How to Measure |
| Persona validity |
Validated by 3+ real users ("sounds like me") |
Post-creation validation interviews |
| Persona coverage |
All key segments represented |
Count of personas vs identified user segments |
| Data confidence level |
"High" (31+ users) |
persona_generator data_points.confidence_level |
| Research cadence |
5-8 interviews per segment per quarter |
Count of completed research sessions |
| Insight-to-action rate |
>70% of findings result in design changes |
Track findings through to implementation |
| Usability issue resolution |
All critical/major issues fixed before release |
Issue severity tracking |
| Journey map freshness |
Updated at least quarterly |
Last-updated date on each journey map |
Scope & Limitations
In scope:
- Data-driven persona generation from user research
- Archetype classification (power, casual, business, mobile-first)
- User journey mapping frameworks
- Usability test planning and scoring
- Research synthesis and coding methodology
- Interview question frameworks
- Empathy map and opportunity identification
Out of scope:
- Automated user interview recording/transcription
- Real-time analytics integration (use analytics platforms)
- Quantitative survey design and distribution (use Typeform/SurveyMonkey)
- Eye tracking or biometric data analysis
- AI-powered sentiment analysis (tool uses heuristic classification)
- Persona illustration or visual asset generation
- Accessibility auditing (see product-designer or design-system-lead skills)
Integration Points
| Tool / Platform |
Integration Method |
Use Case |
| Dovetail / Condens |
Export research data, import persona JSON |
Centralize research insights |
| Figma / Miro |
Paste persona output as design artifact |
Reference personas during design work |
| Notion / Confluence |
Human-readable output |
Document and share personas with team |
| product-manager-toolkit |
Persona pain points inform RICE scoring |
Connect user needs to feature prioritization |
| agile-product-owner |
Persona data informs user story personas |
Write stories grounded in research |
| product-designer |
Persona feeds into journey mapping and usability test recruitment |
End-to-end design research workflow |
1---2name: ux-researcher-designer3description: UX research and design toolkit covering persona generation, journey mapping, usability testing, and research synthesis. Use for user research, persona creation, journey mapping, or design validation.4license: MIT + Commons Clause5---6# UX Researcher & Designer
7
8Generate user personas from research data, create journey maps, plan usability tests, and synthesize research findings into actionable design recommendations.
9
10---
11
12## Table of Contents
13
14- [Trigger Terms](#trigger-terms)
15- [Workflows](#workflows)
16 - [Workflow 1: Generate User Persona](#workflow-1-generate-user-persona)
17 - [Workflow 2: Create Journey Map](#workflow-2-create-journey-map)
18 - [Workflow 3: Plan Usability Test](#workflow-3-plan-usability-test)
19 - [Workflow 4: Synthesize Research](#workflow-4-synthesize-research)
20- [Tool Reference](#tool-reference)
21- [Quick Reference Tables](#quick-reference-tables)
22- [Knowledge Base](#knowledge-base)
23
24---
25
26## Trigger Terms
27
28Use this skill when you need to:
29
30- "create user persona"
31- "generate persona from data"
32- "build customer journey map"
33- "map user journey"
34- "plan usability test"
35- "design usability study"
36- "analyze user research"
37- "synthesize interview findings"
38- "identify user pain points"
39- "define user archetypes"
40- "calculate research sample size"
41- "create empathy map"
42- "identify user needs"
43
44---
45
46## Clarify First
47
48Before generating the research artifact, confirm these inputs. If any is unknown or vague, ASK — do not assume:
49
50- [ ] **Which deliverable** — persona, journey map, usability test plan, or research synthesis (sets which workflow and template applies)
51- [ ] **Available data and volume** — analytics/interviews/surveys and how many users (drives persona confidence and proto- vs data-driven persona)
52- [ ] **The user goal and scope** — the persona, the goal being mapped, and start/end (drives journey-map stages and research questions)
53
54Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
55
56## Workflows
57
58### Workflow 1: Generate User Persona
59
60**Situation:** You have user data (analytics, surveys, interviews) and need to create a research-backed persona.
61
62**Steps:**
63
641. **Prepare user data**
65
66 Required format (JSON):
67 ```json
68 [
69 {
70 "user_id": "user_1",
71 "age": 32,
72 "usage_frequency": "daily",
73 "features_used": ["dashboard", "reports", "export"],
74 "primary_device": "desktop",
75 "usage_context": "work",
76 "tech_proficiency": 7,
77 "pain_points": ["slow loading", "confusing UI"]
78 }
79 ]
80 ```
81
822. **Run persona generator**
83 ```bash
84 # Human-readable output
85 python scripts/persona_generator.py
86
87 # JSON output for integration
88 python scripts/persona_generator.py json
89 ```
90
913. **Review generated components**
92
93 | Component | What to Check |
94 |-----------|---------------|
95 | Archetype | Does it match the data patterns? |
96 | Demographics | Are they derived from actual data? |
97 | Goals | Are they specific and actionable? |
98 | Frustrations | Do they include frequency counts? |
99 | Design implications | Can designers act on these? |
100
1014. **Validate persona**
102
103 - Show to 3-5 real users: "Does this sound like you?"
104 - Cross-check with support tickets
105 - Verify against analytics data
106
1075. **Reference:** See `references/persona-methodology.md` for validity criteria
108
109### Proto-Persona Canvas (Lightweight Alternative)
110
111When you lack research data but need a hypothesis-driven persona to align the team, use a proto-persona canvas. Proto-personas are assumption tools -- not validated truth -- meant to be tested and refined.
112
113**Use when:** Starting a new initiative with no research budget, aligning a cross-functional team quickly, or creating a testable hypothesis about your user.
114
115**Proto-Persona Canvas Template:**
116
117```markdown
118### [Alliterative Name] (e.g., "Careful Carlos")
119
120**Bio & Demographics:**
121- Age, geography, social status, career stage
122- Online presence, leisure activities, partner status
123
124**Quotes** (what they say, feel, think):
125- "[Direct quote capturing their perspective]"
126- "[Quote revealing frustration or aspiration]"
127
128**Pains:**
129- [Pain related to the problem space]
130- [Pain related to current workarounds]
131
132**What They're Trying to Accomplish:**
133- [Observable behavior 1]
134- [Observable behavior 2]
135
136**Goals** (wants, needs, dreams):
137- [Short-term goal]
138- [Long-term aspiration]
139
140**Attitudes & Influences:**
141- Decision Making Authority: [Can they buy/adopt your solution?]
142- Decision Influencers: [Who influences their decisions?]
143- Beliefs & Attitudes: [What beliefs impact their choices?]
144
145**Assumptions to Validate:**
146- [Top assumption that must be true for this persona to be viable]
147- [Second assumption]
148- [Third assumption]
149```
150
151**Next steps after proto-persona:**
1521. Generate interview questions to validate assumptions (Recommended)
1532. Generate an anti-persona to define scope boundaries
1543. Convert into a one-page stakeholder brief
155
156---
157
158### Workflow 2: Create Journey Map
159
160**Situation:** You need to visualize the end-to-end user experience for a specific goal.
161
162**Steps:**
163
1641. **Define scope**
165
166 | Element | Description |
167 |---------|-------------|
168 | Persona | Which user type |
169 | Goal | What they're trying to achieve |
170 | Start | Trigger that begins journey |
171 | End | Success criteria |
172 | Timeframe | Hours/days/weeks |
173
1742. **Gather journey data**
175
176 Sources:
177 - User interviews (ask "walk me through...")
178 - Session recordings
179 - Analytics (funnel, drop-offs)
180 - Support tickets
181
1823. **Map the stages**
183
184 Typical B2B SaaS stages:
185 ```
186 Awareness → Evaluation → Onboarding → Adoption → Advocacy
187 ```
188
1894. **Fill in layers for each stage**
190
191 ```
192 Stage: [Name]
193 ├── Actions: What does user do?
194 ├── Touchpoints: Where do they interact?
195 ├── Emotions: How do they feel? (1-5)
196 ├── Pain Points: What frustrates them?
197 └── Opportunities: Where can we improve?
198 ```
199
2005. **Map three experience paths** (not just the happy path)
201
202 | Stage | Happy Path | Fail Path | Difficult Path |
203 |---|---|---|---|
204 | Awareness | Finds product via search | Never discovers product | Finds competitor first |
205 | Consideration | Clear value proposition | Confused by pricing | Needs manager approval |
206 | Decision | Easy signup flow | Form errors, abandons | Legal review delays |
207 | Delivery & Use | Smooth onboarding | Can't import data | Workaround needed |
208 | Loyalty | Becomes advocate | Churns silently | Stays but complains |
209
210 - **Happy Path:** Everything works as designed.
211 - **Fail Path:** User cannot complete their goal and drops off.
212 - **Difficult Path:** User completes the goal but with friction, workarounds, or frustration.
213
2146. **Add KPIs and ownership per stage**
215
216 | Stage | Leading KPI | Lagging KPI | Team Owner |
217 |---|---|---|---|
218 | Awareness | Site visits, ad impressions | Brand recall | Marketing |
219 | Consideration | Demo requests, pricing page views | MQL conversion | Marketing/Sales |
220 | Decision | Trial starts, contract sent | Close rate | Sales |
221 | Use | Feature adoption, DAU | Retention rate | Product |
222 | Loyalty | NPS, referral count | LTV, expansion revenue | Customer Success |
223
2247. **Identify top friction points and interventions**
225
226 For each friction point, document:
227
228 | Friction Point | Why It Matters | Intervention | Expected Impact | Effort | Confidence |
229 |---|---|---|---|---|---|
230 | [Description] | [User/business impact] | [Proposed fix] | High/Med/Low | S/M/L | High/Med/Low |
231
232 Priority Score = Frequency x Severity x Solvability
233
2348. **Reference:** See `references/journey-mapping-guide.md` for templates
235
236---
237
238### Workflow 3: Plan Usability Test
239
240**Situation:** You need to validate a design with real users.
241
242**Steps:**
243
2441. **Define research questions**
245
246 Transform vague goals into testable questions:
247
248 | Vague | Testable |
249 |-------|----------|
250 | "Is it easy to use?" | "Can users complete checkout in <3 min?" |
251 | "Do users like it?" | "Will users choose Design A or B?" |
252 | "Does it make sense?" | "Can users find settings without hints?" |
253
2542. **Select method**
255
256 | Method | Participants | Duration | Best For |
257 |--------|--------------|----------|----------|
258 | Moderated remote | 5-8 | 45-60 min | Deep insights |
259 | Unmoderated remote | 10-20 | 15-20 min | Quick validation |
260 | Guerrilla | 3-5 | 5-10 min | Rapid feedback |
261
2623. **Design tasks**
263
264 Good task format:
265 ```
266 SCENARIO: "Imagine you're planning a trip to Paris..."
267 GOAL: "Book a hotel for 3 nights in your budget."
268 SUCCESS: "You see the confirmation page."
269 ```
270
271 Task progression: Warm-up → Core → Secondary → Edge case → Free exploration
272
2734. **Define success metrics**
274
275 | Metric | Target |
276 |--------|--------|
277 | Completion rate | >80% |
278 | Time on task | <2× expected |
279 | Error rate | <15% |
280 | Satisfaction | >4/5 |
281
2825. **Prepare moderator guide**
283
284 - Think-aloud instructions
285 - Non-leading prompts
286 - Post-task questions
287
2886. **Reference:** See `references/usability-testing-frameworks.md` for full guide
289
290---
291
292### Workflow 4: Synthesize Research
293
294**Situation:** You have raw research data (interviews, surveys, observations) and need actionable insights.
295
296**Steps:**
297
2981. **Code the data**
299
300 Tag each data point:
301 - `[GOAL]` - What they want to achieve
302 - `[PAIN]` - What frustrates them
303 - `[BEHAVIOR]` - What they actually do
304 - `[CONTEXT]` - When/where they use product
305 - `[QUOTE]` - Direct user words
306
3072. **Cluster similar patterns**
308
309 ```
310 User A: Uses daily, advanced features, shortcuts
311 User B: Uses daily, complex workflows, automation
312 User C: Uses weekly, basic needs, occasional
313
314 Cluster 1: A, B (Power Users)
315 Cluster 2: C (Casual User)
316 ```
317
3183. **Calculate segment sizes**
319
320 | Cluster | Users | % | Viability |
321 |---------|-------|---|-----------|
322 | Power Users | 18 | 36% | Primary persona |
323 | Business Users | 15 | 30% | Primary persona |
324 | Casual Users | 12 | 24% | Secondary persona |
325
3264. **Extract key findings**
327
328 For each theme:
329 - Finding statement
330 - Supporting evidence (quotes, data)
331 - Frequency (X/Y participants)
332 - Business impact
333 - Recommendation
334
3355. **Prioritize opportunities**
336
337 | Factor | Score 1-5 |
338 |--------|-----------|
339 | Frequency | How often does this occur? |
340 | Severity | How much does it hurt? |
341 | Breadth | How many users affected? |
342 | Solvability | Can we fix this? |
343
3446. **Reference:** See `references/persona-methodology.md` for analysis framework
345
346---
347
348## Tool Reference
349
350### persona_generator.py
351
352Generates data-driven personas from user research data.
353
354| Argument | Values | Default | Description |
355|----------|--------|---------|-------------|
356| format | (none), json | (none) | Output format |
357
358**Sample Output:**
359
360```
361============================================================
362PERSONA: Alex the Power User
363============================================================
364
365📝 A daily user who primarily uses the product for work purposes
366
367Archetype: Power User
368Quote: "I need tools that can keep up with my workflow"
369
370👤 Demographics:
371 • Age Range: 25-34
372 • Location Type: Urban
373 • Tech Proficiency: Advanced
374
375🎯 Goals & Needs:
376 • Complete tasks efficiently
377 • Automate workflows
378 • Access advanced features
379
380😤 Frustrations:
381 • Slow loading times (14/20 users)
382 • No keyboard shortcuts
383 • Limited API access
384
385💡 Design Implications:
386 → Optimize for speed and efficiency
387 → Provide keyboard shortcuts and power features
388 → Expose API and automation capabilities
389
390📈 Data: Based on 45 users
391 Confidence: High
392```
393
394**Archetypes Generated:**
395
396| Archetype | Signals | Design Focus |
397|-----------|---------|--------------|
398| power_user | Daily use, 10+ features | Efficiency, customization |
399| casual_user | Weekly use, 3-5 features | Simplicity, guidance |
400| business_user | Work context, team use | Collaboration, reporting |
401| mobile_first | Mobile primary | Touch, offline, speed |
402
403**Output Components:**
404
405| Component | Description |
406|-----------|-------------|
407| demographics | Age range, location, occupation, tech level |
408| psychographics | Motivations, values, attitudes, lifestyle |
409| behaviors | Usage patterns, feature preferences |
410| needs_and_goals | Primary, secondary, functional, emotional |
411| frustrations | Pain points with evidence |
412| scenarios | Contextual usage stories |
413| design_implications | Actionable recommendations |
414| data_points | Sample size, confidence level |
415
416---
417
418## Quick Reference Tables
419
420### Research Method Selection
421
422| Question Type | Best Method | Sample Size |
423|---------------|-------------|-------------|
424| "What do users do?" | Analytics, observation | 100+ events |
425| "Why do they do it?" | Interviews | 8-15 users |
426| "How well can they do it?" | Usability test | 5-8 users |
427| "What do they prefer?" | Survey, A/B test | 50+ users |
428| "What do they feel?" | Diary study, interviews | 10-15 users |
429
430### Persona Confidence Levels
431
432| Sample Size | Confidence | Use Case |
433|-------------|------------|----------|
434| 5-10 users | Low | Exploratory |
435| 11-30 users | Medium | Directional |
436| 31+ users | High | Production |
437
438### Usability Issue Severity
439
440| Severity | Definition | Action |
441|----------|------------|--------|
442| 4 - Critical | Prevents task completion | Fix immediately |
443| 3 - Major | Significant difficulty | Fix before release |
444| 2 - Minor | Causes hesitation | Fix when possible |
445| 1 - Cosmetic | Noticed but not problematic | Low priority |
446
447### Interview Question Types
448
449| Type | Example | Use For |
450|------|---------|---------|
451| Context | "Walk me through your typical day" | Understanding environment |
452| Behavior | "Show me how you do X" | Observing actual actions |
453| Goals | "What are you trying to achieve?" | Uncovering motivations |
454| Pain | "What's the hardest part?" | Identifying frustrations |
455| Reflection | "What would you change?" | Generating ideas |
456
457---
458
459## Knowledge Base
460
461Detailed reference guides in `references/`:
462
463| File | Content |
464|------|---------|
465| `persona-methodology.md` | Validity criteria, data collection, analysis framework |
466| `journey-mapping-guide.md` | Mapping process, templates, opportunity identification |
467| `example-personas.md` | 3 complete persona examples with data |
468| `usability-testing-frameworks.md` | Test planning, task design, analysis |
469
470---
471
472## Validation Checklist
473
474### Persona Quality
475- [ ] Based on 20+ users (minimum)
476- [ ] At least 2 data sources (quant + qual)
477- [ ] Specific, actionable goals
478- [ ] Frustrations include frequency counts
479- [ ] Design implications are specific
480- [ ] Confidence level stated
481
482### Journey Map Quality
483- [ ] Scope clearly defined (persona, goal, timeframe)
484- [ ] Based on real user data, not assumptions
485- [ ] All layers filled (actions, touchpoints, emotions)
486- [ ] Pain points identified per stage
487- [ ] Opportunities prioritized
488
489### Usability Test Quality
490- [ ] Research questions are testable
491- [ ] Tasks are realistic scenarios, not instructions
492- [ ] 5+ participants per design
493- [ ] Success metrics defined
494- [ ] Findings include severity ratings
495
496### Research Synthesis Quality
497- [ ] Data coded consistently
498- [ ] Patterns based on 3+ data points
499- [ ] Findings include evidence
500- [ ] Recommendations are actionable
501- [ ] Priorities justified
502
503---
504
505## Tool Reference
506
507### persona_generator.py
508
509Generates data-driven personas from user research data, classifying users into archetypes with demographics, psychographics, behaviors, goals, frustrations, and design implications.
510
511| Argument | Type | Default | Description |
512|----------|------|---------|-------------|
513| `format` | positional | (none) | Add `json` for JSON output; omit for human-readable |
514
515**Archetypes supported:** power_user, casual_user, business_user, mobile_first
516
517**Output components:** name, archetype, tagline, quote, demographics, psychographics, behaviors, needs_and_goals, frustrations, scenarios, data_points, design_implications
518
519```bash
520python scripts/persona_generator.py # Human-readable formatted output
521python scripts/persona_generator.py json # JSON for programmatic use
522```
523
524**Data input format (customize in script):**
525```json
526[{
527 "user_id": "user_1",
528 "age": 32,
529 "usage_frequency": "daily",
530 "features_used": ["dashboard", "reports", "export"],
531 "primary_device": "desktop",
532 "usage_context": "work",
533 "tech_proficiency": 7,
534 "pain_points": ["slow loading", "confusing UI"]
535}]
536```
537
538---
539
540## Troubleshooting
541
542| Problem | Cause | Solution |
543|---------|-------|----------|
544| Persona confidence level is "Low" | Fewer than 20 users in sample data | Collect more data points; combine quantitative analytics with qualitative interviews |
545| All users classified as same archetype | Insufficient variation in input data | Ensure data includes diverse usage frequencies, devices, and contexts |
546| Frustrations are generic (fallback defaults) | Not enough pain_points in user data | Enrich user data with pain_points from interviews and support tickets |
547| Design implications too vague | Patterns don't strongly differentiate | Add more behavioral signals (features_used, session duration, task completion) |
548| Journey map has flat emotion curve | All stages scored similarly | Re-evaluate with actual user data; conduct contextual interviews per stage |
549| Usability test sample too small | Fewer than 5 participants | 5 participants find ~85% of usability issues; recruit to minimum 5 |
550| Research synthesis has no clear patterns | Data not coded consistently | Use consistent tagging scheme (GOAL, PAIN, BEHAVIOR, CONTEXT, QUOTE) |
551
552---
553
554## Success Criteria
555
556| Criterion | Target | How to Measure |
557|-----------|--------|----------------|
558| Persona validity | Validated by 3+ real users ("sounds like me") | Post-creation validation interviews |
559| Persona coverage | All key segments represented | Count of personas vs identified user segments |
560| Data confidence level | "High" (31+ users) | persona_generator data_points.confidence_level |
561| Research cadence | 5-8 interviews per segment per quarter | Count of completed research sessions |
562| Insight-to-action rate | >70% of findings result in design changes | Track findings through to implementation |
563| Usability issue resolution | All critical/major issues fixed before release | Issue severity tracking |
564| Journey map freshness | Updated at least quarterly | Last-updated date on each journey map |
565
566---
567
568## Scope & Limitations
569
570**In scope:**
571- Data-driven persona generation from user research
572- Archetype classification (power, casual, business, mobile-first)
573- User journey mapping frameworks
574- Usability test planning and scoring
575- Research synthesis and coding methodology
576- Interview question frameworks
577- Empathy map and opportunity identification
578
579**Out of scope:**
580- Automated user interview recording/transcription
581- Real-time analytics integration (use analytics platforms)
582- Quantitative survey design and distribution (use Typeform/SurveyMonkey)
583- Eye tracking or biometric data analysis
584- AI-powered sentiment analysis (tool uses heuristic classification)
585- Persona illustration or visual asset generation
586- Accessibility auditing (see product-designer or design-system-lead skills)
587
588---
589
590## Integration Points
591
592| Tool / Platform | Integration Method | Use Case |
593|-----------------|-------------------|----------|
594| Dovetail / Condens | Export research data, import persona JSON | Centralize research insights |
595| Figma / Miro | Paste persona output as design artifact | Reference personas during design work |
596| Notion / Confluence | Human-readable output | Document and share personas with team |
597| product-manager-toolkit | Persona pain points inform RICE scoring | Connect user needs to feature prioritization |
598| agile-product-owner | Persona data informs user story personas | Write stories grounded in research |
599| product-designer | Persona feeds into journey mapping and usability test recruitment | End-to-end design research workflow |