Production Release Runbook and Smoke Tests

Turn deployment into a repeatable sequence with go/no-go evidence.

Learning contract

What you must be able to do

Objectives

Explain Production Release Runbook and Smoke Tests using a concrete runtime/data-flow model.Implement the smallest working example and predict its behavior before execution.Diagnose a controlled failure related to Production Release Runbook and Smoke Tests using evidence rather than random edits.Transfer the concept into the TaskFlow project without copying the finished example.

Mental model

Understand the idea before syntax

Package, verify, release, deploy, smoke-test, and roll back TaskFlow with explicit evidence at every stage.

D10.7 — Evidence loop

predict

implement

run

observe

locate first mismatch

repair

re-run

When the result differs from your prediction, debugging starts at the first boundary where evidence diverges—not at the last visible symptom.

Before you code

Establish a healthy baseline

01
Open a scratch file or the relevant TaskFlow package.
02
Run the existing project/tests once so you know the baseline is healthy.
03
State what evidence will prove success before changing code.

Instructor code-along

Small change, immediate evidence

01
Write the goal in observable terms before coding: by the end of this lesson you should be able to demonstrate “Production Release Runbook and Smoke Tests” in a running TaskFlow-oriented example.
02
Read the example once without running it. Predict the exact output, state change, request, or compiler behavior and write that prediction down.
03
Type the example yourself rather than pasting it. Run the narrowest command that exercises only this concept, then compare observed evidence with your prediction.
04
Change one assumption at a time. Keep the change small enough that you can explain why the result changed.
05
Perform the intentional failure lab: Deploy an API version requiring a DB migration before running the migration and analyze compatibility failure.
06
Read the resulting compiler error, stack trace, HTTP response, browser evidence, database state, or CI log from the first line that is actually relevant to your code.
07
Repair only the root cause. Re-run the same verification so you can prove the repair changed the observed evidence.
08
Close the reference and rebuild the important part from memory. If you cannot explain why each boundary exists, revisit the smallest missing concept rather than memorizing the final code.

textWorking example

migrate → deploy API → health check → deploy web → smoke auth/tasks/upload → inspect telemetry

Expected evidence

A release is not done when deployment says “success”; user-critical behavior is verified.

Break it on purpose

Deploy an API version requiring a DB migration before running the migration and analyze compatibility failure.

Do not fix it immediately. Capture the compiler error, request/response, stack trace, database state, browser output, or CI log first. Debugging skill grows from comparing evidence with a prior prediction.

Investigation checklist

What did you predict?
What actually happened?
At what boundary do those first differ?
What is the smallest piece of evidence that proves the failure lives there?
Can you fix the cause without changing unrelated layers?
Can you add a regression test or repeatable verification?

Transfer challenge

Now work without the transcript

Apply Production Release Runbook and Smoke Tests to one new TaskFlow requirement. Do not reopen the example until you have a failing attempt, an explanation of the failure, and a specific question you cannot answer.

Exit ticket

Continue only when these are true

Mastery evidence

I can explain why Production Release Runbook and Smoke Tests exists.I can predict the example before running it.I can reproduce the core behavior from memory.I can create and diagnose the intentional failure.I can name what would change in a production system.

Lesson progress

Record this deep-dive lesson

Mark complete only after the transfer challenge and exit ticket.