Skip to content

CCAR-P : Solution Architecture & Design (Domain 1)

Domain 1 : Solution Design & Architecture Quiz

20 questionsmedium

The Solution Design & Architecture domain of the Claude Certified Architect Professional (CCAR-P) certification accounts for 17% of the exam. It focuses on translating complex business challenges into production-grade AI solutions by establishing rigorous conceptual foundations, selecting appropriate architectural patterns, and managing agentic orchestration. Architects must ensure every design aligns with core business pillars: efficiency, cost, and performance Service Level Agreements (SLAs).

CCAR-P Conceptual Foundations of Solution Design

A robust Claude-powered architecture is built upon the translation of business problems into measurable technical outcomes. Every complete architecture must consist of four distinct components:

  1. Input: The raw data, user queries, or environmental signals that initiate the process.
  2. Processing: The logic, model calls, and tool executions that transform input.
  3. Output: The final structured data or response delivered to the user or downstream system.
  4. Feedback Loop: The mechanism—such as evaluations (evals), user signals, or monitoring—that feeds back into the design for continuous improvement.

Aligning AI Architecture to Business Value Pillars

Architectural decisions are governed by three primary value pillars. When multiple technical solutions are valid, the architect must select the one that best satisfies the specific business constraint mentioned in the requirement:

Value PillarKey MetricsArchitectural Influence
EfficiencyThroughput, automation rateFavors patterns that minimize human intervention and maximize automated resolution.
CostPer-transaction spend, token consumptionFavors the Batch API for non-urgent work, prompt caching, and lower model tiers (e.g., Haiku).
Performance (SLAs)Latency percentiles (p95/p99), accuracy floorsFavors capability-tier models (e.g., Opus), streaming responses, and re-ranking for RAG.

Choosing the Right Claude Architectural Patterns

The fundamental task in solution design is matching a business problem to the simplest pattern that satisfies the requirement. Complexity must be justified; if an Augmented LLM call meets the need, both workflow and agentic patterns are considered incorrect choices.

AI Pattern Categories and Their Trade-offs

PatternOperationControl FlowKPI Trade-offs
Augmented LLMSingle model call enriched with retrieval, tools, or memory.Direct / SimpleLowest cost and latency. Best for well-scoped, individual tasks.
WorkflowMultiple model calls in a developer-defined sequence.Sequential Pipeline (Fixed)High predictability and auditability. Ideal for compliance-heavy environments with known steps.
AgenticOpen-ended loop where the model chooses tools and steps.Dynamic LoopHigh autonomy. Higher cost and latency variance; used only when the solution path cannot be scripted.

Sequential Pipelines (Workflows) vs. Dynamic Loops (Agentic)

  • Sequential Pipelines (Workflows): These are deterministic and traceable. Use this pattern when steps are known in advance and the system must remain auditable. Predictability is the primary benefit, allowing compliance teams to sign off on behavior.
  • Dynamic Loops (Agentic): The model runs until a stop_reason is triggered or a termination condition is met. This is reserved for open-ended discovery and exploration where the path to a solution cannot be enumerated up front.

Master Task Decomposition and Agent Orchestration

Complex problems require decomposition into manageable subtasks. Architects must decide whether to decompose based on capability (e.g., a research agent, an analysis agent, and a writing agent) or data domain (e.g., region-specific or product-specific agents).

Key Multi-Agent Orchestration Strategies

The orchestrator lives outside any single agent. Its primary roles are task assignment, result merging, and failure isolation.

  • Sequential Handoff: Used when outputs from one stage serve as necessary inputs for the next.
  • Parallel Fan-out: Used when subtasks are independent. The orchestrator merges parallel results into a single synthesis step.

The Coordinator-Subagent Hub-and-Spoke Pattern

In this pattern, a central coordinator agent manages specialized subagents.

  • Spawning Subagents: Subagents are spawned using the Task tool.
  • Configuration: The coordinator uses the allowedTools configuration to limit the subagent’s scope, preventing capability bloat (the anti-pattern of an agent carrying more tools than required).
  • Isolated Context Rules: Subagents operate with isolated context and do not automatically inherit the coordinator’s conversation history. The coordinator must explicitly pass relevant findings into the subagent’s prompt. Failure to do so is a common root cause for “missing findings” in multi-agent systems.

Advanced Orchestration Techniques using Claude Agent SDK

The Claude Agent SDK provides programmatic hooks that allow architects to enforce boundaries and normalize data without relying solely on probabilistic model instructions.

