Skip to content

History and messages to the requester ("Updated the parser to...", "As requested", "Generated by AI", dated change notes) ​

Comments and text: one of the ways AI coding agents bloat software, from lessloc's pattern catalog. lessloc catches it as history.

What makes history and messages to the requester a bad practice? ​

The standard that calls it a bad practice: Clean Code C1 and Journal Comments: history belongs in source control.

What does lessloc do about history and messages to the requester? ​

lessloc catches it as history.

  • history (tier 3): Dates, change history or notes to the requester in comments.

Examples ​

Caught as history:

js
// Updated the parser to handle empty input, as requested
export const parse = s => s.trim();

Written well:

js
// Empty input is valid: forms post "" for untouched fields
export const parse = s => s.trim();

The other patterns in Comments and text:

Released under the Apache-2.0 license. · llms.txt