githubEdit

file-lines10. UAT

UAT

Outcome: Client empowered to stress-test workflow; issues surfaced before go-live Trigger: Internal testing passed (≥90%) Duration: 90 min setup + 3-5 days client testing

Quick Reference

Step
Action
Time

0

Send pre-frame email

5 min

1

Swap credentials (DEV → CLIENT)

15 min

2

Smoke test with client credentials

15 min

3

Record demo video

20 min

4

Send handoff email

15 min

5

Client testing period

3-5 days

6

UAT Review Call

45 min

Key skills: /swap:credentials, /send:uat-preframe, /send:uat-handoff


Full Guide

Part 0: Pre-Frame Email (5 min)

Send this email 1-2 days before UAT handoff to set expectations.

/send:uat-preframe {CODE} --workflow "{Name}"

Why this matters: Clients often treat UAT as a formality — they watch the demo, say "looks good", then panic when something breaks in production. This email reframes UAT as active stress-testing.

Part 1: Credential Swap (15 min)

Manual verification:

  1. Open workflow in n8n

  2. Click each integration node

  3. Verify credential dropdown shows {CODE}-* not DEV-*

  4. Update Variables node: environment: "production"

  5. Update tags: status-developmentstatus-uat

Part 2: Smoke Test (15 min)

  1. Run workflow with test data

  2. Verify executes successfully with client credentials

  3. Check output reaches client systems (CRM, email, etc.)

If test fails:

Part 3: Demo Recording (20 min)

Tool: Loom desktop app (not Chrome extension)

Get checklist:

Demo structure (2-5 min):

Section
Time
Content

Intro

15s

"Hi {Name}, I'm showing you the {Workflow}..."

Overview

30s

Show workflow canvas, explain flow

Trigger

30s

What starts the workflow

Execution

1-2 min

Run it, show data flowing

Output

30s

Final result in client system

Close

15s

"Your job now is to stress-test this..."

Video title: {Client} - {Workflow} Demo

Part 4: Handoff Email (15 min)

Email includes:

  • Loom video link

  • Testing mission ("try to break it")

  • What to test checklist

  • How to report issues

  • UAT Review Call details

Part 5: Client Testing Period (3-5 days)

Give the client time to actually test. Don't rush this phase.

During this period:

  • Be available for questions

  • Send /send:uat-feedback-request if no response after 2 days

  • Document any issues they report

Part 6: UAT Review Call (45 min)

This is NOT a demo call — it's a review of the client's testing findings.


What to Test (Client Guidance)

Give the client this checklist (included in handoff email, can also share separately):

Test Type
What to Try
Example

Happy path

Normal use case

Standard invoice with all fields filled

Edge cases

Unusual but valid scenarios

Very long product names, special characters

Volume

Multiple items at once

Batch of 10 invoices instead of 1

Missing data

Empty or null fields

Invoice without a PO number

Bad data

Incorrect formats

Date in wrong format, invalid email

Timing

When things happen

What if trigger fires twice quickly?

Permissions

Access issues

What if someone doesn't have access to the output location?

Encourage them: The best testers are the people who use the process daily. They know the weird scenarios we can't anticipate.


UAT Review Call (45 min)

Section
Time
Focus

Their Findings

15 min

What they tested, what broke

Live Troubleshooting

10 min

Reproduce issues together

Fixes & Changes

10 min

What we'll adjust

Go/No-Go

5 min

Ready for sign-off, or another round?

Next Steps

5 min

Timeline to go-live

Key shift: The client should be presenting THEIR findings, not passively watching us demo.


If Client Reports No Issues

Why this matters: "No issues" sometimes means "I watched the demo and didn't actually test." Probe gently to ensure real testing happened.


Email Templates

uat-preframe

When to send: 1-2 days before UAT handoff Command: /send:uat-preframe {CODE} --workflow "{Name}"


uat-handoff

When to send: After demo video recorded, before UAT Review Call Command: /send:uat-handoff {CODE} --workflow "{Name}" --loom-url "{URL}"


uat-feedback-request

When to send: 2 days after handoff email if no feedback received Command: /send:uat-feedback-request {CODE} --workflow "{Name}"


Verify

Next: Sign-Off & Go-Live

Last updated