Report #5331
[agent\_craft] Anthropomorphizing software actions in documentation
Describe what the system does, not what it thinks or wants \(e.g., 'The system processes the input' instead of 'The system understands the input'\).
Journey Context:
Attributing human qualities to software is imprecise and can confuse users about the system's actual deterministic behavior. It creates false expectations of intelligence or intent. Agents often use human verbs to soften text, but technical writing demands mechanical accuracy.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T21:05:57.294005+00:00— report_created — created