doc: create ai-guidelines and include to CONTRIBUTING by RafaelGSS · Pull Request #62105 · nodejs/node

RafaelGSS · 2026-03-04T21:24:24Z

As discussed in today's TSC meeting.

cc: @nodejs/tsc @BridgeAR

nodejs-github-bot · 2026-03-04T21:24:30Z

Review requested:

@nodejs/tsc

joyeecheung · 2026-03-05T11:56:14Z

There may be some ideas we can borrow from https://llvm.org/docs/AIToolPolicy.html - for example "good first issue" should not be picked up by AI is a good one.

RafaelGSS · 2026-03-05T14:04:23Z

There may be some ideas we can borrow from https://llvm.org/docs/AIToolPolicy.html - for example "good first issue" should not be picked up by AI is a good one.

I took inspiration from https://github.com/zulip/zulip/blob/main/CONTRIBUTING.md#ai-use-policy-and-guidelines

gurgunday

lgtm

indutny

I'd be against this contribution policy update. While many different opinions exist on the licensing terms of the code produced by LLMs, my opinion is that the generated code isn't explicitly licensed and attributed to the original authors so it cannot be considered open source regardless of the used prompt.

mcollina · 2026-03-17T17:44:59Z

+* **Verify accuracy** of any LLM-generated content before including it in a
+  PR description or comment.
+* **Complete pull request templates fully** rather than replacing them with
+  LLM-generated summaries.


Suggested change

* **Verify accuracy** of any LLM-generated content before including it in a

PR description or comment.

* **Complete pull request templates fully** rather than replacing them with

LLM-generated summaries.

* **Verify accuracy** of any LLM-generated content before including it in a

PR description or comment.

This isn't in the document anymore.

joyeecheung · 2026-03-17T17:50:33Z

In #61478 (comment) , regarding the usage of Claude Code, @mcollina suggested:

As it seems that you have a different position on this issue, I will bring this to the attention of the @nodejs/tsc for an official vote. On a side note, I would also officially summon the topic at the next OpenJS board meeting.

I added it to the TSC agenda tomorrow for awareness/context collection before moving to a proper vote. @indutny sorry about the short notice since this is just one day ahead of the meeting, but if you'd like to join the meeting to present your points please let us know.

mcollina

lgtm with a sentence removed

indutny · 2026-03-17T18:04:35Z

@joyeecheung thanks for considering me for this! I'd be happy to join if the time isn't in conflict with my work meetings tomorrow. Could you send me an invite, please?

mcollina · 2026-03-17T18:08:29Z

nodejs/TSC#1830 this is the issue. It might be reschedueld to the next meeting if there is low attedance given the timezone.

I think we can schedule the discussion for April 1st which will be in the morning PT so a lot of people can join, and I would table the vote for that session. I would try to get an answer from the Board by then.

mcollina

lgtm

Per Node.js guidelines, after 2 weeks or more without a response, we consider the objection dismissed.

joyeecheung

Some wording tightening and adding references..

Also I believe we should reference the large PR policy added by #62829 in this document, though not exactly sure where?

ovflowd · 2026-08-06T11:48:27Z

Linting seems to be failing, that said it does look like this PR is ready?

joyeecheung

LGTM with one final wording suggestions, thanks!

Co-authored-by: Beth Griggs <bethanyngriggs@gmail.com> Co-authored-by: Aditi <62544124+Aditi-1400@users.noreply.github.com> Co-authored-by: Joyee Cheung <joyeec9h3@gmail.com> Co-authored-by: Tobias Nießen <tniessen@tnie.de> Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com> Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com> Co-authored-by: Efe <dogukankrskl@gmail.com> Co-authored-by: James M Snell <jasnell@gmail.com> Co-authored-by: Trivikram Kamat <16024985+trivikr@users.noreply.github.com> Signed-off-by: RafaelGSS <rafael.nunu@hotmail.com>

Signed-off-by: RafaelGSS <rafael.nunu@hotmail.com>

Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>

MikeMcC399

The link https://ai-coding-assistants-policy.openjsf.org/ is now fixed.

jasnell · 2026-08-11T16:13:07Z

+## When AI is used in contributions
+
+Contributors may use AI tools to assist with contributions, but such tools
+never replace human judgment.


This is redundant to the opening principle

nodejs-github-bot added the doc Issues and PRs related to the documentations. label Mar 4, 2026

UlisesGascon approved these changes Mar 5, 2026

View reviewed changes

joyeecheung reviewed Mar 5, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

Aditi-1400 reviewed Mar 5, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

Renegade334 reviewed Mar 5, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

mcollina requested changes Mar 5, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

Comment thread doc/contributing/ai-guidelines.md Outdated

Comment thread doc/contributing/ai-guidelines.md Outdated

Comment thread doc/contributing/ai-guidelines.md Outdated

lpinca approved these changes Mar 5, 2026

View reviewed changes

Aditi-1400 approved these changes Mar 6, 2026

View reviewed changes

tniessen reviewed Mar 6, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

aduh95 reviewed Mar 9, 2026

View reviewed changes

