From 6c1ca714dbbbf79b1ba02e4acc00364123734a56 Mon Sep 17 00:00:00 2001 From: Harrison Friia <5942798+harrisonfriia@users.noreply.github.com> Date: Tue, 21 Jul 2026 20:41:38 -0700 Subject: [PATCH] docs(agents): document worktree location convention Agents should create worktrees under the main checkout's .worktrees/ directory instead of sibling directories next to the repo root. Co-authored-by: Cursor --- AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 515f491af..8071f196e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,6 +4,11 @@ Stable contracts live here. Current setup and server mechanics are in [RUNNING.md](RUNNING.md); e2e invariants are in [e2e/AGENTS.md](e2e/AGENTS.md). Run `bun run bootstrap` in every fresh rift. +## Worktree location + +- Put new worktrees under `
/.worktrees/` (or the tool's native + root); never `git worktree add ../…` siblings next to the main checkout. + ## Verification and evidence - Tests use Effect Vitest. Run scoped tests with `vitest run ...` or the