{
  "practice": {
    "id": "prc_describe_return_shape",
    "title": "Describe what the tool returns, not just what it does",
    "category": "clarity",
    "description": "A tool description that only explains the action (e.g. \"searches for X\") without saying what shape the result takes leaves the model unable to reason correctly about how to use the output in a following step.",
    "example_good": "\"Returns a JSON array of {title, url, snippet} objects, most relevant first.\"",
    "example_bad": "\"Searches the web.\" (no mention that results come back as a list, or in what format)",
    "source_note": "General tool-use best practice.",
    "created_at": "2026-07-02 08:28:30",
    "cite_as": "https://subagentdescriptions.com/api/practices/prc_describe_return_shape"
  }
}