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

Assisted-by: AI

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