jiaqizho commented on PR #1740: URL: https://github.com/apache/cloudberry/pull/1740#issuecomment-4430266029
Hi @leborchuk, I don't think that adding a project-level `AGENTS.md` or `CLAUDE.md` in project is a good idea. My first concern is that these files are not just passive documentation. For tools like Codex or Claude Code, project-level instruction files can be loaded automatically and affect every local AI session in this repository. As far as Codex is concerned, `AGENTS.md` is project-scoped; there is no separate global `AGENTS.md` file that each developer can maintain independently. If the repository ships one, it effectively becomes part of the local agent behavior for everyone who checks out the project. I would prefer each contributor to define their own AI agent style, level of autonomy, communication pattern, and workflow preferences. My second concern is the content. A good project-level agent file should mainly capture hard project constraints and practical project knowledge: required license/header rules, build and test commands, high-risk subsystems, generated files ... It should constrain or assist the agent where the project has real requirements. It should not try to tune the agent's general coding style, personality, or workflow. Many items in the proposed `AGENTS.md` read more like agent prompting or personal preferences about how an AI assistant should behave, rather than Cloudberry-specific rules. Those preferences can vary by developer and by tool, and I do not think the project should freeze one particular AI-agent behavior into the repository. @my-ship-it Please consider this change seriously. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
