Document AI-generated code policies by Copilot · Pull Request #5693 · mochajs/mocha

Copilot · 2026-02-06T16:01:36Z

Plan for AI-Generated Code Documentation

Review existing documentation structure (CONTRIBUTING.md, MAINTAINERS.md)
Add AI-generated code policy section to CONTRIBUTING.md
- State that AI-generated code must pass all automated tests and manual inspections
- Clarify that these requirements apply to all PRs, AI-generated or not
~~Add maintainer guidelines to MAINTAINERS.md~~ (removed per maintainer feedback)
Validate changes don't break existing build/docs
Run code review and security checks
Address maintainer feedback to remove MAINTAINERS.md changes
Revert unintended package-lock.json changes

Changes Summary

CONTRIBUTING.md

Added "🤖 AI-Generated Code" section that:

Acknowledges AI tools as valuable development aids
Requires all code (AI or human) to pass automated tests
Requires thorough manual review for correctness, security, and standards
Establishes contributor responsibility for all submitted code

Other Files

MAINTAINERS.md: Changes removed per maintainer request
package-lock.json: Unintended changes reverted since package.json was not modified

All linting checks passed ✅

Original prompt

This section details on the original issue you should resolve

<issue_title>🛠️ Repo: Update Mocha docs RE our use of AI-generated code</issue_title>
<issue_description>### Tooling Suggestion Checklist

I have tried restarting my IDE and the issue persists.

I have pulled the latest main branch of the repository.

I have read and agree to Mocha's Code of Conduct and Contributing Guidelines

I have searched for related issues and issues with the faq label, but none matched my issue.

I want to provide a PR to resolve this

Overview

I've started opening GitHub Copilot PRs, and we have also accepted code from other AI tools like Claude provided by outside contributors. Personally, I think AI has a lot of value. I also fully recognize that blindly accepting AI-generated code is a huge risk, and I've seen it in my own life at work. We should update our docs to be clear that any AI-generated code still needs to pass all the same automated tests and manual inspections that any other PR needs to pass. Additionally, if a maintainer uses AI to generate any non-trivial amount of code (let's say 10+ lines), it must be approved by another maintainer before merging.

Additional Info

No response</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes 🛠️ Repo: Update Mocha docs RE our use of AI-generated code #5692

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

linux-foundation-easycla · 2026-02-06T16:01:43Z

❌ - login: @Copilot / name: copilot-swe-agent[bot] . The commit (116e5b6, 2e60fca, bd359d0, e7d8c15, f09eccf) is not authorized under a signed CLA. Please click here to be authorized. For further assistance with EasyCLA, please submit a support request ticket.

Add guidelines for AI-generated code contributions and maintainer review requirements. This addresses issue requirements by: - Clarifying that AI code must pass all tests and manual reviews - Requiring maintainer approval for AI-generated code (10+ lines) by another maintainer Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

mark-wiemer · 2026-02-07T20:22:28Z

MAINTAINERS.md

 Requesting a review from another maintainer _may or may not_ actually result in a review; don't wait on it.
 If the PR cannot move forward without input from a certain maintainer, _assign them to the PR_.

+#### AI-Generated Code by Maintainers


@copilot we can remove changes to this file

Removed changes to MAINTAINERS.md in commit 116e5b6. The AI-generated code policy now only appears in CONTRIBUTING.md.

mark-wiemer · 2026-02-07T20:23:09Z

package-lock.json

      "integrity": "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw==",
      "dev": true,
      "license": "MIT",
+      "peer": true,


@copilot revert changes to this file, as package.json didn't change

Reverted package-lock.json changes in commit bd359d0.

Per maintainer feedback, keep AI-generated code policy only in CONTRIBUTING.md Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

Per maintainer feedback, revert unintended package-lock.json changes since package.json was not modified Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

Initial plan

f09eccf

Copilot AI assigned Copilot and mark-wiemer Feb 6, 2026

Copilot started work on behalf of mark-wiemer February 6, 2026 16:01 View session

Copilot AI and others added 2 commits February 6, 2026 16:03

Complete AI-generated code documentation

2e60fca

Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Update Mocha documentation for AI-generated code~~ Document AI-generated code policies Feb 6, 2026

Copilot AI requested a review from mark-wiemer February 6, 2026 16:05

Copilot finished work on behalf of mark-wiemer February 6, 2026 16:05

mark-wiemer reviewed Feb 7, 2026

View reviewed changes

Copilot started work on behalf of mark-wiemer February 7, 2026 20:22 View session

mark-wiemer reviewed Feb 7, 2026

View reviewed changes

Remove AI-generated code guidelines from MAINTAINERS.md

116e5b6

Per maintainer feedback, keep AI-generated code policy only in CONTRIBUTING.md Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

Copilot finished work on behalf of mark-wiemer February 7, 2026 20:24

Copilot AI requested a review from mark-wiemer February 7, 2026 20:24

Copilot started work on behalf of mark-wiemer February 7, 2026 20:24 View session

Revert package-lock.json changes

bd359d0

Per maintainer feedback, revert unintended package-lock.json changes since package.json was not modified Co-authored-by: mark-wiemer <7833360+mark-wiemer@users.noreply.github.com>

Copilot finished work on behalf of mark-wiemer February 7, 2026 20:26

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Document AI-generated code policies#5693

Document AI-generated code policies#5693
Copilot wants to merge 5 commits intomainfrom
copilot/update-mocha-docs-ai-code

Copilot AI commented Feb 6, 2026 •

edited

Loading

Uh oh!

linux-foundation-easycla bot commented Feb 6, 2026 •

edited

Loading

Uh oh!

mark-wiemer Feb 7, 2026

Uh oh!

Copilot AI Feb 7, 2026

Uh oh!

mark-wiemer Feb 7, 2026

Uh oh!

Copilot AI Feb 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

Copilot AI commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Plan for AI-Generated Code Documentation

Changes Summary

CONTRIBUTING.md

Other Files

Overview

Additional Info

Comments on the Issue (you are @copilot in this section)

Uh oh!

linux-foundation-easycla bot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mark-wiemer Feb 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 7, 2026

Choose a reason for hiding this comment

Uh oh!

mark-wiemer Feb 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 7, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Feb 6, 2026 •

edited

Loading

linux-foundation-easycla bot commented Feb 6, 2026 •

edited

Loading