R014 · drift-trigger
Trigger clarity (heuristic)
- Code: R014
- Slug:
drift-trigger - Tier: heuristic
- Default severity: warning
- Packages: recommended, strict
- Locked: No
- Doc: https://doraval.dev/reference/rules/R014
| What | Heuristic: description (and when_to_use when present) includes an activation cue such as Use when…, trigger, or invoke. |
| Why | Without a when-clause the agent has no reliable signal to load the skill. Size alone is R005; semantic specificity is R025. |
How to fix
Rewrite the description to include capability and situation:
Use when working with PDF files. Do NOT use for general document editing,
spreadsheets, or plain text files.Optional: a short quoted user phrase (“review this PR”). Include a negative case when over-apply is likely.