# Tutorial User Testing Checklist

Use this checklist when testing the tutorial system with new users.

## Pre-Test Setup

- [ ] aiterm installed and working (`ait doctor` passes)
- [ ] User has not used aiterm before (or limited experience)
- [ ] Fresh terminal session
- [ ] Note-taking ready for observations

## Getting Started Tutorial (7 steps, ~10 min)

### Test Questions

1. **Discoverability**
   - [ ] User can find how to start tutorials (`ait learn`)
   - [ ] Tutorial list is clear and understandable

2. **Step 1: What is aiterm?**
   - [ ] Introduction is clear
   - [ ] User understands the purpose

3. **Step 2: ait doctor**
   - [ ] Command is easy to run
   - [ ] Output is understandable
   - [ ] User knows if installation is correct

4. **Step 3: ait config show**
   - [ ] User understands configuration location
   - [ ] Output is not overwhelming

5. **Step 4: ait detect**
   - [ ] Detection makes sense
   - [ ] User understands context types

6. **Step 5: ait switch**
   - [ ] Terminal visually changes
   - [ ] User notices the difference

7. **Step 6: ait --help**
   - [ ] Help is comprehensive but not overwhelming
   - [ ] User can find commands they need

8. **Step 7: Next Steps**
   - [ ] User knows what to do next
   - [ ] Path to intermediate is clear

### Observations

- Time to complete: ___ minutes
- Confusion points: ___
- Feature requests: ___
- Bugs found: ___

## Intermediate Tutorial (11 steps, ~20 min)

### Key Checkpoints

- [ ] Claude Code settings are accessible
- [ ] Backup command works
- [ ] Approval presets are understandable
- [ ] Workflow list is helpful
- [ ] Session management makes sense

### Observations

- Time to complete: ___ minutes
- Most confusing step: ___
- Most helpful step: ___

## Advanced Tutorial (13 steps, ~35 min)

### Key Checkpoints

- [ ] Release workflow is clear
- [ ] Custom workflows are achievable
- [ ] Craft integration is discoverable
- [ ] MCP and IDE sections are useful

### Observations

- Time to complete: ___ minutes
- Power user features discovered: ___
- Missing topics: ___

## Post-Test Questions

1. How would you rate the tutorial experience? (1-5)
2. What was most helpful?
3. What was most confusing?
4. Would you recommend these tutorials to a colleague?
5. What's missing that you'd like to see?

## Success Criteria

| Metric | Target | Actual |
|--------|--------|--------|
| Getting Started completion | 90%+ | ___ |
| Intermediate completion | 70%+ | ___ |
| Advanced completion | 50%+ | ___ |
| Time within estimate | ±20% | ___ |
| User satisfaction | 4+/5 | ___ |

## Notes

```
[Add notes from testing session here]
```