Utilizing SDK Hooks and Tool Call Interception

  • PostToolUse Hook: This hook allows for processing after a tool is executed. It is essential for data normalization, ensuring that tool outputs are formatted correctly before being appended to the conversation history.
  • Tool Call Interception: Architects use interception to create programmatic boundaries. This allows the system to validate inputs, screen for injections, or enforce permissions before the tool logic is actually executed.
  • Stop Reason Handling: Effective orchestration requires monitoring the stop_reason to manage agent control flow, handle tool results, and terminate loops effectively.

Programmatic Boundaries vs. LLM Prompt Instructions

Architects must not rely on “prompt guarantees.” While the system prompt can define behavior, deterministic controls—such as permission scoping and SDK-based validation—are required for compliance-critical or high-stakes actions.

Essential Glossary of CCAR-P Architectural Terms

  1. Augmented LLM: A single model call enhanced by external data, retrieval (RAG), or tools.
  2. Workflow Pattern: A pre-defined, fixed sequence of model calls used for predictable task execution.
  3. Agentic Pattern: An autonomous loop where the model determines its own sequence of actions and tool uses.
  4. Multi-Agent System: An architecture where specialized agents collaborate, often managed by a coordinator.
  5. Task Decomposition: The process of breaking a complex business problem into smaller, specialized subtasks.
  6. Orchestration: The management of agent interactions, task delegation, and result merging.
  7. Coordinator-Subagent Pattern: A hub-and-spoke model where a central agent delegates to specialized sub-agents.
  8. Isolated Context: The principle that subagents do not share memory or history unless explicitly provided by the coordinator.
  9. Capability Bloat: An anti-pattern where an agent is granted more tools or permissions than its specific task requires.
  10. SDK Hooks: Programmatic entry points (like PostToolUse) in the Claude Agent SDK for custom logic.
  11. Feedback Loop: Mechanisms like monitoring or user signals that inform iterative design improvements.
  12. Programmatic Boundaries: Hard-coded constraints or validation layers that sit outside the LLM’s probabilistic reasoning.
  13. Stop Reason: A model-returned status (e.g., tool_use) that dictates the next step in an agentic loop.
  14. AllowedTools: A configuration setting used to restrict an agent’s access to only the tools necessary for its role.
  15. Task Tool: The specific mechanism within the SDK used by a coordinator to spawn and define a subagent.

Domain 1 Scenario-Based Practice Questions

  1. Scenario: A legal firm requires an AI system to review contracts. The process must follow a strict five-step checklist approved by their compliance department. Which architectural pattern should be selected?
  2. Scenario: During testing of a research system, a “Synthesis Agent” fails to include data gathered by the “Search Agent,” even though logs show the “Search Agent” was successful. What is the most likely architectural cause?
  3. Scenario: An architect is designing a support bot. The business priority is to minimize the cost per ticket. Which model tier and API feature should be prioritized?
  4. Scenario: A multi-agent system uses a single coordinator to manage 50 different tools. The model frequently selects the wrong tool. What is the recommended fix?
  5. Scenario: You need to ensure that an agent never performs a “Delete” operation on a database without first validating that the user has specific admin rights. Should you rely on the system prompt or a programmatic boundary?
  6. Scenario: A developer wants to normalize various third-party API responses into a standard JSON format before Claude sees them. Which Agent SDK hook should be used?
  7. Scenario: A system needs to perform open-ended market exploration where the steps change based on the data found. Which control flow type is required?
  8. Scenario: An architect needs to preserve the reasoning behind choosing a Workflow pattern over an Agentic pattern for a specific project. What document should be created?
  9. Scenario: A subagent is being spawned to handle only “Read” operations on a filesystem. How should the architect restrict its capabilities?
  10. Scenario: An architecture includes input, processing, and output, but lacks a mechanism to incorporate accuracy metrics back into the design. What component is missing?

