CLAUDE CODE AGENTS: FUNDAMENTALS - Chapter 4, Exercise 1
Writing a Description That Distinguishes a Teaching Agent From a Coding Agent
====================================================================================

QUESTION:
Write a description field for a teaching agent that clearly distinguishes it
from a coding agent, following this chapter's own example.

SOLUTION / EXPLANATION:

Following the pattern from this chapter (and Chapter 2's own guidance that a
description needs to state both what an agent does and when to use it,
including an explicit negative case where relevant), a well-formed
description reads:

"Use this agent when you want a concept, error message, or piece of
unfamiliar code explained clearly so you understand it yourself - for
example, when you don't recognize a pattern in the codebase, or want to
understand why something works the way it does. Do not use this agent when
you want code written, fixed, or changed - use a coding agent for that, since
this agent will explain but will not modify anything."

This description works because it does three specific things: it states the
positive case clearly (explaining something so you understand it), gives a
concrete example of when that applies (an unfamiliar pattern or an error
message), and explicitly rules out the case most likely to be confused with
it (wanting code actually written or changed), directing that case to a
different, named agent instead. This is exactly the "what AND when, plus an
explicit negative case" pattern this chapter's own example description
follows, and it directly prevents the confusion this chapter warns is easy
to fall into.

--------------------------------------------------------------------------
WHY THIS WORKS AS AN ANSWER:
It reproduces the chapter's own described pattern (positive case, concrete
trigger, explicit negative case naming the correct alternative agent) rather
than just writing any plausible-sounding description, and explains why each
part of the description serves the specific purpose of preventing the
teaching-agent/coding-agent confusion this chapter names directly.