[FEATURE]: Add instructions in docs for using a global AGENTS.md

[cdfuller]

Feature hasn't been suggested before.

• I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

I'm new to the project and was unable to find the way to use my preexisting AGENTS.md from other coding agents with opencode. I was able to solve my issue with help from a user on the discord.

It would be helpful if the docs stated that AGENTS.md could be added at ~/.config/opencode/AGENTS.md

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Opencode doesn't know the location of its config file #6156: Opencode doesn't know the location of its config file - Similar issue about documentation clarity on where config files are located
• Docs miss mentioning XDG base directories for global configuration while already supporting them #6669: Docs miss mentioning XDG base directories for global configuration while already supporting them - About missing documentation for global configuration file locations, including global AGENTS.md
• Reorganize and document dirs for config, agents, auth credentials, sessions #4170: Reorganize and document dirs for config, agents, auth credentials, sessions - Related issue requesting comprehensive documentation of all configuration directories
• v1.1.4 Global md files issue #7160: v1.1.4 Global md files issue - Bug about AGENTS.md/CLAUDE.md files in ~/.config/opencode/ not being retrieved

Feel free to ignore if none of these address your specific case.

[roboticarmgroup]

You simply paste your AGENTS.md file into the opencode config file like you explained someone helped you do... Well also something to be aware of...

Project-Specific AGENTS.md
For rules that apply only to a specific project, the file should be in the root directory of that project. When you run opencode within that directory or its subdirectories, it will automatically look for and apply the instructions in this file

*This is better than sloppily adding a master agents.md because cache/memory/context lengths can be applied at a project level instead of broadly. This is something new and growing rapidly that the developers are aware of and building towards.

[rekram1-node]

this is already documented?

https://opencode.ai/docs/rules#global

[cdfuller]

You're right. I guess I just missed it in the search.