Claude Architect Foundations
How to design, configure, and troubleshoot Claude-based agentic systems by reasoning about the agentic loop, MCP tool design, Claude Code workflows, structured prompting, and context management.
A complete interactive classroom, not just a preview.
Start when you are ready to enter this Stage's 14 scenes and explore, respond, and learn as you go.
How do you make sound architecture and tradeoff decisions when building production-grade agentic systems with Claude?
- agentic-loop
- The request → stop_reason inspection → tool execution → result injection loop and how to control termination.
- multi-agent-orchestration
- Hub-and-spoke coordinator-subagent patterns with isolated subagent context and dynamic delegation.
- subagent-invocation
- Task tool mechanics, allowedTools requirements, AgentDefinition, and explicit context passing.
- workflow-enforcement
- Programmatic prerequisites, structured handoff protocols, and where prompts alone are insufficient.
- agent-sdk-hooks
- PostToolUse and pre-tool interception for normalization and compliance guarantees.
- session-state
- Session resumption, fork_session, and choosing between resume and fresh-with-summary.
- tool-interface-design
- Writing clear, non-overlapping tool descriptions and splitting generic tools by purpose.
- mcp-error-handling
- Structured error metadata via isError, errorCategory, and isRetryable flags.
6 more
The agentic loop should be terminated by parsing natural-language signals from the assistant text.
Show that stop_reason is the authoritative termination signal: 'tool_use' continues the loop, 'end_turn' exits.
Subagents automatically inherit the coordinator's conversation history and memory.
Establish that subagent context is isolated and must be passed explicitly in the prompt.
Adding more tools to an agent makes it more capable and productive.
Demonstrate that excessive tools (e.g., 18 vs 4-5) degrade selection reliability and cause cross-role misuse.
Detailed system-prompt instructions alone are sufficient to enforce deterministic workflow ordering like identity verification before refunds.
Show that prompt instructions have a non-zero failure rate and programmatic hooks/prerequisites are required for guaranteed compliance.
Resuming a session with stale tool results is always preferable to starting a new session with an injected summary.
Establish when fresh-with-summary is more reliable than resume, particularly after the underlying code or data has changed.
- Hands-on experience with the Claude API and tool use
- Familiarity with the Claude Agent SDK and Claude Code CLI
- Working knowledge of JSON Schema and MCP servers
- Production experience with agentic or multi-step LLM workflows
- Detailed Anthropic API pricing tiers
- General LLM theory unrelated to Claude
- Non-Claude IDE integrations beyond Claude Code
- Marketing or sales content around Claude products
- Identify the correct stop_reason handling pattern for an agentic loop.
- Distinguish coordinator-subagent context isolation from automatic inheritance.
- Choose appropriate tool scoping and tool_choice settings for a given subagent role.
- Select hooks vs prompt instructions for compliance-critical enforcement.
- Decide between session resumption and a fresh session with summary based on staleness.
- Apply CCAR-F blueprint reasoning to a new production scenario not covered in the exam, selecting the right architecture, tool design, prompt pattern, and reliability strategy.
Solution architects with 6+ months of hands-on experience building with Claude API, the Agent SDK, Claude Code, and MCP, preparing for the CCAR-F certification exam.
- 01Exam Overview and BlueprintslideOrientationObserve
Orient the learner to the CCAR-F exam structure, domain weights, and scenario-based format.
- 60 items, 4 of 6 scenarios, 120 minutes, scaled pass 720
- Five domains: Agentic Architecture (27%), Claude Code (20%), Prompt Engineering (20%), Tool Design & MCP (18%), Context & Reliability (15%)
- Six real-world scenarios: support agent, code generation, multi-agent research, dev productivity, CI/CD, structured extraction
- 02The Agentic LoopslideModel buildingExplain
Establish the canonical request → tool execution → stop_reason loop that underpins every Claude agent.
- Send request → inspect stop_reason ('tool_use' vs 'end_turn') → execute tool → append result → repeat
- Tool results are appended to conversation history so Claude reasons over new evidence
- Model-driven decisions vs pre-configured trees: let Claude choose the next tool from context
- 03Loop Control SimulatorinteractiveMisconception repairPredict
Let learners step through iterations and observe how stop_reason drives termination, not assistant text.
- Observe the loop continues while stop_reason is 'tool_use'
- Predict when the loop should terminate based on stop_reason, not parsed text
- Compare correct vs anti-pattern termination logic
- 04Coordinator–Subagent OrchestrationslideModel buildingExplain
Explain hub-and-spoke multi-agent design with isolated subagent contexts and dynamic delegation.
- Coordinator owns decomposition, delegation, aggregation, and error routing
- Subagents do not inherit coordinator context — pass findings explicitly in the prompt
- Avoid over-narrow decomposition; design adaptive investigation plans, not fixed pipelines
- 05Task Tool and Agent DefinitionslideModel buildingExplain
Cover the mechanics of spawning subagents, allowedTools, and parallel Task calls in one turn.
- Task tool requires allowedTools to include 'Task' for the coordinator
- AgentDefinition: description, system prompt, restricted tool set
- Emit multiple Task calls in a single coordinator response to run subagents in parallel
- 06Check: Orchestration FundamentalsquizAssessment
Validate understanding of agentic loop and multi-agent orchestration before moving to tool design.
- stop_reason-based termination
- Subagent context isolation
- Coordinator's role in delegation
- 07Enforcement, Hooks, and HandoffsslideMisconception repairExplain
Distinguish programmatic enforcement from prompt-based guidance and show structured handoff patterns.
- Deterministic compliance needs hooks/pre-requisites, not just prompt instructions
- PostToolUse hooks normalize heterogeneous data formats before the model reasons
- Structured handoff (customer ID, root cause, recommended action) for human escalation
- 08MCP Tool Interface DesignslideModel buildingExplain
Teach how tool descriptions drive selection and how to avoid overlap and misuse.
- Tool descriptions are the primary selection signal — be specific about inputs, outputs, boundaries
- Rename and split generic tools to remove functional overlap (e.g., extract_web_results, extract_data_points)
- Audit system prompts for keyword-sensitive phrasing that overrides tool descriptions
- 09MCP Errors and Tool DistributionslideModel buildingExplain
Cover structured error metadata and per-agent tool scoping with tool_choice configuration.
- Return isError + errorCategory + isRetryable + description so the agent can decide
- Scope tools per role (4–5 tools) to keep selection reliable; replace generic tools with constrained ones
- tool_choice: 'auto', 'any', or forced {'type':'tool','name':'...'} for deterministic first steps
- 10Claude Code ConfigurationslideModel buildingExplain
Walk through CLAUDE.md, Agent Skills, plan mode, and custom slash commands for team workflows.
- CLAUDE.md sets team-wide instructions read at session start
- Plan mode requires user approval before edits — use for non-trivial changes
- Custom slash commands and Agent Skills codify recurring workflows
- 11Prompt Engineering for Structured OutputslideModel buildingExplain
Show reliable patterns for JSON schemas, few-shot examples, and extraction from unstructured docs.
- Provide a JSON schema and instruct the model to conform strictly
- Use few-shot examples to lock in format and edge-case behavior
- Combine schema + extraction patterns + validation hooks for high-accuracy pipelines
- 12Context Management and ReliabilityslideSynthesisApply
Synthesize context window, session resumption, and reliability patterns into a unified mental model.
- Pass context explicitly between agents; use structured formats separating content from metadata
- Choose --resume for valid prior context; start fresh with a summary when tool results are stale
- Design self-evaluation checkpoints and human-in-the-loop escalation for production reliability
- 13Scenario Lab: Support Resolution AgentpblApplicationConstruct
Learners design the architecture, tool set, prompts, and escalation policy for Scenario 1 from the blueprint.
- Choose stop_reason loop pattern and subagent delegation strategy
- Specify MCP tool descriptions, scoping, and structured error responses
- Decide where hooks enforce compliance vs where prompts suffice
- Design handoff summary structure for human escalation
- 14Final Practice CheckquizAssessment
Mixed-domain assessment covering tool
Discussion threads for a Stage aren't available yet.