gtmjosh
Carry the Work Across
Chapters
  1. 01 · Map the Teams and Systems
  2. 02 · Define What Each Handoff Carries
  3. 03 · Track Waiting, Running, Completed, and Failed
  4. 04 · Handle Temporary and Permanent Failures
  5. 05 · Reconcile Systems That Disagree
  6. 06 · Notify and Escalate to the Right Owner
  7. 07 · Confirm the Business Outcome
  8. 08 · Capstone: Follow One Record End to End
Guide overview →

12 min · Interactive exercise

Chapter 3 of 80 complete

Track Waiting, Running, Completed, and Failed

Make every state independently visible, and log the job as well as the record.

Waiting, running, completed, failed. Plus the two that matter just as much across a boundary: stale, and last successful.

Most interfaces show a number and a spinner, which collapses all of them. A person looking at that screen cannot tell whether what they see is current, an hour old, or the surviving fragment of a run that mostly failed.

And the rule that makes the whole thing usable during an incident: a failed run must never erase the last successful result. Yesterday's numbers, clearly labelled as yesterday's, are far more useful than a blank panel at exactly the moment somebody needs numbers.

Job history, not just record history

Record history tells you what changed. It does not tell you which run changed it, who started that run, how long it took, or what else it touched at the same time.

So log the job as well as the record. Every scan, evaluation, and batch, with its progress, its duration, and who ran it. The reason is one sentence: so a bad outcome can be traced back to the run that produced it.

That sentence is what turns an incident from an archaeology project into a lookup. Without it, the question “what else did that job do” has no answer, and you end up checking everything.

GTM Lab

Saved locally
Cross-System Operating Plan · 0 of 8 sections started

Saved locally to your browser.

Make the states visible

The panel above answers one question and hides four. Build the state model, then decide what the job log records.

Fixture: spinner-and-number

A status panel that hides four states

FIXTURE-SPINNER-AND-NUMBER
What it shows
One figure, and a spinner while a run is in progress
Is the figure current?
No way to tell
Did last night’s run finish?
No way to tell
Did half of it fail?
No way to tell
During the incident
The panel went blank
Resets every run.
What must the interface be able to show?
Record history already exists. What does the job log add?
Chapter 3 of 80 complete