bneradt opened a new pull request, #13931: URL: https://github.com/apache/trafficserver/pull/13931
AI-generated patches frequently carry low-value comments: narration of what the code does, restated signatures and types, review-round residue, tracker tags, agent names, and descriptions of previous behavior. These add noise and rot quickly, and the existing one-line rule about comments was not enough to prevent them. This patch replaces that rule with a Comments section in both agent instruction files stating that comments should explain why rather than what, describe responsibilities and semantics rather than types, and leave historical context to commit messages and PRs. The guidance applies across the code base, including tests, Python, CMake and replay YAML files. Co-authored-by: Claude Opus 5.5 Medium <[email protected]> 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
