From b905f53e9ee6174a09e655c38bccdcb695f25735 Mon Sep 17 00:00:00 2001
From: Ivan Malison <IvanMalison@gmail.com>
Date: Thu, 12 Feb 2026 11:18:50 -0800
Subject: [PATCH] agents: Add worktrees instructions

---
 dotfiles/agents/AGENTS.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/dotfiles/agents/AGENTS.md b/dotfiles/agents/AGENTS.md
index 37a482ee..675bb990 100644
--- a/dotfiles/agents/AGENTS.md
+++ b/dotfiles/agents/AGENTS.md
@@ -21,6 +21,12 @@
 ## Pane usage
 - Do not create extra panes or windows unless the user asks.
 
+## Git worktrees
+- Default to creating git worktrees under a project-local `.worktrees/` directory at the repository root.
+- For a repository at `<repo_root>`, use worktree paths like `<repo_root>/.worktrees/<task-or-branch>`.
+- Create `.worktrees/` if needed before running `git worktree add`.
+- Only use a non-`.worktrees/` location when the user explicitly asks for a different path.
+
 ## NixOS workflow
 - This system is managed with a Nix flake at `~/dotfiles/nixos`.
 - Use `just switch` from that directory for rebuilds instead of plain `nixos-rebuild`.