From 4e484d9827442dc55ff96b7e8115944d9067589a Mon Sep 17 00:00:00 2001 From: Priyanka Saggu Date: Tue, 11 Aug 2026 19:33:08 +0530 Subject: [PATCH 1/3] add AI usage guildelines to PR template --- .github/pull_request_template.md | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 3dbf24dc..06e90a2b 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -59,4 +59,23 @@ For more information on release notes see: https://git.k8s.io/community/contribu ```release-note ``` -Doc #(issue) \ No newline at end of file +Doc #(issue) + +## Generative AI Usage Disclosure + +- [ ] No AI tools were used +- [ ] AI tools were used (complete below) + +*How they were used:* + From eae9985a68dee9c33931403db85fc167038530d5 Mon Sep 17 00:00:00 2001 From: Priyanka Saggu Date: Tue, 11 Aug 2026 19:33:20 +0530 Subject: [PATCH 2/3] add AI usage guildelines to all issue template --- .github/ISSUE_TEMPLATE/bug_report.yml | 24 +++++++++++++++++----- .github/ISSUE_TEMPLATE/feature_request.yml | 24 +++++++++++++++++----- .github/ISSUE_TEMPLATE/tracking.yml | 24 +++++++++++++++++----- 3 files changed, 57 insertions(+), 15 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 709ee948..01d52136 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -9,11 +9,9 @@ body: Thanks for taking the time to report this! Before submitting, please ensure you have searched the [existing issues](https://github.com/kubernetes-sigs/node-readiness-controller/issues) to avoid duplicates. - - type: markdown - attributes: - value: | - While AI-assisted submissions are acceptable, you should understand the issue and describe it in your own words. - To learn more, please refer to Kubernetes AI usage policy: https://www.kubernetes.dev/docs/guide/pull-requests/#ai-guidance + **Generative AI Usage Disclosure** + + If you used AI tools in preparing this issue, please review our [Generative AI Usage Disclosure](https://github.com/kubernetes-sigs/node-readiness-controller/blob/main/CONTRIBUTING.md#generative-ai-usage-disclosure) guidelines and disclose it below. - type: textarea id: description @@ -80,3 +78,19 @@ body: description: Any other relevant details. validations: required: false + + - type: checkboxes + id: ai-disclosure + attributes: + label: AI Tools Usage + options: + - label: No AI tools were used + - label: AI tools were used (complete below) + + - type: textarea + id: ai-tools-usage + attributes: + label: How They Were Used + description: Describe what the AI helped with (e.g., drafting the description, analyzing logs) and which parts of the issue were affected. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 177cbc82..a4cdd7bf 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -9,11 +9,9 @@ body: Thank you for suggesting an improvement! Please ensure you have checked the [existing issues](https://github.com/kubernetes-sigs/node-readiness-controller/issues) and [Discussions](https://github.com/kubernetes-sigs/node-readiness-controller/discussions) to see if this has already been proposed. - - type: markdown - attributes: - value: | - While AI-assisted submissions are acceptable, you should understand the issue and describe it in your own words. - To learn more, please refer to Kubernetes AI usage policy: https://www.kubernetes.dev/docs/guide/pull-requests/#ai-guidance + **Generative AI Usage Disclosure** + + If you used AI tools in preparing this issue, please review our [Generative AI Usage Disclosure](https://github.com/kubernetes-sigs/node-readiness-controller/blob/main/CONTRIBUTING.md#generative-ai-usage-disclosure) guidelines and disclose it below. - type: textarea id: problem-statement @@ -39,3 +37,19 @@ body: description: A clear and concise description of any alternative solutions or features you've considered. validations: required: false + + - type: checkboxes + id: ai-disclosure + attributes: + label: AI Tools Usage + options: + - label: No AI tools were used + - label: AI tools were used (complete below) + + - type: textarea + id: ai-tools-usage + attributes: + label: How They Were Used + description: Describe what the AI helped with (e.g., drafting the description, analyzing logs) and which parts of the issue were affected. + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/tracking.yml b/.github/ISSUE_TEMPLATE/tracking.yml index ce1b80d4..ca2d3b0b 100644 --- a/.github/ISSUE_TEMPLATE/tracking.yml +++ b/.github/ISSUE_TEMPLATE/tracking.yml @@ -8,11 +8,9 @@ body: value: | This template is intended for maintainers and contributors to track the progress of an epic, cross-cutting feature, or major refactor that requires multiple PRs or sub-tasks. - - type: markdown - attributes: - value: | - While AI-assisted submissions are acceptable, you should understand the issue and describe it in your own words. - To learn more, please refer to Kubernetes AI usage policy: https://www.kubernetes.dev/docs/guide/pull-requests/#ai-guidance + **Generative AI Usage Disclosure** + + If you used AI tools in preparing this issue, please review our [Generative AI Usage Disclosure](https://github.com/kubernetes-sigs/node-readiness-controller/blob/main/CONTRIBUTING.md#generative-ai-usage-disclosure) guidelines and disclose it below. - type: textarea id: summary @@ -52,3 +50,19 @@ body: placeholder: vX.Y.Z or Next validations: required: false + + - type: checkboxes + id: ai-disclosure + attributes: + label: AI Tools Usage + options: + - label: No AI tools were used + - label: AI tools were used (complete below) + + - type: textarea + id: ai-tools-usage + attributes: + label: How They Were Used + description: Describe what the AI helped with (e.g., drafting the description, analyzing logs) and which parts of the issue were affected. + validations: + required: false From 4302a000729da9de509a67664710fa467573bbd5 Mon Sep 17 00:00:00 2001 From: Priyanka Saggu Date: Thu, 20 Aug 2026 12:24:58 +0530 Subject: [PATCH 3/3] add Generative AI usage guidelines to CONTRIBUTING.md and AGENTS.md --- AGENTS.md | 29 +++++++++++++++++++++++++++++ CONTRIBUTING.md | 17 +++++++++++++++++ 2 files changed, 46 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..92a6a40a --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,29 @@ +# AGENTS.md + +This file provides guidance for AI coding agents, and the humans directing +them, when contributing to this repository. + +## Responsibility Split + +Regardless of how much of a contribution is AI-assisted, the human +contributor remains fully responsible for: + +- Understanding every change proposed, including code generated by an agent. +- Verifying correctness through code review and thorough local testing + (unit, integration, and any other relevant verification) before submitting. +- Writing PR descriptions, issue reports, and testing notes in their own + words, reflecting what they actually did and observed, not AI-generated + summaries or hypothetical results. +- Disclosing AI tool usage in the corresponding PR/issue template checkbox + and field. + +AI agents themselves should not open PRs or issues, or submit AI-generated +summaries/test results, without a human verifying the underlying change or +problem first. + +Commits must not include `Co-authored-by` trailers attributing authorship to +AI agents or tools. + +For more details on responsible Generative AI usage, see the +[Generative AI Usage Disclosure](CONTRIBUTING.md#generative-ai-usage-disclosure) +section in CONTRIBUTING.md. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0f2ffe2f..3669c81b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,6 +20,23 @@ If your repo has certain guidelines for contribution, put them here ahead of the - [Mentoring Initiatives](https://k8s.dev/community/mentoring) - We have a diverse set of mentorship programs available that are always looking for volunteers! +## Generative AI Usage Disclosure + +Using AI tools to help write your PR or issue is acceptable, but as the author, you are responsible for understanding and verifying every change or problem you submit. + +- Do not leave the first review of AI generated changes to the reviewers, verify the changes (code review, testing, etc.) before submitting your PR. +- Do not submit an issue based solely on AI-generated analysis without confirming it reflects a real, reproducible problem (or a well-understood request) in your own environment. +- The PR/issue description must be provided in your own words and describe the changes or problem you actually made or experienced. Please do not submit AI-generated summaries as a substitute for understanding and describing your contribution. +- Testing information must reflect tests you actually ran on your local machine. Include relevant commands, output, logs, or other evidence from your own environment where appropriate. Do not submit AI-generated or hypothetical test results. + +For more details please review guidelines on responsible Generative AI usage: +- https://www.linuxfoundation.org/legal/generative-ai +- https://www.kubernetes.dev/docs/guide/pull-requests/#ai-guidance + +If you used AI tools in preparing your PR or issue, please disclose which tools and how they were used, using the corresponding checkbox and field in the PR/issue template. + +See also [AGENTS.md](AGENTS.md) for guidance on using AI coding agents in this repository. + ## Contact Information - [Slack channel](https://kubernetes.slack.com/messages/sig-node)