Practice Questions Answer Key

  1. Workflow Pattern. Explanation: Fixed steps and compliance requirements demand the predictability and auditability provided by a workflow rather than the autonomy of an agent.
  2. Isolated Context. Explanation: Subagents do not automatically share context; the coordinator likely failed to explicitly pass the Search Agent’s findings into the Synthesis Agent’s prompt.
  3. Haiku tier and Prompt Caching. Explanation: Haiku is the fast, low-cost tier; Prompt Caching reduces costs for repeated system instructions or context.
  4. Task Decomposition / Scoping. Explanation: This is capability bloat. The architect should split the agent into scoped subagents, each with a minimal set of tools.
  5. Programmatic Boundary. Explanation: Prompt instructions are probabilistic; deterministic controls like permission validation in the application layer are required for high-stakes actions.
  6. PostToolUse Hook. Explanation: This hook is designed to process or normalize data after a tool has been executed but before it is returned to the model context.
  7. Dynamic Loop. Explanation: When the path is not enumeratable up front and requires exploration, a dynamic (agentic) loop is the correct choice.
  8. Architecture Decision Record (ADR). Explanation: ADRs are used to capture the context, options, and reasoning behind significant architectural choices.
  9. allowedTools configuration. Explanation: Using allowedTools ensures the subagent only has access to the specific tools required for its narrow task, adhering to least privilege.
  10. Feedback Loop. Explanation: A complete architecture requires a feedback loop (monitoring/evals) to inform continuous system improvement.

Architectural Design and Reflection Questions

  1. How would you justify the increased latency and cost of an Agentic pattern to a stakeholder focused on performance SLAs?
  2. Reflect on the trade-offs between decomposing a multi-agent system by capability versus data domain. In what specific business scenario would data-domain decomposition be superior?
  3. When designing a coordinator-subagent architecture, what specific criteria would you use to decide if a task is “well-scoped” enough for a single Augmented LLM call instead of spawning a subagent?
  4. Describe a scenario where relying solely on stop_reason might fail to terminate an agentic loop. How would you design a programmatic safeguard to prevent an infinite loop?
  5. How do SDK hooks like tool call interception contribute to the Governance and Safety of an enterprise AI solution? Give an example involving sensitive data.

Leaderboard

No scores saved yet. Be the first!

20 Questions — Domain 1 : Solution Design & Architecture Quiz

