The signal you normally throw away
You are testing an app. Something feels off — a stale value, a success message you do not believe. Usually that judgment evaporates: hours later someone asks for a bug report, and you reconstruct the moment from memory, losing the timing, the order of actions, and most of the value. The pattern this session builds on calls human intent “the missing signal” in agent debugging and records it the moment it occurs.
This is not a paper idea. A production desktop app we studied ships the same move: a hotkey mints a marker id, captures a screenshot, writes a dev_marker log event, and opens a note where the tester types one explanation — all joined by the same id, with a log CLI whose --marker flag slices the session for agents. The design rule that makes it work: capture happens during the surprise, one keystroke and one sentence. Anything heavier and nobody uses it at the moment that matters.
A capture has two parts that answer different questions. A marker says why this moment deserves attention; a trail says how the tester arrived there. Testimony alone tells an agent what to look for but not when; a trail alone is complete but unweighted. Paired, the testimony points into the trail, and the trail grounds the testimony in ordered facts. Treat the marker as a search warrant, not a verdict.
One captured failure, read cold
The workshop demo plants a bug worth marking: a notes app goes offline, reconnects, and saves. The server rotated its session token during the reconnect; the client kept its stale copy; the save handler treats any status below 500 as success. The user sees “Saved ✓”. The server said 401. We drove that path in a real browser, pressed mark, and typed: “It said Saved but my note never reached the server — this happened right after I reconnected.” Seven consecutive lines of the captured trail, exactly as the packet renderer printed them:
- [seq 3 · t+17397ms] click: click <button#save> "Save note"
- [seq 4 · t+17519ms] fetch: POST /api/notes → NETWORK-ERROR (NetworkError: connection lost) [122ms]
- [seq 5 · t+17519ms] console: console.warn: save failed: network unavailable
- [seq 6 · t+18436ms] click: click <button#toggle-net> "Reconnect"
- [seq 7 · t+18436ms] console: console.log: reconnected: session restored
- [seq 8 · t+18909ms] click: click <button#save> "Save note"
- [seq 9 · t+19031ms] fetch: POST /api/notes → 401 [122ms]
Read it top to bottom and name a hypothesis before anyone tells you: a network failure, a “session restored” log, then a 401 on the very next save under a visible “Saved ✓”. If you reached “the reconnect invalidated something the client still holds,” a nine-line slice just did what a full log dump rarely does — and an agent reads it the same way you just did.
What the capture leaves out
The moment you say “capture the entire state of the app,” you have a privacy decision, because the payload will leave your machine — pasted into an agent, attached to a ticket, shared in chat. Decide the exclusions before the first capture, write them into the payload itself, and accept the narrower evidence. The demo’s export embeds exactly this policy, so every reader can audit what was withheld:
{
"storageValues": "excluded",
"requestBodies": "excluded",
"responseBodies": "excluded",
"userText": "preview+length only"
}
An external architecture review of the production system pushed the same rule harder: order events by a sequence counter, join records by session and marker ids, and store user input as preview, hash, and length — never raw. A capture safe enough to paste anywhere gets pasted; a risky one gets hoarded and helps no one.
The handoff needs a fence too. A weak handoff pastes a log dump and asks “what’s wrong?”, inviting confident guessing over unweighted noise. A strong handoff gives less data and more structure — what the human saw, what the system recorded, what was withheld, and what kind of answer is allowed. That is why the packet ends with a claims boundary, and why the first prompt above demands a hypothesis before code: the agent’s draft arrives labeled as a draft, and a person verifies it against the running app.