Every agent tool I tried dumps all the agents into one workspace. Here's the structure I went with instead

This is the first in a series of documents where I work through the architecture of an agent-orchestration library I'm building. This first one is about the environment in which the agent runs. The problem with one workspace is that it forces very different kinds of things to live in the same place: the code the agent works on, the artifacts it produces that I want to look at, and the secrets I hand it. For this I defined three directories: .artifacts/ agents/ / common/ .secrets/ agents/