JackieTien97 opened a new pull request, #18952: URL: https://github.com/apache/iotdb/pull/18952
## Description The root `AGENTS.md` is a symlink to `CLAUDE.md`, so shared repository guidance depends on symlink support and a tool-specific file. Replace it with a regular `AGENTS.md` and remove the root `CLAUDE.md`, preserving the license header and all existing guidance below the introduction. This implements the October 20 [email protected] proposal, **[DISCUSS] Consolidate repository agent instructions in AGENTS.md** ([mailing-list archive](https://lists.apache.org/[email protected]:2026-10)). - Use a tool-neutral title and introduction, with a link to contributor setup notes. - Document Claude Code version requirements, instruction-file precedence, the Project instructions setting, and how to verify loading in `CONTRIBUTING.md`. - Update the threat model's references and remove the obsolete RAT exclusion so `AGENTS.md` receives normal license checks. ## Validation - `git diff --check` passed. - Compared the migrated file against the previous `CLAUDE.md`: only the title and introduction changed; module-level instructions are unchanged. - Verified the regular-file mode, removal of `CLAUDE.md`, local documentation links and anchor, and POM XML. - `mvn -B -N apache-rat:check` with `rat.includesFile` limited to the four changed files passed: 4 approved licenses, 0 unknown or unapproved. - No application tests were run; this changes documentation and license-check configuration only. This PR has: - [x] been self-reviewed. - [x] added documentation for the changed instruction-loading behavior. -- 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]
