Question: context is useful to humans as well as computers

[alistairstead]

I really like the approach you have created here it is very similar to something I have been working on.

I have been considering the storage of the context documents. You have placed them in a .agent-os folder which is of course still readable to humans(devs). However, why wouldn't we build this context for humans and place it in a doc/* folder. This then implies it is useful for all contributors to the project.

Is there a reason to hide these context files from your perspective?

[csells]

I have been considering the storage of the context documents. You have placed them in a .agent-os folder which is of course still readable to humans(devs). However, why wouldn't we build this context for humans and place it in a doc/* folder. This then implies it is useful for all contributors to the project.

Hey, @CasJam and @alistairstead. I'm really loving where you're going with agent-os, Brian, but I had the exact same reaction as Alistar -- all of those great docs are useful for getting and keeping humans up-to-date as well. My experimentation has actually been with keeping these docs in a wiki/* folder at the root of my project, along with a TOC and nav. Then, on pushes, use a github action to copy the contents of that folder to a github wiki associated with the project.

Thoughts about facilitating such a thing with agent-os?

[vamseeachanta]

Also, the agent-os contents should be customizable per project. THere should be 2 level of customizations:

• system level
• project level

If users have multiple systems (personal and work), then how to sync system level changes?

[CasJam]

Totally agree that the docs (especially those in the .agent-os/product/ folder are useful for everyone, not just the dev team!

Honestly, I didn't give too much thought into why I made that folder hidden, other than I was following the same pattern as the .claude and .cursor folders.

As with anything else, feel free to make this change in your useage and report back here to let us know how it goes! I'll let this idea sit a little while before deciding on it. Thanks!