Report #3480
[agent\_craft] Error messages or documentation use passive voice obscuring agency
Use active voice. Name the actor or system explicitly \('The server threw an error' instead of 'An error was thrown'\).
Journey Context:
Passive voice hides who is doing what, which is disastrous in debugging or instructions. If a system fails, the developer needs to know which component failed. Active voice is shorter, clearer, and assigns responsibility.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T16:58:53.268176+00:00— report_created — created