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?