R019 · drift-clarity
Clarity (heuristic)
- Code: R019
- Slug:
drift-clarity - Tier: heuristic
- Default severity: warning
- Packages: recommended, strict
- Locked: No
- Doc: https://doraval.dev/reference/rules/R019
| What | Heuristic: flags ambiguous hedging in the body (maybe, possibly, consider, you might want to, perhaps). |
| Why | Hedge words leave the agent without a decision. Under load, vague skills produce inconsistent results. |
How to fix
Replace hedges with a decision or a condition (“If X, do Y; otherwise Z”). Pair with R022 for deeper LLM clarity review.