From 398633a2bef49ce8a916b766c8ca1f1dcb0ba3c7 Mon Sep 17 00:00:00 2001 From: Val Alexander Date: Sun, 11 Oct 2026 03:06:50 -0500 Subject: [PATCH] docs: declare the sibling worktree directory for agent sessions Agent worktree skills look for a worktree-directory preference in CLAUDE.md before falling back to a global path. Without one, six jev-harness worktrees landed under ~/.config/superpowers/worktrees, outside every sandboxed session's reach, and could be listed but never retired. State the existing ../jev-harness-wt/ convention so new worktrees stay reachable. Co-Authored-By: Claude Fable 5.1 --- CLAUDE.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..3de139b --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,9 @@ +# Claude Code notes — jev-harness + +Read `AGENTS.md` first; it is the project guide and applies here unchanged. + +Worktree directory: create worktrees as siblings of the checkout at +`../jev-harness-wt/` (`git worktree add -b ../jev-harness-wt/ origin/main`). +Do not use `.worktrees/` inside the repo or a global location such as +`~/.config/superpowers/worktrees/`; sandboxed agent sessions cannot reach the +latter, so worktrees parked there cannot be inspected or retired.