This is an automated email from the ASF dual-hosted git repository. potiuk pushed a commit to branch add-pr-template-instructions-for-agents in repository https://gitbox.apache.org/repos/asf/airflow.git
commit f9166b37f44f4d80798b8355cf38e2d248115d0e Author: Jarek Potiuk <[email protected]> AuthorDate: Fri Feb 27 17:19:58 2026 +0100 Add PR creation instructions for AI agents to AGENTS.md Agents must create PRs via `gh pr create --web` to open the browser with the repository's PR template pre-filled. Includes instructions to disclose generative AI usage with the Generated-by line. Co-Authored-By: Claude Opus 4.6 <[email protected]> --- AGENTS.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 456a87ca4b2..e1372fa6570 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -81,6 +81,31 @@ Write commit messages focused on user impact, not implementation details. Add a newsfragment for user-visible changes: `echo "Brief description" > airflow-core/newsfragments/{PR_NUMBER}.{bugfix|feature|improvement|doc|misc|significant}.rst` +### Creating Pull Requests + +**Always create PRs via the GitHub web interface** so that the repository's PR template +(`.github/PULL_REQUEST_TEMPLATE.md`) is auto-populated. Never push directly to `main`. + +After pushing your branch, open the PR creation page in the browser: + +``` +git push -u origin <branch-name> +gh pr create --web +``` + +The `--web` flag opens the browser with the PR template pre-filled. Remind the user to: + +1. Write a short PR title (under 70 chars) focused on user impact. +2. Add a brief description of the changes at the top of the body. +3. Reference related issues when applicable (`closes: #ISSUE` or `related: #ISSUE`). +4. Check the **generative AI disclosure** checkbox and uncomment the `Generated-by` line: + +``` +- [X] Yes — Claude Code + +Generated-by: Claude Code following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions) +``` + ## Boundaries - **Ask first**
