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

Co-Authored-By: Beth Griggs <bethanyngriggs@gmail.com>

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

Review requested:

@nodejs/tsc

doc/contributing/ai-guidelines.md

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.

doc/contributing/ai-guidelines.md

Co-authored-by: Aditi <62544124+Aditi-1400@users.noreply.github.com> Co-authored-by: Joyee Cheung <joyeec9h3@gmail.com>

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

doc/contributing/ai-guidelines.md

mcollina · 2026-03-05T15:59:17Z

doc/contributing/ai-guidelines.md

+* **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.


Do we have a template? I thought those are for issues, not PRs.

Not strictly a template: https://github.com/nodejs/node/blob/main/.github/PULL_REQUEST_TEMPLATE.md?plain=1

It's not possible to fulfil the instructions "Complete pull request templates fully" based on the contents of https://github.com/nodejs/node/blob/main/.github/PULL_REQUEST_TEMPLATE.md?plain=1 so it looks like this sentence needs to be removed.

doc/contributing/ai-guidelines.md

CONTRIBUTING.md

doc/contributing/ai-guidelines.md

CONTRIBUTING.md

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>

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

doc/contributing/ai-guidelines.md

+* **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.

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.

jasnell · 2026-03-17T18:16:38Z

Let's make sure it's on the agenda for a time more convenient for the majority of TSC members. That said, I can say right now that I'm -1 on blocking this on those grounds.

joyeecheung · 2026-03-17T18:19:50Z

I've updated the agenda tomorrow to mark it FYI (as in, it doesn't need to be discussed this week, but worth taking a look and do some homework before discussions happen). In any case, decisions won't be made in meetings, and this likely needs a proper vote.

jasnell · 2026-03-17T18:26:48Z

doc/contributing/ai-guidelines.md

+* **Own every line you submit.** You are responsible for all code in your
+  pull request, regardless of how it was generated. Be prepared to explain
+  any change in detail during review.


Suggested change

* **Own every line you submit.** You are responsible for all code in your

pull request, regardless of how it was generated. Be prepared to explain

any change in detail during review.

* **Own every line you submit.** You are responsible for all code in your

pull request, regardless of how it was generated. This includes ensuring

that AI-generated or AI-assisted contributions satisfy the project's

[Developer's Certificate of Origin][] and licensing requirements. Be

prepared to explain any change in detail during review.

(would need a DCO link added at the bottom of the page also)

doc: create ai-guidelines and include to CONTRIBUTING

8fa167d

Co-Authored-By: Beth Griggs <bethanyngriggs@gmail.com>

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

doc/contributing/ai-guidelines.md Outdated Show resolved Hide resolved

Aditi-1400 reviewed Mar 5, 2026

View reviewed changes

doc/contributing/ai-guidelines.md Outdated Show resolved Hide resolved

Apply suggestions from code review

cee1884

Co-authored-by: Aditi <62544124+Aditi-1400@users.noreply.github.com> Co-authored-by: Joyee Cheung <joyeec9h3@gmail.com>

Renegade334 reviewed Mar 5, 2026

View reviewed changes

doc/contributing/ai-guidelines.md Outdated Show resolved Hide resolved

mcollina requested changes Mar 5, 2026

View reviewed changes

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

doc/contributing/ai-guidelines.md Outdated Show resolved Hide resolved

aduh95 reviewed Mar 9, 2026

View reviewed changes

CONTRIBUTING.md Outdated Show resolved Hide resolved

MikeMcC399 reviewed Mar 9, 2026

View reviewed changes

doc/contributing/ai-guidelines.md Outdated Show resolved Hide resolved

MikeMcC399 reviewed Mar 9, 2026

View reviewed changes

CONTRIBUTING.md Outdated Show resolved Hide resolved

This comment was marked as resolved.

Sign in to view

RafaelGSS and others added 2 commits March 13, 2026 10:55

Apply suggestions from code review

483c41b

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>

fixup! Apply suggestions from code review

8944958

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

Open

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

jasnell reviewed Mar 17, 2026

View reviewed changes

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!

mcollina Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

legendecas Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

MikeMcC399 Mar 13, 2026

Choose a reason for hiding this comment

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!

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!

jasnell commented Mar 17, 2026

Uh oh!

joyeecheung commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jasnell Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

17 participants

indutny left a comment •

edited

Loading

joyeecheung commented Mar 17, 2026 •

edited

Loading