uatlisted
Install: claude install-skill brandtam/skills
# UAT
User acceptance testing in three phases: **collect**, **grill**, **PRD**.
## Phase 1: Collect
When the user starts a UAT round:
1. Determine the round number by checking for existing `local-docs/uat-round-*.md` files
2. Create `local-docs/uat-round-N.md` with a `# UAT Round N` heading
3. Ensure `local-docs/uat-screenshots/` exists
4. Tell the user you're ready and to start dropping observations
While collecting:
- The user drops observations one at a time — voice transcriptions, typed notes, screenshots, or images
- Add each as a `- [ ]` checkbox item to the UAT doc
- Keep descriptions concise but capture the full intent
- If a screenshot is provided, save a reference to its path next to the item
- Don't ask clarifying questions yet — just log and confirm. Say "Logged. Next." or similar
- Stay in collect mode until the user says they're done ("done", "that's it", "finished testing", etc.)
## Phase 2: Grill
When the user signals they're done collecting:
1. Read back the full UAT document
2. Walk through each item one at a time, asking targeted questions to resolve:
- What specifically should change?
- Are there sub-decisions (behavior, styling, scope)?
- What's the recommended approach?
3. Use AskUserQuestion for structured choices where appropriate
4. After each item is resolved, update the UAT doc with sub-bullets capturing the decisions
5. Present a summary table of all decisions when done
## Phase 3: PRD
After grilling is complete:
1. Write a PRD