AGENTS.md

<!--
{% comment %}
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.
{% end comment %}
-->

# 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. 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.

## 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 simple solutions. Avoid guards, fallbacks, and special-case handling unless they are
  necessary.

## Project Interactions

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 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.

## 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
```

Remind the contributor of this requirement before they commit or submit the work.