Skip to content
Waqas Khan Pitafi
Founder and CEO, DevBatch · Dallas

Starter kit

starter-kit/design/uat-script.md

One file from the portable method that ships with the book.

starter-kit / design / uat-script.md

# UAT Script (L4a — human gate)

The scripted walkthrough a real user runs at a build milestone. **This is not a render-check.**
Each step names the exact action and the exact expected result; a step "passes" only when the result
is observed. Record outcomes; file any miss as a finding in the QA report.

## Pre-conditions
- Environment: <!-- staging/prod-like, auth enforced --> · Data: <!-- fresh seed / real --> · Signed in as: <!-- role -->

## Journeys
1. **<journey name>**
   - Step: <!-- action --> → Expect: <!-- observable result -->
   - Step: … → Expect: …
2. **Fresh-reset check** — reset the database → every screen shows a clean, empty state.
3. **Cross-screen data flow** — enter data on one screen → verify it appears correctly on every
   dependent screen/report.

## Result
- [ ] All steps observed passing. Findings (if any): <!-- link QA report -->
Prefer the whole thing at once? Download the starter kit as a zip. The files here and the files in the zip are the same.