- In short
- The five documented reference architectures are: agent (an open-ended loop where Claude decides its own next step until a stop condition), RAG (retrieval augments a call with chunks from a stable corpus), document-processing pipeline with an evaluator-optimizer pass (process items, then check against a rubric and refine), routing (an initial classification sends work down a specialised path), and coding agent (agentic exploration paired with deterministic edit, test, and review steps). Each is a shape to adapt, not a blueprint to copy.
Shapes the industry already paid to learn
Most partner problems map to one of a handful of reference architectures already proven in the Claude ecosystem. The Claude Certified Architect - Professional (CCAR-P) exam treats recognising these five as an understand-level skill because they are the vocabulary of solution design: knowing them well enough to generalise from lets you take the shape that fits, adapt it to the workload in front of you, and recognise when a problem draws on more than one. A reference architecture is a documented pattern for wiring an LLM application to solve a recurring class of problem, and the point is to understand why each works, not to memorise a diagram.
The five are: the agent, an open-ended loop where Claude decides its own next step until a stop condition; RAG, where retrieval augments a call with relevant chunks from a stable corpus; the document-processing pipeline with an evaluator-optimizer pass, which processes items and then checks output against a rubric and refines; routing, where an initial classification step sends work down a specialised path; and the coding agent, which pairs agentic exploration with deterministic edit, test, and review steps.
- Reference architecture
- A documented, proven pattern for wiring a Claude application to solve a recurring class of problem. The five are agent, RAG, document pipeline with evaluator-optimizer, routing, and coding agent. Each is a shape to understand and adapt to the workload, not a rigid blueprint to implement as drawn.
The five shapes and what each is for
The agent suits open-ended tasks where the sequence of steps cannot be predetermined, so Claude plans and executes toward a goal, deciding what happens next until a stop condition fires. RAG suits questions answerable from a stable body of reference material, documentation, policy text, product manuals, where retrieving the relevant chunks and handing them to the model produces grounded answers. The document-processing pipeline with an evaluator-optimizer pass suits high-volume processing where output quality must be checked: each item is processed, then an evaluator scores it against a rubric and triggers a refinement pass when it fails.
Routing suits work that splits into distinct intents, an initial classification step sends each request down a specialised path, as in customer-service ticket triage. The coding agent suits software tasks: it explores a codebase agentically but pairs that exploration with deterministic edit, test, and review steps so the open-ended reasoning is bounded by checkable operations. Each shape encodes a hard-won answer to a recurring problem, which is why starting from the right one saves the cost of rediscovering it.
Adapt the shape, do not copy the blueprint
The central discipline is treating a reference architecture as a shape to adapt, not a template to implement as drawn. Every partner workload is unique, so the goal is to understand the pattern well enough to reshape it to the problem, adjusting where the standard shape does not fit. A reference architecture implemented rigidly, without adapting it to the actual data and query pattern, imports assumptions that may not hold. The reference is a starting point that carries the accumulated learning of prior projects, not a finished answer to the current one.
Habit is the enemy of fit
The second discipline is not picking a reference architecture out of habit. Reusing RAG because it worked on a prior project, without checking whether this problem's data and query pattern match, is how retrieval gets applied to live state, the single most common reference-architecture mistake. RAG earns its place on stable corpora; it breaks on data a live system owns and updates. The check is to ask, each time, whether the properties that make a given shape appropriate actually hold for this workload, rather than reaching for the shape that is most familiar.
What the CCAR-P exam trips candidates on
The exam tests two traps. The first is assuming a reference architecture is a rigid template to implement as drawn, rather than a shape to adapt to the workload. A scenario will show a standard pattern applied literally to a problem it does not quite fit, and the credited answer adapts the shape rather than forcing the problem into it.
The second is picking a reference architecture out of habit, such as reusing RAG from a prior project, without checking whether this problem's data and query pattern match it. The reliable reading interrogates the fit: does the data have the property, stability for RAG, distinct intents for routing, that the shape assumes? If not, the familiar shape is the wrong one.
Worked example
A team that shipped a successful documentation-search RAG system is asked to build an assistant that answers 'what is the current status of my support ticket?' They propose reusing their RAG pipeline over an index of ticket records. Which reference architecture actually fits, and why?
Name what the successful prior project relied on. Documentation search works with RAG because documentation is a stable corpus: it was true yesterday and will be true tomorrow between refreshes. The team is reaching for the same shape out of habit, which is the trap, without checking whether ticket status shares that property.
It does not. A support ticket's current status is live state owned by the ticketing system and changes independently of any index. Retrieval over ticket records returns point-in-time snapshots, so the assistant would confidently report stale statuses with no error signal, exactly the retrieval-on-live-state failure. RAG is the wrong reference architecture here because the data lacks the stability RAG assumes.
The shape that fits is a tool call to the ticketing system for the live status, wrapped in whatever conversational surface the users need, closer to an augmented call or a routing design that dispatches status questions to a live lookup. Static material around it, ticket-handling policies, escalation guidelines, can still use retrieval. The lesson is that the right reference architecture is chosen by checking the data and query pattern against what each shape assumes, not by reusing the shape that succeeded last time.
Common misreadings to avoid
Misconception
A reference architecture should be implemented exactly as it is drawn.
What's actually true
Misconception
If RAG worked on the last project, it is a safe default for the next one.
What's actually true
How this shows up on the exam
Domain 1 questions on this knowledge point ask you to name the reference architecture that fits a described problem, or to critique a chosen one. The reliable reading recognises the five shapes, agent, RAG, document pipeline with evaluator-optimizer, routing, coding agent, treats each as adaptable, and checks whether the workload's data and query pattern match the shape's assumptions rather than defaulting to a familiar pattern.
These shapes build on the four-stage architecture shape and on live state vs static knowledge, which decides whether RAG or a tool call belongs. They feed forward into composing two reference architectures deliberately and overlap with the workflow sub-patterns that routing and evaluator-optimizer draw on.
A partner needs a system that triages incoming customer emails into billing, technical, and returns queues, then handles each with a path suited to that category. Which reference architecture is the primary fit, and what is the key check?
People also ask
What are the five reference architectures for Claude?
Is a reference architecture a blueprint to copy?
When does RAG fit and when does it fail?
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.