Re: Initial AGENTS.md

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