Expand any question to reveal the correct answer and explanation.

  1. 1 A solution architect is designing a system to process sensitive financial transactions that require a strict audit trail and deterministic execution steps. Which architectural pattern should be prioritized to meet these compliance requirements?

    Consider which pattern uses developer-defined sequences rather than model-driven step selection.

    Workflow Pattern

    Predetermined sequences and programmatic pipelines provide the predictability and auditability required for high-compliance environments.

    • Agentic Pattern

      While powerful, dynamic runtime loops are less deterministic and harder to audit compared to fixed programmatic pipelines.

    • Augmented LLM Pattern

      This pattern is typically limited to single-pass enrichment and lacks the structured multi-step sequencing needed for complex transaction processing.

    • Autonomous Swarm Pattern

      A swarm approach introduces excessive variability and coordination overhead that conflicts with the need for a deterministic audit trail.

  2. 2 When implementing an agentic loop using the Claude Agent SDK, which field should the control flow logic inspect to determine if the loop should terminate?

    Look for a specific SDK-provided indicator that signals whether the model needs more information from a tool.

    stop_reason

    The loop must continue if the reason is 'tool_use' and terminate only when the model returns 'end_turn'.

    • finish_label

      This is not a standard SDK field for loop control; termination depends on specific model-emitted stop signals.

    • assistant_text

      Parsing natural language content for termination is considered an anti-pattern that can lead to unreliable execution or infinite loops.

    • iteration_count

      While useful as a safety cap, relying on a hardcoded count as the primary termination signal prevents the model from completing dynamic tasks.

  3. 3 An architect discovers that a coordinator agent is unable to delegate tasks to specialized subagents during runtime. Which configuration setting is most likely missing?

    Focus on the technical mechanism required by the SDK to allow one agent to invoke another.

    Including 'Task' in the coordinator's allowedTools list

    The Task tool is the specific mechanism for spawning subagents, and it must be explicitly permitted in the agent definition.

    • Setting 'multiAgentEnabled' to true in the API payload

      Agent orchestration is managed through tool definitions rather than a single global boolean flag.

    • Configuring a shared memory buffer in the SDK options

      Subagents operate in isolated contexts and do not use shared memory; context must be passed explicitly in the prompt.

    • Adding 'SubagentSpawner' to the model's system prompt

      System prompts guide behavior, but the technical capability to spawn subagents is governed by the tools available to the coordinator.

  4. 4 In a multi-agent research system, a synthesis subagent is failing to incorporate web search results obtained earlier by a different subagent. What is the most likely architectural cause?

    Recall the principle regarding how subagents access information from the coordinator's history.

    The coordinator failed to explicitly pass the search findings into the synthesis agent's prompt

    Subagents do not inherit the coordinator's conversation history or findings automatically due to context isolation.

    • The web search results exceeded the synthesis agent's default context window

      While window limits exist, the primary reason for a total lack of findings in subagents is a failure to pass the isolated context.

    • The search and synthesis agents are not sharing the same session ID

      Session IDs manage the lifecycle of a single thread, but subagent spawning creates isolated turns that require manual data injection.

    • The synthesis agent requires a 'PostToolUse' hook to read search outputs

      Hooks intercept results within a single agent's loop; they do not facilitate automatic data transfer between different agents.

  5. 5 A developer wants to ensure that an agent never approves a refund exceeding $\$500$ without human intervention. Which implementation method provides the most reliable guarantee?

    Compare probabilistic methods like prompting with deterministic methods like programmatic gates.

    Using an SDK tool call interception hook to block the request

    Programmatic hooks provide deterministic enforcement of business rules that cannot be bypassed by model hallucinations.

    • Adding a strict boundary statement to the system prompt

      Prompt-based instructions are probabilistic and have a non-zero failure rate, making them insufficient for critical financial limits.

    • Increasing the model's temperature to improve rule adherence

      Higher temperature actually increases randomness and variability, which would likely decrease adherence to strict constraints.

    • Defining the refund amount in the JSON schema as a constant

      JSON schemas define structure but do not dynamically validate runtime values against business logic gates.

  6. 6 To reduce total system latency when a coordinator needs to analyze 10 independent documents, which strategy should be implemented?

    Think about how to move from serial execution to simultaneous execution.

    Emit multiple Task tool calls in a single coordinator response

    Emitting multiple calls simultaneously spawns parallel subagents, reducing latency from the sum of all tasks to the duration of the longest one.

    • Utilize a sequential chain where each agent processes one document and hands off the state

      Sequential processing is inefficient for independent tasks and increases total latency unnecessarily.

    • Upgrade the coordinator to the highest capability tier (Opus class)

      A more capable model doesn't solve the underlying serial execution bottleneck; architectural parallelism is required.

    • Enable prompt caching for the document contents

      Caching reduces token costs but does not allow the model to process independent documents in parallel turns.

  7. 7 When standardizing heterogeneous data formats (e.g., converting varied Unix and ISO timestamps) returned from multiple MCP tools, which SDK feature is most appropriate?

    Identify the point in the loop where tool outputs can be programmatically modified before the model sees them.

    PostToolUse hooks

    These hooks intercept tool results for transformation and normalization before the information is passed back to the model for reasoning.

    • System prompt formatting rules

      Instructions can ask the model to format its output, but they cannot normalize incoming raw data from external tools.

    • JSON Schema enums

      Enums restrict possible inputs but do not provide the computational logic needed to transform and normalize varied outputs.

    • .mcp.json environment variables

      Environment variables are used for server configuration and credentials, not for data transformation logic.

  8. 8 A coordinator agent is designed to follow a strict 5-step checklist for every user request. Why might this 'procedural' approach be suboptimal compared to a 'goal-oriented' approach?

    Consider the difference between telling an agent 'how' to do a task versus 'what' the successful outcome looks like.

    It limits the subagents' ability to adapt when pre-specified paths fail

    Providing research goals and quality criteria allows agents to use their reasoning capabilities to navigate emerging patterns or failures.

    • It increases the token count of the coordinator's initial prompt

      While true, the primary architectural disadvantage is the loss of dynamic adaptability in autonomous systems.

    • It prevents the use of fork_session for divergent exploration

      Forking sessions is a separate technical capability that can be used regardless of prompt style, though rigid prompts make it less useful.

    • Procedural instructions automatically trigger iterative refinement loops

      Refinement loops must be explicitly designed; procedural prompts often ignore gaps that a goal-oriented synthesizer might catch.

  9. 9 An agent with access to 25 different tools is frequently misrouting calls or failing to select any tool. Which architectural change is recommended to fix this 'capability bloat'?

    Think about the recommended maximum number of tools per agent to maintain high reliability.

    Decompose the agent into a coordinator and multiple specialized subagents

    Limiting tool sets to $4-5$ per specialized agent reduces decision complexity and significantly improves tool selection reliability.

    • Rewrite all tool descriptions to be at least 500 words long

      Excessively long descriptions can actually increase attention dilution and consume unnecessary tokens without solving the cognitive load issue.

    • Force 'tool_choice: any' to ensure a tool is always selected

      This forces the model to pick a tool, but it does not improve the accuracy of *which* tool is selected among 25 options.

    • Merge the 25 tools into a single monolithic API connector

      Monolithic tools hide parameter requirements and prevent the model from effectively inspecting and selecting specific capabilities.

  10. 10 When passing context between subagents, why is it recommended to use a structured data format (like JSON) rather than a simple prose summary?

    Consider how an agent knows which piece of information came from which specific web page or document.

    To preserve attribution metadata such as source URLs and document names

    Structured formats allow metadata to remain cleanly separated from content, ensuring downstream agents can cite their sources correctly.

    • To reduce the overall token usage in the synthesis turn

      Structured formats often use more tokens than prose summaries, but they prioritize data integrity and provenance.

    • To avoid the 'lost-in-the-middle' effect in long prompts

      Format alone doesn't prevent this effect; careful placement of critical instructions at the beginning and end is still required.

    • Because subagents cannot parse natural language findings from the coordinator

      Subagents are capable of parsing prose, but doing so leads to the loss of granular details and strict metadata association.

  11. 11 What is the specific architectural benefit of using 'context: fork' in an Agent Skill configuration?

    Think about the impact of intermediate 'noise' on the model's limited context window.

    It isolates the skill's outputs from polluting the main conversation history

    Isolated contexts allow for 'exploratory' turns that don't bloat the primary context window with intermediate discovery steps.

    • It allows the skill to inherit all tools from the parent coordinator

      Forking creates an isolated instance; tool inheritance must be explicitly defined in the 'allowed-tools' frontmatter.

    • It forces the model to use the Batch API for the skill execution

      The Batch API is an asynchronous processing mechanism unrelated to the real-time session isolation provided by 'fork'.

    • It automatically enables iterative refinement of the skill output

      Refinement is an orchestration pattern, whereas 'fork' is a session management technique for context control.

  12. 12 In an orchestrator-worker pattern, what is the primary role of the 'synthesizer' component?

    Consider where the 'aggregation' of findings happens in a multi-agent system.

    To merge results from parallel workers and apply final quality control

    The synthesizer assembles the fragmented outputs of parallel agents into a coherent, verified final response.

    • To decompose the initial user query into independent tasks

      Decomposition is the primary responsibility of the planner or coordinator component at the beginning of the workflow.

    • To monitor subagent logs for policy violations

      Monitoring is typically handled via SDK hooks or external observability tools rather than a dedicated synthesis agent.

    • To provide worker agents with the tools they need to execute tasks

      Tool availability is defined in the agent's configuration (allowedTools) and is not provided dynamically by a synthesizer.

  13. 13 A system architect is choosing between 'monolithic context' and 'progressive discovery' for a large document catalog. When should 'progressive discovery' be the preferred choice?

    Focus on the relationship between context window size and document volume.

    When the solution needs to scale across thousands of documents efficiently

    Loading everything at once causes context bloat and poor attention; querying on-demand is more cost-effective and accurate.

    • When latency is the absolute top priority regardless of cost

      Monolithic context can actually be faster for small sets since it avoids the round-trip delay of multiple tool calls.

    • When the documents are highly structured and never change

      If the data is small and stable, monolithic context is acceptable; progressive discovery is specifically for scaling and dynamic data.

    • When using a fast-tier model like Haiku for all tasks

      Model tier doesn't dictate context strategy, though Haiku's smaller window might make monolithic context impossible for large data.

  14. 14 An architect is designing a multi-agent system where a coordinator routes communication between agents. What is a significant risk of 'overly narrow' task decomposition by the coordinator?

    Think about what happens to the 'big picture' when a problem is sliced into too many tiny, isolated pieces.

    Incomplete coverage of broad or ambiguous research topics

    If subtasks are too specific, agents may miss emerging connections or relevant information that falls outside their rigid assignments.

    • An exponential increase in token costs due to subagent spawning

      While costs increase, the primary architectural risk is a loss of research quality and comprehensive synthesis.

    • The coordinator being unable to manage parallel tool calls

      Decomposition granularity doesn't impact the coordinator's ability to handle parallel calls, which is an SDK-level capability.

    • Subagents automatically inheriting too much parent context

      The risk is actually the opposite; subagents inherit no context, and narrow prompts limit their ability to find relevant data.

  15. 15 A multi-agent system is experiencing high latency because the coordinator waits for each subagent to finish before spawning the next, even when tasks are independent. What is the correct SDK-level fix?

    Consider the difference between a single tool call per turn and multiple tool calls per turn.

    Emitting multiple Task tool calls in a single coordinator response

    The SDK can execute these calls concurrently if they are emitted in a single turn, allowing parallel subagent processing.

    • Reducing the 'max_tokens' value for each subagent

      This limits output length but does not change the serial nature of the orchestration logic.

    • Increasing the number of MCP servers configured in .mcp.json

      Servers provide tools; they do not dictate how the coordinator chooses to sequence its calls to those tools.

    • Implementing a PostToolUse hook to trigger the next agent

      Hooks are for data transformation within a turn, not for managing multi-turn orchestration logic.

  16. 16 When designing a recovery mechanism for an agent that crashed mid-task, what is the most effective approach?

    Think about how to provide the agent with a 'clean slate' while still acknowledging prior progress.

    Extract a structured checkpoint (manifest) and inject it into a new session's prompt

    Telling the agent exactly where to start with a summary of completed work is more reliable than resuming a bloated, broken session.

    • Use the --resume flag to reload the exact same conversation history

      Resuming a long history blindly often causes the model to repeat the same error that led to the crash.

    • Switch the model tier to Opus to handle the error state better

      A more capable model doesn't fix a state management failure; architectural recovery is required.

    • Increase the 'iteration_cap' in the agent's SDK settings

      Caps prevent infinite loops but do not help an agent recover lost state or context after a crash.

  17. 17 What is the primary architectural drawback of using a single 'monolithic' prompt for a task requiring 10 different specialist tools?

    Consider how an model's performance changes as you 'stuff' more requirements into a single turn.

    It leads to attention dilution and increased tool selection errors

    As prompts get larger and tools more numerous, the model's ability to precisely follow complex instructions and select the right tool degrades.

    • It prevents the use of prompt caching for stable prefixes

      Monolithic prompts can still be cached, although any minor change to the large prompt will break the cache for subsequent calls.

    • It makes it impossible to use the Message Batches API

      The Batch API can handle large prompts; the issue is one of logic and reliability, not API compatibility.

    • It forces the model to use the 'augmented LLM' pattern

      A monolithic prompt can be used in any pattern, but it is specifically problematic for reliable tool use in complex systems.

  18. 18 In the Model Context Protocol (MCP), what is the function of the 'isError' flag?

    Think about how the agent knows an 'Operation failed' message is a result rather than the actual intended output.

    To communicate tool failures back to the agent so it can decide how to recover

    Returning a structured error allows the agent to distinguish between valid data and failures, enabling retry or escalation logic.

    • To automatically terminate the agentic loop when a tool fails

      Termination is decided by the orchestrator or model; the flag simply provides the necessary information for that decision.

    • To notify the developer of a credential mismatch in .mcp.json

      Configuration errors are typically handled at the application or server log level, not within the runtime tool interaction flag.

    • To force the model to try a different tool automatically

      The model decides its next step based on the error message; it is not 'forced' into a specific action by the flag alone.

  19. 19 An architect is designing an iterative refinement loop where a coordinator evaluates a synthesis subagent's output. What should the coordinator do if it detects a data gap?

    Think about the next logical step in a loop when a required component is missing.

    Re-delegate to search subagents with targeted queries for the missing info

    Iterative refinement involves identifying specific weaknesses and spawning new turns to improve the final synthesis.

    • Increase the synthesis agent's temperature to encourage more detail

      Higher temperature increases randomness but cannot magically generate missing data that the agent does not have.

    • Append the entire coordinator history to the synthesis agent's prompt

      This causes massive context bloat and doesn't solve the problem if the information was never retrieved in the first place.

    • Terminate the loop and return a 'Confidence Low' error to the user

      While possible, the goal of an architectural refinement loop is to proactively fill the gap before returning a response.

  20. 20 Which scenario justifies the transition from a single-agent system to a multi-agent system?

    Look for a scenario where tasks can be done at the same time or must be kept strictly separate.

    When sub-tasks are truly independent or require distinct security permissions

    Parallelism and security isolation are the primary technical drivers for multi-agent complexity; otherwise, a single agent is more efficient.

    • When the total conversation history exceeds 2000 tokens

      Context length alone doesn't justify multiple agents; techniques like summarization or caching can manage a single agent's history.

    • When the task involves a 3-step linear data transformation pipeline

      Linear pipelines are handled better by a single agent with structured prompting to avoid handoff costs.

    • When the model used is from the Sonnet tier instead of Opus

      Model tier affects capability but doesn't dictate the architectural pattern, which should be based on task structure.