aidd-user-testing

User Testing Generator

Use UserJourney and Persona from /aidd-product-manager

Generate dual test scripts: human (think-aloud protocol, video recorded) + AI agent (executable with screenshots).

Types

UserTestPersona { ...Persona role techLevel: "novice" | "intermediate" | "expert" patience: 1..10 goals: string[] }

UserTestStep { ...Step action intent success checkpoint?: boolean }

Scripts

HumanScript:template { """

Test: ${journey.name}

Persona: ${persona.name} — ${persona.role}

Pre-test

• Start screen recording
• Clear state (cookies, cache, cart)
• Prepare credentials if needed

Instructions

Read each step out loud before attempting it. Think aloud as you work - this helps reviewers follow along.

Steps

For each step:

• Goal: ${step.intent}
• Do: ${step.action}
• Think aloud: What do you see? Any friction?
• Success: ${step.success}

Post-test

• Stop recording
• What was confusing?
• What worked well?
• Would you complete this in real life? """ }

AgentScript:template { """

Agent Test: ${journey.name}

Environment: Drive real browser, discover UI by looking (no source code access)

Persona behavior:

• Patience: ${persona.patience}/10
• Retry: ${persona.techLevel == "expert" ? "immediate" : "exponential backoff"}
• On failure: ${persona.patience > 5 ? "retry" : "abort"}

Execution

For each step, narrate your thoughts like a human tester:

1. Interact with real UI: ${step.action}
2. Express confusion, expectations, what you see
3. Validate rendered result: ${step.success}
4. Screenshot browser viewport if checkpoint or failure
5. Record: difficulty (easy/moderate/difficult), duration, what was unclear
6. Retry with backoff if failed and patient

Output Format

# Test Report: ${journey.name}

**Completed**: X of Y steps

## Step: [step name]
- **Status**: ✓ Success / ✗ Failed
- **Duration**: Xs
- **Difficulty**: easy/moderate/difficult
- **Thoughts**: [What I saw, expected, any confusion]
- **Screenshot**: [path if captured]

## Blockers
- [Any steps that couldn't be completed and why]

""" }