- Write log messages in plain language so users can immediately understand what happened.
- Keep log volume intentional: log key workflow steps at
info, add deeper diagnostics atdebug, and record failures witherrorplus useful context. - Do not emit repetitive or duplicate log lines for the same event.
- Keep logs visually consistent and easy to scan, including clean formatting for timestamps and message structure.