QC UAT Facilitation
When to Use
- Preparing business users for UAT before a release
- Translating technical test cases into business-language scenarios
- Coordinating a UAT cycle with multiple business stakeholders
- Collecting and managing UAT defects to release decision
- Obtaining formal UAT sign-off documentation
Core Jobs
1. UAT Planning
## UAT Plan — v2.0 Release
### Scope
Business processes covered:
✅ Customer onboarding (primary)
✅ Order placement and payment
✅ Reporting and exports
❌ Admin user management (internal only, separate UAT)
### Participants
| Role | Person | Responsibility |
|------|--------|---------------|
| UAT Coordinator | QC Lead | Plan, coordinate, report |
| Business Lead | [Name] | Final sign-off authority |
| End User Rep | [Name x3] | Execute test scenarios |
| SME | [Name] | Clarify business rules |
| Dev Support | [Name] | Fix critical UAT blockers same-day |
### Schedule
Week 1 (Apr 14-16): UAT preparation — scenarios, test data, environment
Week 2 (Apr 17-21): UAT execution — testers run scenarios, log defects
Week 3 (Apr 22-23): Defect resolution + re-test
Apr 24: UAT sign-off meeting
### Environment
URL: https://uat.myapp.com
Credentials: shared separately via secure channel
Test data: see section 4 (pre-loaded in UAT environment)
### Entry Criteria (must be met before UAT starts)
✅ All P1/P2 defects from QC resolved
✅ UAT environment stable (no planned maintenance during UAT period)
✅ Test data loaded and verified
✅ UAT participants confirmed and briefed
### Exit Criteria (must be met for sign-off)
✅ All critical scenarios executed
✅ No open P1 defects
✅ P2 defects reviewed and accepted/deferred by business lead
✅ Business lead signs off
2. Business Scenario Test Case Design
UAT test cases = business scenarios, not technical steps
QC mindset (technical):
"POST /api/orders with payload {product_id: 123, quantity: 2}"
UAT mindset (business):
"Customer places order for 2 units of Blue Widget"
Example UAT scenario:
---
Scenario: New customer completes first purchase
Business context: Sarah is a new customer who found the product on Google.
She has no account yet.
Steps:
1. Go to [product page URL]
2. Click "Add to Cart"
3. Click "Checkout"
4. Create new account with your test email [provided]
5. Enter shipping address: [provided test address]
6. Select "Standard Shipping"
7. Enter payment: [provided test card number]
8. Click "Place Order"
Expected outcomes (check all):
□ Order confirmation page shows correct items and total
□ Confirmation email received within 5 minutes
□ Order appears in "My Orders" when you log back in
□ Inventory count decreased on product page
Notes: Use only the provided test card. Do not use real payment information.
---
3. UAT Defect Management
## UAT Defect Triage Process
UAT defects are business-reported — triage with both business and QC:
Priority for UAT defects:
P1 (UAT Blocker): Cannot proceed with UAT, must fix before UAT continues
P2 (UAT High): Critical business process broken, fix before sign-off
P3 (UAT Medium): Process works with workaround, fix before go-live
P4 (UAT Low): Minor UI/cosmetic, document for next release
Won't Fix: Business acknowledges and accepts (document in sign-off)
UAT defect log template:
| ID | Scenario | Step | Expected | Actual | Severity | Status | Notes |
|----|---------|------|---------|--------|---------|--------|-------|
| U001 | New purchase | Step 7 | Order confirmed | Payment error | P1 | Open | |
| U002 | Order history | Step 3 | Shows all orders | Missing 2 orders | P2 | Open | |
Daily UAT status report (send to all stakeholders):
- Scenarios completed today: X/Y
- Defects found: N (P1: n, P2: n, P3: n)
- Defects resolved: N
- Blockers: [list or "none"]
- Tomorrow's plan: [scenarios scheduled]
- Risk: [any risks to UAT timeline]
4. UAT Environment and Test Data Setup
# UAT environment setup checklist
□ Environment URL confirmed and accessible to all UAT testers
□ Test accounts created for each tester (named accounts, not shared)
□ Test data representing real business scenarios loaded:
- Sample customers (new, existing, VIP)
- Sample products (in stock, out of stock, on sale)
- Sample orders (pending, completed, cancelled)
- Historical data for reporting tests
□ Email testing configured (Mailhog or similar — capture UAT emails)
□ Payment gateway in test mode (Stripe test cards, not real)
□ Any integrations sandboxed (ERP, CRM, warehouse system)
□ Data reset procedure documented (if testers corrupt data)
□ Support channel established (Slack, Teams) for tester questions
5. UAT Sign-Off Process
## UAT Sign-Off Document
**System:** MyApp v2.0
**UAT Period:** April 17-24, 2026
**Sign-off Date:** April 24, 2026
### UAT Summary
| Metric | Result |
|--------|--------|
| Total scenarios | 45 |
| Scenarios passed | 43 (96%) |
| Scenarios failed | 2 (non-critical, documented) |
| P1 defects | 0 open |
| P2 defects | 1 open (deferred to v2.1 — workaround documented) |
| P3 defects | 3 open (accepted for post-go-live fix) |
### Known Issues at Go-Live
| ID | Description | Workaround | Next Fix |
|----|-------------|-----------|---------|
| U002 | Order history missing orders >90 days | Use export function | v2.1 |
### Decision
☐ GO — approved for production deployment
☐ NO-GO — do not deploy until issues resolved
**Business Lead Sign-off:** ___________________ Date: ______
**QC Lead Sign-off:** ___________________ Date: ______
**Project Manager:** ___________________ Date: ______
By signing, the business confirms:
1. Critical business processes have been tested and accepted
2. Known issues listed above are acceptable for go-live
3. Business is ready to support the production release
Key Concepts
- UAT — User Acceptance Testing: business stakeholders verify software meets business needs (different from QC testing technical correctness)
- Business scenario — test case written in business language describing a real workflow, not technical steps
- UAT Coordinator — typically QC lead who plans, organizes, tracks, and reports on UAT (does not execute test cases — business users do)
- Entry/Exit criteria — conditions that must be true for UAT to start/end
- Sign-off — formal written approval from business authority confirming acceptance
Checklist
Key Outputs
- UAT plan with schedule, participants, scope, entry/exit criteria
- Business scenario test cases (non-technical, written with business users)
- Daily UAT status reports
- UAT defect log with priority classifications
- Signed UAT sign-off document
Output Format
- 🔴 Critical — no formal UAT (business users test on production), deploying without UAT sign-off, using production data for UAT
- 🟡 Warning — UAT test cases written by QC only (not with business users), no UAT environment separate from QC testing, no formal sign-off document
- 🟢 Suggestion — involve business users in writing test scenarios (they know edge cases), record UAT sessions (with permission) for training, use UAT defects to improve QC test coverage
Anti-Patterns
- Technical test cases in UAT ("click button with id='submit'") — business users can't follow these
- QC team executing UAT scenarios on behalf of business (defeats the purpose)
- No entry criteria — starting UAT with unstable build (wastes business users' time)
- Treating UAT feedback as optional ("the business doesn't understand what they tested")
- No sign-off document (verbal agreement not auditable for compliance)
Integration
qc-defect-management — UAT defects follow same lifecycle, with business-priority classification
qa-risk-management — UAT exit criteria derived from risk register
qa-process-design — UAT is a phase in the SDLC quality process
1---2name: qc-uat-facilitation3description: Use when facilitating User Acceptance Testing — planning UAT sessions with business stakeholders, designing business-scenario test cases (not technical), coordinating UAT execution, managing UAT defects, and obtaining formal sign-off.4---56# QC UAT Facilitation78## When to Use9- Preparing business users for UAT before a release10- Translating technical test cases into business-language scenarios11- Coordinating a UAT cycle with multiple business stakeholders12- Collecting and managing UAT defects to release decision13- Obtaining formal UAT sign-off documentation1415## Core Jobs1617### 1. UAT Planning18```markdown19## UAT Plan — v2.0 Release2021### Scope22Business processes covered:23 ✅ Customer onboarding (primary)24 ✅ Order placement and payment25 ✅ Reporting and exports26 ❌ Admin user management (internal only, separate UAT)2728### Participants29| Role | Person | Responsibility |30|------|--------|---------------|31| UAT Coordinator | QC Lead | Plan, coordinate, report |32| Business Lead | [Name] | Final sign-off authority |33| End User Rep | [Name x3] | Execute test scenarios |34| SME | [Name] | Clarify business rules |35| Dev Support | [Name] | Fix critical UAT blockers same-day |3637### Schedule38Week 1 (Apr 14-16): UAT preparation — scenarios, test data, environment39Week 2 (Apr 17-21): UAT execution — testers run scenarios, log defects40Week 3 (Apr 22-23): Defect resolution + re-test41Apr 24: UAT sign-off meeting4243### Environment44URL: https://uat.myapp.com45Credentials: shared separately via secure channel46Test data: see section 4 (pre-loaded in UAT environment)4748### Entry Criteria (must be met before UAT starts)49 ✅ All P1/P2 defects from QC resolved50 ✅ UAT environment stable (no planned maintenance during UAT period)51 ✅ Test data loaded and verified52 ✅ UAT participants confirmed and briefed5354### Exit Criteria (must be met for sign-off)55 ✅ All critical scenarios executed56 ✅ No open P1 defects57 ✅ P2 defects reviewed and accepted/deferred by business lead58 ✅ Business lead signs off59```6061### 2. Business Scenario Test Case Design62```63UAT test cases = business scenarios, not technical steps6465QC mindset (technical):66 "POST /api/orders with payload {product_id: 123, quantity: 2}"6768UAT mindset (business):69 "Customer places order for 2 units of Blue Widget"7071Example UAT scenario:72---73Scenario: New customer completes first purchase7475Business context: Sarah is a new customer who found the product on Google.76She has no account yet.7778Steps:791. Go to [product page URL]802. Click "Add to Cart"813. Click "Checkout"824. Create new account with your test email [provided]835. Enter shipping address: [provided test address]846. Select "Standard Shipping"857. Enter payment: [provided test card number]868. Click "Place Order"8788Expected outcomes (check all):89□ Order confirmation page shows correct items and total90□ Confirmation email received within 5 minutes91□ Order appears in "My Orders" when you log back in92□ Inventory count decreased on product page9394Notes: Use only the provided test card. Do not use real payment information.95---96```9798### 3. UAT Defect Management99```markdown100## UAT Defect Triage Process101102UAT defects are business-reported — triage with both business and QC:103104Priority for UAT defects:105 P1 (UAT Blocker): Cannot proceed with UAT, must fix before UAT continues106 P2 (UAT High): Critical business process broken, fix before sign-off107 P3 (UAT Medium): Process works with workaround, fix before go-live108 P4 (UAT Low): Minor UI/cosmetic, document for next release109 Won't Fix: Business acknowledges and accepts (document in sign-off)110111UAT defect log template:112| ID | Scenario | Step | Expected | Actual | Severity | Status | Notes |113|----|---------|------|---------|--------|---------|--------|-------|114| U001 | New purchase | Step 7 | Order confirmed | Payment error | P1 | Open | |115| U002 | Order history | Step 3 | Shows all orders | Missing 2 orders | P2 | Open | |116117Daily UAT status report (send to all stakeholders):118 - Scenarios completed today: X/Y119 - Defects found: N (P1: n, P2: n, P3: n)120 - Defects resolved: N121 - Blockers: [list or "none"]122 - Tomorrow's plan: [scenarios scheduled]123 - Risk: [any risks to UAT timeline]124```125126### 4. UAT Environment and Test Data Setup127```bash128# UAT environment setup checklist129□ Environment URL confirmed and accessible to all UAT testers130□ Test accounts created for each tester (named accounts, not shared)131□ Test data representing real business scenarios loaded:132 - Sample customers (new, existing, VIP)133 - Sample products (in stock, out of stock, on sale)134 - Sample orders (pending, completed, cancelled)135 - Historical data for reporting tests136□ Email testing configured (Mailhog or similar — capture UAT emails)137□ Payment gateway in test mode (Stripe test cards, not real)138□ Any integrations sandboxed (ERP, CRM, warehouse system)139□ Data reset procedure documented (if testers corrupt data)140□ Support channel established (Slack, Teams) for tester questions141```142143### 5. UAT Sign-Off Process144```markdown145## UAT Sign-Off Document146147**System:** MyApp v2.0148**UAT Period:** April 17-24, 2026149**Sign-off Date:** April 24, 2026150151### UAT Summary152| Metric | Result |153|--------|--------|154| Total scenarios | 45 |155| Scenarios passed | 43 (96%) |156| Scenarios failed | 2 (non-critical, documented) |157| P1 defects | 0 open |158| P2 defects | 1 open (deferred to v2.1 — workaround documented) |159| P3 defects | 3 open (accepted for post-go-live fix) |160161### Known Issues at Go-Live162| ID | Description | Workaround | Next Fix |163|----|-------------|-----------|---------|164| U002 | Order history missing orders >90 days | Use export function | v2.1 |165166### Decision167☐ GO — approved for production deployment168☐ NO-GO — do not deploy until issues resolved169170**Business Lead Sign-off:** ___________________ Date: ______171**QC Lead Sign-off:** ___________________ Date: ______172**Project Manager:** ___________________ Date: ______173174By signing, the business confirms:1751. Critical business processes have been tested and accepted1762. Known issues listed above are acceptable for go-live1773. Business is ready to support the production release178```179180## Key Concepts181- **UAT** — User Acceptance Testing: business stakeholders verify software meets business needs (different from QC testing technical correctness)182- **Business scenario** — test case written in business language describing a real workflow, not technical steps183- **UAT Coordinator** — typically QC lead who plans, organizes, tracks, and reports on UAT (does not execute test cases — business users do)184- **Entry/Exit criteria** — conditions that must be true for UAT to start/end185- **Sign-off** — formal written approval from business authority confirming acceptance186187## Checklist188- [ ] UAT plan created with scope, schedule, participants, entry/exit criteria?189- [ ] Test scenarios written in business language (not technical)?190- [ ] UAT environment separate from dev/staging (business users should not see dev noise)?191- [ ] Test data representative of real business scenarios?192- [ ] Daily status reports sent to stakeholders?193- [ ] UAT sign-off document obtained before production deployment?194195## Key Outputs196- UAT plan with schedule, participants, scope, entry/exit criteria197- Business scenario test cases (non-technical, written with business users)198- Daily UAT status reports199- UAT defect log with priority classifications200- Signed UAT sign-off document201202## Output Format203- 🔴 **Critical** — no formal UAT (business users test on production), deploying without UAT sign-off, using production data for UAT204- 🟡 **Warning** — UAT test cases written by QC only (not with business users), no UAT environment separate from QC testing, no formal sign-off document205- 🟢 **Suggestion** — involve business users in writing test scenarios (they know edge cases), record UAT sessions (with permission) for training, use UAT defects to improve QC test coverage206207## Anti-Patterns208- Technical test cases in UAT ("click button with id='submit'") — business users can't follow these209- QC team executing UAT scenarios on behalf of business (defeats the purpose)210- No entry criteria — starting UAT with unstable build (wastes business users' time)211- Treating UAT feedback as optional ("the business doesn't understand what they tested")212- No sign-off document (verbal agreement not auditable for compliance)213214## Integration215- `qc-defect-management` — UAT defects follow same lifecycle, with business-priority classification216- `qa-risk-management` — UAT exit criteria derived from risk register217- `qa-process-design` — UAT is a phase in the SDLC quality process