Your lookup_order tool is being called with malformed inputs. About 6% of calls pass order IDs like "order-1234" or "#1234" instead of the bare numeric form the backend expects. The tool currently returns a generic {"error": "Order not found"} for these, and the agent then escalates the case. Which fix best matches the documented tool-design pattern?
Scenario 1: Customer Support Resolution Agent | Domain 2 — Tool Design & MCP
You're deciding whether process_refund should be a single tool or split into two: initiate_refund (which puts the refund in a pending state) and confirm_refund (which commits it). Refunds above $200 require manager review under your policy. Which decomposition fits the documented agent-design principles best?
Scenario 1: Customer Support Resolution Agent | Domain 1 — Agentic Architecture
Your team is debating tool description style. One engineer writes terse descriptions ("Refunds an order"); another writes long ones with examples, edge cases, and explicit guidance on when to prefer this tool over alternatives. Production accuracy data shows the longer descriptions outperform terse ones by 8 percentage points on tool-selection correctness. What is the documented principle here?
Scenario 1: Customer Support Resolution Agent | Domain 2 — Tool Design & MCP
Your agent's conversation summarization kicks in at 70% context utilization. After summarization, the agent occasionally forgets a billing exception it had agreed to mid-conversation ("we'll waive the late fee given the circumstances"). Spot-checking confirms the summarization step is condensing the agreement into something vague like "discussed billing concerns." Which approach addresses the root cause?
Scenario 1: Customer Support Resolution Agent | Domain 5 — Context Management & Reliability
Your agent's loop reads each model response and decides whether to continue or terminate. A new engineer proposes a heuristic: "if the assistant's text contains a question mark, the model is asking the user something, so terminate the loop and wait for input; otherwise iterate." Initial testing looks promising. What is the architectural problem with this design?
Scenario 1: Customer Support Resolution Agent | Domain 1 — Agentic Architecture
Your agent's resolution responses occasionally include speculative information not derivable from tool results — e.g., asserting a refund will arrive on a specific date when no tool returned a date. The model is confabulating timeline details when uncertain. Which intervention is the documented fix?
Scenario 1: Customer Support Resolution Agent | Domain 4 — Prompt Engineering
You're adding a new MCP tool get_account_balance(account_id). The backend returns {balance, currency, as_of_timestamp, pending_transactions[]}. The agent only needs balance and as_of_timestamp for the common "what's my balance?" question; pending_transactions is occasionally relevant. Returning everything bloats context across many turns. Which design fits?
Scenario 1: Customer Support Resolution Agent | Domain 2 — Tool Design & MCP
A customer escalation policy says: "If the customer indicates dissatisfaction, immediately route to a human." Your agent applies this — but production data shows ~14% of routed cases involved phrases like "this is frustrating" used about a product, not the agent's handling. Customers report they did NOT want a human; they wanted the agent to keep helping. What's the most appropriate refinement?
Scenario 1: Customer Support Resolution Agent | Domain 5 — Context Management & Reliability
Your team is onboarding a fourth developer to Claude Code. The existing three have personalized ~/.claude/CLAUDE.md files reflecting their individual preferences (preferred test framework, commit message style, verbosity). The new developer asks how to get started. What is the documented onboarding guidance?
Scenario 2: Code Generation with Claude Code | Domain 3 — Claude Code Configuration
A regulatory requirement forces your agent to log a "decision rationale" with each refund issued — a short structured record of why the agent chose that resolution, what alternatives it considered, and what policy applies. The team wants the rationale generated as part of the resolution flow, not after the fact. Which design fits?
Scenario 1: Customer Support Resolution Agent | Domain 5 — Context Management & Reliability
You want Claude Code to automatically run pnpm install whenever a developer edits package.json. The action should fire on every save, not require manual invocation, and should happen regardless of which session is open. Which mechanism fits?
Scenario 2: Code Generation with Claude Code | Domain 3 — Claude Code Configuration
A developer is debugging a flaky CI job. They start a Claude Code session, examine logs, hypothesize a race condition, write a fix, and run the test 8 times to confirm it passes. The fix works. Two weeks later, the same flaky behavior returns. The developer wants to resume the prior diagnostic session to compare what they learned. Which best matches the documented pattern?
Scenario 2: Code Generation with Claude Code | Domain 1 — Agentic Architecture
Your CLAUDE.md says "always use the team's logger (@/lib/logger) rather than console.log for instrumentation." A developer reports Claude Code repeatedly proposes console.log in debug code. Investigation reveals the developer's session has been open for 3 hours with many topic switches, and other instructions have accumulated in the prompt over time. Which is the most appropriate first step?
Scenario 2: Code Generation with Claude Code | Domain 3 — Claude Code Configuration
You're using Claude Code's Task capability to spawn a subagent that runs a long-running codebase analysis (~6 minutes). The main session is meanwhile blocked waiting. You want the main session to remain responsive to short interactive questions from the developer while the subagent runs in the background. What is the documented limitation?
Scenario 2: Code Generation with Claude Code | Domain 1 — Agentic Architecture
You have an existing .claude/commands/test-fix.md slash command that runs the test suite and proposes fixes. A developer wants to extend it to also run npm run lint before testing. The change should be team-wide. Which approach matches documented practice?
Scenario 2: Code Generation with Claude Code | Domain 3 — Claude Code Configuration
A customer reports an issue affecting their entire shipping history. Resolving it requires the agent to investigate orders going back 18 months — potentially 60+ lookup_order calls. The agent currently iterates through them one at a time and the conversation takes ~12 minutes. The investigation phase is "embarrassingly parallel" — each order lookup is independent. Which architectural change matches the documented parallelization pattern?
Scenario 1: Customer Support Resolution Agent | Domain 1 — Agentic Architecture
A developer is using Claude Code to refactor a large module. After ~40 minutes, the session has accumulated detailed context about the module's structure, several reads of dependent files, and an evolving plan. The developer hits a confusing test failure and asks Claude Code to "diagnose this specific test failure." Claude Code's response weaves in details from the refactor planning that are irrelevant to the test failure. Which is the best fix?
Scenario 2: Code Generation with Claude Code | Domain 5 — Context Management & Reliability
Your team's .claude/rules/conventions.md uses paths: ["src/**/*.ts"] to scope TypeScript rules to source files. A developer reports that when they edit a .ts file inside __tests__/ directories, the conventions don't load — but they want test files to also follow these conventions. What's the right change?
Scenario 2: Code Generation with Claude Code | Domain 3 — Claude Code Configuration
Your project's .mcp.json includes a server internal-tools that the team uses heavily. A new contractor joining temporarily should not have access to internal-tools but should have access to all other configured servers. The contractor will work in the same repo. What is the documented mechanism?
Scenario 2: Code Generation with Claude Code | Domain 3 — Claude Code Configuration
Your team uses plan mode for architectural changes. A developer in plan mode produces a comprehensive plan over 25 minutes. The plan is solid but execution will touch ~40 files. The developer wants to execute the plan in stages with checkpoints, so they can review progress and back out if things go wrong. Which workflow fits?
Scenario 2: Code Generation with Claude Code | Domain 1 — Agentic Architecture