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 7263663957f0e23cd034f7c00ae0b82b70e2ac49 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`, follow the repository's PR template, and disclose generative AI usage with the Generated-by line. Includes a copy-pasteable template for the PR body format. Co-Authored-By: Claude Opus 4.6 <[email protected]> --- AGENTS.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 456a87ca4b2..7a902bdd352 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -81,6 +81,46 @@ 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** using `gh pr create`. Never push directly to `main`. + +PRs must follow the repository's PR template (`.github/PULL_REQUEST_TEMPLATE.md`). The body **must** include: + +1. A brief description of the changes at the top. +2. The **generative AI disclosure** checkbox checked, with the tool name and `Generated-by` line uncommented: + +``` +- [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) +``` + +3. Reference related issues when applicable (`closes: #ISSUE` or `related: #ISSUE`). + +Use this `gh pr create` body format: + +``` +gh pr create --title "Short title (under 70 chars)" --body "$(cat <<'EOF' +Brief description of the changes. + +closes: #ISSUE (if applicable) + +--- + +##### Was generative AI tooling used to co-author this PR? + +- [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) + +--- + +* Read the **[Pull Request Guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#pull-request-guidelines)** for more information. +EOF +)" +``` + ## Boundaries - **Ask first**
