CCA-F: Claude Certified Architect — Foundations

Question

You are developing developer-productivity tools with the Claude Agent SDK. The agent assists engineers in exploring unfamiliar codebases, understanding legacy systems, generating boilerplate code, and automating repetitive tasks. It uses the built-in tools (Read, Write, Bash, Grep, Glob) and integrates with Model Context Protocol (MCP) servers.

Your agent must insert a new helper function into the middle of a 150-line utility module, between two existing functions. The Edit tool fails because its old_string parameter cannot locate unique text to match—the file contains repetitive docstrings, variable names, and structural patterns. What is the most reliable way to perform this insertion?

Explanation

The managed-agent Edit tool performs string replacement and normally requires old_string to occur exactly once. When no dependable unique anchor exists, loading the complete file with Read, inserting the helper at the required location in the content, and replacing the file through Write produces a deterministic result. The Write tool accepts the full file contents, while replace_all would affect every matching occurrence.

Learn more

CCA-F: Claude Certified Architect — Foundations

AstroTutor

Notes

Readiness

QuestionQ79

Community Discussion