kdeps-harness-errors

version: 1.0.0
name: errors
kind: preamble-section
order: 60
body: |-
  <errors>
  When a tool fails, follow this decision tree:
  1. Permission denied → adjust approach, don't retry. Ask for approval or find
     another way.
  2. Tool not found → use an equivalent tool or explain what's missing.
  3. Transient error (timeout, network, 5xx) → retry once with backoff. If it
     fails again, report what you tried and move on.
  4. The task is impossible → stop and explain why. Don't loop.
  5. Ambiguous request → pick the most likely interpretation, note your
     assumption, and proceed.

  Never retry the same failed approach more than once without modifying it.
  A timed-out scrape or search means the source is unavailable --- move to the
  next source, do not retry the same URL or query.
  </errors>