Update contributor docs about AI coding assistants

[janhoy]

These are my suggested edits. See also dev-list discussion with subject "[DISCUSS] AI assisted contributions"

[epugh]

LGTM.

[dsmiley]

Nice. Glad this is short.

[janhoy]

I came across https://vibe-coding-manifesto.com from another ASF mailing list, which goes more in depth on many of these topics. Perhaps worth linking to, especially for non-devs who want to contribute.

Would it be an idea to start a PROMPTING.md file in the repo, to encode the key peculiarities of our project, such as tidy, precommit etc?

[rahulgoswami]

Would it be an idea to start a PROMPTING.md file in the repo, to encode the key peculiarities of our project, such as tidy, precommit etc?

I can think of both pros and cons of doing this.
Pros: Could help provide a consistent project view across agents. "/init" in either OpenAI Codex or Claude Code will generate a solid first draft which could be iterated upon. I tried both the agents, and fwiw CLAUDE.md was much more comprehensive. Let me know if you'd like me to share it.

Cons: Agents have gotten good at generating this themselves. Do we want to maintain it?