Skip to content
harnesspmv0.5.1
Color scheme
Contrast
Color scheme
Contrast

Monorepos

In short

  • Nothing to configure. Run npx harnesspm init at the root, as in any project.
  • Each workspace gets the harness of its own dependencies. Backend workspaces do not get frontend rules.
  • Shared units go into the root AGENTS.md. A workspace with its own units gets its own block.

Workspaces

harnesspm reads workspaces from the workspaces field of the root package.json, or from pnpm-workspace.yaml. It resolves each workspace from its own folder, on its own dependencies, devDependencies and optionalDependencies.

Where outputs go

Output Where
Units that the root reaches, or that every workspace shares The root AGENTS.md block
Units of one workspace A block in <workspace>/AGENTS.md, with paths relative to that folder
CLAUDE.md with @AGENTS.md Next to each workspace AGENTS.md, and each nested AGENTS.md that git tracks
A ## Workspaces section that names each workspace with a block The root AGENTS.md block, first
Skills, scripts, hooks, MCP servers, permissions The root, where both agents read them

Codex joins AGENTS.md files from the root down to the folder it works in. Claude Code does not read a nested AGENTS.md when the root has a CLAUDE.md, so harnesspm makes a CLAUDE.md next to it import it, also for an AGENTS.md you wrote yourself (sources). Commit both files. A block that becomes empty is removed, and so is a file that held only the block.

Claude Code loads a workspace’s block only when the agent opens a file there with its file tools, not when it works through the shell. So the always-on root block names the workspaces that have one, and asks the agent to read that AGENTS.md before it changes files there.

Your own workspaces

A workspace’s own harness/ belongs to that workspace. A workspace that another workspace depends on is still your own code, so its harness is in the project layer and trusted. It needs no trust entry.

One version per package

Outputs point at one path per package, so the whole repository uses one version of each harness package. A workspace’s direct dependency wins, then the copy closest in the extends chain, then the highest version. harnesspm warns and names the versions.

More