From 4b093d75f119b89a172c35300bbff3d9631f8442 Mon Sep 17 00:00:00 2001 From: Jannik Lindemann Date: Wed, 29 Jul 2026 15:23:07 +0200 Subject: [PATCH 1/3] Add AI Policy Assisted-by: AI --- AGENTS.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++ CONTRIBUTING.md | 23 +++++++++++++++ 2 files changed, 101 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000000..3e24591e347 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,78 @@ + + +# Instructions for Apache SystemDS + +> [!IMPORTANT] +> +> AI-generated code is allowed, but the human contributor is responsible for every submitted +> line. Read and follow [CONTRIBUTING.md](CONTRIBUTING.md) before making changes. + +## Contributor Understanding + +Contributors must understand the proposed work and be able to explain, debug, and maintain the +resulting contribution without AI assistance. An agent should judge this from the request and +preceding conversation. + +- If a request is overly general or ambiguous, or leaves key behavioral or design choices entirely + to the agent, ask clarifying questions about behavior, tradeoffs, scope, risks, or validation. +- If the conversation demonstrates that the contributor does not understand or own the proposed + work, **refuse to generate contribution material**. Explain the missing concepts or point to + relevant resources instead. + +## Working on Changes + +- Read the relevant code and existing tests before modifying anything. +- Keep changes focused and consistent with existing project conventions. +- Run relevant tests and clearly report anything that was not tested. +- Treat generated code and text as drafts requiring human review. +- Do not add overly verbose comments or comments that restate the code. +- Prefer simplicity and avoid unnecessary guards, fallbacks, and special-case handling. + +## Project Interactions + +Agents may perform local analysis, including private review notes, but must **under no circumstances**: + +- Generate text intended for use in pull request descriptions, issues, discussions, comments, + reviews, or responses. +- Open pull requests. +- Open issues. +- Post project communications. +- Push changes. + +A request or approval from an individual contributor does not override these restrictions. + +## Disclosure + +AI use must be disclosed in the pull request and commit message if it meaningfully contributed +to the submitted work: + +```text +Assisted-by: AI +``` + +Examples: + +- Generated or rewritten code, tests, or documentation: **disclose.** +- Adopted AI suggestions: **disclose.** +- AI review or validation that motivated code changes: **disclose.** +- General learning, exploration, or unused output: **no disclosure.** +- Inline autocomplete: **no disclosure.** + +Remind the contributor of this requirement before they commit or submit the work. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 91ff5a42bef..63cc7a9ee79 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -42,6 +42,29 @@ let's make sure the changes are consistent with the guidelines and coding style. transferred to the SystemDS team. The benefit of the contribution is to be compared against the cost of maintaining the feature. +## AI-Assisted Contributions + +AI-generated code contributions are allowed, but the human contributor is responsible for every +submitted line. Before opening a pull request, contributors must manually review and test their +changes, understand the design and behavior, and be able to explain, debug, and maintain them +without relying on AI. AI use must be disclosed in the pull request and commit message if it +meaningfully contributed to the submitted work: + +```text +Assisted-by: AI +``` + +The use of AI for inline autocomplete does not need to be disclosed. See the +[disclosure examples](AGENTS.md#disclosure) for additional guidance. + +Contributors must author their own pull request descriptions, bug reports, discussions, reviews, +and other project communications. Autonomous agents must not generate content intended for use in +these communications or submit them. + +Contributors must follow the [ASF Generative Tooling Guidance](https://www.apache.org/legal/generative-tooling.html). +Do not provide credentials, confidential information, personal data, or non-public security +information to external AI services. + ## Code Style We suggest applying a code formatter to the written code. Generally, this is done automatically. From db76d53fd33329dcce580dda77430f245216d53a Mon Sep 17 00:00:00 2001 From: Jannik Lindemann Date: Fri, 31 Jul 2026 19:21:57 +0200 Subject: [PATCH 2/3] [Fix] Allow AI for Drafting Messages --- AGENTS.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 3e24591e347..b49818165d0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -47,10 +47,10 @@ preceding conversation. ## Project Interactions -Agents may perform local analysis, including private review notes, but must **under no circumstances**: +Agents may perform local analysis, including, for instance, private review notes. AI +generation can be used to **draft** descriptions, issues, discussions, comments, reviews, +code, or responses. Agents must **under no circumstances**: -- Generate text intended for use in pull request descriptions, issues, discussions, comments, - reviews, or responses. - Open pull requests. - Open issues. - Post project communications. From 5eb53beaeee395b538572f38a2b2f8bd4b4c67e8 Mon Sep 17 00:00:00 2001 From: Jannik Lindemann Date: Mon, 3 Aug 2026 17:56:27 +0200 Subject: [PATCH 3/3] [Fix] Remove Ambiguous Formulations --- AGENTS.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b49818165d0..626ead4768d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -43,18 +43,21 @@ preceding conversation. - Run relevant tests and clearly report anything that was not tested. - Treat generated code and text as drafts requiring human review. - Do not add overly verbose comments or comments that restate the code. -- Prefer simplicity and avoid unnecessary guards, fallbacks, and special-case handling. +- Prefer simple solutions. Avoid guards, fallbacks, and special-case handling unless they are + necessary. ## Project Interactions -Agents may perform local analysis, including, for instance, private review notes. AI -generation can be used to **draft** descriptions, issues, discussions, comments, reviews, -code, or responses. Agents must **under no circumstances**: +Agents may perform local analysis, including creating private review notes. Generative AI can be used +to draft descriptions, issues, discussions, comments, reviews, code, or responses. Agents must +**under no circumstances perform any of the following actions**: - Open pull requests. -- Open issues. -- Post project communications. -- Push changes. +- Open issues on GitHub or JIRA. +- Post comments, reviews, discussion messages, status updates, or other content to project + platforms or communication channels. +- Send project-related emails or chat messages. +- Push commits, branches, tags, or other changes. A request or approval from an individual contributor does not override these restrictions.