01One missing day, named by its date, led straight to the cause
In September 2026, a daily automated publishing run that the operator maintains failed to publish the previous day's instalment. The operator did not report a broken system. The operator named the date that was missing and asked the AI why nothing had been produced for it.
What came back was not a theory about why the system had stopped. It was an account of what had happened to that date. The job had run. Because a record of that run had been left behind, the next run treated the day as already handled and skipped it. The cause was not a failed process. It was how the records were kept.
The fix involved deleting part of that leftover record. The AI said first that unless this was repaired before the next collection window, the same reason would produce nothing again that night. The operator was asked whether to go as far as removing the record and publishing the missing day, and approved it.
One pattern can be lifted out of this. Name what is missing by its identifier, and the AI's search moves away from the system as a whole and towards the history of that single item.
02A date gives the AI a handle it can follow through the records
"It isn't showing up" and "it isn't working" do not narrow anything down. An AI that receives that has to search widely for whatever part of the system is broken. Give it a date and the search has exactly one subject.
An identifier here means a value that separates one item from every other: a date, a version number, an intake number, a sequence number. With an identifier in hand, the AI can search the records for that value. If the records exist, they line up in order: when, what, and how it was handled.
This changes the kind of answer that comes back. Hand over a symptom and the AI lists plausible causes and guesses among them. Hand over an identifier and the AI reads one item's history and answers with facts. In the operator's case the answer was not a guess. It was the state of the record left against that date.
03Narrowing to one item cuts the candidate causes to a countable few
Suspect the whole system and the candidates are many: collection failed, writing failed, the schedule was wrong, an external service did not answer, permissions were missing. All of them are possible, so there is no reason to start with any one of them.
Narrow to a single item and the candidates shrink to whatever happened to that item alone. If the other days ran, the system itself runs. What remains is that day's input, that day's record, and that day's timing.
| Aspect | Reporting the symptom | Naming the missing item by its identifier |
|---|---|---|
| What comes back first | A list of possible causes | The record of what happened to that item |
| Search area | The whole system | One item's history |
| Nature of the answer | A guess | A fact |
| Cost of being wrong | Repairing something unrelated | Re-reading one item's record |
Anthropic's guidance for Claude Code points the same way. Instead of "the build is failing", give the symptom, the likely location, and what a fixed state looks like, then address the root cause rather than suppressing the error. The same guidance asks for a check that proves the repair held.
04Naming works when everything else runs and a single item is absent
It is worth stating when this pattern applies. It applies where the same process runs repeatedly and exactly one of its results is missing. Four things go into the request.
The subject
An article that should be published, an entry that should be registered, a row that should appear in a list.
The identifier
A date, a version number, an intake number: a value that separates this item from the rest.
The expectation
It should have been produced like every other day and appeared in the same place.
The deadline
The next scheduled run. Leave this out and there is no basis for ordering the repair.
There are cases where it does not apply. In a system that has never run, there is no record to name. When everything is missing, an identifier narrows nothing. What is needed then is to set out working and failing examples side by side and state the expected range first.
The other boundary is an absent record. Without records, an identifier is not a search key. Being able to name a missing item rests on an operation that keeps records in the first place.
05In material review, missing numbers and skipped versions take the same form
The same shape of absence turns up in pharmaceutical material review and medical affairs work. One approved item is not on the list of approved materials. An intake number is skipped in the review log. A version that was supposed to be replaced is still the previous version where it is published.
Say "the list doesn't match" and the person receiving it questions how the list is built. Say "the item with this intake number is not on the list" and they look at that item's history. Which is faster depends only on how wide the search area is.
The demands made of records point the same way. The United States Food and Drug Administration's 2018 guidance on data integrity and compliance with drug manufacturing practice states that all data be reliable and accurate, and asks firms to hold effective strategies for managing data integrity risk based on their understanding of their own processes. Being able to determine afterwards which single item is missing is part of meeting that.
If absences can be named one at a time, the confirmation after a repair can also be done one at a time. Rebuilding an entire list and saying it is probably fixed is weaker evidence than showing that the number which was missing is now present.
06A single absence usually means the records disagree, not that the process broke
Why would only one item go missing? If the process itself were broken, everything would be missing. When one item alone is absent, something is still treating that item as already handled.
Three causes are common. A marker meant to prevent duplicate work is present even though the work was never completed. The process stopped part way and only the first half of its record was written. The boundary between one day and the next sits out of step with the run schedule, so a day falls between two runs.
This is why repairing such a defect often means rewriting records. In the operator's case the substance of the fix was a deletion. Deletions are hard to undo. That is the reason to place a point of human approval here rather than leaving it to the AI.
The United States National Institute of Standards and Technology's 2006 guide to log management sets out why organisations need processes for generating, collecting and retaining records before they are needed. Records are usually thought of as something read after an incident, but as this case shows, the records themselves can govern how a process proceeds. Deciding what to keep is also deciding what will happen.
07From tomorrow: put the identifier and the deadline in one sentence, and ask for the cause first
There are five steps.
- Write the missing item as an identifier. "Nothing was produced for this date." "This intake number is not on the list." Drop the adjectives about the symptom and write the value.
- Add the expectation and the deadline. One sentence: it should have appeared as the others did, and it is needed before the next run.
- Ask for the cause before the fix. Require the record of what happened to that item ahead of any proposed repair. If it cannot be shown, you learn early that the records are insufficient.
- Separate approval for changes that cannot be undone. Deleting records, publishing, replacing a version: a person decides after seeing what will be done.
- Ask for evidence at the level of the item. Have it shown that the identifier which was missing is now present. A report that the whole run succeeded is not enough.
Mozilla's bug writing guidelines call steps to reproduce the most important part of any report and ask that multiple issues be filed separately. Whether the reader is a person or an AI, neither of those changes. One item at a time, named by its value.
Anthropic's prompting guidance notes that being specific about the output format and constraints you want makes results more consistent. An identifier is the shortest form that specificity can take. A date is under ten characters, and it narrows the search area to one item.
- Do not report a defect as a symptom; name the missing item by its identifier. Given a date or an intake number, the AI reads that item's history and answers with facts rather than guesses.
- When a single item is missing, the cause lies more often in disagreeing records than in a failed process. Suspect completion markers, half-written entries, and timing that sits out of step.
- If the repair involves deleting records or publishing, a person approves before it runs. Evidence of the fix should be the missing identifier now being present.
The ability to name what is missing comes from a habit of reading records, not from knowing how a system is built. Which item, when, handled how. Put that question as a value and the AI can answer with facts. Keeping things nameable is the same work as keeping an operation that retains its records. The next instalment takes up a different pattern: turning unease about one section into a demand for consistency.
- Anthropic. Best practices for Claude Code. Claude Code Docs. https://code.claude.com/docs/en/best-practices
- Anthropic. Prompting best practices. Claude Developer Platform Docs. https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices
- Mozilla. Bug writing guidelines. Bugzilla@Mozilla. https://bugzilla.mozilla.org/page.cgi?id=bug-writing.html
- Kent, K., Souppaya, M. Guide to Computer Security Log Management. NIST Special Publication 800-92, 2006. https://csrc.nist.gov/pubs/sp/800/92/final
- U.S. Food and Drug Administration. Data Integrity and Compliance With Drug CGMP: Questions and Answers. Guidance for Industry, 2018. https://www.fda.gov/regulatory-information/search-fda-guidance-documents/data-integrity-and-compliance-drug-cgmp-questions-and-answers