Field papers

Real problems, traced from the symptom to the source to the result. Each paper says what was tested, what failed, and what you can do yourself. Each one is useful even if you never hire us.

  1. FIELD PAPER 01The site wasn’t broken. The domain wasn’t active yet.
  2. FIELD PAPER 02The handoff wasn’t wrong. It was old.
  3. FIELD PAPER 03The check was guarding a decision that had already changed.
  4. NOTE 01The people aren’t lost. The doorway is.
  5. NOTE 02A tool can organize the work. It cannot create authority.

FIELD PAPER 01 · VERSION 1.0The site wasn’t broken. The domain wasn’t active yet.

Last tested
2026-11-06
Environment
A new domain moved to a DNS provider; a website ready to be attached to that domain
Sources
The DNS provider’s own status for the domain, read through its API; the release record
Tests
Domain status read twice, nine minutes apart; the site’s full local test suite
Result
Attached and verified from outside once the domain showed active
Corrections
None

Symptom

The finished site could not be put on its public address.

Reality

Every local test of the site passed. Nothing in the site depended on the domain. The failure only appeared at the step that joins the two.

Source

The DNS provider listed the domain as pending. The new nameservers had been set at the registrar but not yet confirmed by the provider.

Test

Read the domain’s status from the provider twice, nine minutes apart. Pending both times. That ruled out a passing glitch and ruled in a state that had to change before anything else could.

Failed line

The first assumption: that the problem was in the site or the release process. Changing either would have spent time and fixed nothing.

Code

No custom code needed. To check a domain yourself, see Recipe 03: Check where a domain points, especially the NS step.

Receipts

Receipt R1, the full record.

Baton

Bring the Problem: symptom in one sentence, then what would have to be true upstream.

Road

Hold the public step until the domain shows active. Then attach, and verify from outside, not from the inside view.

Act

Held. The status was read again later, found active, and the work continued.

Result

Attached, verified from outside, live. Nothing in the site had to change.

Do it yourself: when something fails at the step where two systems meet, check the one you didn’t build first. Ask its provider what state it is in.

FIELD PAPER 02 · VERSION 1.0The handoff wasn’t wrong. It was old.

Last tested
2026-11-06
Environment
A project tracked in version control, picked up again from a written handoff
Sources
The handoff note; the repository’s own history; the release record
Tests
Branch history and release record read directly, before any change
Result
Four newer changes found before work began; no decision reversed
Corrections
None

Symptom

Work resumed from a handoff note that named four changes as the latest work.

Reality

A handoff is a claim about the record. It was true when written. Nobody knew whether it was still true.

Source

The repository held eight changes, not four. The four newer ones included a decision about payment and a redeployed test version.

Test

Read the history and the release record directly, and compare them line by line with the handoff, before touching anything.

Failed line

None, and that is the point. Starting from the handoff would have quietly undone a decision the owner had already made.

Code

No custom code. In git: git log --oneline on the branch, compared with the changes the handoff names. If they differ, the repository wins.

Receipts

Receipt R5.

Baton

Find the Source: two columns, what I was told and what I can show.

Road

Source wins. Recover from the repository, name the conflict out loud, then work.

Act

Recovered from the repository and reported the four missing changes up front.

Result

No rework, and no decision quietly reversed.

Do it yourself: treat every handoff, summary or status update as a claim with a date. Check it against the record before you build on it.

FIELD PAPER 03 · VERSION 1.0The check was guarding a decision that had already changed.

Last tested
2026-11-06
Environment
Automated release checks that must pass before a site goes public
Sources
The owner’s recorded decision; the checks themselves; the page’s behaviour with nothing configured
Tests
The page run with no payment configured: it must show the reference and no payment destination at all
Result
Checks corrected; they now fail if a payment destination appears too early
Corrections
None

Symptom

The release check failed: payment details missing.

Reality

The site was ready. The check was enforcing a rule written before the owner decided to launch without automated payment.

Source

The recorded decision said launch without payment. The check had never been updated to match it.

Test

With no payment configured, the page shows the reference and says payment details come later. No handles, no buttons, no placeholders.

Failed line

The rule in the check, not the product.

Code

The change was two small edits to two test files. The pattern matters more than the code: a check is a record, and a record goes out of date.

Receipts

Receipt R2.

Baton

Correct the Record: new fact, old record, corrected record, date.

Road

Change the check to require only what launch needs, and to fail if a parked feature ever shows something it shouldn’t.

Act

Two edits. Nothing visitors see changed.

Result

Checks pass, and they now guard against fake details appearing instead of demanding real ones too early.

Do it yourself: when a check blocks you, ask which decision it encodes and whether that decision is still the current one. Then fix the record, not the product.

NOTE 01 · VERSION 1.1The people aren’t lost. The doorway is.

People arrive, look around, and leave without doing what they came for. The usual conclusion is that they didn’t really want it. Most of the time they knew exactly what they wanted, and the doorway asked them to understand the building before letting them in.

Method. Stand where a stranger stands. Count what they must read, decide or understand before the first useful act. Move everything that isn’t that act one layer back: still there for anyone who wants it, never in front of the door.

Example. GROK’it’s front screen holds one question, one sentence, four optional doors, a box for the problem, a name and a way to reply, one safety line, and one button. The method, the price, the receipts and the fine print are one layer back.

Corrections. 2026-11-07: version 1.0 said the front screen showed the price in dollars. It no longer does: the price now comes after the problem is understood and scoped. Baton: Make the Next Move.

NOTE 02 · VERSION 1.0A tool can organize the work. It cannot create authority.

A script, an assistant or an automation can plan, check and even act. It is tempting to let it decide too, because it already has the steps lined up.

Method. Before work starts, list the acts that spend money, publish, or can’t easily be undone, and write who decides each one. Let the tool do everything up to that point, then stop and hand over exactly one decision: what it changes and how to undo it.

Example. Twice during GROK’it’s launch the release process stopped short of the public step: once because it will not attach a site without a passing test on record, once because publishing waited for the owner’s explicit go. Both times the work waited for the person.

Baton: Which Decisions Are Mine?

Stuck on something like this? Tell GROK’it what’s happening →