Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 19 additions & 5 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
24 changes: 19 additions & 5 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
24 changes: 19 additions & 5 deletions .github/ISSUE_TEMPLATE/tracking.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
21 changes: 20 additions & 1 deletion .github/pull_request_template.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,23 @@ For more information on release notes see: https://git.k8s.io/community/contribu
```release-note

```
Doc #(issue)
Doc #(issue)

## Generative AI Usage Disclosure
<!--
If you used AI tools in preparing this PR, please disclose and how they were used.

Using AI tools to help write your PR is acceptable, but as the author, you are responsible for understanding every change in your contribution.

Please write the PR description in your words. Do not submit AI-generated summary and analysis and do not leave the first review of AI generated changes to the reviewers, please verify the changes (code review, local testing, etc.) before submitting your PR.

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

-->
- [ ] No AI tools were used
- [ ] AI tools were used (complete below)

*How they were used:*
<!-- Describe what the AI helped with (e.g., code generation, refactoring, documentation, tests) and which parts of the PR were affected -->
29 changes: 29 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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.
17 changes: 17 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
Loading