this article is a MUST read. it walks through the engineering decisions behind designing Claude Code tools. it shows one of the most interesting aspects of designing agent harnesses: it’s not just engineering, it’s an art. the agents always behave in unexpected ways, surprising you when you least expect it. anything that can go wrong, does go wrong at some point. you tweak one prompt, one tool description, and the agent starts reacting in a whole new way.