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]

Reply via email to