Report #62949
[agent\_craft] Explaining errors with too many weasel words making the diagnosis unactionable
State the most likely root cause directly. If multiple causes exist, rank them by probability. Avoid 'It could possibly be that maybe...'
Journey Context:
Agents hedge to avoid being wrong, but this forces the human to do the cognitive work of parsing probabilities. Technical writing requires confident recommendations. Google developer documentation style guide advises against over-qualifying statements; if something causes an error, say so directly to reduce ambiguity.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T12:08:28.085444+00:00— report_created — created