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