In #1432, the agent introduced some questionable guidance regarding the significance of the distinction between Tool and ToolSpec. I've myself found a lack of clarify on my part about the distinction but its firming up now, so it's time to document it.