I just love how in some situations AI makes work faster. Matt Pocock shared video Never Run claude /init. It contained suggestions how to improve AGENTS.md. I simply copy-pasted transcript of video to OpenCode and asked to create instructions:

AGENTS.md rules:

* Keep AGENTS.md minimal
* Move domain-specific rules to separate files

AGENTS.md should not contain:

* Trivially discoverable stuff, e.g.:
  * package scripts (npm run dev, etc.) - can be found via package.json
  * architecture overviews (frameworks, SSR mode, etc.) - can be found from config files and imports
* Specific file paths & service names
* Task specific stuff (not global)
* Introductory/explanatory prose
* Stuff that can be found out using skills

AGENTS.md can contain:

* Non-discoverable from the codebase itself
* Universally relevant across all session types
* Stable — unlikely to change with code refactors

After that I have asked to fix my AGENTS.md by following these rules. Result was quite good.

P.S. there is article related to video as well https://www.aihero.dev/a-complete-guide-to-agents-md