From b78c77098d5432fda631192eeb475fa5289cdc55 Mon Sep 17 00:00:00 2001 From: microcks-bot Date: Fri, 4 Sep 2026 18:39:12 +0000 Subject: [PATCH] chore: update AI-POLICY.md from global .github repo Signed-off-by: microcks-bot --- AI-POLICY.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/AI-POLICY.md b/AI-POLICY.md index dbaf4f4..8e51be5 100644 --- a/AI-POLICY.md +++ b/AI-POLICY.md @@ -2,6 +2,8 @@ Contributors may use Generative AI tools (such as Large Language Models, GitHub Copilot, Cursor, Claude Code, etc.) when contributing to Microcks. As with any development tool, you are responsible for the quality of the result and for understanding what you submit. +This policy applies to all repositories in the `microcks` GitHub organization. + ## Guiding Principle Microcks is a community-driven organization that values expertise, clear communication, and personal responsibility. To maintain trust in the AI era, we follow a key principle: @@ -15,6 +17,7 @@ Successful ongoing contribution to this community is contingent on building trus * **You must understand your contribution.** Do not submit code, documentation, or other content that you do not fully understand. You should be able to explain to reviewers what your contribution does, how it works, and how you verified it. You should be able to answer reviewers' questions yourself, without recourse to AI. * **Review all AI-generated content.** Before submitting, verify that the contribution is correct, tested, and follows the project's contributing guidelines. * **You own what you submit.** As the PR author, you are responsible for all changes, regardless of the tools used to create them. +* **Do not blame the AI tool.** “The AI generated it” is not an acceptable response to review feedback. You are expected to understand and defend every part of your contribution. ## Acceptable Use @@ -34,6 +37,7 @@ It is **not acceptable** to use Generative AI tools in the following ways: * **Do not instruct AI tools to directly respond to comments.** You must not use AI tools to auto-reply to maintainer review comments on Pull Requests or Issues. Reviewers want to engage with you, not receive generic AI-generated responses. If you use AI assistance to formulate responses, ensure they genuinely reflect your understanding and that you can defend your reasoning. * **Do not use AI tools in commit trailers.** AI tools MUST NOT be added to `Signed-off-by`, `Co-authored-by`, `Assisted-by`, or similar tags in commit messages. Only humans can legally certify the [Developer Certificate of Origin (DCO)](https://developercertificate.org/). The `Signed-off-by` tag certifies that you wrote the code or otherwise have the right to submit it. An AI tool is not a legal entity and cannot make this certification. * **Do not submit large, unfocused AI-generated PRs.** AI tools can generate content faster than reviewers can read it. Keep PRs focused. Maintainers MAY close pull requests that are too large to review effectively. +* **Do not flood the project with contributions.** If you already have Pull Requests awaiting review, allow maintainers time to respond before opening more. * **Avoid verbose AI-generated content.** Trim down unnecessary verbosity in PR descriptions, commit messages, and code comments. Be clear, concise, and specific. * **Do not use AI for `good first issue` tasks.** Issues labeled as `good first issue` are intended for new contributors to learn the codebase and gain experience. Using AI tools to complete these issues is against their purpose. * **Do not plagiarize.** Do not submit work produced via AI tooling that copies from external sources without correct attribution or licensing. @@ -49,19 +53,30 @@ It is **not acceptable** to use Generative AI tools in the following ways: * **AI reviews don't replace human review.** Automated checks and AI-generated review comments can provide useful signals, but they do not satisfy the project's review requirements. Maintainers make the merge decisions. * **Do not request AI-assisted reviews on PRs.** Do not invoke AI bots or tools to post review comments on project PRs. If AI-assisted review is desired, maintainers will request it. * **Proposals require deep understanding.** If you use AI tools to help draft architectural proposals, you must have a thorough understanding of the problem space, proposed solution, and alternatives. The rationale matters most. +* **Communicate in your own voice.** AI tools may help improve clarity, especially when English is not your first language, but the reasoning and final message must genuinely be yours. ## Transparency & Attribution We expect contributors to declare when Generative AI was used to prepare a submission. -* **Explicit Disclosure:** You must explicitly disclose AI usage in your Pull Request description (e.g., checking the box in the PR template). +* **Explicit Disclosure:** You must explicitly disclose AI usage in your Pull Request description. * **Developer Certificate of Origin:** If you submit AI-assisted contributions, you are personally certifying via the DCO that you have the right to contribute the content under the project's license. If you’re unsure about the licensing of code you created using Generative AI tools, **don’t submit it**. +## Linux Foundation Policy + +As a CNCF project, Microcks contributions must also comply with the [Linux Foundation Generative AI Policy](https://www.linuxfoundation.org/legal/generative-ai). + ## Consequences of Non-Compliance Pull Requests that violate this policy may be closed. Specific cases include: * PRs where the contributor cannot explain or defend the changes during review. * PRs with generic, inauthentic responses to reviewer feedback that demonstrate a lack of understanding. * Large, unfocused PRs that appear to be bulk AI-generated content. + +## Credits + +This policy was inspired by the [Crossplane AI Contribution Policy](https://github.com/crossplane/crossplane/blob/main/AI_POLICY.md) and by the experiences and references shared through the collaborative [CNCF discussion on AI contribution policies](https://github.com/cncf/foundation/issues/1285) initiated by Microcks. + +We thank all the maintainers and contributors who have participated in this discussion: @caniszczyk, @charlieegan, @CortNick, @jberkus, @jbw976, @joestringer, @krook, @mx-psi, @Sapthagiri777, @soltysh, @stefanprodan, @tuminoid, @Vaishnav88sk, @xmulligan, @yada, and @yurishkuro.