Best practices for configuring context in monorepos

[TheSteinn]

With typical agents/harnesses, I would add an AGENTS.md file to the root on the monorepo, and then another to each subdirectory that has a different context/domain. For instance, something like

apps/
  app1/
    src/
    AGENTS.md
  app2/
    src/
    AGENTS.md
libs/
 ...nested libraries with agent files
AGENTS.md

From what I understand, ContextScout works by evaluating the context files stored in the root of the repository. What would be your best suggestion for configuring the OAC context in this type of project? Can it handle having a .opencode/context folder in multiple subdirectories?

[darrenhinde]

So with Agent.md it’s good to know that these are pulled in automatically depending on the layer you use your AI tooling. I don’t like depending on these as feels unreliable most of the time.

So I mainly use monorepo so how I am configuring is building project intelligence into subfolders then I like breaking things by function so have a folder of function/service then relevant context in there. Having a navigation.md at each folder root to quickly highlight where to find other context files. All this is in the context folder/project-intelligence.

This approach does two things one, it’s easy to maintain as long as you using file references and core concepts do not change in your project. You don’t need to state working on api v2 but the function and ai will get it automatically which allows when working with multiple services makes it a lot easier to work with as you use normal language to help with development.