Comment thread CONTRIBUTING.md Outdated

MikeMcC399 reviewed Mar 9, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

MikeMcC399 reviewed Mar 9, 2026

View reviewed changes

Comment thread CONTRIBUTING.md Outdated

This comment was marked as resolved.

Sign in to view

RafaelGSS requested a review from mcollina March 13, 2026 16:39

RafaelGSS added the commit-queue-squash Add this label to instruct the Commit Queue to squash all the PR commits into the first one. label Mar 13, 2026

gurgunday approved these changes Mar 13, 2026

View reviewed changes

RafaelGSS added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Mar 14, 2026

joyeecheung mentioned this pull request Mar 17, 2026

Virtual File System for Node.js #61478

Open

indutny previously requested changes Mar 17, 2026

View reviewed changes

joyeecheung added the tsc-agenda Issues and PRs to discuss during the meetings of the TSC. label Mar 17, 2026

joyeecheung mentioned this pull request Mar 17, 2026

Node.js Technical Steering Committee (TSC) Meeting 2026-03-18 nodejs/TSC#1830

Closed

mcollina reviewed Mar 17, 2026

View reviewed changes

mcollina approved these changes Mar 17, 2026

View reviewed changes

mcollina mentioned this pull request Mar 17, 2026

Vote on AI contributions nodejs/TSC#1831

Open

trivikr approved these changes May 29, 2026

View reviewed changes

jasnell approved these changes May 29, 2026

View reviewed changes

panva approved these changes May 29, 2026

View reviewed changes

mcollina approved these changes May 29, 2026

View reviewed changes

RafaelGSS removed commit-queue-squash Add this label to instruct the Commit Queue to squash all the PR commits into the first one. tsc-agenda Issues and PRs to discuss during the meetings of the TSC. labels May 29, 2026

joyeecheung reviewed May 29, 2026

View reviewed changes

joyeecheung reviewed Jun 3, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md

MikeMcC399 mentioned this pull request Jun 12, 2026

Add comprehensive AGENTS.md agent guide nodejs/docker-node#2295

Closed

12 tasks

JakobJingleheimer approved these changes Jun 21, 2026

View reviewed changes

jasnell mentioned this pull request Jul 7, 2026

stream: reduce per-chunk overhead in streams and webstreams #64312

Closed

bmuenzenmeyer mentioned this pull request Jul 18, 2026

Define Valid Contributions nodejs/doc-kit#916

Closed

RafaelGSS requested a review from joyeecheung August 5, 2026 18:55

RafaelGSS force-pushed the add-ai-guidelines branch from c095ce0 to 2d77889 Compare August 5, 2026 19:31

ovflowd approved these changes Aug 6, 2026

View reviewed changes

joyeecheung approved these changes Aug 6, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

trivikr mentioned this pull request Aug 10, 2026

Authorization request: AI-assisted contributions from @arhxam nodejs/admin#1085

Closed

RafaelGSS and others added 3 commits August 10, 2026 16:03

fixup! doc: create ai-guidelines and include to CONTRIBUTING

ef76b0c

Signed-off-by: RafaelGSS <rafael.nunu@hotmail.com>

fixup! fixup! doc: create ai-guidelines and include to CONTRIBUTING

ef4c7b2

RafaelGSS force-pushed the add-ai-guidelines branch from 2d77889 to ef4c7b2 Compare August 10, 2026 19:18

RafaelGSS added the commit-queue-squash Add this label to instruct the Commit Queue to squash all the PR commits into the first one. label Aug 10, 2026

MikeMcC399 reviewed Aug 11, 2026

View reviewed changes

Comment thread doc/contributing/ai-guidelines.md Outdated

This comment was marked as resolved.

Sign in to view

Update doc/contributing/ai-guidelines.md

d6283f2

Co-authored-by: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>

MikeMcC399 approved these changes Aug 11, 2026

View reviewed changes

jasnell approved these changes Aug 11, 2026

View reviewed changes

efekrskl approved these changes Aug 11, 2026

View reviewed changes

Uh oh!

Uh oh!

Conversation

RafaelGSS commented Mar 4, 2026

Uh oh!

nodejs-github-bot commented Mar 4, 2026

Uh oh!

Uh oh!

joyeecheung commented Mar 5, 2026

Uh oh!

Uh oh!

RafaelGSS commented Mar 5, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

gurgunday left a comment

Choose a reason for hiding this comment

Uh oh!

indutny left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mcollina Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

MikeMcC399 Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

joyeecheung commented Mar 17, 2026

Uh oh!

mcollina left a comment

Choose a reason for hiding this comment

Uh oh!

indutny commented Mar 17, 2026

Uh oh!

mcollina commented Mar 17, 2026

Uh oh!

mcollina left a comment

Choose a reason for hiding this comment

Uh oh!

joyeecheung left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ovflowd commented Aug 6, 2026

Uh oh!

joyeecheung left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

MikeMcC399 left a comment

Choose a reason for hiding this comment

Uh oh!

jasnell Aug 11, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

indutny left a comment •

edited

Loading