BLOG
BlogGuides

A handoff record that proves the site worked at launch

Scope arguments after launch start with “it never worked”. Run the key journeys at handoff and keep the results, with replays, as the record both sides can open.

The argument after launch#

Three weeks after handoff, the client writes: the booking form has never worked. Maybe it never did. Maybe their new marketing plugin broke it last week. Without a record, it is your memory against theirs, and the conversation turns into who pays for the fix.

Launch checklists address part of this. One recommends getting written sign-off from the client decision-maker before go-live, because verbal confirmation does not prevent post-launch disputes. A sign-off says the client agreed. It does not say what worked.

Run the key journeys at handoff#

Before you hand over, run a test for each journey in the scope of work:

Open https://client.example/book. Book the first free slot next
Tuesday for "Initial consultation" as "QA Handoff", with this run's
email address. Check the confirmation page names the slot, and the
confirmation email arrives.
Open https://client.example/contact. Send a message from "QA Handoff"
with this run's email address. Check the page confirms it and the
confirmation email arrives.

Each result records the date and time, the address tested, each check with the value it was decided on, a replay of every step and a video.

A passed run: every check with the value it was decided on, the replay and the video.
A passed run: every check with the value it was decided on, the replay and the video.

Put it in the handoff email#

Create a share link for each passed run (the longest is 90 days) and list them in the handoff email or the sign-off document: "Booking form: passed on 21 November at 14:05, [result]". The client can open them without an account.

For your own files, the run stays in your workspace, with its files kept for 365 days.

When the client reports a problem later#

Run the same test again. If it fails now and passed at handoff, the record shows when it worked and what is different now, and the replay of the new failure shows where. That is a conversation about what changed, not about whether it ever worked.

Keep it fair#

The record cuts both ways. If the handoff run failed and you shipped anyway, it shows that too. Run the tests before you write the handoff email, not after.

This post is part of Find the bug before your client does.

Filed underWebClient sitesSharing and alerts