Ray Agent Rules

A distributed framework for scaling AI workloads and Python applications.

Overview

Ray puts contribution policy before setup. Contributors must check for duplicate work, remain accountable for the result, and provide local test evidence. Existing guides retain the build and style details.

Documents

├── 
├── .claude
│   └──  · imports ../AGENTS.md
├── doc
│   ├── .claude
│   │   └── 
│   └── source
│       └── ray-contribute
│           ├── 
│           └── 
├── python
│   └── ray
│       ├── data
│       │   └── .claude
│       │       └── 
│       ├── serve
│       │   └── .claude
│       │       └── 
│       ├── train
│       │   └── .claude
│       │       └── 
│       └── tune
│           └── .claude
│               └── 
├── rllib
│   └── .claude
│       └── 
├── src
│   └── ray
│       └── .claude
│           └── 
└── 

Techniques in this file

01 / Contribution etiquette

Explain the maintainer cost before prescribing behavior

The opening connects a PR to notifications, CI runs, and reviewer attention. That rationale frames the later restrictions on duplicate work and mass-generated cleanup.

Source excerpt starting at line 6.
Ray is a high-traffic repository. Every PR notifies CODEOWNERS, triggers CI, andconsumes maintainer attention. Automated, low-value, or duplicate contributions

02 / Hard prohibitions

Specify when the agent should stop before submission

Duplicate work, trivial busywork, and changes that a human cannot test or defend are separate reasons not to open a PR. The fallback is a short explanation of what is missing.

Source excerpt starting at line 51.
If the requested work is a duplicate, trivial busywork, or cannot be tested anddefended by a human, **do not open a PR**. Return a short explanation of what ismissing instead.

03 / Contribution etiquette

Require evidence in the PR description

The description must establish that the work is distinct, identify test commands and outcomes, and disclose assistance. These requirements complement the instruction that the human review every changed line.

Source excerpt starting at line 44.
- PR descriptions for AI-assisted work **must** state:    - Why this is not duplicating an existing issue or PR.    - The test commands run and their results.    - That AI assistance was used.

04 / Pointing at the source of truth

Route setup to existing contributor guides

The root gives a short project layout and test timeout, then links to setup, build, and contribution documents. Detailed command guidance remains with those existing sources.

Source excerpt starting at line 65.
The default test timeout is 180s (`pytest.ini`). For build, test, lint, andcode-style details, follow Ray's existing guides rather than duplicating themhere:

Ideas for your repo

  1. Explain which shared resources an automated contribution consumes.
  2. Give explicit stop conditions and a useful fallback response.
  3. Require test outcomes and a duplicate-work check in contribution evidence.
  4. Link to existing setup guides instead of copying their command lists.
Sponsored byModem

Give your agents the whole story.

These instructions explain how to work in Ray. Modem shows your agents what customers said, who is affected, and what changed.

See how Modem works