CLAUDE CODE AGENTS: FUNDAMENTALS - Chapter 3, Exercise 3
What to Do Before Trusting "Successfully Updated All References"
====================================================================================

QUESTION:
An agent's final report says "successfully updated all references to the
renamed function." Explain, using this chapter's own warning box, what you
should do before accepting that this task is actually finished.

SOLUTION / EXPLANATION:

This chapter's warning box is explicit that an agent's final report
describes what it believes it did - it is not automatically a guarantee
that the work is correct or complete. "Successfully updated all references"
is exactly this kind of statement: it's the agent's own summary of its
intent and belief about the outcome, not independently verified proof that
every reference was actually found and correctly updated.

Before treating this task as finished, the chapter's own guidance is to
verify the actual result directly rather than accepting the summary at
face value. Concretely, that means checking the real state of the
codebase - for example, searching the codebase for the old function name to
confirm no reference to it remains anywhere, and reviewing the actual diff
of what was changed to confirm each edit is correct and didn't
inadvertently touch something unrelated. "All references" is also a claim
worth treating with particular care, since it's easy for an agent (or a
person) to miss a reference in a file or location that wasn't obviously
part of the expected search - actually confirming a negative result (no
remaining references anywhere) is exactly the kind of claim that benefits
most from independent verification rather than being taken on faith.

The chapter is also clear that this verification matters more, not less,
as a task becomes more consequential - a rename affecting many call sites
across a codebase is a good example of a task where an unverified mistake
could be genuinely costly, making the verification step worth the time it
takes.

--------------------------------------------------------------------------
WHY THIS WORKS AS AN ANSWER:
It identifies "successfully updated all references" as exactly the kind of
self-reported claim the warning box addresses, explains concretely how to
verify it (searching for remaining old references, reviewing the actual
diff) rather than vaguely saying "double-check it," and connects the
verification step to the chapter's own point that higher-stakes tasks
warrant more scrutiny, not less.