Hello,
I'd like to bring to discussion that we add a set of a dedicated AI
instructions file (e.g., INSTRUCTIONS.ai) to the Apache Camel repository
(core and other sub-projects).
The purpose of these files would be to define how AI-powered coding agents
and tools should behave when generating code for this project. I believe
this would be beneficial for a few key reasons:
1.
*Enforce ASF Generative Tooling Guidelines:* It would help us formally
adopt and point to the standards defined by the ASF on the use of
generative AI, ensuring all contributions are compliant.
-
Apache Software Foundation Legal - Generative Tooling
<https://www.apache.org/legal/generative-tooling.html>
2.
*Maintain Project Coding Standards:* We can use it to instruct AI tools
on Camel's specific coding patterns, conventions, and architectural
principles. This will help maintain the consistency and quality of the
codebase.
3.
*Define Clear Guardrails:* It allows us to establish a reasonable set of
rules and constraints for generated code, promoting security, reliability,
and adherence to best practices from the start.
This is becoming a standard practice in other major open-source projects.
For example, the Linux kernel community is already discussing and defining
similar guidelines to ensure AI-assisted contributions are constructive.
-
Linux Kernel Mailing List Discussion
<https://lore.kernel.org/all/20250725175358.1989323-1-sas...@kernel.org/>
I believe that taking this proactive step will help us harness the benefits
of AI tooling while safeguarding the integrity of the project.
I'd like to open a discussion on this. What are your thoughts? Any other
projects in the ASF that have defined these instructions and that we could
inspire our guidelines on?
Kind regards,
--
Otavio R. Piske
http://orpiske.net
