From c880799eb892e0f1132fd864151844ee00329fcd Mon Sep 17 00:00:00 2001
From: David Li <li.davidm96@gmail.com>
Date: Mon, 26 Oct 2026 09:07:01 +0900
Subject: [PATCH] MINOR: Add AI guidance and PR limit

For consistency with apache/arrow and apache/arrow-adbc. While
contributors are tackling some useful work, it is getting
unmanageable given the limited number of maintainers.
---
 .asf.yaml                         |  4 +++
 .github/workflows/comment_bot.yml | 42 -------------------------------
 AGENTS.md                         | 23 +++++++++++++++++
 CONTRIBUTING.md                   |  3 +++
 4 files changed, 30 insertions(+), 42 deletions(-)
 delete mode 100644 .github/workflows/comment_bot.yml
 create mode 100644 AGENTS.md

diff --git a/.asf.yaml b/.asf.yaml
index 13bd59c224..10a014236c 100644
--- a/.asf.yaml
+++ b/.asf.yaml
@@ -34,6 +34,10 @@ github:
   protected_branches:
     main:
       required_linear_history: true
+  pull_requests:
+    creation_cap:
+      enabled: true
+      max_open_pull_requests: 2
 notifications:
   commits: commits@arrow.apache.org
   discussions: user@arrow.apache.org
diff --git a/.github/workflows/comment_bot.yml b/.github/workflows/comment_bot.yml
deleted file mode 100644
index 507d6a969c..0000000000
--- a/.github/workflows/comment_bot.yml
+++ /dev/null
@@ -1,42 +0,0 @@
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#   http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-
-name: Comment Bot
-on:
-  issue_comment:
-    types:
-      - created
-      - edited
-jobs:
-  issue_assign:
-    name: "Assign issue"
-    permissions:
-      contents: read
-      issues: write
-    if: github.event.comment.body == 'take'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v9
-        with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          script: |-
-            github.rest.issues.addAssignees({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.payload.issue.number,
-                assignees: context.payload.comment.user.login
-            });
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000..b31518f3d7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,23 @@
+<!---
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+
+# AGENTS.md
+
+You must follow the guidance around pull requests and commits in
+@CONTRIBUTING.md.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 680750070f..3cd33d4f93 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -19,6 +19,9 @@
 
 # How to contribute to Apache Arrow Java
 
+Please see general guidance about commits, pull requests, and AI usage for the
+Apache Arrow project: https://arrow.apache.org/docs/dev/developers/overview.html
+
 ## Did you find a bug?
 
 The Arrow Java project uses GitHub as a bug tracker.  To report a bug, sign in