Hi Paul,
Some thoughts and suggestions.
1. Since we are build a language compiler here, it is worth adding the
phases of compilation in a section like "Internals" or something similar
## Internals
The compiler has the following phases (and where the code for
those reside)
1. Parsing - src/antlr
2. AST generation - src/main/groovy/org/codehaus/groovy/ast/builder
3. Class generator -
src/main/groovy/org/codehaus/groovy/ast/builder
2. Also, we can add a guardrails section like
## Guardrails
- NEVER break backward compatibility lightly
- Maintain Java interoperability guarantees
- Do not change AST structure without review
If you think it is more appropriate to raise a Jira ticket + PR, I'll
try doing that later today. Thanks
On 4/23/26 07:00, Paul King wrote:
I committed one:
https://github.com/apache/groovy/blob/master/AGENTS.md
But please make suggestions if you spot anything that should be
included initially.
On Thu, Apr 23, 2026 at 10:25 AM Keegan Witt <[email protected]> wrote:
Did you intend to attach a file?
On Wed, Apr 22, 2026, 8:12 PM Paul King <[email protected]> wrote:
Hi folks,
Handling AI contributions is an area we need to talk more
about at some point. Some other ASF projects receive 10 or
more AI-generated "security fix" proposals on some days. We
certainly aren't impacted by this just yet, but we should
prepare in case we see a rise in such PRs.
Also, the ASF has some general advice on generative coding:
https://www.apache.org/legal/generative-tooling.html
A key part of that advice is that humans need to vouch for
what gets submitted/approved. However, we can take steps to
ensure future submissions meet minimal requirements if AI is
involved somewhere in the process.
So, I have put together an initial version of an AGENTS.md
file that attempts to capture at least the "comply with ASF
licensing part" of the general advice. We should undoubtedly
expand the AGENTS.md file, but there is a lot of activity
happening within and outside the ASF in this space, so we
don't need to rush.
Please discuss if you have any thoughts/concerns.
Cheers, Paul.
--
Thank you,
Balachandran Sivakumar
