- In short
- Production Claude issues fall into distinct failure classes: prompt failure, hallucination, model mismatch, and orchestrator-workers failure. Each class has a different root cause and therefore a different fix, so classifying the failure correctly is a prerequisite step, not an afterthought. An LLM system rarely crashes on failure; it silently produces a subtly wrong response, so failures must be actively classified rather than caught automatically by errors and exceptions.
You cannot fix a failure you have not classified
When a production Claude system misbehaves, the instinct is to reach for a fix, usually "improve the prompt." The CCAR-P exam treats that instinct as the mistake. Production issues come in distinct classes, each caused by a different thing and each demanding a different remedy, so the fix that resolves one class does nothing for another. This remember-level knowledge point establishes the taxonomy and the discipline that goes with it: classify the failure first, because the classification determines the fix.
- The core failure taxonomy
- A classification of production Claude issues into distinct failure classes, prompt failure (ambiguous or underspecified instruction), hallucination (confident content not grounded in a reliable source), model mismatch (wrong model tier for the task, or swapped without re-evaluation), and orchestrator-workers failure (a breakdown across the orchestrator-subagent boundary). Each class has a different root cause and a different fix, and classification is a prerequisite step before any fix is attempted.
Four distinct classes
The taxonomy names four failure classes. Prompt failure happens when the instruction was ambiguous or underspecified and the model filled the gap in a way you did not intend; the root cause is in the prompt. Hallucination happens when the model produces confident, fluent content that is not grounded in the input or a reliable source; the root cause is missing grounding, not wording. Model mismatch happens when the chosen model tier is wrong for the task's complexity, or a model was swapped without re-evaluation; the root cause is the model selection. Orchestrator-workers failure happens in multi-agent systems when something breaks across the boundary between the orchestrator and its subagents; the root cause lives in the coordination, not any single call.
The reason to memorize these as separate classes is that their fixes are as distinct as their causes, clarify the prompt, add grounding, re-select the model behind an eval, or repair the orchestration boundary, and those are explored in the knowledge points that follow.
Classification is the first step, not the last
Because the fixes diverge, classifying the failure correctly is a prerequisite, not something you do after trying a fix. If you skip classification and apply a generic remedy, you will fix only the cases that happened to belong to the class your remedy targets and leave every other class untouched, while believing you have addressed the problem. The order is fixed: observe the failure, classify it into one of the four classes, then apply the matching fix. Reversing the order, fix first, understand later, is how teams burn cycles making a hallucination worse by rewording the prompt.
Why the failure is usually silent
There is a reason this discipline is harder for LLM systems than for traditional software. A conventional system tends to fail loudly, an exception, a crash, a stack trace, so failures announce themselves and monitoring can catch them automatically. An LLM system rarely crashes. It produces a response that is confident, fluent, and subtly wrong, and nothing in the logs flags it as an error because, mechanically, nothing errored. The harder-to-catch failure mode is exactly this quiet wrongness, which means failures have to be actively surfaced, through evaluation, monitoring, and human judgment, and then classified, rather than waiting for an exception that will never come.
What the exam trips candidates on
The first trap is applying a single generic fix, such as "improve the prompt," to every production issue regardless of which class it is. A scenario will describe a team that reflexively rewords the prompt for a problem that is actually a hallucination or a model mismatch; the credited reading insists on classifying the failure first and applying the class-appropriate fix.
The second trap is assuming a system with no crashes or exceptions in its logs has no failures. A scenario will present clean error logs as evidence of health; the correct answer points out that the dangerous LLM failure is a silently wrong response that never throws an exception, so clean logs are not clean output, and failures must be surfaced actively.
Worked example
A production Claude system is 'sometimes giving wrong answers,' but its error logs are clean, no exceptions, no timeouts. A developer proposes rewording the system prompt to fix it. Critique this response and describe the correct approach.
Two things are wrong with the proposed response, and both trace to the taxonomy.
First, the clean error logs are being misread as evidence of health. An LLM system rarely crashes when it fails; it produces a confident, subtly wrong response, and nothing throws an exception, so the logs stay clean while the output is wrong. "No errors in the logs" is not "no failures." The wrong answers are real failures that the error-based logging simply cannot see, which is why they have to be surfaced through evaluation, output sampling, and monitoring rather than waited for.
Second, jumping straight to rewording the prompt skips the mandatory first step: classifying the failure. "Wrong answers" could be a prompt failure (an ambiguous instruction the model filled unexpectedly), a hallucination (confident content ungrounded in any source), a model mismatch (the tier is too weak for the task, or was swapped without re-evaluation), or, in a multi-agent design, an orchestrator-workers failure. Each has a different fix, and rewording the prompt only helps if the failure is actually a prompt failure. Applied to a hallucination or a model mismatch, it wastes effort and can even make things worse.
The correct approach is to surface concrete failing examples, classify them into one of the four classes by examining root cause, and then apply the matching fix, clarify the prompt, add grounding, re-select the model behind an eval, or repair the orchestration. Classification is the prerequisite; the prompt reword is at most one possible outcome of it, not the starting move.
Common misreadings to avoid
Misconception
Most production Claude issues can be fixed by improving the prompt.
What's actually true
Misconception
If the error logs are clean, the system has no failures.
What's actually true
How this shows up on the exam
Domain 4 questions on this knowledge point present a vague production symptom, wrong answers, poor quality, and either a reflexive prompt fix or clean logs offered as reassurance. The reliable move is to insist that failures be classified into the four classes before any fix, and to treat a subtly wrong, non-crashing response as the default LLM failure mode.
This taxonomy is the entry point for the diagnosis task statement. It splits into prompt failure vs hallucination and fixing model mismatch for the single-call classes, and into orchestrator-workers failure attribution for the multi-agent class, with change attribution handling why a metric moved. Surfacing silent failures depends on logging the four categories a production system must capture.
A Claude system is producing wrong answers, but its logs show no exceptions or timeouts. What is the best first response?
People also ask
What are the main failure classes for a Claude system?
Why classify a failure before fixing it?
Why do LLM systems fail silently?
Watch and learn
Official Anthropic Academy lessons first, then hand-picked walkthroughs. Videos load only when you press play.
No videos curated for this concept yet
We are still curating the best official and community videos for this topic.
Official prep for this domain
Anthropic's own free prep module for this part of the syllabus, on the official prep course. Free with an Anthropic Academy sign-in.
References & primary sources
Master this concept with Archie
Practice it inside an adaptive study session. Archie, your Socratic AI tutor, tracks your mastery with Bayesian Knowledge Tracing and schedules the perfect next review.