Builds stakeholder-readable scripted manual test cases from a feature spec in four formats: a step-table (preconditions / steps / expected result / actual / pass-fail / notes) for spreadsheet review, a Gherkin Given/When/Then format for BDD-aware teams, a business-language UAT script with acceptance-criteria mapping and contractual sign-off (references/uat-format.md), and a one-line-per-item execution checklist for smoke / on-call / bug-bash / compliance sweeps (references/checklist-format.md). Each script is self-contained (no implicit team knowledge), single-scenario (one happy + N edge per script), and includes the data setup the tester needs without being a developer. Use when a feature can't be (or shouldn't be) fully automated and a human tester needs an executable script or checklist - UAT sign-off rounds, regression baselines, certification testing, deploy smoke checklists, exploratory follow-up scripts.
94
88%
Does it follow best practices?
Impact
95%
0.98xAverage score across 10 eval scenarios
High
Do not use without reviewing
qa/activation-steps.md is what we hand to whoever is covering eSIM activation
this sprint. Not one of its nine steps says what should happen. The tester taps
things and then decides for themselves whether the phone looks activated.
It also assumes things the tester has no way to know: which handset, which network state the phone should be in at each point, and "the usual test SIM", which meant something to the two engineers who built the feature and nothing to anyone since. A contractor last month burned four activation codes working out that the download and the service check need opposite Wi-Fi settings.
When something did go wrong, the defect went into a Slack thread that has since rolled out of retention, so the fix was never reproduced and the case has been passing ever since without anybody being sure the original problem is gone.
We need a case a tester can pick up cold, and a run that leaves a record.
Produce one markdown document at exactly qa/TC-esim-activation.md containing:
Out of scope: automating the case, physical SIM activation, and anything to do with billing.
Extract the following files before beginning.
=============== FILE: qa/activation-steps.md ===============
=============== FILE: qa/device-lab.md ===============
Lab location: 3rd floor cabinet, key with the office manager. App under test: Kestrel Mobile, build 7.4.0 (shown in Settings > About).
| Device | OS | Carrier app | Usable for eSIM |
|---|---|---|---|
| iPhone 14 | iOS 18.4 | 7.4.0 | yes |
| Pixel 8 | Android 15 | 7.4.0 | yes |
| Galaxy S23 | Android 14 | 5.9.2 | no - eSIM download |
| needs carrier app 6.2+ |
Twelve QR activation codes were issued for this quarter. Each one can be downloaded onto a device exactly once; once used it is dead, and deleting the profile from the handset does not release it.
The consumed/unconsumed state is tracked in qa/esim-code-tracker.md. Codes
ESIM-Q3-01 through ESIM-Q3-05 are marked consumed. ESIM-Q3-06 through
ESIM-Q3-12 are unconsumed. The tracker is only correct if the tester marks
the code they used.
The profile download goes over IP, so the handset needs Wi-Fi on for that part. Verifying that the new plan actually carries service requires Wi-Fi off, otherwise calls and data ride the office network and the check proves nothing.
Lab Wi-Fi: kestrel-lab, password on the cabinet door.