[wp-trac] [WordPress Trac] #63901: Add `AGENTS.md` for the project

[WordPress Trac]

#63901: Add `AGENTS.md` for the project
------------------------------+------------------------------
 Reporter:  flixos90          |       Owner:  (none)
     Type:  enhancement       |      Status:  new
 Priority:  normal            |   Milestone:  Awaiting Review
Component:  Build/Test Tools  |     Version:
 Severity:  normal            |  Resolution:
 Keywords:                    |     Focuses:
------------------------------+------------------------------

Comment (by jeremyfelt):

 I think adding `AGENTS.md` is a great idea, that we should start simple,
 and that while tools should generally be good at analyzing and picking up
 existing structure, it can be helpful to point them in the right initial
 direction.

 FWIW, I've found success by maintaining context in a separate directory
 (like `/docs`) and then explicitly loading it through the main agent file
 (previously, `CLAUDE.md`).

 {{{
 # Agent context for the WordPress project

 This is the root level context file for the open source project,
 WordPress.

 ## Project overview

 Always load @CONTRIBUTING.md, @README.md, and @docs/architecture.md ....
 when starting a new session.
 }}}

 This can then be tested with a prompt like:

 {{{
 > What context have you loaded already? Please provide filenames.

 I've loaded the following context files:

 - /{HOME}/wordpress-develop/AGENTS.md
 - /{HOME}/wordpress-develop/CONTRIBUTING.md
 - /{HOME}/wordpress-develop/README.md
 - /{HOME}/wordpress-develop/docs/architecture.md
 }}}

 IMO, this helps keep `AGENTS.md` clean and can allow for additional
 context to be designed more for people and agents.

 This is also a good opportunity to revisit our existing documentation and
 improve it for the current state of the project. (e.g. code maintained in
 other repos, explanation of `src/` and `build/` directories, etc...)

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/63901#comment:9>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform