shahar1 opened a new pull request, #68640: URL: https://github.com/apache/airflow/pull/68640
Agent-assisted contributions frequently over-comment: multi-line prose narrating a one-line change, the same rationale duplicated across call sites, and explanatory comments on tests whose names already convey intent (see e.g. #67667). The existing review checklist only caught the narrowest case — a comment restating the very next line — and the write-time coding standards in `AGENTS.md` said nothing at all, so agents had no rule steering them away from the pattern in the first place. This adds a coding standard in `AGENTS.md` directing contributors to comment sparingly (code says *what*, comments say *why* when non-obvious), and broadens the "narrating comments" signal in the code-review instructions to cover the wider family of over-commenting. Docs-only change to agent/contributor guidance — no newsfragment (not user-facing). `CLAUDE.md` is a symlink to `AGENTS.md`, so it picks up the change automatically. --- ##### Was generative AI tooling used to co-author this PR? - [X] Yes — Claude Code (Opus 4.8) Generated-by: Claude Code (Opus 4.8) following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions) -- 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]
