[jamesdaniels]

Start of an agents.md

[markgoho]

There is a general consensus in the community that most of this is now unnecessary for agents. I would just recommend reducing this file to only what's absolutely critically necessary to tell the agent about, because it couldn't possibly figure it out itself.

Remember, every token here will be part of every context window for every session.

[armando-navarro]

@jamesdaniels Hey, James. I've held off on merging this for the same reasons @markgoho mentioned. You did this as a favor to me to help me understand the repo as the new maintainer. I personally used it as a guide. Thank you for that.

But in terms of merging, the newer research indicates this isn't the thing that works most effectively for agents these days.

So, I'm kind of not sure what to do about this PR. User-focused agent instructions would likely be more useful, as opposed to maintainer/contributor-focused. It's on my to-do list.

Let me know what you think.