afrexai-ux-research-engine

# UX Research Engine ⚡

Complete UX research methodology — from discovery to validated design decisions. No scripts, no APIs, no dependencies. Pure agent skill.

---

## Phase 1: Research Planning

### Research Brief YAML

```yaml
project: "[Product/Feature Name]"
research_question: "[What do we need to learn?]"
business_context:
  objective: "[Business goal this research supports]"
  decision: "[What decision will this research inform?]"
  stakeholders: ["PM", "Design Lead", "Engineering"]
  deadline: "YYYY-MM-DD"
scope:
  product_area: "[Feature/flow being studied]"
  user_segment: "[Who are we studying?]"
  geographic: "[Regions/markets]"
methodology: "[See selection matrix below]"
sample_size: "[See calculator below]"
timeline:
  planning: "Week 1"
  recruiting: "Week 1-2"
  fieldwork: "Week 2-3"
  analysis: "Week 3-4"
  reporting: "Week 4"
budget:
  participant_incentives: "$X"
  tools: "$X"
  total: "$X"
success_criteria:
  - "[Specific insight we need]"
  - "[Confidence level required]"
  - "[Actionable output format]"
```

### Method Selection Matrix

| Method | Best For | Sample Size | Time | Cost | Confidence |
|--------|----------|-------------|------|------|------------|
| User Interviews | Deep "why" understanding, exploring unknowns | 5-15 | 2-4 weeks | $$ | High (qualitative) |
| Usability Testing | Finding interaction problems, validating flows | 5-8 per round | 1-2 weeks | $$ | High (behavioral) |
| Surveys | Quantifying attitudes, measuring satisfaction | 100-400+ | 1-2 weeks | $ | High (statistical) |
| Card Sorting | Information architecture, navigation labels | 15-30 (open), 30+ (closed) | 1 week | $ | Medium |
| Diary Studies | Long-term behavior, context of use | 10-15 | 2-6 weeks | $$$ | High (longitudinal) |
| A/B Testing | Comparing specific design variants | 1000+ per variant | 1-4 weeks | $ | Very High |
| Contextual Inquiry | Understanding real environment, workflows | 4-8 | 2-3 weeks | $$$ | Very High |
| Tree Testing | Validating IA w...

# UX Research Engine ⚡

Complete UX research methodology — from discovery planning to validated design decisions. Zero dependencies. Pure agent skill.

## What This Does

Turns your AI agent into a senior UX researcher. Plan studies, recruit participants, run interviews, build data-driven personas, map user journeys, conduct usability tests, synthesize findings, and validate designs — all with proven frameworks and templates.

## Install

```bash
clawhub install afrexai-ux-research-engine
```

## Quick Start

```
"Plan a research study for our checkout flow"
"Build a screener for SaaS product managers"
"Create interview guide for onboarding experience"
"Build persona from these interview notes"
"Map the journey for [persona] signing up"
"Plan usability test for the new dashboard prototype"
"Run heuristic evaluation of our settings page"
"Synthesize findings from the discovery interviews"
```

## What's Inside

- **Research Planning** — Method selection matrix, sample size calculator, decision tree
- **Recruiting** — Screener templates, quality checklist, channel recommendations
- **User Interviews** — Complete guide template, note-taking YAML, 80/20 moderation rules
- **Persona Building** — Data-driven YAML template with goals/frustrations/behaviors/mental models
- **Journey Mapping** — Stage-by-stage template with emotion curves and service blueprint layer
- **Usability Testing** — Test plan template, task writing rules, severity scale, finding templates
- **Heuristic Evaluation** — Nielsen's 10 scorecard with grading system
- **Research Synthesis** — Affinity mapping process, theme templates, insight formula
- **Research Reports** — Executive summary template, prioritized recommendations
- **Design Validation** — CAMPS critique framework, prototype review checklist
- **Research Ops** — Repository structure, cross-study insight tracker, impact metrics

## ⚡ Level Up

Want industry-specific UX research frameworks? Our context packs include tailored user research g...