[anonyfox]

Currently I am building a new JS web toolkit on the side with AI assistance for faster progress, and I came to have some prompts folder in the project root that I just drop into the agents (like cursor CMD+I) and point it to a direction (file/folder).

https://github.com/Anonyfox/raven-js/tree/main/prompts

I think we should not split README and AGENT into different documents - the way its heading is that the coding agents are optimized to "act as" humans and use tools like them more and more - and understanding how something works or how to do something should be aimed for humans and expecting AI tools to pick it up like a human would... if they don't currently then probably they will in the the future.

[tracker1]

Kind of my first thought... seems to me this could be part of README.md, or as another suggested CONTRIBUTING.md

I tend to put a lot of this type of info into the readme anyway... for more complex projects, I'll include a docs/ directory with more markdown, images as needed, etc.

For that matter, I think context hints from the likes of Dockerfile(s), compose, and .github/workflows also can serve a dual-purpose here.

[thrown-0825]

Agreed, between this and MCP we are quickly approaching the point where you basically need to document your codebase twice.

Its completely pointless