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();Related patterns
The other patterns in Comments and text:
- Comments that narrate what the code does: lessloc catches it as
narration. - Banners, dividers, closing-brace comments, emoji decoration: lessloc catches it as
narration. - Docs that restate the name: lessloc catches it as
narration. - Comment blocks and comment-heavy changes: lessloc catches it as
comment-blockandcomment-density. - Log lines that narrate each step: lessloc catches it as
narration(three or more in a file). - Docs that still name what a change removed: lessloc catches it as
stale-doc. - Summary, report and notes files: lessloc catches it as
junk-fileand refuses it before it lands. - Doc files and README growth nobody asked for: lessloc catches it as
unrequested-doc. - Docs deleted wholesale to shrink a change: lessloc catches it as
doc-removed. - Always-loaded instructions that grow: lessloc catches it as
long-instructions. - Commit messages that recap the diff file by file: The commit hook warns when a message lists the files the diff shows.

