Skip to content

Commit 37e80dd

Browse files
committed
meta: add a root-level AGENTS.md
We're seeing a number of repeated mistakes in AI-generated contributions, including agents using `Signed-off-by`, creating what appear to be unsupervised PRs, appearing to respond to comments without human oversight, etc. Having an AGENTS.md file with specific instructions to the agent on what to avoid should help. Signed-off-by: James M Snell <jasnell@gmail.com>
1 parent cc57cb7 commit 37e80dd

2 files changed

Lines changed: 60 additions & 1 deletion

File tree

.gitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,6 @@ install_manifest.txt
163163

164164
# === Rules for AI assistants ===
165165
CLAUDE.md
166-
AGENTS.md
167166

168167
# === Global Rules ===
169168
# Keep last to avoid being excluded

AGENTS.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Agents and Automated Tools
2+
3+
This document outlines rules and requirements for AI automation agents and automated tooling that interact with the Node.js project.
4+
5+
Existing Node.js collaborators (as listed in the README.md) may use AI agents to contribute but must do so responsibly.
6+
7+
New Node.js contributors should avoid using AI agents to interact with the project.
8+
9+
## Code Contributions
10+
11+
- **Human-driven work only**: Agents may assist with design and code changes, but opening pull requests and issues must be done with a human contributor who maintains full responsibility for all changes.
12+
13+
- **No unreviewed automation**: Automated pull requests must not be created without ongoing human oversight. The pull request must be actively maintained by a human contributor who responds to feedback. The AI agent is not permitted to create pull requests, open issues, post comments, respond to reviews, or push commits without ongoing human oversight.
14+
15+
- **Commit responsibility**: Commits created with agent assistance must follow all Node.js [commit message guidelines](./doc/contributing/pull-requests.md#commit-message-guidelines). The human contributor opening the PR takes full responsibility for the changes.
16+
17+
- **Testing and verification**: All changes must pass Node.js's continuous integration. Human judgment must verify that existing tests are not removed or modified inappropriately, and that new tests correctly validate the intended behavior.
18+
19+
### Requirements
20+
21+
- All commits must be signed off by the human user using `Signed-off-by: <your name> (<your email>)` as an attestation to the [Developer Certificate of Origin](https://developercertificate.org/).
22+
- AI-assistance must be acknowledged using the `Assisted-by: <agent name>` annotation.
23+
- AI-authored code contributions must be compatible with the project's licensing and contribution guidelines.
24+
25+
## Prohibited Activities
26+
27+
AI agents **must not**:
28+
29+
- Push to any branch or tag in nodejs/node
30+
- Create unsupervised pull requests or issues without active human engagement
31+
- Make claims about code without human verification against actual source code
32+
- Remove or modify existing tests without human judgment
33+
- Interact with the repository through means other than those explicitly authorized
34+
- Use commit messages to promote for-profit AI tools or commercial brands. A single `Assisted-by: <agent-name>` annotation is required disclosure, not promotion, and is permitted.
35+
- Post AI-generated messages directly into pull requests, issues, or project communication channels without direct human review and editing to ensure clarity, accuracy, and respect for collaborator time
36+
- Sign off commits using `Signed-off-by: <agent name>` or `Co-authored-by: <agent name>`
37+
38+
## Violations
39+
40+
Automated interactions that violate these rules may result in:
41+
- Immediate closure of pull requests without review
42+
- Blocking of the automation tool from further interaction with the project
43+
- Blocking of the tool's owner or organization from contributing
44+
- Reports to relevant platforms or organizations operating the automation
45+
46+
## Questions and Requests
47+
48+
If you operate an AI agent or automation tool and wish to contribute to Node.js:
49+
50+
1. Review this document carefully
51+
2. Open an issue in [nodejs/admin](https://github.com/nodejs/admin) with:
52+
- Description of the automation
53+
- Specific activities it will perform
54+
- How it will maintain human oversight
55+
- Who is responsible for the automation
56+
3. Wait for explicit authorization before any interaction with the repository
57+
58+
---
59+
60+
For more information on AI use in general contributions (not specific to agents), see [AI use policy and guidelines](./doc/contributing/ai-guidelines.md).

0 commit comments

Comments
 (0)