R016 · drift-voice
Imperative voice (heuristic)
- Code: R016
- Slug:
drift-voice - Tier: heuristic
- Default severity: warning
- Packages: recommended, strict
- Locked: No
- Doc: https://doraval.dev/reference/rules/R016
| What | Heuristic: body uses imperative verbs (Create, Run, Verify, …) rather than only passive or suggestive phrasing. |
| Why | Agents follow directives. Trivia (“you might want to consider…”) is weaker than “Always use interactions.create().“ |
How to fix
Replace suggestions with commands:
| Weak | Stronger |
|---|---|
| You might want to run tests | Run the test suite before opening a PR |
| Consider using model X | Use model X — model Y is deprecated and returns errors |
Explain why when it helps the agent generalize.