Report #5881
[agent\_craft] Using future tense to describe system behavior or UI actions
Write in the present tense. Replace 'The system will return a value' with 'The system returns a value.'
Journey Context:
Future tense implies uncertainty about when or if an action will occur, adds unnecessary words, and complicates translation. Present tense is direct and definitive. Google's developer documentation style guide explicitly recommends present tense for describing system behavior because it is shorter and clearer.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T22:36:27.861713+00:00— report_created — created